威联通NAS刷入飞牛后一键编译ITE8528控制器驱动并安装

XingL

QNAP8528 内核模块（容器化编译版）

本项目基于 0xGiddi/qnap8528 二次开发，针对 NAS 系统普遍缺乏编译环境、追求系统纯净的用户，新增 Docker 容器化编译方案。通过映射 NAS 内核资源到容器，实现无侵入式驱动编译与安装，兼容原厂及第三方固件（如飞牛 OS）。

经实测在 TS-453Bmini（刷入飞牛 OS） 稳定运行，理论支持所有 Debian 系 Linux 环境。

🚀 核心优势

容器化编译

◦ 无需在 NAS 本地安装编译工具链，通过 Docker 隔离环境编译，避免污染系统。
◦ 自动挂载 NAS 内核头文件，解决跨平台依赖问题。

一键式脚本

◦ build.sh 脚本覆盖 编译、安装、依赖刷新、驱动加载及开机自启 全流程，减少手动操作风险。

系统洁癖友好

◦ 仅向系统写入必要的驱动文件，支持轻松卸载，适合对系统修改敏感的场景。

📦 前置准备

1. 在 NAS 应用中心安装 Docker（若系统支持）。
2. 通过 SSH 登录 NAS（需启用 SSH 服务）。
3. 克隆仓库：

   git clone https://github.com/gzxiexl/qnap8528.git && cd qnap8528  
   

4. 赋予脚本执行权限：

   chmod +x build.sh  
   

🛠️ 使用步骤

以 root 权限运行脚本（推荐）

sudo ./build.sh  

脚本自动执行流程

1. 启动 Docker 容器：挂载 NAS 内核头文件及当前目录，构建隔离编译环境。

2. 编译驱动：在容器内生成适用于当前 NAS 内核的 qnap8528.ko 模块。

3. 安装驱动：将模块复制到系统内核模块目录 /lib/modules/$(uname -r)/extra/。

4. 刷新依赖：执行 depmod -a 更新系统模块数据库，确保驱动可被识别。

5. 加载驱动：通过 modprobe qnap8528 立即启用模块，无需重启。

6. 配置自启：创建 Systemd 服务，确保驱动随系统启动自动加载。

   

💡 注意事项

• 内核升级后：若 NAS 内核版本更新（通过 uname -r 确认），需重新运行 sudo ./build.sh 重新编译安装驱动。
• 特殊设备适配：若设备为 TS-464/TS-253D 等非 ITE8528 芯片型号，可在脚本中添加参数 skip_hw_check=true（如 sudo ./build.sh skip_hw_check=true）。

🧪 功能验证

1. 检查驱动是否加载：

   lsmod | grep qnap8528  
   # 输出包含 `qnap8528` 即表示加载成功  
   

2. 查看 Systemd 服务状态：

   systemctl status qnap8528-load-module.service  
   # 状态应为 `active (exited)`  
   

📄 原项目功能继承

完整支持原仓库所有特性，包括：

• 硬件控制：风扇转速调节、LED 状态管理（含磁盘槽指示灯）、温度传感器读取。
• 系统信息：设备序列号（VPD）、EC 固件版本等底层信息获取。
• 兼容性：支持 QNAP 多型号 NAS（详见原仓库 Supported Models）。

🤝 贡献与反馈

欢迎通过 Star/Fork 支持项目！若遇问题或有优化建议：

• 在 GitHub 仓库提交 Issue，附 NAS 型号、固件版本及日志信息。
• 优秀改进可通过 Pull Request 合并至主分支。

License：GPLv3
Copyright：基于 0xGiddi 原项目，容器化改进 by gzxiexl
Disclaimer：本项目为第三方开发，与 QNAP 官方无关，使用前请备份数据。

财色兼收

大佬，这个教程和驱动适配威联通TS 451d么？

XingL

财色兼收 发表于 2025-5-28 22:19
大佬，这个教程和驱动适配威联通TS 451d么？

https://github.com/0xGiddi/qnap8528
支持型号列表看是支持的

财色兼收

折腾了一下，小白没搞定！烧开水喝

