热门搜索:

boinc/client

boinc

官方BOINC客户端，用于连接分布式计算项目并贡献计算资源。

54 次收藏下载次数: 0状态：社区镜像维护者：boinc仓库类型：镜像最近更新：1 年前

让 AI 帮你使用轩辕镜像？ · 展开查看说明

如果你使用 DeepSeek、元宝 AI、Copilot、ChatGPT 等 AI 工具，协助配置轩辕镜像、编写 docker pull 命令、修改 Docker Compose 镜像地址、配置镜像加速、排查镜像拉取失败、分析报错日志等问题，请先让 AI 阅读并遵守轩辕镜像的规则文档。

只需在 AI 对话中先发送下面这句话即可：

请先完整阅读并严格遵守以下文档中的全部规则与要求：

https://xuanyuan.cloud/agents.md

在未充分阅读并理解该文档前，不要生成任何命令、配置、修改建议、故障排查方案或技术回答。后续所有输出都必须严格以该文档中的规范为最高优先级执行。

查看 agents.md 用法指南与完整示范。国内用户首推元宝 AI、DeepSeek 的深度思考模式，不推荐豆包 AI；Cursor 等编辑器可在对话 @ 该链接，或加入 User Rules。若 AI 无法访问外链，可打开说明文档复制全文粘贴。文档会随站点更新，复制内容可能过期，建议定期检查。

镜像标签列表与下载命令

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架构

标签	说明
`latest`, `base-ubuntu`	基于Ubuntu的基础版BOINC客户端，所有x86-64镜像均以此为基础
`base-alpine`	基于Alpine的轻量版（注意：Alpine使用musl库，部分项目可能不兼容）
`amd`	支持AMD GPU的客户端（需主机安装ROCm驱动）
`intel`	支持Intel GPU的客户端（支持Broadwell及以上CPU集成显卡）
`intel-legacy`	支持旧款Intel GPU（Sandybridge/Ivybridge/Haswell CPU集成显卡）
`multi-gpu`	同时支持Intel GPU与NVIDIA GPU的客户端
`nvidia`	支持NVIDIA GPU（CUDA/OpenCL）的客户端（需主机安装NVIDIA驱动及原生GPU支持）
`virtualbox`	支持VirtualBox项目的客户端（需主机安装`virtualbox-dkms`包）

4.2 ARM架构

标签	说明
`arm32v7`	适用于ARMv7 32位设备（如树莓派3）
`arm64v8`	适用于ARMv8 64位设备（如树莓派4/5）

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连接

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

!https://github.com/BOINC/boinc-client-docker/blob/master/manager_connect.png

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客户端

前提条件

主机安装https://rocm.github.io/ROCmInstall.html
重启系统使驱动生效

启动命令

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客户端

前提条件

主机安装https://github.com/NVIDIA/nvidia-docker/wiki/Frequently-Asked-Questions#how-do-i-install-the-nvidia-driver
安装https://github.com/NVIDIA/nvidia-docker/wiki/Installation-(Native-GPU-Support)

启动命令

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 环境变量

参数	功能描述
`BOINC_GUI_RPC_PASSWORD`	GUI RPC连接密码，用于BOINC Manager或`boinccmd`远程连接认证
`BOINC_CMD_LINE_OPTIONS`	BOINC客户端命令行选项，如`--allow_remote_gui_rpc`允许远程连接，`--cpu_usage_limit 50`限制CPU使用率等
`BOINC_REMOTE_HOST`	（可选）限制仅允许指定IP远程连接，格式为`IP地址`（如`192.168.1.100`），不设置则允许所有IP
`TZ`	（可选）指定时区，默认UTC，如`Asia/Shanghai`（需镜像支持时区配置）

8.2 挂载与设备参数

