热门搜索:
boinc/client
boinc
官方BOINC客户端，用于连接分布式计算项目并贡献计算资源。
54 次收藏下载次数: 0状态：社区镜像维护者：boinc仓库类型：镜像最近更新：12 个月前
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计算项目）：
shdocker 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 通过命令行控制
-
本地控制（在容器所在主机执行）：
shdocker exec boinc boinccmd <命令参数>示例：查看任务状态
docker exec boinc boinccmd --get_tasks -
远程控制（从其他主机执行）：
shdocker 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
- 重启系统使驱动生效
启动命令
shdocker 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驱动
启动命令
shdocker 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)
启动命令
shdocker 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版本完全一致（主版本.次版本.补丁版本）
启动命令
shdocker 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）
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
ARM64v8（64位，如树莓派4/5）
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
7. Swarm模式部署
7.1 初始化Swarm集群
sh# 在管理节点初始化Swarm docker swarm init # 创建Overlay网络（供集群内服务通信） docker network create -d overlay --attachable boinc
7.2 部署BOINC服务
shdocker 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工具向所有节点发送命令：
shdocker 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启动：
yamlversion: '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，镜像同步调整。使用新版镜像需更新挂载路径，否则无法识别旧数据。
镜像拉取方式
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本，请访问 标签列表页面。
DockerHub 原生拉取命令
docker pull boinc/client:<标签>
更多 client 镜像推荐
dragonflyoss/client
dragonflyoss
Dragonfly client written in Rust.
1 次收藏50万+ 次下载
11 天前更新
keybaseio/client
keybaseio
Keybase官方命令行客户端发行版
13 次收藏50万+ 次下载
12 天前更新
tsuru/client
tsuru
Tsuru客户端工具，用于与Tsuru PaaS平台交互，执行应用部署、管理等操作。
10万+ 次下载
1 个月前更新
decisionrules/client
decisionrules
DecisionRules.io的客户端应用，用于运行规则引擎，支持日常分析和流程决策，可每分钟处理超10万次决策，需连接MongoDB和Redis。
10万+ 次下载
11 天前更新
revoltchat/client
revoltchat
REVOLT网页客户端，用于访问REVOLT平台的网页版服务。
4 次收藏5万+ 次下载
7 个月前更新
mondoo/client
mondoo
Mondoo是云原生安全与漏洞风险管理工具，提供基础设施自动化风险评估、实时合规检查和安全策略即代码功能，支持多云、容器、Kubernetes等环境的持续安全监控与配置审计。
6 次收藏10万+ 次下载
11 天前更新
轩辕镜像配置手册
探索更多轩辕镜像的使用方法，找到最适合您系统的配置方式
Docker 配置
登录仓库拉取
通过 Docker 登录认证访问私有仓库
专属域名拉取
无需登录使用专属域名
K8s Containerd
Kubernetes 集群配置 Containerd
K3s
K3s 轻量级 Kubernetes 镜像加速
Dev Containers
VS Code Dev Containers 配置
Podman
Podman 容器引擎配置
Singularity/Apptainer
HPC 科学计算容器配置
其他仓库配置
ghcr、Quay、nvcr 等镜像仓库
Harbor 镜像源配置
Harbor Proxy Repository 对接专属域名
Portainer 镜像源配置
Portainer Registries 加速拉取
Nexus 镜像源配置
Nexus3 Docker Proxy 内网缓存
系统配置
需要其他帮助？请查看我们的 常见问题Docker 镜像访问常见问题解答 或 提交工单
镜像拉取常见问题
使用与功能问题
配置了专属域名后，docker search 为什么会报错？
docker search 限制
Docker Hub 上有的镜像，为什么在轩辕镜像网站搜不到？
站内搜不到镜像
机器不能直连外网时，怎么用 docker save / load 迁镜像？
离线 save/load
docker pull 拉插件报错（plugin v1+json）怎么办？
插件要用 plugin install
WSL 里 Docker 拉镜像特别慢，怎么排查和优化？
WSL 拉取慢
轩辕镜像安全吗？如何用 digest 校验镜像没被篡改？
安全与 digest
第一次用轩辕镜像拉 Docker 镜像，要怎么登录和配置？
新手拉取配置
轩辕镜像合规吗？轩辕镜像的合规是怎么做的？
镜像合规机制
错误码与失败问题
docker pull 提示 manifest unknown 怎么办？
manifest unknown
docker pull 提示 no matching manifest 怎么办？
no matching manifest（架构）
镜像已拉取完成，却提示 invalid tar header 或 failed to register layer 怎么办？
invalid tar header（解压）
Docker pull 时 HTTPS / TLS 证书验证失败怎么办？
TLS 证书失败
Docker pull 时 DNS 解析超时或连不上仓库怎么办？
DNS 超时
docker 无法连接轩辕镜像域名怎么办？
域名连通性排查
Docker 拉取出现 410 Gone 怎么办？
410 Gone 排查
出现 402 或「流量用尽」提示怎么办？
402 与流量用尽
Docker 拉取提示 UNAUTHORIZED（401）怎么办？
401 认证失败
遇到 429 Too Many Requests（请求太频繁）怎么办？
429 限流
docker login 提示 Cannot autolaunch D-Bus，还算登录成功吗？
D-Bus 凭证提示
为什么会出现「单层超过 20GB」或 413，无法加速拉取？
413 与超大单层
账号 / 计费 / 权限
用户好评
来自真实用户的反馈，见证轩辕镜像的优质服务
oldzhang
运维工程师
Linux服务器
5
"Docker访问体验非常流畅，大镜像也能快速完成下载。"