
如果你使用 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 无法访问外链,可 打开说明文档 复制全文粘贴。文档会随站点更新,复制内容可能过期,建议定期检查。
https://images.microbadger.com/badges/version/boinc/client.svg](https://microbadger.com/images/boinc/client "Get your own version badge on microbadger.com") https://images.microbadger.com/badges/image/boinc/client.svg](https://microbadger.com/images/boinc/client "Get your own image badge on microbadger.com") !https://img.shields.io/docker/pulls/boinc/client.svg !https://img.shields.io/docker/stars/boinc/client.svg !https://img.shields.io/docker/cloud/build/boinc/client.svg
客户端可通过任何BOINC Manager进行远程或本地访问。
目录
2020.08.02: 重大变更! NVIDIA-Docker 2.0已弃用,需使用原生GPU支持(https://github.com/NVIDIA/nvidia-docker/wiki/Installation-(Native-GPU-Support))%E3%80%82Docker run脚本也有轻微变化。
2018.12.03: 重大变更! 从7.10.2版本开始,https://boinc.berkeley.edu/wiki/Release_Notes_for_BOINC_7.10 /var/lib/boinc-client 改为 /var/lib/boinc。我们的镜像已相应调整。新镜像必须使用新命令运行,否则无法识别之前的数据和设置。
以下命令运行BOINC客户端Docker容器:
shdocker 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
要将BOINC Manager连接到客户端,启动BOINC Manager,进入文件 > 选择计算机...,在"主机名"字段输入运行Docker容器的PC的IP地址(本地运行时为127.0.0.1),以及通过BOINC_GUI_RPC_PASSWORD设置的密码(此处为123)。
!https://github.com/BOINC/boinc-client-docker/blob/master/manager_connect.png
通常,客户端也可通过boinccmd命令从命令行控制。
在运行Docker容器的同一台计算机上,可通过以下命令执行操作:
shdocker exec boinc boinccmd <参数>
在其他计算机上,应使用:
shdocker run --rm boinc/client boinccmd --host <主机> --passwd 123 <参数>
其中<主机>是运行Docker容器的机器的主机名或IP地址。如果已本地安装boinccmd,也可直接运行,无需通过Docker。
可使用以下标签指定boinc/client镜像的特定版本。
| 标签 | 说明 |
|---|---|
latest, base-ubuntu | 基于Ubuntu的BOINC客户端。所有x86-64镜像均基于此构建。 |
base-alpine | 基于Alpine的BOINC客户端。重要: Alpine使用musl而非glibc,因此部分项目可能不支持。 |
amd | 支持AMD GPU的BOINC客户端。使用方法见下文。 |
intel | 支持Intel GPU的BOINC客户端。支持Broadwell(第5代)及更高版本CPU。使用方法见下文。 |
intel-legacy | 支持旧版Intel GPU的BOINC客户端(Sandybridge - 第2代、Ivybridge - 第3代、Haswell - 第4代)。使用方法见下文。 |
multi-gpu | 支持Intel和Nvidia GPU的BOINC客户端。使用方法见下文。 |
nvidia | 支持NVIDIA(CUDA和OpenCL)的BOINC客户端。使用方法见下文。 |
virtualbox | 支持VirtualBox的BOINC客户端。使用方法见下文。 |
| 标签 | 说明 |
|---|---|
arm32v7 | 支持ARMv7 32位的BOINC客户端。使用方法见下文。 |
arm64v8 | 支持ARMv8 64位的BOINC客户端。使用方法见下文。 |
AMD GPU支持的BOINC客户端使用方法
shdocker run -d \ --name boinc \ --device /dev/dri:/dev/dri \ --device /dev/kfd:/dev/kfd \ --net=host \ --pid=host \ --group-add video \ -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
Intel GPU支持的BOINC客户端使用方法
shdocker run -d \ --name boinc \ --device /dev/dri:/dev/dri \ --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
旧版Intel GPU支持的BOINC客户端使用方法
shdocker run -d \ --name boinc \ --device /dev/dri:/dev/dri \ --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-legacy
多GPU支持的BOINC客户端使用方法
shdocker run -d \ --gpus all \ --name boinc \ --device /dev/dri:/dev/dri \ --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:multi-gpu
NVIDIA支持的BOINC客户端使用方法
shdocker run -d \ --gpus all \ --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:nvidia
VirtualBox支持的BOINC客户端使用方法
virtualbox-dkms包。注意:主机和容器中的VirtualBox版本(主版本.次版本.补丁版本)必须完全相同。shdocker run -d \ --name boinc \ --device=/dev/vboxdrv:/dev/vboxdrv \ --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
ARMv7 32位支持的BOINC客户端使用方法
shdocker 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
ARMv8 64位支持的BOINC客户端使用方法
shdocker 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
可使用Docker Swarm启动大量客户端,例如在用于BOINC计算的集群上。首先启动swarm并创建网络:
shdocker swarm init docker network create -d overlay --attachable boinc
如有需要,可在工作节点上运行提示的docker swarm join命令将其他节点连接到swarm(也可仅在一个节点上运行)。
然后启动客户端:
shdocker service create \ --replicas <N> \ --name boinc \ --network=boinc \ -p 31416 \ -e BOINC_GUI_RPC_PASSWORD="123" \ -e BOINC_CMD_LINE_OPTIONS="--allow_remote_gui_rpc" \ boinc/client
现在有<N>个客户端在swarm中分布式运行。可通过以下命令向所有客户端发送指令:
shdocker run --rm --network boinc boinc/client boinccmd_swarm --passwd 123 <参数>
注意无需指定--host。boinccmd_swarm命令会自动将指令发送到swarm中的所有主机。
Docker Swarm不支持pid=host模式,因此与非BOINC CPU使用率或排除应用相关的客户端设置将无法生效。
运行客户端时,以下参数可用(格式为“主机侧:容器侧”):
| 参数 | 功能 |
|---|---|
-e BOINC_GUI_RPC_PASSWORD="123" | 连接BOINC客户端时需使用的密码。 |
-e BOINC_CMD_LINE_OPTIONS="--allow_remote_gui_rpc" | --allow_remote_gui_rpc命令行选项允许从任何IP地址连接客户端。如不需要,可移除该参数,但需使用-e BOINC_REMOTE_HOST="IP"。 |
-v /opt/appdata/boinc:/var/lib/boinc | BOINC存储配置数据的路径。 |
-e BOINC_REMOTE_HOST="IP" | (可选)将IP替换为你的IP地址。此时仅允许从此IP连接客户端。 |
-e TZ=Europe/London | (可选)指定时区。默认是UTC+0。 |
--pid=host | (可选)共享主机的进程命名空间,允许容器内进程查看系统所有进程。使BOINC能够确定非BOINC进程的CPU百分比和排除应用。 |
可创建以下docker-compose.yml文件,在同一目录中运行docker-compose up -d启动客户端,避免使用较长的命令:
yamlversion: '2' services: boinc: image: boinc/client 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
docker build -t boinc/client -f Dockerfile.base-ubuntu .docker exec -it boinc /bin/bashdocker logs -f boinc您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本,请访问 标签列表页面。
来自真实用户的反馈,见证轩辕镜像的优质服务