参数	功能描述
`-v /opt/appdata/boinc:/var/lib/boinc`	挂载BOINC数据目录，持久化存储配置、任务数据及计算结果
`--device /dev/dri:/dev/dri`	挂载GPU显示设备（Intel/AMD GPU需配置）
`--device /dev/kfd:/dev/kfd`	挂载AMD KFD设备（AMD GPU需配置）
`--device /dev/vboxdrv:/dev/vboxdrv`	挂载VirtualBox驱动设备（VirtualBox标签镜像需配置）
`--gpus all`	启用所有NVIDIA GPU（NVIDIA标签镜像需配置，Docker 19.03+支持）
`--net=host`	使用主机网络模式，避免端口映射复杂配置（推荐远程管理场景）
`--pid=host`	使用主机进程命名空间，允许客户端获取主机进程信息（资源限制相关功能依赖）

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 .（需获取https://github.com/BOINC/boinc-client-docker%EF%BC%89
容器内命令行访问：docker exec -it boinc /bin/bash
实时日志查看：docker logs -f boinc
官方文档：https://github.com/BOINC/boinc-client-docker

更新日志

2020.08.02：重大变更！废弃NVIDIA-Docker 2.0，需使用https://github.com/NVIDIA/nvidia-docker/wiki/Installation-(Native-GPU-Support)%EF%BC%8C%60docker run`命令略有调整。
2018.12.03：重大变更！BOINC 7.10.2起，Linux客户端工作目录从/var/lib/boinc-client改为/var/lib/boinc，镜像同步调整。使用新版镜像需更新挂载路径，否则无法识别旧数据。

镜像拉取方式

您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本，请访问标签列表页面。

轩辕镜像加速拉取命令点我查看更多 client 镜像标签

docker pull docker.xuanyuan.run/boinc/client:<标签>

使用方法：

DockerHub 原生拉取命令

docker pull boinc/client:<标签>

轩辕镜像配置手册

按平台快速找到配置文档

Docker

登录仓库拉取

登录认证 · 私有仓库

专属域名拉取

免登录 · 高速拉取

Linux

Docker 镜像配置

Windows / Mac

Docker Desktop 配置

MacOS OrbStack

OrbStack 容器

Docker Compose

Compose 项目配置

NAS

群晖

Synology 配置

飞牛

fnOS 镜像配置

绿联

绿联 NAS

威联通

QNAP 配置

极空间

极空间 NAS

企业仓库

其他仓库

ghcr · Quay · nvcr

Harbor 镜像源

Proxy Repository 对接

Portainer 镜像源

Registries 配置

Nexus 镜像源

Docker Proxy 缓存

开发工具

Dev Containers

VS Code 开发容器

Podman

Podman 配置指南

Singularity / Apptainer

HPC 科学计算容器

Kubernetes

K8s Containerd

Kubernetes · Containerd

K3s

轻量级集群

面板 / 网络

爱快路由

iKuai 镜像加速

宝塔面板

一键配置镜像源

AI

用 AI 使用轩辕镜像

agents.md · AI 对话 · 提示词

一键安装

一键安装 Docker

Linux Docker 一键安装

需要其他帮助？请查看我们的常见问题Docker 镜像访问常见问题解答或提交工单

镜像拉取常见问题

功能

免费版与专业版区别

功能对比 · 版本选择

支持的镜像仓库

Docker Hub · GCR · GHCR

新手拉取配置

docker search 限制

专属域名 · Hub 搜索

不支持 push

仅支持 pull · 不支持

拉取速度原因

带宽 · 缓存 · 冷热镜像

错误码

402 与流量用尽

402 · 流量包 · 充值

401 认证失败

401 · docker login

manifest unknown

标签错误 · 镜像不存在

410 Gone 排查

410 · Docker 升级

429 限流

免费版 · 请求频率

其他报错

DNS 超时

DNS 解析 · 网络超时

TLS 证书失败

no matching manifest（架构）

账号

失败是否计费

manifest · blob · 计费

申请开发票（企业 / 个人）

企业 · 个人 · 工单

修改登录密码

网站 · 仓库 · 重置

注销账户

工单 · 数据 · 注销

原理

mirrors 不生效

daemon.json · 重启

去掉域名前缀

docker tag · 重命名

指定架构拉取

ARM64 · AMD64 · 多架构

