SearXNGのローカルデプロイと設定

CherryStudio は SearXNG を通じたネット検索をサポートしています。SearXNG はローカルにもサーバーにもデプロイできるオープンソースプロジェクトなので、API プロバイダーを必要とする他の設定方法とは少し異なります。

SearXNG プロジェクトリンク：SearXNG

SearXNG の利点

• オープンソースで無料、API 不要
• 比較的プライバシー性が高い
• 高いカスタマイズ性

ローカルデプロイ

1. Docker で直接デプロイ

SearXNG は複雑な環境設定を必要としないため、docker compose を使わず、空いているポートを 1 つ用意するだけでデプロイできます。そのため、最も手軽な方法は Docker で直接イメージを取得してデプロイすることです。

1. ダウンロード・インストールして設定 docker

インストール後、イメージの保存先パスを 1 つ選択します：

2. SearXNG イメージを検索して取得

検索欄に入力 searxng ：

イメージを取得：

3. イメージを実行

取得に成功したら images ページへ：

取得したイメージを選択して［実行］をクリック：

設定項目を開いて設定します：

例として 8085 ポートを例にすると：

実行に成功したらリンクをクリックするだけで SearXNG のフロントエンド画面を開けます：

このページが表示されればデプロイ成功です：

サーバーへのデプロイ

Windows で Docker をインストールするのはやや面倒なため、SearXNG をサーバーにデプロイして他の人と共有することもできます。しかし残念ながら、SearXNG 自体は現時点で認証をサポートしていないため、他人が技術的手段であなたのデプロイしたインスタンスを見つけて悪用する可能性があります。

そのため、Cherry Studio は現在、 HTTP Basic 認証（RFC7617）を設定できます。ユーザーが自分でデプロイした SearXNG をインターネット上に公開したい場合は、 必ず Nginx などのリバースプロキシソフトで HTTP Basic 認証を設定してください。以下に簡単なチュートリアルを示しますが、基本的な Linux 運用知識が必要です。

SearXNG をデプロイ

同様に、ここでも Docker でデプロイします。あなたがすでに 公式チュートリアル に従ってサーバーに最新の Docker CE をインストール済みだとします。以下は、Debian システムでの新規インストール向けの一括コマンドです：

sudo apt update
sudo apt install git -y

# 公式リポジトリを取得
cd /opt
git clone https://github.com/searxng/searxng-docker.git
cd /opt/searxng-docker

# サーバーの帯域幅が小さい場合は false に設定できます
export IMAGE_PROXY=true

# 設定ファイルを変更
cat <<EOF > /opt/searxng-docker/searxng/settings.yml
# 詳細は https://docs.searxng.org/admin/settings/settings.html#settings-use-default-settings を参照
use_default_settings: true
server:
  # base_url は SEARXNG_BASE_URL 環境変数で定義されます。 .env と docker-compose.yml を参照してください
  secret_key: $(openssl rand -hex 32)
  limiter: false # プライベートインスタンスでは無効化できます
  image_proxy: $IMAGE_PROXY
ui:
  static_use_hash: true
redis:
  url: redis://redis:6379/0
search:
  formats:
    - html
    - json
EOF

ローカルの待受ポートを変更したり、既存のローカル nginx を流用したりしたい場合は、 docker-compose.yaml ファイルを編集し、以下を参考にしてください：

version: "3.7"

