202 lines
4.1 KiB
Markdown
202 lines
4.1 KiB
Markdown
# 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（服务器上没有的话）
|
||
|
||
```bash
|
||
# Ubuntu/Debian
|
||
sudo apt update && sudo apt install -y golang-go
|
||
|
||
# CentOS/RHEL
|
||
sudo yum install -y golang
|
||
```
|
||
|
||
---
|
||
|
||
## 编译
|
||
|
||
```bash
|
||
cd /opt
|
||
git clone https://gitee.com/thzxx/metona-ollama-desktop.git
|
||
cd metona-ollama-desktop/search-proxy
|
||
go build -o metona-search-proxy .
|
||
```
|
||
|
||
### 本地交叉编译（编译好再上传）
|
||
|
||
```bash
|
||
# 编译 Linux 版本
|
||
GOOS=linux GOARCH=amd64 go build -o metona-search-proxy .
|
||
|
||
# 上传到服务器
|
||
scp metona-search-proxy user@your-server:/opt/metona-search-proxy/
|
||
```
|
||
|
||
---
|
||
|
||
## 全局命令
|
||
|
||
```bash
|
||
sudo cp metona-search-proxy /usr/local/bin/
|
||
sudo chmod +x /usr/local/bin/metona-search-proxy
|
||
```
|
||
|
||
之后任何目录都可以直接用：
|
||
|
||
```bash
|
||
metona-search-proxy --version
|
||
metona-search-proxy -status
|
||
```
|
||
|
||
---
|
||
|
||
## CLI 命令
|
||
|
||
### 服务管理
|
||
|
||
```bash
|
||
metona-search-proxy -start # 后台启动
|
||
metona-search-proxy -stop # 停止
|
||
metona-search-proxy -status # 查看状态
|
||
metona-search-proxy -restart # 重启
|
||
```
|
||
|
||
### 运行参数
|
||
|
||
```bash
|
||
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 重启后台实例
|
||
```
|
||
|
||
### 示例
|
||
|
||
```bash
|
||
# 查看状态
|
||
metona-search-proxy -status
|
||
# ● 运行中 PID: 12345 端口: 7899
|
||
# 健康检查: http://localhost:7899/health
|
||
|
||
# 前台运行（调试用，Ctrl+C 停止）
|
||
metona-search-proxy
|
||
|
||
# 后台启动（默认端口 7899）
|
||
metona-search-proxy -start
|
||
# 已后台启动 (PID: 12345)
|
||
|
||
# 后台启动（自定义端口和缓存）
|
||
metona-search-proxy -start -port 6789 -cache 10 -rate 50
|
||
|
||
# 停止
|
||
metona-search-proxy -stop
|
||
# 已停止 (PID: 12345)
|
||
```
|
||
|
||
---
|
||
|
||
## 部署方式（二选一）
|
||
|
||
### 方式一：systemd 服务（推荐—生产环境）
|
||
|
||
```bash
|
||
# 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 管理（轻量—个人开发）
|
||
|
||
```bash
|
||
# 安装全局命令
|
||
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`
|
||
|
||
---
|
||
|
||
## 测试
|
||
|
||
```bash
|
||
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
|
||
```
|
||
|
||
重启应用即可。
|