Linux怎么安装SearXNG私有搜索引擎

云宇吖_6858

云宇吖_6858

2026-06-15

1016人浏览

原创

docker compose 部署是首选方案,官方镜像预装全部依赖并支持 redis;手动部署仅适用于无 docker 环境,需严格匹配 python 3.9–3.10 及编译依赖,且须配置反向代理与 https。

linux怎么安装searxng私有搜索引擎

直接用 Docker Compose 部署最稳,不用折腾 Python 环境、依赖冲突和权限问题。手动编译安装在 Linux 上容易卡在 lxml 或 pycurl 编译失败,尤其在 Ubuntu 22.04+ 和国产系统(如统信UOS、银河麒麟)上,libxml2-dev 和 libxslt1-dev 版本不匹配是高频翻车点。

Docker Compose 部署:推荐首选方案

这是目前最可靠、可复现、易维护的方式,官方镜像 searxng/searxng:latest 已预装全部依赖,且自带 Redis 支持。

  • 确保已安装 docker 和 docker-compose(注意不是 docker compose 插件,旧版需用 docker-compose 命令)
  • 创建项目目录:mkdir -p ~/searxng && cd ~/searxng
  • 写入 docker-compose.yml,关键项必须对齐:
    version: '3.7'
    services:
      searxng:
        image: searxng/searxng:latest
        container_name: searxng
        ports:
          - "8000:8080"
        volumes:
          - ./searxng:/etc/searxng
        environment:
          - SEARXNG_BASE_URL=http://你的服务器IP:8000/
        restart: unless-stopped
        depends_on:
          - redis
    <p>redis:
    image: redis:alpine
    container_name: redis
    restart: unless-stopped
    command: redis-server --save "" --appendonly no</p>
  • SEARXNG_BASE_URL 必须填真实可访问的地址(不能写 localhost 或 127.0.0.1),否则前端资源加载失败
  • 首次启动前,先手动创建配置目录:mkdir -p ./searxng,否则容器会因挂载失败退出

手动部署:只在无 Docker 环境下才考虑

常见于嵌入式设备、老旧 VPS 或强制离线环境。但要注意:pip install -e . 在 Python 3.11+ 下大概率因 setuptools 版本不兼容报错,且 searx-run 默认绑定 127.0.0.1:8080,外网无法访问。

onewo-rtlinux
onewo-rtlinux

Linux 实时编程助手。生成、审查并修改用于周期性控制任务和中断驱动程序的 C 代码。强制实施实时调度策略。

下载
  • 必须用 Python 3.9–3.10(Ubuntu 22.04 自带 3.10,推荐;3.11+ 需降级或加 --no-build-isolation)
  • 编译依赖缺一不可:sudo apt install build-essential libxml2-dev libxslt1-dev libffi-dev libssl-dev zlib1g-dev,漏掉 libxslt1-dev 会导致 lxml 安装失败
  • settings.yml 要复制到项目根目录,并修改 general > base_url 和 secret_key(用 openssl rand -hex 16 生成)
  • 启动命令不是 python app.py,而是:SEARXNG_SETTINGS_PATH=$(pwd)/settings.yml searx-run
  • 若要外网访问,必须改 settings.yml 中的 uwsgi > host 为 0.0.0.0,并确认防火墙放行端口(如 sudo ufw allow 8080)

配置反向代理:暴露服务前必做

直接暴露 8000 或 8080 端口不安全,且无法套 HTTPS。Nginx 是最轻量、最通用的选择。

  • 配置里 proxy_pass 地址必须和容器内端口一致(Docker 方案是 http://127.0.0.1:8080,手动部署也是)
  • 务必加 proxy_set_header X-Forwarded-Proto $scheme;,否则 SearXNG 会误判 HTTPS 为 HTTP,导致静态资源 404
  • 如果用域名,server_name 写域名后,必须提前解析到服务器 IP,否则 Certbot 申请证书会失败
  • 启用 HTTPS 后,SEARXNG_BASE_URL 必须同步改成 https://your-domain.com,否则前端 AJAX 请求跨协议被浏览器拦截

真正麻烦的不是启动,而是后续维护:比如搜索引擎失效(Bing 接口变更)、Redis 内存溢出、或者某天发现 duckduckgo 源返回空结果——这些都得去翻 settings.yml 里的 engines 配置段,而不是重装整个服务。所以第一次部署时,花十分钟把 ./searxng/settings.yml 挂载出来,比省事更重要。

相关专题

更多
磁盘配额是什么
磁盘配额是什么

磁盘配额是计算机中指定磁盘的储存限制,就是管理员可以为用户所能使用的磁盘空间进行配额限制,每一用户只能使用最大配额范围内的磁盘空间。php中文网为大家提供各种磁盘配额相关的内容,教程,供大家免费下载安装。

2023.06.21

3650

4

如何安装LINUX
如何安装LINUX

本站专题提供如何安装LINUX的相关教程文章,还有相关的下载、课程,大家可以免费体验。

2023.06.29

3173

10

linux find
linux find

find是linux命令,它将档案系统内符合 expression 的档案列出来。可以指要档案的名称、类别、时间、大小、权限等不同资讯的组合,只有完全相符的才会被列出来。find根据下列规则判断 path 和 expression,在命令列上第一个 - ( ) , ! 之前的部分为 path,之后的是 expression。还有指DOS 命令 find,Excel 函数 find等。本站专题提供linux find相关教程文章,还有相关

2023.06.30

2233

5

linux修改文件名
linux修改文件名

本专题为大家提供linux修改文件名相关的文章,这些文章可以帮助用户快速轻松地完成文件名的修改工作,大家可以免费体验。

2023.07.05

5350

7

linux系统安装教程
linux系统安装教程

linux系统是一种可以免费使用,自由传播,多用户、多任务、多线程、多CPU的操作系统。本专题提供linux系统安装教程相关的文章,大家可以免费体验。

2023.07.06

5002

7

linux查看文件夹大小
linux查看文件夹大小

Linux是一种自由和开放源码的类Unix操作系统,存在着许多不同的Linux版本,但它们都使用了Linux内核。Linux可安装在各种计算机硬件设备中,比如手机、平板电脑、路由器、视频游戏控制台、台式计算机、大型机和超级计算机。linux怎么查看文件夹大小呢?php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2023.07.20

2993

8

linux查看ip命令
linux查看ip命令

本专题为大家提供linux查看ip命令相关文章内容,感兴趣的朋友可以免费下载体验试试。

2023.07.20

2505

4

linux查看cpu使用率
linux查看cpu使用率

在linux的系统维护中,可能需要经常查看cpu使用率,分析系统整体的运行情况。本专题为大家带来了linux查看cpu使用率的相关文章,感兴趣的朋友千万不要错过了。

2023.07.25

2719

6

linux查找文件命令
linux查找文件命令

Linux是一种自由和开放源码的类Unix操作系统,存在着许多不同的Linux版本,但它们都使用了Linux内核。Linux可安装在各种计算机硬件设备中,比如手机、平板电脑、路由器、视频游戏控制台、台式计算机、大型机和超级计算机。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2023.07.31

277

3

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Buffalo框架快速入门指南
Buffalo框架快速入门指南

共0课时 | 0人学习

Valgrind支持平台说明
Valgrind支持平台说明

共0课时 | 0人学习