SearXNG 部署指南环境要求Python 版本≥ 3.11推荐 3.13依赖管理pip配置目录~/.searxng/安装步骤1. 克隆 SearXNG 仓库cd~gitclone https://github.com/searxng/searxng.git2. 安装 Python 依赖cdsearxng pipinstall-rrequirements.txt注意Python 3.10 用户需额外安装tomli兼容包pipinstalltomli3. 创建配置目录并复制配置文件mkdir-p~/.searxngcpsearx/settings.yml ~/.searxng/settings.yml4. 配置环境变量并启动服务cd~/searxngexportSEARXNG_SECRET$(openssl rand-hex32)exportSEARXNG_SETTINGS_PATH~/.searxng/settings.ymlPYTHONPATH. /home/frank/miniconda3/bin/python searx/webapp.py服务配置默认监听地址地址127.0.0.1端口8888外网访问配置如需外网访问修改~/.searxng/settings.yml中的bind_addressserver:bind_address:0.0.0.0反向代理配置推荐使用 Nginx 或 Caddy 配置反向代理将域名指向 SearXNG 服务。常见问题1. Python 版本不足问题SearXNG 要求 Python ≥ 3.11系统默认 Python 3.10 不满足要求。解决方案使用 conda 环境推荐conda activate base# Python 3.13cd~/searxng pipinstall-rrequirements.txt2. Docker 权限不足问题无法访问/var/run/docker.sock。解决方案避免使用 Docker 部署直接使用 Python 运行服务3. SQLite 多线程警告警告内容SQLite is not configured for multi-threaded access解决方案在settings.yml中配置 SQLite 连接池database:url:sqlite:///searx.sqliteconnection_args:check_same_thread:false4. 部分引擎初始化失败原因部分引擎需要网络访问或 Tor如 wikidata、ahmia。影响不影响基本搜索功能可后续配置启用。启动脚本推荐创建~/searxng/start.sh#!/bin/bashcd~/searxngexportSEARXNG_SECRET$(openssl rand-hex32)exportSEARXNG_SETTINGS_PATH~/.searxng/settings.ymlPYTHONPATH. /home/user/miniconda3/bin/python searx/webapp.py运行chmodx ~/searxng/start.shnohup~/searxng/start.sh~/searxng/searxng.log21验证部署访问http://127.0.0.1:8888页面正常显示即表示部署成功。