企业官网建设流程全解析

电视盒子变 7×24 小时家庭服务器：Armbian 系统安装与调优完整指南

【免费下载链接】amlogic-s9xxx-armbianSupports running Armbian on Amlogic, Allwinner, and Rockchip devices. Support a311d, s922x, s905x3, s905x2, s912, s905d, s905x, s905w, s905, s905l, rk3588, rk3568, rk3399, rk3328, h6, etc.项目地址: https://gitcode.com/GitHub_Trending/am/amlogic-s9xxx-armbian

amlogic-s9xxx-armbian 是一个面向晶晨（Amlogic）、瑞芯微（Rockchip）、全志（Allwinner）三类芯片的 Armbian 系统项目，覆盖 s905x3、s905x2、s912、s905x、s905l、s905w、s905、rk3588、rk3568、rk3399、rk3328、h6 等数十种 SoC，能把闲置电视盒子装上一套基于 Debian/Ubuntu 的轻量级 Linux，并以约 8~10W 的功耗长期运行 Docker、NAS、智能家居等服务。

和官方 Armbian 的区别在于：该项目保留了官方系统的完整性，同时补齐了大量电视盒子的适配工作，并附带一组以armbian-开头的快捷管理命令，安装到 eMMC、更新内核、备份原安卓系统都可以一条命令完成。下面按"查型号 → 拿镜像 → 装系统 → 日常维护 → 调优 → 排障 → 进阶"的顺序走一遍。

先确认盒子在支持列表里

不是所有盒子都在覆盖范围内，动手前花一分钟核对芯片型号。支持的 SoC 按三大平台划分，常见机型举例如下：

完整的机型与分区表（dtb、u-boot 对应关系）在系统内的 model_database.conf 中，也可以到项目 Issues 里搜索自己的型号确认适配状态。一个需要留意的限制：s905 系列的盒子目前仅支持 TF/SD/USB 启动，其他型号都可以写入 eMMC 长期使用。

获取 Armbian 系统镜像的 3 种途径

途径一：直接下载预编译镜像（新手推荐）

到项目 Releases 页面找到自己型号对应的 Armbian 镜像（文件名格式形如Armbian_*-trunk_*_kernel.img.gz），用 Rufus 或 balenaEtcher 写入 USB 或 SD 卡即可。这是耗时最短的路径，镜像已包含对应 SoC 的 u-boot、dtb 和全部管理脚本。

途径二：本地编译（需要定制内核或文件系统时）

在 Ubuntu 24.04 环境下编译：

git clone --depth 1 https://gitcode.com/GitHub_Trending/am/amlogic-s9xxx-armbian cd amlogic-s9xxx-armbian sudo apt-get update -y sudo apt-get install -y $(cat compile-kernel/tools/script/ubuntu2404-build-armbian-depends) sudo ./rebuild -b s905x3 -k 6.6.12

rebuild脚本按"原版 Armbian 镜像 + 指定内核"重构出目标设备的系统，-b指定设备代号（可用_连接多个，或直接填amlogic/rockchip/allwinner平台名批量编译），-k指定内核版本，-t可切换 ext4/btrfs，-s可调整分区大小。产物输出在build/output/images目录。

途径三：GitHub Actions 云端编译（免本地环境）

在仓库 Actions 页面选择Build Armbian server image工作流，填写设备代号和内核版本参数后运行即可。参数与rebuild一一对应，适合不想搭本地编译环境、或需要定期更新镜像的场景。

首次启动：登录、配网与写入 eMMC

把写好镜像的 SD 卡或 U 盘插入盒子后，盒子默认仍会启动 Android，需要先让它从外部存储启动：进入 Android 的"设置 → 关于本机"，快速点击版本号 5 次开启开发者模式，打开 USB 调试，然后在电脑端执行adb shell reboot update，设备即重启进入 Armbian。

首次用 U 盘重新安装时则不需要这一步——USB 启动优先级高于 eMMC，个别设备如果仍然从 eMMC 启动，把 eMMC 的/boot分区里boot.scr改名后再插入 U 盘即可。

启动后通过 SSH 登录（默认账号root，密码1234，端口22，IP 从路由器 DHCP 获取）。确认网络正常后，将系统写入 eMMC：

armbian-install

该命令会自动处理 Amlogic 平台的分区表和 u-boot 部署，支持-m yes（主线 u-boot）、-a no（关闭 ampart 分区工具）、-l（列出全部设备）等参数。Rockchip 平台设备的 eMMC 安装步骤略有不同，请按 官方使用文档第 8 章 操作。

