BOINC客户端Docker镜像文档

!Docker Pulls !Docker Stars !Docker Cloud Build Status

1. 镜像概述与主要用途

1.1 概述

BOINC（Berkeley Open Infrastructure for Network Computing，伯克利开放式网络计算平台）是一个开源分布式计算框架，允许用户贡献闲置计算资源参与科学研究项目（如蛋白质折叠、气候变化模拟等）。本镜像为***BOINC客户端的Docker化版本，旨在简化BOINC客户端的部署与管理，支持在容器环境中高效运行分布式计算任务。

1.2 主要用途

• 在Docker容器中运行BOINC客户端，参与各类分布式科学计算项目
• 通过BOINC Manager或命令行工具远程管理客户端
• 在多种硬件架构（x86-64、ARM）及GPU环境（AMD、Intel、NVIDIA）中部署
• 构建分布式计算集群（支持Docker Swarm模式）

2. 核心功能与特性

• 多架构支持：覆盖x86-64（Ubuntu/Alpine基础）、ARM32v7、ARM64v8等架构
• GPU加速：原生支持AMD、Intel、NVIDIA GPU，可利用显卡算力提升计算效率
• VirtualBox集成：支持运行依赖VirtualBox的计算项目（需主机安装对应版本VirtualBox驱动）
• 远程管理：通过BOINC Manager图形界面或boinccmd命令行工具远程控制
• 数据持久化：配置与任务数据通过卷挂载持久化存储，容器重启后数据不丢失
• Swarm模式兼容：支持Docker Swarm集群部署，可横向扩展计算节点

3. 使用场景与适用范围

• 个人用户：利用个人电脑、服务器或嵌入式设备（如树莓派）的闲置算力参与科学项目
• 企业/机构：部署分布式计算节点，贡献组织闲置服务器资源支持科研
• 多架构环境：在x86服务器、ARM开发板等不同硬件平台上统一部署
• GPU计算场景：针对需GPU加速的项目（如GPU网格计算），利用容器化简化驱动配置

4. 支持的架构与标签

4.1 x86-64架构

4.2 ARM架构

5. 基本使用方法

5.1 基础客户端部署

以下命令启动基础版BOINC客户端（适用于CPU计算项目）：

sh
docker run -d \
  --name boinc \
  --net=host \
  --pid=host \
  -v /opt/appdata/boinc:/var/lib/boinc \  # 持久化存储路径（主机路径可自定义）
  -e BOINC_GUI_RPC_PASSWORD="123" \       # 设置GUI RPC密码（远程连接需使用）
  -e BOINC_CMD_LINE_OPTIONS="--allow_remote_gui_rpc" \  # 允许远程GUI连接
  boinc/client

5.2 远程连接客户端

5.2.1 通过BOINC Manager连接

1. 启动BOINC Manager，进入文件 > 选择计算机...
2. 在“主机名”栏输入容器所在主机IP（本地连接填127.0.0.1）
3. 输入BOINC_GUI_RPC_PASSWORD环境变量设置的密码（如上例中的123）
4. 点击“确定”完成连接

!BOINC Manager连接示意图

5.2.2 通过命令行控制

• 本地控制（在容器所在主机执行）：

  sh
  docker exec boinc boinccmd <命令参数>
  

  示例：查看任务状态
  docker exec boinc boinccmd --get_tasks

• 远程控制（从其他主机执行）：

  sh
  docker run --rm boinc/client boinccmd --host <主机IP> --passwd <密码> <命令参数>
  

  示例：暂停所有任务
  docker run --rm boinc/client boinccmd --host 192.168.1.100 --passwd 123 --suspend_all

6. 特殊架构与GPU支持配置

6.1 AMD GPU客户端

前提条件

• 主机安装ROCm驱动
• 重启系统使驱动生效

启动命令

sh
docker run -d \
  --name boinc \
  --device /dev/dri:/dev/dri \    # 挂载GPU显示设备
  --device /dev/kfd:/dev/kfd \    # 挂载AMD KFD设备
  --net=host \
  --pid=host \
  --group-add video \             # 添加video用户组，获取GPU访问权限
  -v /opt/appdata/boinc:/var/lib/boinc \
  -e BOINC_GUI_RPC_PASSWORD="123" \
  -e BOINC_CMD_LINE_OPTIONS="--allow_remote_gui_rpc" \
  boinc/client:amd

6.2 Intel GPU客户端（Broadwell及以上）

前提条件

• 主机安装Intel GPU驱动

启动命令

sh
docker run -d \
  --name boinc \
  --device /dev/dri:/dev/dri \    # 挂载GPU显示设备
  --net=host \
  --pid=host \
  -v /opt/appdata/boinc:/var/lib/boinc \
  -e BOINC_GUI_RPC_PASSWORD="123" \
  -e BOINC_CMD_LINE_OPTIONS="--allow_remote_gui_rpc" \
  boinc/client:intel

6.3 NVIDIA GPU客户端

前提条件

