diff --git a/en/guides/tools/tool-configuration/searxng.md b/en/guides/tools/tool-configuration/searxng.md index 02812c75a..05e6091cf 100644 --- a/en/guides/tools/tool-configuration/searxng.md +++ b/en/guides/tools/tool-configuration/searxng.md @@ -29,7 +29,7 @@ Fill in the access address in "Tools > SearXNG > Authenticate" to establish a co --- -# Hosting SearXNG on a Linux VM for a Private Instance +## Hosting SearXNG on a Linux VM for a Private Instance This section covers how to host **SearXNG** on a **Linux VM** and make it accessible to Dify. @@ -166,7 +166,7 @@ For the SearXNG service to be accessed from other machines or services (like Dif --- -# 4. Connect SearXNG with Dify +## 4. Connect SearXNG with Dify Once your SearXNG instance is up and running on the Linux VM, you need to authenticate it in Dify. @@ -183,7 +183,7 @@ http://:8081 --- -## 5. Testing SearXNG Integration +### 5. Testing SearXNG Integration You can test if everything is working correctly by making a sample search using `curl`: diff --git a/jp/guides/tools/tool-configuration/searxng.md b/jp/guides/tools/tool-configuration/searxng.md index 428ff6c05..88c6b5cc7 100644 --- a/jp/guides/tools/tool-configuration/searxng.md +++ b/jp/guides/tools/tool-configuration/searxng.md @@ -6,16 +6,194 @@ 「ツール」は「プラグイン」エコシステムに完全アップグレードされました。詳しい使用方法については[プラグイン開発](https://docs.dify.ai/ja-jp/plugins/quick-start/install-plugins)をご参照ください。以下の内容はアーカイブされています。 {% endhint %} -SearXNGは、様々な検索サービスの結果を統合する無料のインターネットメタサーチエンジンです。 DifyはSearXNGにアクセスするためのインターフェイスを実装しており、Difyから直接利用することができます。 以下では、Dockerを使用してSearXNGをDifyに統合する手順を説明します。他の方法でSearXNGをインストールしたい場合は、[こちら](https://docs.searxng.org/admin/installation.html)を参照してください。 +SearXNGは、様々な検索サービスの結果を統合する無料のインターネットメタサーチエンジンです。ユーザーは追跡されず、検索行動も分析されません。Difyから直接このツールを利用することができます。 -## 1. Dockerを使用してSearXNGコンテナをインストールする -設定ファイルは `dify/api/core/tools/provider/builtin/searxng/docker/settings.yml` にあり、[こちら](https://docs.searxng.org/admin/installation.html)を参照してください。 +以下では、[コミュニティ版](https://docs.dify.ai/ja-jp/getting-started/install-self-hosted/docker-compose)でDockerを使用してSearXNGをDifyに統合する方法を説明します。 -## 2. DifyのルートディレクトリでDockerコンテナを起動する -``` +> Difyクラウドサービス内でSearXNGを使用したい場合は、[SearXNGインストールドキュメント](https://docs.searxng.org/admin/installation.html)を参照して自分のサービスを構築し、Difyに戻って「ツール > SearXNG > 認証へ行く」ページでサービスのBase URLを入力してください。 + +## 1. Dify設定ファイルの変更 + +SearXNGの設定ファイルは `dify/api/core/tools/provider/builtin/searxng/docker/settings.yml` にあります。設定ドキュメントは[こちら](https://docs.searxng.org/admin/settings/index.html)を参照してください。 + +必要に応じて設定を変更するか、デフォルト設定をそのまま使用することもできます。 + +## 2. サービスの起動 + +Difyのルートディレクトリで以下のコマンドを実行し、Dockerコンテナを起動します。 + +```bash cd dify docker run --rm -d -p 8081:8080 -v "${PWD}/api/core/tools/provider/builtin/searxng/docker:/etc/searxng" searxng/searxng ``` -## 3. DifyにSearXNGを統合する -`ツール > SearXNG > 認証へ行く` でアクセスアドレスを入力します。Dockerを使用してDifyを展開する場合、アドレスは一般的に`http://host.docker.internal:8081`となります。 \ No newline at end of file +## 3. SearXNGの使用 + +`ツール > SearXNG > 認証へ行く` でアクセスアドレスを入力し、DifyサービスとSearXNGサービスの接続を確立します。SearXNGのDocker内部アドレスは通常 `http://host.docker.internal:8081` です。 + +--- + +## Linux VMでプライベートインスタンスとしてSearXNGをホスティングする + +このセクションでは、**Linux VM**でSearXNGをホスティングし、Difyと統合する方法について説明します。 + +### 1. Linux VM環境の準備 + +Linux VM環境が以下の条件を満たしていることを確認してください： + +- **DockerとDocker Composeがインストールされている**。 +- サポートされているLinuxディストリビューション（Ubuntu 24.04や他のDebianベースのシステムなど）を使用できます。 + +#### 1.1 Dockerのインストール + +以下のコマンドを実行してDockerをインストールします： + +```bash +# パッケージリストの更新 +sudo apt update + +# 必要なパッケージのインストール +sudo apt install apt-transport-https ca-certificates curl software-properties-common + +# Docker GPGキーの追加 +curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg + +# Docker公式リポジトリの追加 +echo "deb [arch=amd64 signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null + +# Dockerのインストール +sudo apt update +sudo apt install docker-ce docker-ce-cli containerd.io +``` + +Dockerが正常にインストールされたか確認します： + +```bash +docker --version +``` + +#### 1.2 Docker Composeのインストール + +以下のコマンドを実行してDocker Composeをインストールします： + +```bash +sudo curl -L "https://github.com/docker/compose/releases/download/2.32.1/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose +sudo chmod +x /usr/local/bin/docker-compose +``` + +Docker Composeが正常にインストールされたか確認します： + +```bash +docker-compose --version +``` + +### 2. SearXNG Dockerコンテナの設定 + +#### 2.1 SearXNG Dockerリポジトリのクローン + +まず、SearXNG DockerリポジトリをLinux VMにクローンします： + +```bash +git clone https://github.com/searxng/searxng-docker.git +cd searxng-docker +``` + +#### 2.2 Docker設定ファイルの変更 + +1. **`docker-compose.yaml`ファイルを変更**して、SearXNGサービスがポート`8081`にバインドされ、Redisサービスが設定されていることを確認します。変更後の`docker-compose.yaml`ファイルは以下のようになります： + +```yaml +version: '3' + +services: + searxng: + image: searxng/searxng:latest + ports: + - "8081:8080" # コンテナの8080ポートをホストマシンの8081ポートにマッピング + volumes: + - ./searxng:/etc/searxng # SearXNG設定ファイルのマウント設定 + networks: + - searxng_network + + redis: + image: valkey/valkey:8-alpine + ports: + - "6379:6379" # Redisサービスのマッピングポート + networks: + - searxng_network + + caddy: + image: caddy:2-alpine + ports: + - "80:80" + - "443:443" + networks: + - searxng_network + +networks: + searxng_network: + driver: bridge +``` + +2. **`settings.yml`設定ファイルを変更**して、SearXNGがすべてのIPアドレスをリッスンし、JSON形式の出力を有効にします： + +```yaml +server: + bind_address: "0.0.0.0" # 外部アクセスを許可 + port: 8080 + +search: + formats: + - html + - json + - csv + - rss +``` + +#### 2.3 Dockerコンテナの起動 + +設定ファイルを変更した後、以下のコマンドでDockerコンテナを起動します： + +```bash +docker-compose up -d +``` + +### 3. SearXNGサービスをアクセス可能にする + +デフォルトでは、DockerコンテナはlocalホストまたはIP 127.0.0.1にバインドされます。外部デバイス（Difyなど）からSearXNGにアクセスできるようにするには、Linux VMが公開IPアドレスを通じてポート`8081`にアクセスできることを確認する必要があります。 + +VMの公開IPアドレスを確認するには： + +```bash +ip addr show +``` + +ファイアウォールでポート`8081`が開放されていることを確認してください。 + +--- + +## 4. SearXNGとDifyの統合 + +Linux VM上でSearXNGインスタンスが実行されたら、Difyと接続できます。 + +### 4.1 Difyの設定 + +1. Difyプラットフォームの**ツール > SearXNG > 認証へ行く**ページで、自分でホストしているSearXNGサービスの**Base URL**を入力します。フォーマットは以下の通りです： + +```text +http://:8081 +``` + +2. 設定を保存すると、DifyはSearXNGインスタンスに接続できるようになります。 + +--- + +### 5. SearXNG統合のテスト + +`curl`コマンドを使用してSearXNGサービスが正常に動作しているかテストできます： + +```bash +curl "http://:8081/search?q=apple&format=json&categories=general" +``` + +すべてが正常に動作していれば、「apple」の検索結果を含むJSON応答が返されるはずです。 diff --git a/zh_CN/guides/tools/tool-configuration/searxng.md b/zh_CN/guides/tools/tool-configuration/searxng.md index 35741ed03..02b88757a 100644 --- a/zh_CN/guides/tools/tool-configuration/searxng.md +++ b/zh_CN/guides/tools/tool-configuration/searxng.md @@ -31,10 +31,9 @@ docker run --rm -d -p 8081:8080 -v "${PWD}/api/core/tools/provider/builtin/searx 在 `工具 > SearXNG > 去认证` 中填写访问地址，建立 Dify 服务与 SearXNG 服务的连接。SearXNG 的 Docker 内网地址一般是 `http://host.docker.internal:8081`。 - --- -# 在 Linux VM 上托管 SearXNG 作为私有实例 +## 在 Linux VM 上托管 SearXNG 作为私有实例 本节将指导你如何在 **Linux VM** 上托管 SearXNG 并确保它可以与 Dify 集成。 @@ -173,7 +172,7 @@ ip addr show --- -# 4. 将 SearXNG 与 Dify 集成 +## 4. 将 SearXNG 与 Dify 集成 一旦你的 SearXNG 实例在 Linux VM 上运行，你可以将其与 Dify 进行连接。 @@ -189,7 +188,7 @@ http://:8081 --- -## 5. 测试 SearXNG 集成 +### 5. 测试 SearXNG 集成 你可以通过 `curl` 命令测试 SearXNG 服务是否正常工作：