chore: 更新 headless_browser 至 v0.3.0 并补充代理配置文档

升级 headless_browser 依赖以支持 WithProxy,同时在 README 和
docker/README.md 中补充 XHS_PROXY 环境变量的使用说明。

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
This commit is contained in:
zy
2026-02-28 01:30:19 +08:00
parent 3175d2e15a
commit 2f8af39aa1
4 changed files with 45 additions and 2 deletions

View File

@@ -405,6 +405,20 @@ go run .
go run . -headless=false
```
**配置代理(可选)**
如果需要通过代理访问,可以设置 `XHS_PROXY` 环境变量:
```bash
# 设置代理后启动
XHS_PROXY=http://user:pass@proxy:port ./xiaohongshu-mcp-darwin-arm64
# 或使用源码
XHS_PROXY=http://proxy:port go run .
```
支持 HTTP/HTTPS/SOCKS5 代理,日志中会自动隐藏代理的认证信息。
## 1.4. 验证 MCP
```bash

View File

@@ -92,7 +92,34 @@ docker compose pull && docker compose up -d
<img width="1662" height="458" alt="image" src="https://github.com/user-attachments/assets/309c2dab-51c4-4502-a41b-cdd4a3dd57ac" />
## 4. 扫码登录
## 4. 配置代理(可选)
如果需要通过代理访问小红书,可以通过 `XHS_PROXY` 环境变量配置。
### 使用 docker run
```bash
docker run -e XHS_PROXY=http://user:pass@proxy:port xpzouying/xiaohongshu-mcp
```
### 使用 docker-compose
`docker-compose.yml``environment` 中添加 `XHS_PROXY`
```yaml
environment:
- ROD_BROWSER_BIN=/usr/bin/google-chrome
- COOKIES_PATH=/app/data/cookies.json
- XHS_PROXY=http://user:pass@proxy:port
```
支持 HTTP/HTTPS/SOCKS5 代理。日志中会自动隐藏代理的认证信息,输出示例:
```
Using proxy: http://***:***@proxy:port
```
## 5. 扫码登录
1. **重要**,一定要先把 App 提前打开,准备扫码登录。
2. 尽快扫码,有可能二维码会过期。

2
go.mod
View File

@@ -11,7 +11,7 @@ require (
github.com/pkg/errors v0.9.1
github.com/sirupsen/logrus v1.9.3
github.com/stretchr/testify v1.11.1
github.com/xpzouying/headless_browser v0.2.0
github.com/xpzouying/headless_browser v0.3.0
)
require (

2
go.sum
View File

@@ -83,6 +83,8 @@ github.com/ugorji/go/codec v1.2.12 h1:9LC83zGrHhuUA9l16C9AHXAqEV/2wBQ4nkvumAE65E
github.com/ugorji/go/codec v1.2.12/go.mod h1:UNopzCgEMSXjBc6AOMqYvWC1ktqTAfzJZUZgYf6w6lg=
github.com/xpzouying/headless_browser v0.2.0 h1:EmuHXDVzx0tAevHJUdETs8iT/eK+QqrLiybvGd1xZDA=
github.com/xpzouying/headless_browser v0.2.0/go.mod h1:bQTSzGYHIipa1zwToMlOGHcXWDlvw8y33Cx5zzElekc=
github.com/xpzouying/headless_browser v0.3.0 h1:ila/Kmei1dvBbP71SXEQuWfLuvjCw5HMqsgOzK39xn0=
github.com/xpzouying/headless_browser v0.3.0/go.mod h1:bQTSzGYHIipa1zwToMlOGHcXWDlvw8y33Cx5zzElekc=
github.com/yosida95/uritemplate/v3 v3.0.2 h1:Ed3Oyj9yrmi9087+NczuL5BwkIc4wvTb5zIM+UJPGz4=
github.com/yosida95/uritemplate/v3 v3.0.2/go.mod h1:ILOh0sOhIJR3+L/8afwt/kE++YT040gmv5BQTMR2HP4=
github.com/ysmood/fetchup v0.2.3 h1:ulX+SonA0Vma5zUFXtv52Kzip/xe7aj4vqT5AJwQ+ZQ=