Ubuntu 24.04 使用 Docker 安装 SearXNG 私密搜索引擎教程

前言

SearXNG 是一个免费的互联网元搜索引擎，它从多达 251 个搜索服务聚合结果，同时不追踪或分析用户。通过 Docker 部署 SearXNG，您可以轻松搭建自己的私密搜索引擎实例，保护您的搜索隐私。

本教程将指导您在 Ubuntu 24.04 系统上使用 Docker 和 Docker Compose 部署 SearXNG。

前置条件

Ubuntu 24.04 系统
sudo 权限
基本的 Linux 命令行知识

步骤 1：系统更新

首先，确保您的系统是最新的：

sudo apt update && sudo apt upgrade -y

步骤 2：安装 Docker

Ubuntu 24.04 推荐使用官方 Docker 仓库安装 Docker：

# 安装必要的依赖
sudo apt install -y ca-certificates curl gnupg lsb-release

# 添加 Docker 官方 GPG 密钥
sudo mkdir -p /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg

# 设置 Docker 仓库
echo \
  "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.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 -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

# 将当前用户添加到 docker 组
sudo usermod -aG docker $USER
newgrp docker  # 使组成员资格立即生效

验证 Docker 安装：

docker --version
docker-compose version

步骤 3：创建 SearXNG 部署目录

mkdir -p ~/searxng
cd ~/searxng

步骤 4：获取 Docker Compose 配置文件

# 下载官方的 docker-compose.yml 模板
curl -fsSL https://raw.githubusercontent.com/searxng/searxng/master/container/docker-compose.yml -o docker-compose.yml

# 下载环境变量模板文件
curl -fsSL https://raw.githubusercontent.com/searxng/searxng/master/container/.env.example -o .env.example

# 复制环境变量模板并重命名为 .env
cp .env.example .env

步骤 5：配置 SearXNG

编辑 .env 文件根据您的需求进行配置：

nano .env

常用配置选项包括：

# 使用特定版本标签（可选）
#SEARXNG_VERSION=latest

# 监听特定地址（默认为所有地址）
#SEARXNG_HOST=[::]

# 监听特定端口（默认为 8080）
#SEARXNG_PORT=8080

保存并退出编辑器（在 nano 中按 Ctrl+O，然后 Enter，再 Ctrl+X）。

步骤 6：创建配置目录

mkdir -p ./core-config

步骤 7：启动 SearXNG 服务

docker compose up -d

等待容器启动完成（大约需要 1-2 分钟）。

检查容器状态：

docker compose ps

您应该看到类似以下输出：

NAME                COMMAND                  SERVICE   STATUS              PORTS
searxng-core        "/init"                  core      running             0.0.0.0:8080->8080/tcp
searxng-valkey      "valkey-server --save..." valkey    running             0.0.0.0:6379->6379/tcp

步骤 8：访问 SearXNG

在浏览器中访问：http://您的服务器IP:8080

如果是在本地机器上安装，可以访问：http://localhost:8080

步骤 9：配置反向代理（可选但推荐）

为了在生产环境中使用域名和 HTTPS，建议配置 Nginx 作为反向代理：

安装 Nginx

sudo apt install -y nginx

创建 Nginx 配置文件

sudo nano /etc/nginx/sites-available/searxng

添加以下内容：

server {
    listen 80;
    server_name your-domain.com;  # 替换为您的域名

    location / {
        proxy_pass http://localhost:8080;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}

保存并退出。

启用站点并重载 Nginx

sudo ln -s /etc/nginx/sites-available/searxng /etc/nginx/sites-enabled/
sudo nginx -t  # 测试配置
sudo systemctl reload nginx

获取免费 SSL 证书（使用 Let’s Encrypt）

sudo apt install -y certbot python3-certbot-nginx
sudo certbot --nginx -d your-domain.com  # 替换为您的域名

按照提示完成证书申请过程。

步骤 10：维护和更新

查看日志

docker compose logs -f

更新 SearXNG

docker compose pull
docker compose up -d

备份数据

SearXNG 的数据存储在两个卷中：
– core-data: 存储缓存和临时数据
– valkey-data: 存储 Valkey（Redis 兼容）数据

要备份这些数据，可以使用：

# 停止容器
docker compose down

# 备份卷数据（需要额外的备份策略或工具）
# 或者直接复制卷目录（在宿主机上查看卷位置）
docker volume inspect searxng-core-data
docker volume inspect searxng-valkey-data