ApuOS 目标面向多种设备，具体安装、驱动和运行能力仍依赖已发布的硬件适配。发帖时提供设备型号、CPU架构、系统与内核版本、启动方式，以及网卡、显示、USB设备或UPS的具体型号；相同品牌不同芯片和连接方式可能具有不同表现。

安装前后分别记录

首次安装请说明使用的镜像来源和版本、目标存储设备以及失败发生在哪一步。已有系统升级问题应记录升级前后版本、可回退方式和报错。不要在公开帖子里上传能直接登录机器的凭据，也不要为尝试驱动随意替换内核、固件或设备树。

外设排查

USB、串口、网络设备的检查方式不同。说明连接方式、是否被系统识别、何时断开及应用显示的状态；截取与该设备有关的脱敏日志。对于供电、磁盘或UPS相关故障，先确保数据和供电安全，再考虑可逆的检查步骤。

可参考首次使用和常见问题。社区经验是针对特定环境的记录，不能自动当作所有同类设备已经适配的结论。

发布前检查

请先搜索已有主题，一帖讨论一个主要问题。截图和日志请遮蔽密码、访问令牌、配对码、许可证私钥、个人文件和设备序列号。社区账号独立于 NAS 账号。涉及存储操作时先备份重要数据，按照实际设备与版本核对说明。