Docker中RStudio的Plumber未监听8004端口，如何接收主机请求？

排查步骤与解决方案 #

1. 确认Docker端口映射配置 #

确保你的docker-compose.yml（或docker run命令）中，8004端口是主机端口直接映射到容器端口，不要只使用expose指令（expose仅让容器间可见，无法实现主机到容器的访问）。

正确的docker-compose.yml配置示例：

services:
  rstudio:
    image: rstudio/rstudio:latest
    ports:
      - "8787:8787"  # RStudio GUI端口映射
      - "8004:8004"  # Plumber API端口映射
    volumes:
      - ./your-local-project:/home/rstudio/project  # 挂载本地项目到容器
    environment:
      - USER=rstudio
      - PASSWORD=your-custom-password

如果用docker run命令启动：

docker run -p 8787:8787 -p 8004:8004 -v ./your-local-project:/home/rstudio/project rstudio/rstudio:latest

2. 验证容器内Plumber的监听状态 #

进入Docker容器，检查Plumber是否真的在监听0.0.0.0:8004：

1. 查看容器ID：docker ps
2. 进入容器终端：docker exec -it <容器ID> /bin/bash
3. 安装端口检测工具（若容器未预装）：apt-get update && apt-get install -y net-tools
4. 检查端口监听：netstat -tulpn | grep 8004
   • 如果输出显示0.0.0.0:8004且关联进程为R，说明监听正常；
   • 若无输出，说明Plumber未启动或监听端口配置错误。

3. 修正Plumber启动逻辑 #

你的代码中存在路径依赖风险，建议明确指定文件路径，同时确保启动后R进程不被中断：

# plumber.R
library(plumber)
# 使用容器内的绝对路径加载API文件，避免工作目录问题
pr <- plumb("/home/rstudio/project/plumber.R")
# 强制监听所有网卡（0.0.0.0），确保外部能访问
pr$run(port = 8004, host = '0.0.0.0', docs = TRUE)

注意：在RStudio中运行该代码后，不要关闭运行窗口，否则Plumber进程会终止。

4. 检查主机防火墙设置 #

即使Docker完成了端口映射，主机防火墙仍可能拦截8004端口的入站请求：

• Windows：打开「Windows Defender防火墙」，添加允许8004端口入站的规则；
• Linux：执行ufw allow 8004（若使用ufw防火墙）；
• macOS：在「系统设置-网络-防火墙」中允许该端口的连接。

5. 测试主机到容器的连接 #

在主机终端执行以下命令验证：

curl http://localhost:8004/echo?msg=test

如果返回{"msg":"The message is: 'test'"}，说明连接正常；若仍提示连接被拒绝，重新检查容器内Plumber的运行状态和端口映射配置。

关于镜像选择的说明 #

rstudio/plumber镜像默认仅用于运行Plumber API，不带RStudio GUI。如果需要同时使用RStudio和Plumber，应使用rstudio/rstudio镜像，然后在RStudio内手动安装Plumber：

install.packages("plumber")

内容的提问来源于stack exchange，提问作者AnserGIS