services:
# Caddy が不要で、既存の Nginx を流用する場合は、以下を削除してください。デフォルトでは Caddy は不要です。
  caddy:
    container_name: caddy
    image: docker.io/library/caddy:2-alpine
    network_mode: host
    restart: unless-stopped
    volumes:
      - ./Caddyfile:/etc/caddy/Caddyfile:ro
      - caddy-data:/data:rw
      - caddy-config:/config:rw
    environment:
      - SEARXNG_HOSTNAME=${SEARXNG_HOSTNAME:-http://localhost}
      - SEARXNG_TLS=${LETSENCRYPT_EMAIL:-internal}
    cap_drop:
      - ALL
    cap_add:
      - NET_BIND_SERVICE
    logging:
      driver: "json-file"
      options:
        max-size: "1m"
        max-file: "1"
# Caddy が不要で、既存の Nginx を流用する場合は、上のものを削除してください。デフォルトでは Caddy は不要です。
  redis:
    container_name: redis
    image: docker.io/valkey/valkey:8-alpine
    command: valkey-server --save 30 1 --loglevel warning
    restart: unless-stopped
    networks:
      - searxng
    volumes:
      - valkey-data2:/data
    cap_drop:
      - ALL
    cap_add:
      - SETGID
      - SETUID
      - DAC_OVERRIDE
    logging:
      driver: "json-file"
      options:
        max-size: "1m"
        max-file: "1"

  searxng:
    container_name: searxng
    image: docker.io/searxng/searxng:latest
    restart: unless-stopped
    networks:
      - searxng
    # デフォルトではホストの 8080 ポートにマッピングされます。8000 で待ち受けたい場合は "127.0.0.1:8000:8080" に変更してください
    ports:
      - "127.0.0.1:8080:8080"
    volumes:
      - ./searxng:/etc/searxng:rw
    environment:
      - SEARXNG_BASE_URL=https://${SEARXNG_HOSTNAME:-localhost}/
      - UWSGI_WORKERS=${SEARXNG_UWSGI_WORKERS:-4}
      - UWSGI_THREADS=${SEARXNG_UWSGI_THREADS:-4}
    cap_drop:
      - ALL
    cap_add:
      - CHOWN
      - SETGID
      - SETUID
    logging:
      driver: "json-file"
      options:
        max-size: "1m"
        max-file: "1"

networks:
  searxng:

volumes:
# Caddy が不要で、既存の Nginx を流用する場合は、以下を削除してください
  caddy-data:
  caddy-config:
# Caddy が不要で、既存の Nginx を流用する場合は、上のものを削除してください
  valkey-data2:

実行 docker compose up -d を起動します。実行： docker compose logs -f searxng ログを確認できます。

Nginx リバースプロキシと HTTP Basic 認証をデプロイ

宝塔パネルや 1Panel などのサーバーパネルを使用している場合は、ドキュメントを参照してサイトを追加し、nginx のリバースプロキシを設定してください。その後、nginx 設定ファイルを編集する場所を見つけ、以下の例を参考に変更します：

server
{
    listen 443 ssl;

    # この行はあなたのホスト名です
    server_name search.example.com;

    # index index.html;
    # root /data/www/default;

    # SSL を設定している場合は、この 2 行が必要です
    ssl_certificate /path/to/your/cert/fullchain.pem;
    ssl_certificate_key /path/to/your/cert/privkey.pem;

    # HSTS
    # add_header Strict-Transport-Security "max-age=31536000; includeSubDomains; preload";

    # 通常はパネルでリバースプロキシを設定すると、デフォルトの location ブロックはこのようになります
    location / {
        # location ブロックに以下の 2 行を追加するだけでよく、他はそのままで構いません。
        # この例では、設定ファイルが /etc/nginx/conf.d/ ディレクトリに保存されていると仮定しています。
        # 宝塔の場合は /www などのディレクトリに保存されているはずなので、注意してください。
        auth_basic "Please enter your username and password";
        auth_basic_user_file /etc/nginx/conf.d/search.htpasswd;

        proxy_http_version 1.1;
        proxy_set_header Connection "";
        proxy_redirect off;
        proxy_set_header Host $host;
        proxy_set_header X-Forwarded-For $proxy_protocol_addr;
        proxy_pass http://127.0.0.1:8000;
        client_max_body_size 0;
    }

    # access_log ...;
    # error_log ...;
}

Nginx 設定ファイルが /etc/nginx/conf.d に保存されていると仮定し、パスワードファイルも同じディレクトリに保存します。

コマンドを実行します（ example_name、example_password は、これから設定するユーザー名とパスワードに置き換えてください）：

echo "example_name:$(openssl passwd -5 'example_password')" > /etc/nginx/conf.d/search.htpasswd

Nginx を再起動します（設定の再読み込みでも可）。

この時点で Web ページを開くと、ユーザー名とパスワードの入力を求められます。先ほど設定したユーザー名とパスワードを入力し、SearXNG の検索ページに正常に入れるか確認して、設定が正しいかチェックしてください。

Cherry Studio の関連設定

SearXNG をローカルまたはサーバーにデプロイできたら、次は CherryStudio の関連設定です。

ネット検索設定ページに移動し、Searxng を選択します：

ローカルデプロイのリンクを直接入力すると検証失敗になりますが、この時は心配いりません：

直接デプロイした後はデフォルトで json の返却形式が設定されていないため、データを取得できません。設定ファイルを変更する必要があります。

Docker に戻り、Files タブでイメージ内のタグ付きフォルダを見つけます：

展開してさらに下へスクロールすると、別のタグ付きフォルダが見つかります：

さらに展開して、 settings.yml 設定ファイルを見つけます：

クリックしてファイルエディタを開きます：

78 行目を見つけると、形式が html しかないことがわかります

json 形式を追加して保存し、イメージを再実行します

Cherry Studio に戻って再度検証します。検証成功：

アドレスはローカルでも指定できます： http://localhost : ポート番号\nDocker のアドレスでも指定できます：http://host.docker.internal : ポート番号

ユーザーが前述の例に従ってサーバーにデプロイし、リバースプロキシを正しく設定し、json 返却形式も有効にしている場合、アドレスを入力して検証すると、リバースプロキシに HTTP Basic 認証が設定されているため、この時点での検証は 401 エラーコードを返すはずです：

クライアント側で HTTP Basic 認証を設定し、先ほど設定したユーザー名とパスワードを入力します：

検証を行うと、成功するはずです。

その他の設定

この時点で SearXNG はデフォルトのネット検索機能を備えています。検索エンジンをカスタマイズしたい場合は、自分で設定する必要があります

注意すべきなのは、ここでの優先設定は大規模モデル呼び出し時の設定には影響しないことです

大規模モデルの呼び出しで使用する検索エンジンを設定したい場合は、設定ファイルで次を指定します：

設定言語の参考：

内容が長くて直接編集しづらい場合は、ローカルの IDE にコピーし、修正後に設定ファイルへ貼り付ければ問題ありません。

検証失敗のよくある原因

返却形式に json 形式が追加されていない

設定ファイルで返却形式に json を追加します：

検索エンジンが正しく設定されていない

Cherry Studio はデフォルトで categories に web と general の両方を含むエンジンを検索に選択します。通常は google などのエンジンが選ばれますが、中国本土からは google などのサイトへ直接アクセスできないため失敗します。以下の設定を追加して searxng に baidu エンジンを強制使用させれば、問題を解決できます：

use_default_settings:
  engines:
    keep_only:
      - baidu
engines:
  - name: baidu
    engine: baidu 
    categories: 
      - web
      - general
    disabled: false

アクセス速度が速すぎる

searxng の limiter 設定が API アクセスを妨げています。設定で false にしてみてください：

---

ヘルプの取得とフィードバックの送信

設定または使用中に不明点、バグ、機能改善の提案がある場合は、 フィードバックと提案 に記載の公式チャネルをご参照ください。