写入 eMMC 前建议先给原安卓系统留条退路：

armbian-ddbr

按提示输入b备份 eMMC 原始系统（备份文件位于/ddbr/BACKUP-arm-64-emmc.img.gz），日后输入r可恢复。

服务器日常维护的常用命令

系统内置了一批维护命令，覆盖日常 90% 的操作需求：

以内核更新为例，指定内核大版本会自动采用该系列最新版：

sudo -i armbian-update -k 5.15

针对低内存、长待机设备的调优

电视盒子普遍只有 2~4GB 内存、带 IR 红外接收器，作为 7×24 服务器使用时，以下四项调整收益最直接：

1. 加 swap，缓解内存压力

armbian-swap 1

把 1GB 磁盘空间虚拟为内存，Docker 容器多开时不容易被 OOM 杀掉。

2. 启用 TCP BBR，提升吞吐

echo 'net.core.default_qdisc=fq' >> /etc/sysctl.conf echo 'net.ipv4.tcp_congestion_control=bbr' >> /etc/sysctl.conf sysctl -p

对做下载、流媒体转发的场景，传输效率提升比较明显。

3. 开启定期 TRIM（使用 SSD 时）

sudo systemctl enable fstrim.timer sudo systemctl start fstrim.timer

保持 SSD 长期读写性能稳定。

4. 禁用红外接收，防止误触关机

盒子接红外遥控时可能被误触关机，用作服务器建议屏蔽 IR 内核模块：在/etc/modprobe.d/blacklist.conf中加入blacklist meson_ir后重启。

出问题时的排查清单

设备无法启动

• 电源适配器是否满足 5V/2A 以上，供电不足是最常见的"玄学"原因
• 使用 Class 10 以上 SD 卡，并重新校验镜像完整性
• 换一个内核版本试：不同 SoC 对内核的兼容性有差异
• 少数设备（T95、T95Z-Plus、BesTV-R3300L 等）需要extlinux.conf引导，系统已将对应配置文件放在/bootfs/extlinux/，其他设备保持uEnv.txt引导即可，不要动extlinux.conf.bak

网络连接失败

• 先ip addr看接口状态；DHCP 拿不到地址时，编辑/etc/network/interfaces手动配置静态 IP（模板格式见 使用文档 12.7 节）

外设识别异常

• dmesg | tail -50查看内核日志确认驱动是否加载
• 用armbian-update升到更新的内核再试

想恢复安卓系统

• 从 U 盘启动 Armbian 后执行armbian-ddbr输入r恢复备份；若未备份，可用 amlogic 刷机工具（USB 双公头线短接主板恢复点线刷安卓镜像），具体步骤见 文档 12.3 节

进阶：自定义内核与 LED 屏显示

需要给系统加私有补丁或自定义驱动模块时，可以直接在盒子里编译内核：

armbian-kernel -u # 更新编译环境和配置 armbian-kernel -k 6.6.12 # 编译指定版本

-n "-myname"可附加个人签名。添加内核补丁、制作驱动模块的完整流程见 内核编译指南；仓库的 compile-kernel/ 目录中还附带了 Docker 化编译环境的脚本。

部分机型机身带 LED 点阵屏，可用armbian-openvfd调试显示内容，配置方法在 LED 屏显示控制说明 中。

遇到问题去哪里找答案

• documents/README.cn.md：安装、eMMC 写入、网络配置、常见问题（第 12 章）的完整文档
• CONTRIBUTORS.md：数百位贡献者记录，设备适配情况大多能在其中找到线索
• 项目 Issues 区：搜索自己的设备型号，多数兼容性问题都有现成答案；找不到再提交新 Issue 并附上设备信息

一套镜像、一次写入，盒子的身份就从播放器变成了服务器。剩下的事情——装 Docker、挂硬盘、跑服务——和在任何一台 Debian 机器上没有区别。

【免费下载链接】amlogic-s9xxx-armbianSupports running Armbian on Amlogic, Allwinner, and Rockchip devices. Support a311d, s922x, s905x3, s905x2, s912, s905d, s905x, s905w, s905, s905l, rk3588, rk3568, rk3399, rk3328, h6, etc.项目地址: https://gitcode.com/GitHub_Trending/am/amlogic-s9xxx-armbian