From 2f8af39aa195c4777f8fdbdb23530fb78d7a68ee Mon Sep 17 00:00:00 2001
From: zy <xpzouying@gmail.com>
Date: Sat, 28 Feb 2026 01:30:19 +0800
Subject: [PATCH] =?UTF-8?q?chore:=20=E6=9B=B4=E6=96=B0=20headless=5Fbrowse?=
 =?UTF-8?q?r=20=E8=87=B3=20v0.3.0=20=E5=B9=B6=E8=A1=A5=E5=85=85=E4=BB=A3?=
 =?UTF-8?q?=E7=90=86=E9=85=8D=E7=BD=AE=E6=96=87=E6=A1=A3?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

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

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
---
 README.md        | 14 ++++++++++++++
 docker/README.md | 29 ++++++++++++++++++++++++++++-
 go.mod           |  2 +-
 go.sum           |  2 ++
 4 files changed, 45 insertions(+), 2 deletions(-)

diff --git a/README.md b/README.md
index d98e891..65c7672 100644
--- a/README.md
+++ b/README.md
@@ -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
diff --git a/docker/README.md b/docker/README.md
index 32c85f0..1af4818 100644
--- a/docker/README.md
+++ b/docker/README.md
@@ -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. 尽快扫码，有可能二维码会过期。
diff --git a/go.mod b/go.mod
index 9cbacb7..daf58b9 100644
--- a/go.mod
+++ b/go.mod
@@ -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 (
diff --git a/go.sum b/go.sum
index 304b398..fd5d27b 100644
--- a/go.sum
+++ b/go.sum
@@ -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=