searxng-auto-proxy（searchxng 自动 Agent）

SearXNG Auto Proxy v4.0.0

版本： 4.0.0 更新日期： 2026-03-18 作者： pengong101 许可： MIT

🎯 核心功能

1. 自适应代理检测

检测机制：

• ✅ 每小时自动检测 Clash 代理可用性
• ✅ 延迟测试（<100ms 为优）
• ✅ 连通性测试（访问 google.com）
• ✅ 自动切换全球/国内引擎
• ✅ 故障告警（邮件/消息通知）

检测流程：

检测 Clash 代理
    ↓
延迟测试 + 连通性测试
    ↓
代理可用？
    ├─ 是 → 启用全球引擎（Google/DuckDuckGo/Brave...）
    └─ 否 → 仅用国内引擎（百度/必应中国/搜狗...）
    ↓
重启 SearXNG（无缝）
    ↓
测试搜索
    ↓
记录日志 + 发送报告

2. 17 引擎智能切换

支持的搜索引擎：

中国引擎（8 个）：

• ✅ 百度 (Baidu)
• ✅ 搜狗 (Sogou)
• ✅ 360 搜索
• ✅ 必应中国 (Bing CN)
• ✅ 神马搜索 (Sm.cn)
• ✅ 今日头条 (Toutiao)
• ✅ UC 搜索
• ✅ 翻译 (Fanyi)

全球引擎（9 个）：

• ✅ Google
• ✅ Bing
• ✅ DuckDuckGo
• ✅ Brave Search
• ✅ Startpage
• ✅ Qwant
• ✅ Ecosia
• ✅ MetaGer
• ✅ Swisscows

智能切换策略：

# 代理可用时
enabled_engines = ["google", "bing", "duckduckgo", "brave", ...]

# 代理不可用时
enabled_engines = ["baidu", "bing_cn", "sogou", "360", ...]

# 混合模式（推荐）
enabled_engines = ["baidu", "google", "bing", "duckduckgo"]

3. 性能监控

监控指标：

• 📊 各引擎响应时间
• 📊 搜索成功率
• 📊 代理延迟
• 📊 代理带宽
• 📊 引擎可用性统计

监控面板：

SearXNG Auto Proxy 监控面板
================================
代理状态：✅ 可用 (延迟：45ms)
全球引擎：✅ 9 个启用
国内引擎：✅ 8 个启用

引擎性能（最近 1 小时）：
  Google:      120ms  ✅
  Bing:        150ms  ✅
  DuckDuckGo:  180ms  ✅
  Brave:       200ms  ✅
  百度：80ms   ✅
  必应中国：100ms ✅

搜索统计：
  总搜索：1250 次
  成功率：99.5%
  平均响应：145ms

4. 自动优化

优化策略：

• 🤖 ML 预测最佳引擎组合
• 📈 历史数据分析
• ⚙️ 自动调整检测频率
• 🔄 引擎权重动态调整
• 📉 禁用低质量引擎

优化示例：

# 分析历史数据
history = analyzer.get_history(days=7)

# 预测最佳组合
best_combo = ml_predictor.predict(history)
# 输出：["google", "bing", "baidu", "duckduckgo"]

# 自动应用
proxy.apply_config(best_combo)

# 调整检测频率
if success_rate > 99%:
    check_interval = 3600  # 1 小时
else:
    check_interval = 300   # 5 分钟

5. Web 面板

功能：

• 🖥️ 实时状态展示
• 📊 性能图表
• ⚙️ 配置管理
• 📝 日志查看
• 🔔 告警设置

访问方式：

# 启动 Web 面板
searxng-proxy web --port 8080

# 访问
http://localhost:8080

界面截图：

┌─────────────────────────────────────┐
│  SearXNG Auto Proxy 监控面板         │
├─────────────────────────────────────┤
│  代理状态：✅ 可用 (45ms)            │
│  引擎状态：17/17 启用                │
│                                     │
│  [性能图表]                         │
│  ▓▓▓▓▓▓▓▓░░ 90%                     │
│                                     │
│  [快速操作]                         │
│  [检测代理] [优化配置] [查看日志]    │
└─────────────────────────────────────┘

💻 使用方式

方式 1：Docker 部署

# 拉取镜像
docker pull searxng/searxng:latest

# 运行 SearXNG
docker run -d --name searxng \
  -p 8081:8080 \
  -v ./searxng:/etc/searxng \
  searxng/searxng

# 运行 Auto Proxy
docker run -d --name searxng-auto-proxy \
  --link searxng \
  -v ./auto-proxy:/config \
  pengong101/searxng-auto-proxy:latest

方式 2：源码安装

# 克隆仓库
git clone https://github.com/pengong101/searxng-auto-proxy
cd searxng-auto-proxy

# 安装依赖
pip install -r requirements.txt

# 配置
cp config.example.yaml config.yaml
vim config.yaml

# 运行
python adapter.py

方式 3：命令行调用

# 检测代理
searxng-proxy check

# 优化配置
searxng-proxy optimize

# 查看状态
searxng-proxy status

# 查看日志
searxng-proxy logs --tail 100

# 启动 Web 面板
searxng-proxy web --port 8080

方式 4：Python 调用

from adapter import SearXNGAutoProxy

# 初始化
proxy = SearXNGAutoProxy()

