Skip to content
This repository was archived by the owner on May 29, 2025. It is now read-only.
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 3 additions & 3 deletions en/guides/tools/tool-configuration/searxng.md
Original file line number Diff line number Diff line change
Expand Up @@ -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.

Expand Down Expand Up @@ -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.

Expand All @@ -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`:

Expand Down
192 changes: 185 additions & 7 deletions jp/guides/tools/tool-configuration/searxng.md
Original file line number Diff line number Diff line change
Expand Up @@ -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応答が返されるはずです。
7 changes: 3 additions & 4 deletions zh_CN/guides/tools/tool-configuration/searxng.md
Original file line number Diff line number Diff line change
Expand Up @@ -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 集成。

Expand Down Expand Up @@ -173,7 +172,7 @@ ip addr show

---

# 4. 将 SearXNG 与 Dify 集成
## 4. 将 SearXNG 与 Dify 集成

一旦你的 SearXNG 实例在 Linux VM 上运行,你可以将其与 Dify 进行连接。

Expand All @@ -189,7 +188,7 @@ http://<your-linux-vm-ip>:8081

---

## 5. 测试 SearXNG 集成
### 5. 测试 SearXNG 集成

你可以通过 `curl` 命令测试 SearXNG 服务是否正常工作:

Expand Down