linuxserver/foldingathome

https://github.com/linuxserver/docker-foldingathome

https://foldingathome.org/是一个分布式计算项目，用于模拟蛋白质动态，包括蛋白质折叠过程和与多种疾病相关的蛋白质运动。它汇聚了志愿贡献个人电脑计算资源的公民科学家，通过这些数据，科学家能更好地理解生物学，并为开发治疗方法提供新机会。

LinuxServer.io团队提供的此容器具有以下特点：

• 定期及时的应用更新
• 简单的用户映射（PGID、PUID）
• 带有s6 overlay的自定义基础镜像
• 每周基础操作系统更新，在整个LinuxServer.io生态系统中共享通用层，以最小化空间占用、 downtime和带宽
• 定期安全更新

支持的架构

我们利用docker manifest实现多平台支持。只需拉取lscr.io/linuxserver/foldingathome:latest即可获取适合您架构的正确镜像，也可通过标签拉取特定架构镜像。

支持的架构：

应用设置

此镜像部署Folding@home客户端，界面可通过https://app.foldingathome.org访问。

在设置容器前，请先在https://app.foldingathome.org注册账户，并在账户设置中获取账户令牌。该值需填入`ACCOUNT_TOKEN`环境变量。

使用令牌和机器名称创建容器后，实例将列于Web应用中，可在该处进行控制。之后，ACCOUNT_TOKEN和MACHINE_NAME变量可移除，因为实例已与在线账户关联，配置信息存储在config文件夹中。

从7.6版本迁移

Fah-client 8版本经过重写，存在一些我们无法在容器中自动缓解的破坏性变更。与v7不同，v8不再捆绑本地WebGUI，Web应用从在线源加载，且只能自动检测与浏览器运行在同一台机器（物理机）上的实例，这在Docker容器中无法实现。因此，升级到v8需注册在线账户，获取账户令牌，并通过新环境变量ACCOUNT_TOKEN及MACHINE_NAME（友好名称）进行设置。

GPU硬件加速

Nvidia

Nvidia硬件加速用户需在主机上安装Nvidia提供的容器运行时，安装说明见：https://docs.nvidia.com/datacenter/cloud-native/container-toolkit/latest/install-guide.html。我们会自动添加必要的环境变量以利用主机GPU的所有可用功能。安装Nvidia容器工具包后，需使用Nvidia容器运行时重新创建Docker容器：`--runtime=nvidia`，并添加环境变量`-e NVIDIA_VISIBLE_DEVICES=all（也可设为特定GPU的UUID，可通过nvidia-smi --query-gpu=gpu_name,gpu_uuid --format=csv`查看）。Nvidia会自动将主机的GPU和驱动挂载到Folding@home容器中。

只读操作

此镜像可在只读容器文件系统下运行，详情请参阅https://docs.linuxserver.io/misc/read-only/。

使用方法

以下提供docker-compose和docker cli两种使用方式帮助您创建容器。

[!NOTE] 除非标记为“可选”，否则所有参数为必填项，必须提供值。

docker-compose（推荐，https://docs.linuxserver.io/general/docker-compose）

yaml
---
services:
  foldingathome:
    image: docker.xuanyuan.run/linuxserver/foldingathome:latest
    container_name: foldingathome
    environment:
      - PUID=1000
      - PGID=1000
      - TZ=Etc/UTC
      - ACCOUNT_TOKEN=
      - MACHINE_NAME=
      - CLI_ARGS= #可选
    volumes:
      - /path/to/foldingathome/data:/config
    ports:
      - 7396:7396 #可选
    restart: unless-stopped

