OpenCPU Docker 镜像文档

镜像概述与主要用途

OpenCPU Docker 镜像是基于多种平台构建的容器化部署方案，旨在提供 OpenCPU 服务的快速、隔离式运行环境。容器镜像自动发布于 Docker Hub，支持 OpenCPU 核心功能及可选的 RStudio Server 集成，适用于数据分析、统计计算 API 服务及 R 语言开发调试场景。

核心功能与特性

• 多端口支持：暴露 80（HTTP）、8004（HTTP 备用）及 443（HTTPS）端口，满足不同网络环境需求。
• RStudio Server 集成：特定镜像（如 opencpu/rstudio）内置 RStudio Server，通过 Apache 代理实现 /rstudio/ 路径访问。
• 灵活的端口映射：支持将容器端口映射到主机，可按需选择端口组合。
• root 权限访问：支持通过 docker exec 进入容器获取 root shell，便于系统级配置（如安装依赖库）。
• 自动代理配置：集成 RStudio Server 的镜像自动配置 Apache 代理，实现 /ocpu/ 与 /rstudio/ 路径的无缝访问。

使用场景与适用范围

• 数据分析 API 服务：快速部署 OpenCPU 服务，提供统计计算接口。
• 开发与调试环境：通过 opencpu/rstudio 镜像，在隔离环境中进行 R 语言开发及 OpenCPU 应用调试。
• 隔离式部署：利用 Docker 容器隔离特性，避免系统环境冲突，简化多版本并存需求。

使用方法与配置说明

环境要求

• Docker 版本需 1.0 及以上。

基础镜像使用（opencpu/base）

启动容器

通过以下命令启动基础 OpenCPU 服务容器，映射 80 和 8004 端口：

# 交互式运行（前台）
docker run -t -p 80:80 -p 8004:8004 opencpu/base

# 后台运行（守护进程模式）
docker run -d -t -p 80:80 -p 8004:8004 opencpu/base

访问服务

容器启动后，通过以下 URL 访问 OpenCPU 服务：

• http://localhost/ocpu/（映射 80 端口时）
• http://localhost:8004/ocpu/（映射 8004 端口时）

集成 RStudio Server 的镜像使用（opencpu/rstudio）

启动容器

该镜像同时运行 OpenCPU 服务与 RStudio Server，启动命令：

# 交互式运行
docker run -t -p 80:80 -p 8004:8004 opencpu/rstudio

# 后台运行
docker run -d -t -p 80:80 -p 8004:8004 opencpu/rstudio

访问服务

• OpenCPU 服务：http://localhost/ocpu/ 或 http://localhost:8004/ocpu/
• RStudio Server：http://localhost/rstudio/ 或 http://localhost:8004/rstudio/

RStudio 登录信息

• 用户名：opencpu
• 密码：opencpu

获取 Root Shell

如需在运行中的容器内执行系统级操作（如安装依赖库），可通过 docker exec 获取 root shell：

步骤 1：获取容器 ID 或名称

# 列出运行中的容器，获取 CONTAINER ID 或 NAMES
docker ps

步骤 2：进入容器（通过 ID）

# 替换 [container-id] 为实际容器 ID
docker exec -i -t [container-id] /bin/bash

步骤 2（可选）：通过容器名称进入（推荐）

启动容器时指定名称（如 mybox）：

docker run --name mybox -t -p 80:80 opencpu/rstudio

通过名称进入容器：

docker exec -i -t mybox /bin/bash

端口映射详解

基本语法

通过 -p 主机端口:容器端口 映射端口，例如：

# 仅映射 8004 端口（主机 8004 → 容器 8004）
docker run -t -p 8004:8004 opencpu/base

注意事项

• 不支持跨端口重定向：HTTP 协议限制，映射 -p 1234:8004 会导致响应头（如 Location）包含错误地址，需使用反向代理（如 Nginx）重写请求头解决。
• 按需选择端口：若主机 80 端口被占用，可仅映射 8004 端口。

Docker Compose 部署示例

以下为 opencpu/rstudio 镜像的 docker-compose.yml 配置示例：

version: '3'
services:
  opencpu:
    image: opencpu/rstudio
    container_name: opencpu-rstudio
    ports:
      - "80:80"    # HTTP 主端口
      - "8004:8004"# HTTP 备用端口
    restart: unless-stopped  # 容器退出时自动重启（除非手动停止）

启动命令：

docker-compose up -d

安全说明

• Docker 容器默认禁用 AppArmor、SELinux 等 Linux 安全模块，OpenCPU API 在容器内的执行环境无额外限制。
• 建议通过网络隔离（如防火墙）限制容器端口访问，仅开放必要端口。

帮助与反馈

问题与建议可通过以下渠道反馈：

• OpenCPU 邮件列表

• ---