latest 与「最新」

digest · 版本号 · 标签

查看全部问题→

用户好评

来自真实用户的反馈，见证轩辕镜像的优质服务

oldzhang

运维工程师

Linux服务器

"Docker访问体验非常流畅，大镜像也能快速完成下载。"

热门搜索:

boinc/client

boinc

官方BOINC客户端，用于连接分布式计算项目并贡献计算资源。

54 次收藏下载次数: 0状态：社区镜像维护者：boinc仓库类型：镜像最近更新：1 年前

让 AI 帮你使用轩辕镜像？ · 展开查看说明

只需在 AI 对话中先发送下面这句话即可：

请先完整阅读并严格遵守以下文档中的全部规则与要求：

https://xuanyuan.cloud/agents.md

在未充分阅读并理解该文档前，不要生成任何命令、配置、修改建议、故障排查方案或技术回答。后续所有输出都必须严格以该文档中的规范为最高优先级执行。

镜像标签列表与下载命令

BOINC客户端Docker镜像文档

!Docker Pulls !Docker Stars !Docker Cloud Build Status

1. 镜像概述与主要用途

1.1 概述

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架构

标签	说明
`latest`, `base-ubuntu`	基于Ubuntu的基础版BOINC客户端，所有x86-64镜像均以此为基础
`base-alpine`	基于Alpine的轻量版（注意：Alpine使用musl库，部分项目可能不兼容）
`amd`	支持AMD GPU的客户端（需主机安装ROCm驱动）
`intel`	支持Intel GPU的客户端（支持Broadwell及以上CPU集成显卡）
`intel-legacy`	支持旧款Intel GPU（Sandybridge/Ivybridge/Haswell CPU集成显卡）
`multi-gpu`	同时支持Intel GPU与NVIDIA GPU的客户端
`nvidia`	支持NVIDIA GPU（CUDA/OpenCL）的客户端（需主机安装NVIDIA驱动及原生GPU支持）
`virtualbox`	支持VirtualBox项目的客户端（需主机安装`virtualbox-dkms`包）

4.2 ARM架构

标签	说明
`arm32v7`	适用于ARMv7 32位设备（如树莓派3）
`arm64v8`	适用于ARMv8 64位设备（如树莓派4/5）

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连接

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

!https://github.com/BOINC/boinc-client-docker/blob/master/manager_connect.png

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客户端

前提条件

主机安装https://rocm.github.io/ROCmInstall.html
重启系统使驱动生效

启动命令

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客户端

前提条件

主机安装https://github.com/NVIDIA/nvidia-docker/wiki/Frequently-Asked-Questions#how-do-i-install-the-nvidia-driver
安装https://github.com/NVIDIA/nvidia-docker/wiki/Installation-(Native-GPU-Support)

启动命令

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 环境变量

参数	功能描述
`BOINC_GUI_RPC_PASSWORD`	GUI RPC连接密码，用于BOINC Manager或`boinccmd`远程连接认证
`BOINC_CMD_LINE_OPTIONS`	BOINC客户端命令行选项，如`--allow_remote_gui_rpc`允许远程连接，`--cpu_usage_limit 50`限制CPU使用率等
`BOINC_REMOTE_HOST`	（可选）限制仅允许指定IP远程连接，格式为`IP地址`（如`192.168.1.100`），不设置则允许所有IP
`TZ`	（可选）指定时区，默认UTC，如`Asia/Shanghai`（需镜像支持时区配置）

8.2 挂载与设备参数

参数	功能描述
`-v /opt/appdata/boinc:/var/lib/boinc`	挂载BOINC数据目录，持久化存储配置、任务数据及计算结果
`--device /dev/dri:/dev/dri`	挂载GPU显示设备（Intel/AMD GPU需配置）
`--device /dev/kfd:/dev/kfd`	挂载AMD KFD设备（AMD GPU需配置）
`--device /dev/vboxdrv:/dev/vboxdrv`	挂载VirtualBox驱动设备（VirtualBox标签镜像需配置）
`--gpus all`	启用所有NVIDIA GPU（NVIDIA标签镜像需配置，Docker 19.03+支持）
`--net=host`	使用主机网络模式，避免端口映射复杂配置（推荐远程管理场景）
`--pid=host`	使用主机进程命名空间，允许客户端获取主机进程信息（资源限制相关功能依赖）

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 .（需获取https://github.com/BOINC/boinc-client-docker%EF%BC%89
容器内命令行访问：docker exec -it boinc /bin/bash
实时日志查看：docker logs -f boinc
官方文档：https://github.com/BOINC/boinc-client-docker