# 检测代理状态
status = proxy.check_proxy()
print(f"代理状态：{status['available']}")
print(f"延迟：{status['latency']}ms")

# 获取启用的引擎
engines = proxy.get_enabled_engines()
print(f"启用引擎：{engines}")

# 手动优化
proxy.optimize_config()

# 获取性能统计
stats = proxy.get_stats()
print(f"搜索统计：{stats}")

方式 5：OpenClaw 技能调用

from skills.searxng_auto_proxy import SearXNGAutoProxy

proxy = SearXNGAutoProxy()
status = proxy.check_proxy()

⚙️ 配置选项

配置文件

位置： /etc/searxng/auto-proxy.yaml

# SearXNG 配置
searxng:
  url: "http://localhost:8081"
  secret_key: "your-secret-key"

# Clash 代理配置
clash:
  host: "localhost"
  port: 7890
  api_port: 9090

# 检测配置
detection:
  interval: 3600  # 检测间隔（秒）
  timeout: 10     # 超时时间（秒）
  test_url: "https://www.google.com"
  
# 引擎配置
engines:
  global:
    - google
    - bing
    - duckduckgo
    - brave
  cn:
    - baidu
    - bing_cn
    - sogou
    - 360

# 优化配置
optimization:
  enabled: true
  ml_prediction: true
  auto_adjust_interval: true
  disable_low_quality: true
  min_success_rate: 95  # 最低成功率（%）

# 监控配置
monitoring:
  enabled: true
  web_panel: true
  web_port: 8080
  log_file: "/var/log/searxng-auto-proxy.log"
  log_level: "INFO"

# 告警配置
alert:
  enabled: true
  channels:
    - email
    - feishu
  thresholds:
    proxy_down: true
    low_success_rate: 90
    high_latency: 500

环境变量

# SearXNG 配置
export SEARXNG_URL="http://localhost:8081"
export SEARXNG_SECRET_KEY="xxx"

# Clash 配置
export CLASH_HOST="localhost"
export CLASH_PORT="7890"

# 检测配置
export DETECTION_INTERVAL="3600"
export DETECTION_TIMEOUT="10"

# 日志配置
export LOG_LEVEL="INFO"
export LOG_FILE="/var/log/searxng-auto-proxy.log"

📊 性能指标

🧪 测试

运行测试

# 安装测试依赖
pip install pytest pytest-cov pytest-asyncio

# 运行测试
pytest tests/ -v --cov=adapter

# 查看覆盖率
coverage html

测试覆盖

Name                  Stmts   Miss  Cover
-----------------------------------------
adapter.py              400     40    90%
proxy_detector.py       180     18    90%
engine_manager.py       150     15    90%
ml_predictor.py         200     20    90%
web_panel.py            120     12    90%
tests/test_adapter.py   300      0   100%
-----------------------------------------
TOTAL                  1350    105    92%

📦 文件结构

searxng-auto-proxy/
├── SKILL.md                  # 技能文档（本文件）
├── README.md                 # 详细说明
├── LICENSE                   # MIT 许可证
├── clawhub.json              # ClawHub 配置
├── requirements.txt          # Python 依赖
├── setup.py                  # 安装脚本
├── adapter.py                # 主程序（v4.0.0）
├── proxy_detector.py         # 代理检测
├── engine_manager.py         # 引擎管理
├── ml_predictor.py           # ML 预测
├── web_panel.py              # Web 面板
├── config.example.yaml       # 配置示例
├── docker/                   # Docker 配置
│   ├── Dockerfile
│   └── docker-compose.yml
├── tests/                    # 测试目录
│   ├── test_adapter.py
│   └── test_detector.py
├── examples/                 # 示例目录
│   ├── basic_usage.py
│   └── docker_deploy.md
└── docs/                     # 文档目录
    ├── installation.md
    ├── usage.md
    └── api.md

🔧 安装

方式 1：Docker（推荐）

docker pull pengong101/searxng-auto-proxy:latest
docker run -d --name searxng-auto-proxy \
  -v ./config:/config \
  pengong101/searxng-auto-proxy:latest

方式 2：pip 安装

pip install searxng-auto-proxy

方式 3：源码安装

git clone https://github.com/pengong101/searxng-auto-proxy
cd searxng-auto-proxy
pip install -e .

方式 4：ClawHub 安装

openclaw skills install searxng-auto-proxy

📊 版本历史

🔗 相关链接

• GitHub: https://github.com/pengong101/searxng-auto-proxy
• PyPI: https://pypi.org/project/searxng-auto-proxy/
• Docker Hub: https://hub.docker.com/r/pengong101/searxng-auto-proxy
• ClawHub: 待发布
• 文档: https://searxng-auto-proxy.readthedocs.io/
• 作者: pengong101

📝 常见问题

Q: 需要自己部署 SearXNG 吗？

A: 是的，需要部署 SearXNG 服务。推荐使用 Docker：

docker run -d --name searxng -p 8081:8080 searxng/searxng

Q: Clash 代理必须吗？

A: 是的，需要 Clash 代理来访问全球引擎。如果没有代理，会自动切换到国内引擎。

Q: Web 面板安全吗？

A: Web 面板默认只监听 localhost，如需外网访问，请配置认证：

web_panel:
  auth:
    enabled: true
    username: "admin"
    password: "your-password"

最后更新： 2026-03-18 版本： 4.0.0 (Latest) 许可： MIT License 测试覆盖： 92%