Armbian 电视盒子指南:旧盒子装上 Linux,变身 7×24 小时在线小服务器
【免费下载链接】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
这个项目做的事情很直接:让 Armbian 这个为 ARM 芯片打造的 Linux 系统,跑在官方并不支持的电视盒子上。你手里那台吃灰的 Amlogic、瑞芯微或全志芯片盒子,插上一块写好的 U 盘,就能从安卓切换到一套完整、精简、100% 兼容 Debian/Ubuntu 的 Linux 发行版——装上 Docker、Jellyfin 这类服务后,它就是一台 7×24 小时在线的迷你服务器。
整个流程分四步:挑对镜像 → U 盘启动 → 一条命令写入 eMMC → 用armbian-*系列命令管理日常。下面按这个顺序走一遍,每一步都给出判断依据,避免"下载了镜像却不知道插哪个口、连哪个 IP"。
项目一览:Armbian 是什么,哪些盒子在支持名单里
Armbian(中文名"岸边")是基于 Debian/Ubuntu 构建的轻量级 Linux 发行版,软件源、apt 生态都和桌面 Linux 通用,可以稳定运行在 TF/SD 卡、U 盘和 eMMC(焊在主板上的闪存,相当于盒子的内置硬盘)上。本仓库在官方 Armbian 的基础上,为三类芯片平台补齐了适配,并内置了一批管理命令:
| 芯片平台 | 代表性设备 | 说明 |
|---|---|---|
| Amlogic(晶晨) | X96 Max+、HK1 Box、Tanix TX8 Max、Phicomm N1、MiBox 4C | 最常见的电视盒子芯片,覆盖 s922x / s905x3 / s912 / s905d / s905x 等型号 |
| Rockchip(瑞芯微) | Rock 5B、R68S、NanoPi R5S、橙派 5 | rk3588 / rk3568 / rk3399 等 |
| Allwinner(全志) | TQC A01 等 | h6 / h618 等 |
完整设备列表(按 SoC 性能排序)和每个型号对应的内核版本见 中文说明,设备代号数据库在build-armbian/armbian-files/common-files/etc/model_database.conf。
有一个硬性限制要先说清楚:s905 芯片的盒子只能以 TF/SD/USB 方式使用,无法写入 eMMC;其余型号都支持 eMMC 安装。选镜像前请先确认芯片型号(盒子背面标签或"关于本机"里能看到)。
U 盘启动:从下载镜像到进系统的最快路径
- 挑镜像:到项目 Releases 页面下载与盒子芯片型号对应的
.img文件,文件名里带芯片代号(如s905x3、rk3588),解压后得到.img。 - 写 U 盘:用 Rufus、balenaEtcher 等任意支持整盘写入的工具把
.img烧录到 U 盘。 - 第一次进 U 盘:Amlogic/Allwinner 盒子默认优先从 eMMC 启动,首次需要借 ADB 命令切换启动介质——
- 盒子系统里开启"开发者模式"和"USB 调试"(设置 → 关于本机 → 连点版本号 5 次);
- 电脑端连上 ADB:
adb connect <盒子IP>(IP 在路由器后台可查); - 执行
adb shell reboot update,盒子重启后就会从 U 盘加载 Armbian。
- 以后重启:U 盘插着盒子就能直接启动,USB 优先级高于 eMMC;个别型号不行时,把 eMMC 里
/boot下的boot.scr改名(如boot.scr.bak)即可。
登录信息是固定的:账号root,密码1234,SSH 端口22,盒子 IP 在路由器管理页查看。Rockchip 平台(Rock 5B、R68S 等)的写入流程各不相同(RKDevTool、Maskrom 模式等),按 使用文档第 8 章 对应小节操作。
正式安装:armbian-install 把系统写进 eMMC
U 盘启动只是"临时工",系统装进 eMMC 后盒子才算真正落地。SSH 登录 Armbian 后执行:
armbian-install -m yes -a no常用参数:
| 参数 | 默认 | 作用 |
|---|---|---|
-m | no | 是否启用主线 u-boot(社区引导程序),老设备换 USB 不认盘时建议开 |
-a | yes | 是否使用 ampart 分区调整工具(可把 eMMC 空间利用满) |
-l | no | 显示全部设备列表 |
安装完成盒子自动重启,拔掉 U 盘即可直接从 eMMC 启动。动手之前有一个强烈建议:先用armbian-ddbr备份原安卓系统(见下一节的回滚通道),万一新系统不合用还能退回去。
日常运维:一条 armbian- 前缀命令管一件事
这个仓库最大的日常价值,是把盒子上的常见操作都封装成了前缀统一的命令,不用自己翻文档拼参数:
| 命令 | 干什么用 |
|---|---|
armbian-software | 软件中心,按 ID 一键安装/更新/卸载 Docker 镜像(Jellyfin、Nextcloud、Home Assistant、Portainer 等)、桌面软件和应用服务,清单与说明 |
armbian-apt | 更换软件源,按所在地区加速下载 |
armbian-update | 更新内核,详见下节 |
armbian-swap 1 | 用磁盘空间创建 1GB 虚拟内存,缓解跑 Docker 时的内存不足 |
armbian-config | 修改系统配置 |
armbian-sync | 把系统内全部服务脚本升级到最新版 |
armbian-openvfd | 调试盒子上的 LED 数码管屏,调试说明 |
把盒子当服务器长期用时,社区文档还推荐一个小动作:在/etc/modprobe.d/blacklist.conf里禁用红外接收内核模块(blacklist meson_ir),防止遥控器误触把服务器关机。
排坑与回滚:内核更新、系统救援的三条退路
改内核、动分区这类操作,项目内置了三层保险:
1. 内核更新自动备份
armbian-update不带参数时更新到最新版;-k 6.6可指定内核系列(自动取该系列最新),-k 6.6.12锁定具体版本。更新时当前内核会备份到/ddbr/backup,保留最近 3 个版本,新内核跑不稳随时切回。
2. SOS 内核救援:如果更新后盒子起不来了,用 U 盘启动任意版本的 Armbian,执行armbian-update -s,它会把 U 盘里的内核恢复回 eMMC,救回系统。
3. eMMC 整盘备份/还原
armbian-ddbr按提示输入b备份原 eMMC 系统到 U 盘(存为/ddbr/BACKUP-arm-64-emmc.img.gz),输入r还原。这也是"后悔药"的第一选择。
另外,使用文档 的 FAQ 章节(第 12 章)收录了内存识别异常、eMMC 写入 I/O 错误、无声音、网络与 WiFi 配置等高频问题的排查方法,遇到怪现象先查那里再动手。
下一步
挑一个今晚就能做的动作:确认盒子芯片型号(背面标签或"关于本机"),下载对应镜像写入 U 盘,第一次启动前先进入 U 盘系统跑一遍armbian-ddbr的b把原系统备份好——有了这份备份,后面的所有操作都可以放心试。
【免费下载链接】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
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考