更新日志

2020.08.02：重大变更！废弃NVIDIA-Docker 2.0，需使用https://github.com/NVIDIA/nvidia-docker/wiki/Installation-(Native-GPU-Support)%EF%BC%8C%60docker run`命令略有调整。
2018.12.03：重大变更！BOINC 7.10.2起，Linux客户端工作目录从/var/lib/boinc-client改为/var/lib/boinc，镜像同步调整。使用新版镜像需更新挂载路径，否则无法识别旧数据。

镜像拉取方式

您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本，请访问标签列表页面。

轩辕镜像加速拉取命令点我查看更多 client 镜像标签

docker pull docker.xuanyuan.run/boinc/client:<标签>

使用方法：

DockerHub 原生拉取命令

docker pull boinc/client:<标签>

轩辕镜像配置手册

按平台快速找到配置文档

Docker

登录仓库拉取

登录认证 · 私有仓库

专属域名拉取

免登录 · 高速拉取

Linux

Docker 镜像配置

Windows / Mac

Docker Desktop 配置

MacOS OrbStack

OrbStack 容器

Docker Compose

Compose 项目配置

NAS

群晖

Synology 配置

飞牛

fnOS 镜像配置

绿联

绿联 NAS

威联通

QNAP 配置

极空间

极空间 NAS

企业仓库

其他仓库

ghcr · Quay · nvcr

Harbor 镜像源

Proxy Repository 对接

Portainer 镜像源

Registries 配置

Nexus 镜像源

Docker Proxy 缓存

开发工具

Dev Containers

VS Code 开发容器

Podman

Podman 配置指南

Singularity / Apptainer

HPC 科学计算容器

Kubernetes

K8s Containerd

Kubernetes · Containerd

K3s

轻量级集群

面板 / 网络

爱快路由

iKuai 镜像加速

宝塔面板

一键配置镜像源

AI

用 AI 使用轩辕镜像

agents.md · AI 对话 · 提示词

一键安装

一键安装 Docker

Linux Docker 一键安装

需要其他帮助？请查看我们的常见问题Docker 镜像访问常见问题解答或提交工单

镜像拉取常见问题

功能

免费版与专业版区别

功能对比 · 版本选择

支持的镜像仓库

Docker Hub · GCR · GHCR

新手拉取配置

docker search 限制

专属域名 · Hub 搜索

不支持 push

仅支持 pull · 不支持

拉取速度原因

带宽 · 缓存 · 冷热镜像

错误码

402 与流量用尽

402 · 流量包 · 充值

401 认证失败

401 · docker login

manifest unknown

标签错误 · 镜像不存在

410 Gone 排查

410 · Docker 升级

429 限流

免费版 · 请求频率

其他报错

DNS 超时

DNS 解析 · 网络超时

TLS 证书失败

no matching manifest（架构）

账号

失败是否计费

manifest · blob · 计费

申请开发票（企业 / 个人）

企业 · 个人 · 工单

修改登录密码

网站 · 仓库 · 重置

注销账户

工单 · 数据 · 注销

原理

mirrors 不生效

daemon.json · 重启

去掉域名前缀

docker tag · 重命名

指定架构拉取

ARM64 · AMD64 · 多架构

latest 与「最新」

digest · 版本号 · 标签

查看全部问题→

用户好评

来自真实用户的反馈，见证轩辕镜像的优质服务

oldzhang

运维工程师

Linux服务器

"Docker访问体验非常流畅，大镜像也能快速完成下载。"