docker cli (https://docs.docker.com/engine/reference/commandline/cli/)

bash
docker run -d \
  --name=foldingathome \
  -e PUID=1000 \
  -e PGID=1000 \
  -e TZ=Etc/UTC \
  -e ACCOUNT_TOKEN= \
  -e MACHINE_NAME= \
  -e CLI_ARGS= `#optional` \
  -p 7396:7396 `#optional` \
  -v /path/to/foldingathome/data:/config \
  --restart unless-stopped \
  lscr.io/linuxserver/foldingathome:latest

参数

容器通过运行时参数配置（如上述示例）。参数格式为<外部>:<内部>，例如-p 8080:80表示将容器内80端口映射到主机8080端口。

环境变量从文件（Docker secrets）

可通过特殊前缀FILE__从文件设置任何环境变量。例如：

bash
-e FILE__MYVAR=/run/secrets/mysecretvariable

这将根据/run/secrets/mysecretvariable文件内容设置环境变量MYVAR。

Umask设置

所有镜像支持通过可选环境变量-e UMASK=022覆盖容器内服务的默认umask设置。注意umask不是chmod，它基于值减少权限而非增加，使用前请参阅相关说明。

用户/组标识符

使用卷（-v参数）时，主机OS与容器间可能出现权限问题。通过指定用户PUID和组PGID可避免此问题。确保主机上的卷目录归指定用户所有，权限问题将迎刃而解。

示例中PUID=1000和PGID=1000，可通过id your_user命令查看您的ID：

bash
id your_user

输出示例：

text
uid=1000(your_user) gid=1000(your_user) groups=1000(your_user)

Docker Mods

我们发布多种https://github.com/linuxserver/docker-mods以扩展容器功能。上述动态徽章链接可访问此镜像专用Mods及适用于所有镜像的通用Mods列表。

支持信息

• 容器运行时Shell访问：

  bash
  docker exec -it foldingathome /bin/bash
  

• 实时监控容器日志：

  bash
  docker logs -f foldingathome
  

• 容器版本号：

  bash
  docker inspect -f '{{ index .Config.Labels "build_version" }}' foldingathome
  

• 镜像版本号：

  bash
  docker inspect -f '{{ index .Config.Labels "build_version" }}' lscr.io/linuxserver/foldingathome:latest
  

更新信息

大多数镜像为静态、版本化，需更新镜像并重建容器以更新内部应用。除特殊说明外，不建议或支持在容器内更新应用。请参考上文应用设置部分确认是否适用于此镜像。

通过Docker Compose更新

• 更新镜像：

  • 所有镜像：

    bash
    docker-compose pull
    

  • 单个镜像：

    bash
    docker-compose pull foldingathome
    

• 更新容器：

  • 所有容器：

    bash
    docker-compose up -d
    

  • 单个容器：

    bash
    docker-compose up -d foldingathome
    

• 清理旧镜像：

  bash
  docker image prune
  

通过Docker Run更新

• 更新镜像：

  bash
  docker pull docker.xuanyuan.run/linuxserver/foldingathome:latest
  

• 停止运行中的容器：

  bash
  docker stop foldingathome
  

• 删除容器：

  bash
  docker rm foldingathome
  

• 使用相同参数重建容器（若卷映射正确，/config文件夹及设置将保留）

• 清理旧镜像：

  bash
  docker image prune
  

镜像更新通知 - Diun（Docker Image Update Notifier）

[!TIP] 推荐使用https://crazymax.dev/diun/接收更新通知。不建议或支持使用其他自动更新容器的工具。

本地构建

如需本地修改镜像进行开发或自定义：

bash
git clone https://github.com/linuxserver/docker-foldingathome.git
cd docker-foldingathome
docker build \
  --no-cache \
  --pull \
  -t lscr.io/linuxserver/foldingathome:latest .

可使用lscr.io/linuxserver/qemu-static在x86_64硬件上构建ARM变体，反之亦然：

bash
docker run --rm --privileged docker.xuanyuan.run/linuxserver/qemu-static --reset

注册后，可通过-f Dockerfile.aarch64指定架构对应的Dockerfile。

版本历史

• 10.08.24: - 添加libexpat1以支持Nvidia。
• 25.06.24: - 破坏性变更 - 详见应用设置部分。重构镜像以支持F@H v8。
• 15.06.24: - 基于Ubuntu Noble重建，添加可选命令行参数。
• 14.12.22: - 基于Ubuntu Jammy重建，迁移至s6v3。
• 15.01.22: - 基于Ubuntu Focal重建。添加arm64v8构建（仅CPU）。增加关于GPU驱动权限设置的详细说明。
• 09.01.21: - 添加nvidia.icd。
• 14.04.20: - 添加Folding@home***链接。
• 20.03.20: - 初始发布。