Files
xiaohongshu-mcp/docker
zy 77eff4a9df fix: 修复 Docker 环境中的僵尸进程问题 (#355)
在 Docker 环境中,当应用作为 PID 1 运行时,无法自动回收子进程。
go-rod 启动的 Chrome 浏览器及其子进程在关闭时会变成僵尸进程。

解决方案:
- 在 docker-compose.yml 中添加 init: true 配置
- Docker 会使用 tini/dumb-init 作为 init 进程
- init 进程会自动回收僵尸进程

此修复方案已由 issue 报告者验证有效。

Fixes #351

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-authored-by: Claude Sonnet 4.5 <noreply@anthropic.com>
2025-12-27 14:38:07 +08:00
..

Docker 使用说明

0. 重点注意

写在最前面。

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

1. 获取 Docker 镜像

1.1 从 Docker Hub 拉取(推荐)

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

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

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

1.2 从阿里云镜像源拉取(国内用户推荐)

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

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

1.3 自己构建镜像(可选)

在有项目的Dockerfile的目录运行

docker build -t xpzouying/xiaohongshu-mcp .

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

image

2. 手动 Docker Compose

国内用户提示:如需使用阿里云镜像源,请修改 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

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

image
# 停止 docker-compose
docker compose stop

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

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

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

3. 使用 MCP-Inspector 进行连接

注意 IP 换成你自己的 IP

image

对应的 Docker 日志一切正常。

image

4. 扫码登录

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

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

image image

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

image