• 主机安装NVIDIA驱动
• 安装Docker原生GPU支持)

启动命令

sh
docker run -d \
  --name boinc \
  --gpus all \                    # 启用所有GPU（或指定GPU，如"device=0"）
  --net=host \
  --pid=host \
  -v /opt/appdata/boinc:/var/lib/boinc \
  -e BOINC_GUI_RPC_PASSWORD="123" \
  -e BOINC_CMD_LINE_OPTIONS="--allow_remote_gui_rpc" \
  boinc/client:nvidia

6.4 VirtualBox支持客户端

前提条件

• 主机安装virtualbox-dkms包，且版本与容器内VirtualBox版本完全一致（主版本.次版本.补丁版本）

启动命令

sh
docker run -d \
  --name boinc \
  --device=/dev/vboxdrv:/dev/vboxdrv \  # 挂载VirtualBox驱动设备
  --net=host \
  --pid=host \
  -v /opt/appdata/boinc:/var/lib/boinc \
  -e BOINC_GUI_RPC_PASSWORD="123" \
  -e BOINC_CMD_LINE_OPTIONS="--allow_remote_gui_rpc" \
  boinc/client:virtualbox

6.5 ARM架构客户端

ARM32v7（32位，如树莓派3）

sh
docker run -d \
  --name boinc \
  --net=host \
  --pid=host \
  -v /opt/appdata/boinc:/var/lib/boinc \
  -e BOINC_GUI_RPC_PASSWORD="123" \
  -e BOINC_CMD_LINE_OPTIONS="--allow_remote_gui_rpc" \
  boinc/client:arm32v7

ARM64v8（64位，如树莓派4/5）

sh
docker run -d \
  --name boinc \
  --net=host \
  --pid=host \
  -v /opt/appdata/boinc:/var/lib/boinc \
  -e BOINC_GUI_RPC_PASSWORD="123" \
  -e BOINC_CMD_LINE_OPTIONS="--allow_remote_gui_rpc" \
  boinc/client:arm64v8

7. Swarm模式部署

7.1 初始化Swarm集群

sh
# 在管理节点初始化Swarm
docker swarm init

# 创建Overlay网络（供集群内服务通信）
docker network create -d overlay --attachable boinc

7.2 部署BOINC服务

sh
docker service create \
  --replicas <N> \                # 指定副本数（计算节点数量）
  --name boinc \
  --network=boinc \               # 使用创建的overlay网络
  -p 31416 \                      # 暴露BOINC RPC端口
  -e BOINC_GUI_RPC_PASSWORD="123" \
  -e BOINC_CMD_LINE_OPTIONS="--allow_remote_gui_rpc" \
  boinc/client

7.3 集群命令管理

通过boinccmd_swarm工具向所有节点发送命令：

sh
docker run --rm --network boinc boinc/client boinccmd_swarm --passwd 123 <命令参数>

示例：查询所有节点任务状态
docker run --rm --network boinc boinc/client boinccmd_swarm --passwd 123 --get_tasks

注意：Swarm模式不支持--pid=host，因此客户端无法获取主机非BOINC进程CPU使用率，相关资源限制设置可能失效。

8. 配置参数说明

8.1 环境变量

8.2 挂载与设备参数

9. Docker Compose配置

创建docker-compose.yml文件，通过docker-compose up -d启动：

yaml
version: '2'
services:
  boinc:
    image: boinc/client  # 根据需求替换标签，如boinc/client:nvidia
    container_name: boinc
    restart: always     # 容器退出时自动重启
    network_mode: host
    pid: host
    volumes:
      - /opt/appdata/boinc:/var/lib/boinc  # 主机数据目录（自定义）
    environment:
      - BOINC_GUI_RPC_PASSWORD=123         # 替换为自定义密码
      - BOINC_CMD_LINE_OPTIONS=--allow_remote_gui_rpc  # 允许远程连接
    # 以下设备挂载根据GPU类型添加（如NVIDIA无需，AMD/Intel需添加）
    # devices:
    #   - /dev/dri:/dev/dri
    #   - /dev/kfd:/dev/kfd
    # 如使用NVIDIA GPU，添加以下配置（需Docker 19.03+）
    # deploy:
    #   resources:
    #     reservations:
    #       devices:
    #         - driver: nvidia
    #           count: all
    #           capabilities: [gpu]

10. 更多信息

• 手动构建镜像：docker build -t boinc/client -f Dockerfile.base-ubuntu .（需获取源码）
• 容器内命令行访问：docker exec -it boinc /bin/bash
• 实时日志查看：docker logs -f boinc
• ***文档：BOINC客户端Docker项目源码

更新日志

• 2020.08.02：重大变更！废弃NVIDIA-Docker 2.0，需使用Docker原生GPU支持)，docker run命令略有调整。
• 2018.12.03：重大变更！BOINC 7.10.2起，Linux客户端工作目录从/var/lib/boinc-client改为/var/lib/boinc，镜像同步调整。使用新版镜像需更新挂载路径，否则无法识别旧数据。