XingL

财色兼收 发表于 2025-5-29 23:42
折腾了一下，小白没搞定！烧开水喝

第一步是安装pwm控制器驱动，实现获取传感器数据，
第二部安装风扇控制软件，设置风扇控制。

财色兼收

XingL 发表于 2025-5-30 10:48
第一步是安装pwm控制器驱动，实现获取传感器数据，
第二部安装风扇控制软件，设置风扇控制。 ...

大佬，有空录个全流程视频教程呗，小白是真搞不定

idamon

大佬请教下led状态怎么控制的，比如把亮度调低

idamon

idamon 发表于 2025-6-7 14:27
大佬请教下led状态怎么控制的，比如把亮度调低

已解决...

ajoa

镜像构建失败，大佬帮忙看看是啥原因

root@TS-435Bmini:/qnap8528# chmod +x build.sh
root@TS-435Bmini:/qnap8528# sudo ./build.sh
🔄 正在构建 Docker 镜像 (qnap8528-compiler)...
[+] Building 62.4s (2/2) FINISHED docker:default
=> [internal] load build definition from Dockerfile 0.1s
=> => transferring dockerfile: 448B 0.0s
=> ERROR [internal] load metadata for docker.io/library/debian:bookworm 62.1s

[internal] load metadata for docker.io/library/debian:bookworm:

---

Dockerfile:1

1 | >>> FROM debian:bookworm AS builder
2 | RUN sed -i 's/deb.debian.org/mirrors.ustc.edu.cn/g' /etc/apt/sources.list.d/debian.sources
3 |

ERROR: failed to solve: debian:bookworm: failed to resolve source metadata for docker.io/library/debian:bookworm: unexpected status from HEAD request to https://docker.ketches.cn/v2/library/debian/manifests/bookworm?ns=docker.io: 429 Too Many Requests
❌ 镜像构建失败，请检查 Dockerfile 或网络连接
root@TS-435Bmini:~/qnap8528#

XingL

ajoa 发表于 2025-6-23 15:45
镜像构建失败，大佬帮忙看看是啥原因
root@TS-435Bmini:/qnap8528# chmod +x build.sh
root@TS-435Bmini:/q ...

基础镜像下载不下来，网络问题，提供一个解决思路：关键词kspeeder

ajoa

ajoa 发表于 2025-6-23 15:45
镜像构建失败，大佬帮忙看看是啥原因
root@TS-435Bmini:/qnap8528# chmod +x build.sh
root@TS-435Bmini:/q ...

已解决，换了几个容器镜像源就可以了

ajoa

请教大佬，Systemd 服务没有自动开启，如何解决？

Unit qnap8528-load-module.service could not be found.

一叶知_a3Vyz

ajoa 发表于 2025-6-25 19:49
请教大佬，Systemd 服务没有自动开启，如何解决？
Unit qnap8528-load-module.service could not be found. ...

解决了吗，我也是最后提示这个，也看不到设置风扇的地方。

ajoa

一叶知_a3Vyz 发表于 2025-6-26 09:01
解决了吗，我也是最后提示这个，也看不到设置风扇的地方。

没解决，但是重启之后风扇驱动是有自动加载的，就没管了

一叶知_a3Vyz

ajoa 发表于 2025-6-26 10:57
没解决，但是重启之后风扇驱动是有自动加载的，就没管了

加载后就可以调速了吗，后续怎么操作。我先重启一下试试

XingL

services:
  coolercontrol:
    container_name: coolercontrol
    image: ghcr.io/guniv/coolercontrol-docker
    network_mode: bridge
    ports:
      - "11987:11987"  # 将主机的11987端口映射到容器的11987端口
    volumes:
      - /sys/class/hwmon:/sys/class/hwmon
      - ./:/etc/coolercontrol  # 将当前目录挂载到容器的/etc/coolercontrol目录
    privileged: true  # 开启特权模式
    restart: always

我是通过docker跑cooler control来设置风扇曲线，仅供参考

一叶知_a3Vyz

idamon 发表于 2025-6-7 19:51
已解决...

怎么控制LED亮度呢，知道一下吧