OpenWebUI 接入 SearXNG：本地大模型实现实时联网搜索配置指南

接下来创建 SearXNG 的工作目录并获取配置文件：

# 创建专用目录
mkdir -p ~/searxng-docker && cd ~/searxng-docker

# 克隆官方仓库（包含 Docker 配置）
git clone https://github.com/searxng/searxng-docker.git .

注意：如果你在国内，GitHub 克隆可能会很慢。可以考虑使用镜像源，或者先下载 ZIP 包再解压。

Docker Compose 配置优化

官方提供的 docker-compose.yaml 文件包含 Caddy 反向代理，但对于大多数内网部署场景来说，这个组件不是必需的。我建议使用简化版的配置，只保留核心服务。

创建或修改 docker-compose.yaml 文件：

version: "3.7"
services:
  redis:
    container_name: redis
    image: docker.io/valkey/valkey:8-alpine
    command: valkey-server --save 30 1 --loglevel warning
    restart: unless-stopped
    networks:
      - searxng
    volumes:
      - valkey-data:/data
    logging:
      driver: "json-file"
      options:
        max-size: "1m"
        max-file: "1"

  searxng:
    container_name: searxng
    image: searxng/searxng:latest
    restart: unless-stopped
    networks:
      - searxng
    ports:
      - "8080:8080" # 可以根据需要修改端口
    volumes:
      - ./searxng:/etc/searxng:rw
      - ./engines:/usr/local/searxng/searx/engines:rw # 关键：持久化引擎目录
    environment:
      - SEARXNG_BASE_URL=http://${SEARXNG_HOSTNAME:-localhost}:8080/
      - UWSGI_WORKERS=${SEARXNG_UWSGI_WORKERS:-4}
      - UWSGI_THREADS=${SEARXNG_UWSGI_THREADS:-4}
      - SEARXNG_SETTINGS_PATH=/etc/searxng/settings.yml
    logging:
      driver: "json-file"
      options:
        max-size: "1m"
        max-file: "1"

networks:
  searxng:

volumes:
  valkey-data:
    driver: local
    driver_opts:
      type: none
      o: bind
      device: /data/searxng-docker/redis

这里有几个关键点需要注意：

1. 移除了 Caddy 服务：对于内网部署，直接用 Nginx 或直接访问端口更简单
2. 持久化引擎目录：这是支持国内搜索引擎的关键，后面会详细说明
3. 使用 Valkey 替代 Redis：Valkey 是 Redis 的分支，兼容性更好，性能也有所提升
4. 网络配置：使用自定义网络，方便后续与 OpenWebUI 容器通信

配置文件深度定制

SearXNG 的配置文件位于 ./searxng/settings.yml。首次启动容器时会自动生成默认配置，但我们需要对其进行定制以支持国内搜索引擎。

首先创建必要的目录结构：

# 创建配置目录
mkdir -p searxng engines

# 首次启动以生成默认配置
docker compose up -d
sleep 10

# 等待容器启动后停止，以便修改配置
docker compose down

现在我们来修改 searxng/settings.yml 文件。以下是我经过多次测试优化的配置：

# 使用默认设置作为基础
use_default_settings: true

server:
  # base_url 在环境变量 SEARXNG_BASE_URL 中定义
  secret_key: "你的安全密钥" # 使用 openssl rand -hex 32 生成
  limiter: false # 私有实例可以禁用限制器
  image_proxy: true # 启用图片代理，保护用户隐私

ui:
  static_use_hash: true

redis:
  url: redis://redis:6379/0

search:
  formats:
    - html
    - json # 必须启用 JSON 格式，OpenWebUI 需要

# 搜索引擎配置 - 重点部分
engines:
  # 启用国内搜索引擎
  - name: baidu
    categories: [web, news, general]
    engine: baidu
    shortcut: bd
    timeout: 9.0
    disabled: false
    enable_http: false # 强制使用 HTTPS

  - name: 360search
    categories: [web, news, general]
    engine: 360search
    shortcut: 360so
    timeout: 9.0
    disabled: false
    enable_http: false

  - name: sogou
    categories: [web, news, general]
    engine: sogou
    shortcut: sg
    timeout: 9.0
    disabled: false

  # 禁用部分不常用或访问慢的国外引擎
  - name: google
    engine: google
    disabled: true # 国内访问困难，建议禁用

  - name: bing
    engine: bing
    disabled: true # API 限制严格

  - name: duckduckgo
    engine: duckduckgo
    disabled: true

  - name: startpage
    engine: startpage
    disabled: true

  # 保留一些有用的国外引擎（可选）
  - name: wikipedia
    engine: wikipedia
    disabled: false
    timeout: 15.0 # 维基百科可以慢一点

  - name: github
    engine: github
    disabled: false
    shortcut: gh

提示：secret_key 需要自己生成，可以使用命令 openssl rand -hex 32。Windows 用户可以用 PowerShell 运行相同命令生成随机字符串。