Docs: update searxng content

This commit is contained in:
AllenWriter
2025-04-15 14:53:57 +08:00
parent a8674b8e0f
commit fd340ef6c3
3 changed files with 191 additions and 14 deletions
@@ -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://<your-linux-vm-ip>:8081
---
## 5. Testing SearXNG Integration
### 5. Testing SearXNG Integration
You can test if everything is working correctly by making a sample search using `curl`:
+185 -7
View File
@@ -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`となります。
## 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://<your-linux-vm-ip>:8081
```
2. 設定を保存すると、DifyはSearXNGインスタンスに接続できるようになります。
---
### 5. SearXNG統合のテスト
`curl`コマンドを使用してSearXNGサービスが正常に動作しているかテストできます:
```bash
curl "http://<your-linux-vm-ip>:8081/search?q=apple&format=json&categories=general"
```
すべてが正常に動作していれば、「apple」の検索結果を含むJSON応答が返されるはずです。
@@ -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://<your-linux-vm-ip>:8081
---
## 5. 测试 SearXNG 集成
### 5. 测试 SearXNG 集成
你可以通过 `curl` 命令测试 SearXNG 服务是否正常工作: