写在最前面。

• 启动后，会产生一个 images/ 目录，用于存储发布的图片。它会挂载到 Docker 容器里面。 如果要使用本地图片发布的话，请确保图片拷贝到 ./images/ 目录下，并且让 MCP 在发布的时候，指定文件夹为：/app/images，否则一定失败。

我们提供了预构建的 Docker 镜像，可以直接从 Docker Hub 拉取使用：

# 拉取最新镜像
docker pull xpzouying/xiaohongshu-mcp

Docker Hub 地址：https://hub.docker.com/r/xpzouying/xiaohongshu-mcp

国内用户可以使用阿里云容器镜像服务，拉取速度更快：

# 拉取最新镜像
docker pull crpi-hocnvtkomt7w9v8t.cn-beijing.personal.cr.aliyuncs.com/xpzouying/xiaohongshu-mcp

在有项目的Dockerfile的目录运行

docker build -t xpzouying/xiaohongshu-mcp .

xpzouying/xiaohongshu-mcp为镜像名称和版本。

国内用户提示：如需使用阿里云镜像源，请修改 docker-compose.yml 文件，注释掉 Docker Hub 镜像行，取消阿里云镜像行的注释：

# image: xpzouying/xiaohongshu-mcp
image: crpi-hocnvtkomt7w9v8t.cn-beijing.personal.cr.aliyuncs.com/xpzouying/xiaohongshu-mcp

# 注意：在 docker-compose.yml 文件的同一个目录，或者手动指定 docker-compose.yml。

# --- 启动 docker 容器 ---
# 启动 docker-compose
docker compose up -d

# 查看日志
docker logs -f xpzouying/xiaohongshu-mcp

# 或者
docker compose logs -f

查看日志，下面表示成功启动。

# 停止 docker-compose
docker compose stop

# 查看实时日志
docker logs -f xpzouying/xiaohongshu-mcp

# 进入容器
docker exec -it xiaohongshu-mcp bash

# 手动更新容器
docker compose pull && docker compose up -d

注意 IP 换成你自己的 IP

对应的 Docker 日志一切正常。

如果需要通过代理访问小红书，可以通过 XHS_PROXY 环境变量配置。

docker run -e XHS_PROXY=http://user:pass@proxy:port xpzouying/xiaohongshu-mcp

在 docker-compose.yml 的 environment 中添加 XHS_PROXY：

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

1. 重要，一定要先把 App 提前打开，准备扫码登录。
2. 尽快扫码，有可能二维码会过期。

打开 MCP-Inspector 获取二维码和进行扫码。

扫码成功后，再次扫码后，就会提示已经完成登录了。