petersulyok/smfc Docker 镜像 - 轩辕镜像

smfc Docker镜像文档

镜像概述和主要用途

本镜像为smfc（Super Micro风扇控制工具）提供Docker化部署方案，适用于Linux（家庭）服务器的风扇控制与硬件监控。提供两种镜像版本：

• 标准镜像：基于Alpine Linux，体积小巧，不支持GPU监控
• GPU支持镜像：基于Debian Linux，体积较大，支持GPU监控（需配合NVIDIA Container Toolkit）

核心功能和特性

通用特性

1. smfc以简单前台进程形式运行（非systemd服务）
2. ipmitool和smartctl需对主机的/dev和/run目录有只读访问权限及管理员权限
3. 容器可访问/sys文件系统，但主机需加载相应内核模块（如coretemp、k10temp、drivetemp）
4. 容器日志可发送至主机的journald守护进程（默认配置），也可自定义其他日志驱动
5. 若IPMI接口无法从容器访问，可使用IPMI远程访问（配置文件中设置[IPMI] remote_parameters=-U 用户名 -P 密码 -H 主机参数）
6. 支持IPMI远程访问的网络配置

使用场景和适用范围

• 标准镜像：适用于不需要GPU监控的Linux服务器环境，追求轻量级部署
• GPU支持镜像：适用于需要监控NVIDIA GPU的Linux服务器环境，如运行GPU计算任务的家庭服务器

详细使用方法和配置说明

标准镜像

组件版本

• Alpine Linux 3.22.2
• Python 3.12.12-r0
• ipmitool 1.8.19-r1
• smartmontools 7.5-r0

使用方法 #1：docker CLI

启动服务：

bash
docker run \
  -d \
  --rm \
  --log-driver=journald \
  --privileged=true \
  --name "smfc" \
  -v /dev:/dev:ro \
  -v /run:/run:ro \
  -v /etc/timezone:/etc/timezone:ro \
  -v /etc/localtime:/etc/localtime:ro \
  -v /etc/smfc/smfc.conf:/etc/smfc/smfc.conf:ro \
  -e SMFC_ARGS="-l 3" \
  petersulyok/smfc:latest

（示例脚本见此处）

停止服务：

bash
docker stop smfc

使用方法 #2：docker-compose（推荐）

创建docker-compose.yaml文件：

yaml
version: "2"
services:
  smfc:
    image: petersulyok/smfc:latest
    container_name: smfc
    logging:
        driver: journald
    privileged: true
    environment:
      - SMFC_ARGS=-l 3
    volumes:
      - /dev:/dev:ro
      - /run:/run:ro
      - /etc/smfc/smfc.conf:/etc/smfc/smfc.conf:ro
      - /etc/timezone:/etc/timezone:ro
      - /etc/localtime:/etc/localtime:ro
    restart: unless-stopped

（示例yaml文件见此处）

启动/停止服务：

bash
docker-compose up -d
docker-compose down

GPU支持镜像

组件版本

• Debian Linux 12 (slim)
• Python 3.11.2
• ipmitool 1.8.19-4
• smartmontools 7.3-1

如何启用NVIDIA GPU支持

在主机上安装NVIDIA驱动和NVIDIA Container Toolkit，具体步骤见官方指南。安装完成后执行：

bash
nvidia-ctk runtime configure --runtime=docker
systemctl restart docker

需重启Docker服务以应用配置（NVIDIA Container Toolkit会修改/etc/docker/daemon.json并添加NVIDIA运行时参数）。

使用方法 #1：docker CLI

启动服务：

bash
docker run \
    -d \
    --rm \
    --runtime=nvidia \
    --gpus all \
    --log-driver=journald \
    --privileged=true \
    --name "smfc" \
    -v /dev:/dev:ro \
    -v /run:/run:ro \
    -v /etc/timezone:/etc/timezone:ro \
    -v /etc/localtime:/etc/localtime:ro \
    -v /etc/smfc/smfc.conf:/etc/smfc/smfc.conf:ro \
    -e SMFC_ARGS="-l 3" \
    petersulyok/smfc:latest-gpu

（示例脚本见此处）

停止服务：

bash
docker stop smfc

使用方法 #2：docker-compose（推荐）

创建docker-compose-gpu.yaml文件：

yaml
version: "2"
services:
  smfc:
    image: petersulyok/smfc:latest-gpu
    container_name: smfc
    runtime: nvidia
    deploy:
      resources:
        reservations:
          devices:
            - driver: nvidia
              capabilities: [gpu]
    logging:
        driver: journald
    privileged: true
    environment:
      - SMFC_ARGS=-l 3
      - NVIDIA_VISIBLE_DEVICES=all
      - NVIDIA_DRIVER_CAPABILITIES=all
    volumes:
      - /dev:/dev:ro
      - /run:/run:ro
      - /etc/smfc/smfc.conf:/etc/smfc/smfc.conf:ro
      - /etc/timezone:/etc/timezone:ro
      - /etc/localtime:/etc/localtime:ro
    restart: unless-stopped

（示例yaml文件见此处）

启动/停止服务：

bash
docker-compose -f docker-compose-gpu.yaml up -d
docker-compose -f docker-compose-gpu.yaml down

配置参数说明

本地构建镜像

可通过以下命令在本地构建镜像：

bash
git clone [***]
cd smfc
./docker/docker-build.sh 3.4.0

注意：Dockerfile会从pypi.org安装smfc，因此版本号需对应官方发布版本。

版本历史

详见CHANGELOG.md：

• 4.2.1 (2025.10.26)：更新至smfc 4.2.1（Alpine 3.22.2/Debian 12）
• 4.1.0 (2025.08.28)：更新至smfc 4.1.0（Alpine 3.22.1/Debian 12）
• 4.0.0 (2025.07.08)：更新至smfc 4.0.0（Alpine 3.22/Debian 12）- 删除beta版本
• 3.8.0 (2025.03.15)：更新至smfc 3.8.0（Alpine 3.20.6）
• 3.7.0 (2025.01.27)：更新至smfc 3.7.0（Alpine 3.20.5）
• 3.6.0 (2024.12.12)：更新至smfc 3.6.0（Alpine 3.20.3）
• 3.5.1 (2024.08.23)：更新至smfc 3.5.1（Alpine 3.20）
• 3.5.0 (2024.03.21)：更新至smfc 3.5.0（Alpine 3.19）
• 3.4.0 (2023.11.28)：文档更新
• 3.3.0 (2023.11.19)：初始发布