Armbian在Amlogic S9xxx设备上运行Home Assistant的cgroup配置优化

问题背景

在基于Amlogic S9xxx芯片（如HK1盒子）的设备上安装Armbian 24.8.0 Bookworm版本时，用户报告在运行Home Assistant时遇到了cgroup相关的错误。这类问题通常与Linux内核的cgroup版本控制和系统资源配置有关。

技术原理分析

现代Linux系统使用cgroup(控制组)来管理和限制系统资源。从Linux 4.5内核开始引入了cgroup v2，但部分容器化应用（如Docker和Home Assistant管理组件）仍需要兼容cgroup v1。Armbian默认启用了unified cgroup hierarchy(v2)，这可能导致某些应用兼容性问题。

解决方案

通过修改Armbian的启动参数，可以强制系统使用传统的cgroup v1层级结构：

1. 编辑/boot/armbianEnv.txt文件
2. 添加或修改extraargs参数：

extraargs=systemd.unified_cgroup_hierarchy=0 apparmor=1 security=apparmor

3. 保存后重启系统

参数详解

• systemd.unified_cgroup_hierarchy=0：禁用统一的cgroup v2层级，使用传统的v1模式
• apparmor=1：启用AppArmor安全模块
• security=apparmor：设置系统默认使用AppArmor作为安全模块

注意事项

1. 此修改主要影响容器化应用的运行环境
2. 修改后需要完全重启系统才能生效
3. 对于Home Assistant等依赖Docker的应用，建议同时检查Docker的cgroup驱动配置
4. 在性能敏感场景下，cgroup v1可能比v2有轻微的性能优势

延伸阅读

对于Amlogic S9xxx设备用户，还应注意：

• 确保使用专为Amloc芯片优化的Armbian版本
• 检查设备温度控制，避免长时间高负载运行导致过热
• 考虑使用ZRAM交换分区优化内存使用

通过以上配置调整，可以解决大多数在Armbian系统上运行容器化应用时遇到的cgroup兼容性问题。