SearXNG 部署指南

環(huán)境要求

• Python 版本：≥ 3.11（推薦 3.13）
• 依賴管理：pip
• 配置目錄：~/.searxng/

安裝步驟

1. 克隆 SearXNG 倉庫

cd ~
git clone https://github.com/searxng/searxng.git

2. 安裝 Python 依賴

cd searxng
pip install -r requirements.txt

注意：Python 3.10 用戶需額外安裝 tomli 兼容包：

pip install tomli

3. 創(chuàng)建配置目錄并復(fù)制配置文件

mkdir -p ~/.searxng
cp searx/settings.yml ~/.searxng/settings.yml

4. 配置環(huán)境變量并啟動(dòng)服務(wù)

cd ~/searxng
export SEARXNG_SECRET=$(openssl rand -hex 32)
export SEARXNG_SETTINGS_PATH=~/.searxng/settings.yml
PYTHONPATH=. /home/frank/miniconda3/bin/python searx/webapp.py &

服務(wù)配置

默認(rèn)監(jiān)聽地址

• 地址：127.0.0.1
• 端口：8888

外網(wǎng)訪問配置

如需外網(wǎng)訪問，修改 ~/.searxng/settings.yml 中的 bind_address：

server:
    bind_address: "0.0.0.0"

反向代理配置（推薦）

使用 Nginx 或 Caddy 配置反向代理，將域名指向 SearXNG 服務(wù)。

常見問題

1. Python 版本不足

問題：SearXNG 要求 Python ≥ 3.11，系統(tǒng)默認(rèn) Python 3.10 不滿足要求。

解決方案：

使用 conda 環(huán)境（推薦）：

conda activate base  # Python 3.13
cd ~/searxng
pip install -r requirements.txt

2. Docker 權(quán)限不足

問題：無法訪問 /var/run/docker.sock。

解決方案：

• 避免使用 Docker 部署
• 直接使用 Python 運(yùn)行服務(wù)

3. SQLite 多線程警告

警告內(nèi)容：SQLite is not configured for multi-threaded access

解決方案：在 settings.yml 中配置 SQLite 連接池：

database:
    url: "sqlite:///searx.sqlite"
    connection_args:
        check_same_thread: false

4. 部分引擎初始化失敗

原因：部分引擎需要網(wǎng)絡(luò)訪問或 Tor（如 wikidata、ahmia）。

影響：不影響基本搜索功能，可后續(xù)配置啟用。

啟動(dòng)腳本（推薦）

創(chuàng)建 ~/searxng/start.sh：

#!/bin/bash
cd ~/searxng
export SEARXNG_SECRET=$(openssl rand -hex 32)
export SEARXNG_SETTINGS_PATH=~/.searxng/settings.yml
PYTHONPATH=. /home/user/miniconda3/bin/python searx/webapp.py

運(yùn)行：

chmod +x ~/searxng/start.sh
nohup ~/searxng/start.sh > ~/searxng/searxng.log 2>&1 &

驗(yàn)證部署

訪問 http://127.0.0.1:8888，頁面正常顯示即表示部署成功。

到此這篇關(guān)于OpenClaw WSL 中配置 SearXNG 指南的文章就介紹到這了,更多相關(guān)OpenClaw WSL配置 SearXNG內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章，希望大家以后多多支持腳本之家！

最新評論