metona-ollama-desktop/search-proxy/README.md

metona-search-proxy

部署在可直连 Google/Bing/DuckDuckGo/Baidu 的云服务器上，通过 HTTP API 提供搜索引擎代理。

本应用(web_search) → HTTP → metona-search-proxy(:7899) → Google/Bing/DDG/Baidu → JSON

---

前置要求

依赖	说明
Go	1.21+（编译用，运行不需要）
服务器	能直连 Google/Bing/DDG（海外云服务器/VPS）
系统	Linux (Ubuntu/Debian/CentOS) / macOS

安装 Go（服务器上没有的话）

# Ubuntu/Debian
sudo apt update && sudo apt install -y golang-go

# CentOS/RHEL
sudo yum install -y golang

---

编译

cd /opt
git clone https://gitee.com/thzxx/metona-ollama-desktop.git
cd metona-ollama-desktop/search-proxy
go build -o metona-search-proxy .

本地交叉编译（编译好再上传）

# 编译 Linux 版本
GOOS=linux GOARCH=amd64 go build -o metona-search-proxy .

# 上传到服务器
scp metona-search-proxy user@your-server:/opt/metona-search-proxy/

---

全局命令

sudo cp metona-search-proxy /usr/local/bin/
sudo chmod +x /usr/local/bin/metona-search-proxy

之后任何目录都可以直接用：

metona-search-proxy --version
metona-search-proxy -status

---

CLI 命令

服务管理

metona-search-proxy -start          # 后台启动
metona-search-proxy -stop           # 停止
metona-search-proxy -status         # 查看状态
metona-search-proxy -restart        # 重启

运行参数

metona-search-proxy [选项]

选项:
  -port int      监听端口 (默认 7899)
  -cache int     缓存时间/分钟 (默认 5)
  -rate int      限流速率 req/s (默认 30)
  -burst int     限流突发容量 (默认 60)
  -timeout int   搜索引擎超时/秒 (默认 12)
  -version       显示版本号
  -start         后台启动
  -stop          停止后台实例
  -status        查看运行状态
  -restart       重启后台实例

示例

# 查看状态
metona-search-proxy -status
# ● 运行中  PID: 12345  端口: 7899
#   健康检查: http://localhost:7899/health

# 前台运行（调试用，Ctrl+C 停止）
metona-search-proxy

# 后台启动
metona-search-proxy -start
# 已后台启动 (PID: 12345)

# 停止
metona-search-proxy -stop
# 已停止 (PID: 12345)

---

部署方式（二选一）

方式一：systemd 服务（推荐—生产环境）

# 1. 安装二进制
sudo mkdir -p /opt/metona-search-proxy
sudo cp metona-search-proxy /opt/metona-search-proxy/
sudo chmod +x /opt/metona-search-proxy/metona-search-proxy

# 2. 创建服务
sudo cp metona-search-proxy.service /etc/systemd/system/
sudo systemctl daemon-reload
sudo systemctl enable --now metona-search-proxy

# 3. 管理
sudo systemctl status metona-search-proxy   # 状态
sudo systemctl stop metona-search-proxy     # 停止
sudo journalctl -u metona-search-proxy -f   # 日志

⚠️ 使用 systemd 后不要再用 -start/-stop CLI 命令，会冲突。

方式二：CLI 管理（轻量—个人开发）

# 安装全局命令
sudo cp metona-search-proxy /usr/local/bin/

# 启动
metona-search-proxy -start

# 查看状态
metona-search-proxy -status

# 停止
metona-search-proxy -stop

# 设置开机自启（加到 crontab）
(crontab -l 2>/dev/null; echo "@reboot metona-search-proxy -start") | crontab -

⚠️ 使用 CLI 管理前确保 systemd 服务已停止：sudo systemctl stop metona-search-proxy

---

测试

curl http://localhost:7899/health
curl "http://localhost:7899/search?q=hello&engine=google&n=5"
curl "http://localhost:7899/search?q=天气&engine=all&n=10"

---

API

GET /search?q=关键词&engine=all&n=10

engine: google | bing | ddg | baidu | all (默认)
n: 1-20，默认10
缓存: 5分钟（可配）
限流: 30 req/s（可配）

GET /health

---

本应用配置

Metona Ollama Desktop → 设置 → 代理 → 填入：

http://服务器IP:7899

重启应用即可。