SearXNG 高级部署方案：自带反向代理的专家级配置

SearXNG 高级部署方案：自带反向代理的专家级配置

【免费下载链接】searxng-dockerThe docker-compose files for setting up a SearXNG instance with docker.项目地址: https://gitcode.com/gh_mirrors/se/searxng-docker

想要快速搭建一个安全、隐私保护的搜索引擎吗？SearXNG 是一个开源的元搜索引擎，可以聚合来自多个搜索引擎的结果，保护用户隐私。今天，我将分享一个完整的 SearXNG 高级部署方案，这个方案自带 Caddy 反向代理，支持自动 TLS 证书管理，让你在五分钟内就能拥有一个功能完善的私有搜索引擎实例。😊

为什么选择 SearXNG 私有搜索引擎？

SearXNG 是一个强大的元搜索引擎，它不追踪用户，不收集个人信息，完全开源透明。通过 Docker 部署，你可以轻松搭建一个属于自己的搜索服务，享受无广告、无追踪的搜索体验。这个部署方案特别适合注重隐私的用户和技术爱好者。

准备工作与环境要求

在开始之前，你需要确保系统满足以下要求：

• Docker 和 Docker Compose 已安装
• 一个可用的域名（用于 HTTPS 证书）
• 基本的 Linux 命令行操作知识

一键安装步骤

1. 克隆项目仓库

首先，获取 SearXNG Docker 部署文件：

cd /usr/local git clone https://gitcode.com/gh_mirrors/se/searxng-docker.git cd searxng-docker

2. 配置环境变量

编辑环境配置文件，设置你的域名和邮箱：

# 设置主机名和邮箱 echo "SEARXNG_HOSTNAME=search.yourdomain.com" > .env echo "LETSENCRYPT_EMAIL=your-email@example.com" >> .env

3. 生成安全密钥

SearXNG 需要一个安全的密钥，使用以下命令生成：

sed -i "s|ultrasecretkey|$(openssl rand -hex 32)|g" searxng/settings.yml

4. 自定义 SearXNG 设置

根据你的需求调整 SearXNG 配置：

# searxng/settings.yml 中的关键配置 server: secret_key: "你的新密钥" # 已自动生成 limiter: false # 公开使用时启用 image_proxy: true # 启用图片代理

专家级配置详解

Caddy 反向代理配置

这个部署方案的核心优势是集成了 Caddy 反向代理。Caddy 会自动处理 TLS 证书，让你的搜索服务默认启用 HTTPS。查看 Caddyfile 配置文件：

# Caddyfile 中的安全配置 header { Content-Security-Policy "upgrade-insecure-requests; default-src 'none'; script-src 'self'; style-src 'self' 'unsafe-inline'; form-action 'self' https:; font-src 'self'; frame-ancestors 'self'; base-uri 'self'; connect-src 'self'; img-src * data:; frame-src https:;" # 禁用不必要的浏览器功能 Permissions-Policy "accelerometer=(),camera=(),geolocation=(),gyroscope=(),magnetometer=(),microphone=(),payment=(),usb=()" # 防止搜索引擎索引 X-Robots-Tag "noindex, nofollow, noarchive, nositelinkssearchbox, nosnippet, notranslate, noimageindex" }

Docker Compose 架构

部署方案包含三个核心服务：

1. Caddy- 反向代理和 TLS 证书管理
2. SearXNG- 搜索引擎核心
3. Valkey- 内存数据库（Redis 替代品）

查看完整的 docker-compose.yaml 文件了解服务配置细节。

启动和运行

启动服务

一切配置就绪后，只需一个命令：

docker compose up -d

验证部署

检查服务运行状态：

docker compose ps docker compose logs -f

系统服务集成

如果你使用 systemd，可以创建系统服务：

cp searxng-docker.service.template searxng-docker.service systemctl enable $(pwd)/searxng-docker.service systemctl start searxng-docker.service

高级配置技巧

性能优化

1. 缓存策略：Caddy 已经配置了智能缓存，静态资源缓存 30 秒，图片代理缓存 1 小时
2. 日志管理：Docker 日志限制为 1MB，防止磁盘空间被占满
3. 网络配置：Caddy 使用 host 网络模式，减少网络延迟

安全加固

1. IP 地址保护：Caddy 配置中移除了客户端 IP 的可识别信息
2. CSP 策略：严格的内容安全策略防止 XSS 攻击
3. HTTPS 强制：自动 Let's Encrypt 证书，确保所有流量加密

多架构支持

这个部署方案支持多种 CPU 架构：

• amd64 (x86_64)
• arm64 (苹果 M1/M2、树莓派 4)
• arm/v7 (旧版树莓派)

维护和更新

日常维护

查看服务日志：

# 查看所有容器日志 docker compose logs -f # 查看特定容器日志 docker compose logs -f caddy docker compose logs -f searxng docker compose logs -f redis

更新 SearXNG

保持系统最新：

git pull docker compose pull docker compose up -d

故障排除指南

常见问题

1. 证书获取失败：检查域名解析和防火墙设置
2. 服务无法启动：查看 Docker 日志，检查端口冲突
3. 搜索无结果：确认网络连接，检查 SearXNG 配置

日志分析

使用以下命令分析问题：

# 实时查看 Caddy 日志 docker compose logs -f caddy # 检查 SearXNG 错误 docker compose logs searxng | grep -i error

总结

这个 SearXNG 高级部署方案提供了一个完整、安全、易维护的私有搜索引擎解决方案。通过集成 Caddy 反向代理，你无需手动配置 TLS 证书，无需担心 HTTPS 设置，一切都会自动完成。方案还包含了完善的安全策略、性能优化和多架构支持，适合从个人使用到小型团队的各种场景。

无论你是隐私倡导者、技术爱好者，还是需要一个无干扰的搜索环境，这个部署方案都能满足你的需求。开始搭建你的私有搜索引擎吧，享受真正自由的搜索体验！🔍✨

【免费下载链接】searxng-dockerThe docker-compose files for setting up a SearXNG instance with docker.项目地址: https://gitcode.com/gh_mirrors/se/searxng-docker