runtimes-docker 镜像文档

1. 镜像概述和主要用途

runtimes-docker 是 DMOJ（Distributed Multi-Open Judge）在线评测系统官方提供的运行时环境镜像，用于为 DMOJ 平台提供隔离、安全、标准化的编程语言执行环境。该镜像预装了多种编程语言的编译器、解释器及依赖库，旨在简化 DMOJ 系统部署流程，确保评测任务在一致的环境中高效执行。

2. 核心功能和特性

2.1 多语言支持

• 预装常见编程语言的运行时环境，包括但不限于：C/C++ (GCC/Clang)、Python (2/3)、Java、Go、JavaScript (Node.js)、Ruby、PHP、C#、Rust 等（具体语言列表以镜像最新版本为准）。
• 支持编译型语言的动态编译及解释型语言的直接执行。

2.2 安全隔离

• 集成轻量级沙箱机制，限制评测程序的系统资源访问（CPU、内存、磁盘 I/O、网络）。
• 基于 Linux Namespaces 和 Control Groups (cgroups) 实现进程级隔离，防止恶意代码对宿主系统的影响。

2.3 标准化环境

• 统一的运行时配置，避免因环境差异导致的评测结果不一致。
• 预配置的依赖库版本固定，确保代码在不同部署环境中的行为一致性。

2.4 高效执行

• 优化的资源调度策略，支持多任务并发处理，提升评测吞吐量。
• 精简的镜像体积，减少部署时间和资源占用。

3. 使用场景和适用范围

3.1 DMOJ 平台部署

作为 DMOJ 在线评测系统的核心依赖组件，为代码提交提供运行时环境支持。

3.2 编程竞赛评测环境

用于搭建本地或云端编程竞赛的自动化评测系统，支持多语言题目评测。

3.3 教学与练***平台

为编程教学平台提供安全的代码执行环境，支持学生作业自动批改和实时反馈。

4. 详细使用方法和配置说明

4.1 镜像拉取

从 Docker 镜像仓库拉取最新版本（需确保已配置 DMOJ 官方镜像源或访问公开仓库）：

docker pull dmoj/runtimes-docker:latest

4.2 容器运行（基础示例）

4.2.1 基本运行命令

docker run -d \
  --name dmoj-runtimes \
  --network dmoj-network \  # 与 DMOJ 主服务在同一网络
  --cap-add=SYS_ADMIN \    # 部分沙箱功能可能需要额外权限（视安全策略调整）
  -v /path/to/temp:/tmp \  # 挂载临时目录用于评测任务
  dmoj/runtimes-docker:latest

4.2.2 资源限制配置

通过 Docker 原生参数限制容器资源，避免单个评测任务过度占用系统资源：

docker run -d \
  --name dmoj-runtimes \
  --memory=4g \           # 限制内存使用
  --cpus=2 \              # 限制 CPU 核心数
  --network dmoj-network \
  dmoj/runtimes-docker:latest

4.3 docker-compose 配置示例

适用于与 DMOJ 主服务协同部署的场景，创建 docker-compose.yml：

version: '3'

services:
  dmoj-runtimes:
    image: dmoj/runtimes-docker:latest
    container_name: dmoj-runtimes
    networks:
      - dmoj-net
    volumes:
      - ./dmoj-temp:/tmp  # 本地临时目录挂载
      - ./logs:/var/log/dmoj-runtimes  # 日志目录挂载
    environment:
      - RUNTIME_TIMEOUT=5  # 默认评测超时时间（秒）
      - MAX_MEMORY=1024    # 默认最大内存限制（MB）
    deploy:
      resources:
        limits:
          cpus: '2'
          memory: 4G

networks:
  dmoj-net:
    driver: bridge

启动服务：

docker-compose up -d

4.4 环境变量配置

4.5 数据卷挂载

5. 注意事项

1. 权限配置：沙箱功能可能需要 --cap-add 或 --privileged 权限（生产环境需谨慎评估安全风险）。
2. 语言支持：具体支持的编程语言版本以镜像标签为准，建议通过 docker run --rm dmoj/runtimes-docker:latest --list-languages 命令查看详细列表。
3. 更新策略：定期拉取最新镜像以获取语言版本更新和安全补丁。
4. 安全隔离：该镜像仅提供基础运行时隔离，生产环境需结合 DMOJ 主服务的安全策略（如防火墙、用户权限控制）进一步加固。

6. 参考链接

• DMOJ 官方文档：[***]
• Docker 镜像仓库：[***]