feat: metona-search-proxy v2 — CLI命令/端口7899/百度引擎/详细README
This commit is contained in:
thzxx
+184
-27
@@ -1,46 +1,203 @@
|
||||
# search-proxy
|
||||
# metona-search-proxy
|
||||
|
||||
部署在可直连 Google/Bing/DuckDuckGo 的云服务器上，通过 HTTP API 提供搜索引擎代理。
|
||||
部署在可直连 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
|
||||
# 1. 上传到服务器
|
||||
scp search-proxy user@your-server:/opt/search-proxy/
|
||||
# Ubuntu/Debian
|
||||
sudo apt update && sudo apt install -y golang-go
|
||||
|
||||
# CentOS/RHEL
|
||||
sudo yum install -y golang
|
||||
|
||||
# 或手动安装最新版
|
||||
wget https://go.dev/dl/go1.22.0.linux-amd64.tar.gz
|
||||
sudo tar -C /usr/local -xzf go1.22.0.linux-amd64.tar.gz
|
||||
echo 'export PATH=$PATH:/usr/local/go/bin' >> ~/.bashrc && source ~/.bashrc
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 安装与编译
|
||||
|
||||
```bash
|
||||
# 1. 克隆仓库
|
||||
cd /opt
|
||||
git clone https://gitee.com/thzxx/metona-ollama-desktop.git
|
||||
cd metona-ollama-desktop/search-proxy
|
||||
|
||||
# 2. 编译
|
||||
cd /opt/search-proxy && go build -o search-proxy .
|
||||
go build -o metona-search-proxy .
|
||||
|
||||
# 本地交叉编译：
|
||||
# GOOS=linux GOARCH=amd64 go build -o search-proxy .
|
||||
# 3. 验证
|
||||
./metona-search-proxy --version
|
||||
# metona-search-proxy v2.0.0 go/go1.22.0
|
||||
```
|
||||
|
||||
# 3. 启动（默认端口 18080）
|
||||
PORT=18080 ./search-proxy &
|
||||
### 本地交叉编译（在本地编译好上传）
|
||||
|
||||
# 4. 测试
|
||||
curl "http://localhost:18080/health"
|
||||
curl "http://localhost:18080/search?q=hello&n=5"
|
||||
```bash
|
||||
# Windows 上编译 Linux 版本
|
||||
GOOS=linux GOARCH=amd64 go build -o metona-search-proxy .
|
||||
|
||||
# 5. 安装 systemd 服务
|
||||
sudo cp search-proxy.service /etc/systemd/system/
|
||||
# macOS 上编译 Linux 版本
|
||||
GOOS=linux GOARCH=amd64 go build -o metona-search-proxy .
|
||||
|
||||
# 上传到服务器
|
||||
scp metona-search-proxy user@your-server:/opt/metona-search-proxy/
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## CLI 命令
|
||||
|
||||
```bash
|
||||
./metona-search-proxy [选项]
|
||||
|
||||
选项:
|
||||
-port int 监听端口 (默认 7899)
|
||||
-cache int 缓存时间/分钟 (默认 5)
|
||||
-rate int 限流速率 req/s (默认 30)
|
||||
-burst int 限流突发容量 (默认 60)
|
||||
-timeout int 搜索引擎超时/秒 (默认 12)
|
||||
-version 显示版本号
|
||||
|
||||
示例:
|
||||
./metona-search-proxy # 默认配置
|
||||
./metona-search-proxy -port 7899 -cache 10 # 自定义端口和缓存
|
||||
./metona-search-proxy -port 7899 -rate 50 -burst 100 # 高并发配置
|
||||
PORT=7899 ./metona-search-proxy # 也可用环境变量
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 测试
|
||||
|
||||
```bash
|
||||
# 启动
|
||||
./metona-search-proxy &
|
||||
|
||||
# 健康检查
|
||||
curl http://localhost:7899/health
|
||||
|
||||
# 单引擎搜索
|
||||
curl "http://localhost:7899/search?q=hello+world&engine=google&n=5"
|
||||
|
||||
# 四引擎并行
|
||||
curl "http://localhost:7899/search?q=今天天气&engine=all&n=10"
|
||||
|
||||
# 百度搜索
|
||||
curl "http://localhost:7899/search?q=春节&engine=baidu&n=5"
|
||||
```
|
||||
|
||||
### 响应格式
|
||||
|
||||
```json
|
||||
{
|
||||
"success": true,
|
||||
"query": "hello world",
|
||||
"engine": "google",
|
||||
"total": 5,
|
||||
"results": [
|
||||
{
|
||||
"title": "...",
|
||||
"url": "https://...",
|
||||
"snippet": "...",
|
||||
"engine": "google"
|
||||
}
|
||||
]
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 安装为系统服务（开机自启）
|
||||
|
||||
### 1. 拷贝二进制文件
|
||||
|
||||
```bash
|
||||
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. 创建 systemd 服务文件
|
||||
|
||||
```bash
|
||||
sudo tee /etc/systemd/system/metona-search-proxy.service << 'EOF'
|
||||
[Unit]
|
||||
Description=Metona Search Proxy - Google/Bing/DDG/Baidu API
|
||||
After=network.target
|
||||
|
||||
[Service]
|
||||
Type=simple
|
||||
ExecStart=/opt/metona-search-proxy/metona-search-proxy
|
||||
Restart=always
|
||||
RestartSec=5
|
||||
Environment=PORT=7899
|
||||
|
||||
[Install]
|
||||
WantedBy=multi-user.target
|
||||
EOF
|
||||
```
|
||||
|
||||
### 3. 启动服务
|
||||
|
||||
```bash
|
||||
sudo systemctl daemon-reload
|
||||
sudo systemctl enable --now search-proxy
|
||||
sudo systemctl enable metona-search-proxy # 开机自启
|
||||
sudo systemctl start metona-search-proxy # 立即启动
|
||||
|
||||
# 查看状态
|
||||
sudo systemctl status metona-search-proxy
|
||||
|
||||
# 查看日志
|
||||
sudo journalctl -u metona-search-proxy -f
|
||||
```
|
||||
|
||||
## API
|
||||
### 4. 验证
|
||||
|
||||
```bash
|
||||
curl http://localhost:7899/health
|
||||
# {"engines":["google","bing","ddg","baidu","all"],"status":"ok","time":"...","version":"2.0.0"}
|
||||
```
|
||||
GET /search?q=关键词&engine=google&n=10
|
||||
|
||||
engine: google | bing | ddg | baidu | all (默认)
|
||||
n: 1-20，默认10
|
||||
缓存: 5分钟
|
||||
限流: 30 req/s
|
||||
|
||||
GET /health
|
||||
→ {"status":"ok","engines":["google","bing","ddg","baidu","all"],"time":"..."}
|
||||
```
|
||||
---
|
||||
|
||||
## 本应用配置
|
||||
|
||||
设置面板 → 代理设置 → 填入 `http://服务器IP:18080` → 重启
|
||||
Metona Ollama Desktop 设置面板 → 代理设置 → 填入：
|
||||
|
||||
```
|
||||
http://你的服务器IP:7899
|
||||
```
|
||||
|
||||
重启应用即可。web_search 的 Google/DDG/Bing/百度 四引擎请求会自动路由到这台服务器。
|
||||
|
||||
---
|
||||
|
||||
## 常用管理命令
|
||||
|
||||
```bash
|
||||
sudo systemctl start metona-search-proxy # 启动
|
||||
sudo systemctl stop metona-search-proxy # 停止
|
||||
sudo systemctl restart metona-search-proxy # 重启
|
||||
sudo systemctl status metona-search-proxy # 状态
|
||||
sudo journalctl -u metona-search-proxy -f # 实时日志
|
||||
sudo journalctl -u metona-search-proxy --since today # 今日日志
|
||||
```
|
||||
|
||||
Reference in New Issue
Block a user