电视盒子刷Armbian系统完整实战教程:6步把闲置盒子变成稳定服务器
2026/8/21 10:42:57 网站建设 项目流程

电视盒子刷Armbian系统完整实战教程:6步把闲置盒子变成稳定服务器

【免费下载链接】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 这个项目能适配哪些芯片,再按"准备 → 安装 → 日常维护 → 内核升级 → 自行编译 → 性能调优 → 排障"的路径走一遍完整流程。文中的每个命令都来自项目实际支持的功能,照着敲就能上手;想深挖细节的地方,也标注了对应的项目文档路径,方便随时查阅。

很多人家里的电视盒子上落了一层灰:它本身性能不差,却因为安卓系统臃肿、广告频繁而无处施展。其实这类设备完全可以"脱胎换骨"——换上基于 Debian/Ubuntu 的 Armbian 轻量系统,当作下载机、家庭服务器、Docker 运行平台来用。这篇教程就带你完成这场改造,全程以amlogic-s9xxx-armbian项目(支持 Amlogic、Rockchip、Allwinner 三大平台)为操作基础,从零起步,一步步把盒子变成真正能干活的机器。

一、改造前的"体检":先确认你的盒子够不够格

刷机之前先别急着动手,得先搞清楚手里的盒子属于哪个阵营。就像买鞋要先量脚码,Armbian 的不同芯片对应着不同的引导方式和镜像包。本项目覆盖的 SoC 大体可分为三个平台:

平台代表芯片常见设备形态
Amlogic(晶晨)s922x、s905x3、s905x2、s905l3a、s912、s905d、s905x 等各种外贸盒子、运营商盒子、刷机神机 Phicomm N1
Rockchip(瑞芯微)rk3588(s)、rk3576、rk3399、rk3568、rk3566、rk3328 等开发板(Rock5B、NanoPi R5S)、软路由盒子(R66S)、NAS 设备
Allwinner(全志)h6、h618Vplus、Tanix TX6、OrangePi Zero3 等

怎么确认自己的芯片?最简单的方法是去设备的包装盒、底部铭牌或系统设置里找"CPU/处理器"一栏,对照上表即可。实在找不到型号,也可以先烧录镜像到 U 盘试启动,项目在启动阶段会自动识别设备型号(也可以运行armbian-install -l查看全部支持列表)。

一个小提醒:目前s905老芯片的盒子只能在 TF/SD/USB 上运行,其余绝大多数型号都支持写入 eMMC。也就是说,只有最老的那批盒子会受"存储介质"限制,其他都能直接内置安装。

二、开工备料:镜像、烧录工具与编译环境

动手前把三样东西备齐,后面会顺畅很多。

1. 获取镜像文件

项目在 Releases 页面持续发布编译好的系统镜像,选择与你设备芯片匹配的版本下载即可。镜像的命名里通常包含发行版本号和内核版本号,比如Armbian_21.11.0-trunk_Odroidn2_current_5.15.50.img,这两段信息在后续二次打包时会被沿用,最好不要改动文件名。

2. 准备写盘工具

Windows 用户推荐用 Rufus,跨平台用户用 balenaEtcher,两者都能把镜像写进 U 盘。这一步只需注意:写盘会清空 U 盘所有数据,别选错盘符。

3. 了解默认登录信息

系统默认的登录口令是固定的,首次 SSH 连接或接显示器登录时直接使用:

项目默认值
用户名root
密码1234
SSH 端口22
IP 地址去路由器后台查看设备列表

如果你打算在本地自己打包系统或编译内核,还需要准备一台 Ubuntu 环境(官方文档以 Ubuntu 24.04 为例)。先克隆仓库:

git clone --depth 1 https://gitcode.com/GitHub_Trending/am/amlogic-s9xxx-armbian

然后进入项目根目录,把依赖一次性装齐。项目专门维护了一份依赖清单,比手动一个个装省心得多:

sudo apt-get update -y sudo apt-get full-upgrade -y # Ubuntu 24.04 专用依赖列表 sudo apt-get install -y $(cat compile-kernel/tools/script/ubuntu2404-build-armbian-depends)

依赖文件就放在 compile-kernel/tools/script/ 目录下,其他发行版如果遇到缺包报错,也可以把清单文件当作"标准答案"逐条对照安装。

三、首次开机:从 U 盘引导到写入 eMMC

镜像烧进 U 盘后,把它插到盒子上电启动。Amlogic 和 Allwinner 平台的盒子通常会优先从 USB 引导,如果不成功,可以参考项目文档 documents/README.cn.md 中"设置盒子从 USB/TF/SD 中启动"的章节,用安卓系统的终端工具切换启动入口。

成功进入 Armbian 桌面或命令行后,别急着删 U 盘,按下面的顺序操作:

  1. 先备份原厂系统(强烈建议)。盒子里自带的安卓 TV 系统虽然不好用,但万一以后想刷回去,没有备份就只能干瞪眼。运行:

    armbian-ddbr

    按提示输入b会把 eMMC 中的原系统完整备份下来,输入r则可以还原。

  2. 把系统写进 eMMC。确认功能没问题后,执行:

    armbian-install

    这个命令支持几个常用参数,初次使用保持默认即可:

    参数默认值作用
    -mno是否使用主线 u-boot
    -ayes是否使用 ampart 分区调整工具(可让 eMMC 空间 100% 被利用)
    -lno是否列出全部可选设备

    例如想用主线引导且不调整分区,可以写成armbian-install -m yes -a no

  3. 拔掉 U 盘重启,如果一切顺利,盒子会直接从内置存储启动 Armbian。

Rockchip 平台的安装路径略有不同,具体步骤请参考 documents/README.cn.md 中"安装 Armbian 到 eMMC"章节的第 8 部分,按对应设备型号的操作说明执行即可。

四、安家之后的三件小事:换源、装软件、改配置

系统能正常跑起来,接下来就是让它的"居住体验"更好。这三个命令覆盖了日常使用中最频繁的需求,建议记在备忘录里。

✅ 换软件源,告别龟速下载:国内网络访问默认源常常慢得让人抓狂,运行armbian-apt,按提示选择你所在地区的镜像源,apt install的速度会有质的提升。

✅ 安装常用软件,一条命令搞定armbian-software相当于一个盒子专用的"软件中心",内置了 Docker 镜像、桌面软件、应用服务等多类常用软件的安装入口。先执行armbian-software -u刷新一下软件列表,再选择要装的项目即可。具体清单可查看项目内的软件配置说明。

✅ 修改系统配置:需要调整网络、开启某些服务时,运行armbian-config打开图形化配置界面,比手动改配置文件更直观、更不容易出错。

如果发现系统里内置的服务脚本版本落后了,还可以运行armbian-sync一键把所有脚本同步到最新,确保后续使用的命令都是新版本。

五、内核升级与回滚:别让版本更新变成惊吓

Armbian 的内核更新远比想象中简单,一个命令就能完成,而且项目内置了"后悔药"机制,这也是我觉得最贴心的地方。

日常升级直接执行:

armbian-update

不跟参数时,它会自动更新到最新版本。想精确控制时,armbian-update提供了丰富的可选参数:

参数默认值说明
-k最新版指定内核版本,可精确到5.15.50,也可只写系列如5.15(自动选该系列最新版)
-u自动识别指定内核 tags 后缀,可选stable/flippy/beta/rk3588/rk35xx
-ddeb首选内核包格式(deb/tar),要编译自定义驱动时推荐 deb
-byes更新时是否自动备份当前内核
-mno是否使用主线 u-boot
-sSOS 模式,用于恢复 eMMC/NVMe/sdX 磁盘上的系统内核

更新的"后悔药"机制:每次升级前,系统会自动把当前内核备份到/ddbr/backup目录,并保留最近 3 个版本。如果你发现新版内核不稳定,随时可以回退。最坏的情况——更新后系统直接无法启动,也不用慌,用armbian-update -s进入 SOS 恢复模式,就能把内核抢救回来。

一个推荐的组合示例:armbian-update -k 5.15 -u stable -d deb,表示用 deb 格式、stable 系列中 5.15 的最新内核来更新。想了解参数细节,项目文档 documents/README.cn.md 的"更新 Armbian 内核"章节写得很详细。

六、想要专属内核?三种编译姿势任你挑

直接用现成内核当然省事,但如果你想裁剪模块、打补丁、或给内核加上个性签名,那就得自己动手编译了。项目提供了三种编译途径,各有适用场景,可以对照下表选择:

编译方式适用场景产物输出位置
本地recompile有 Ubuntu 电脑,想快速出包compile-kernel/output目录
设备内armbian-kernel盒子已经在跑 Armbian,就地取材/opt/kernel/compile-kernel/output
GitHub Actions 云编译不想占用本地资源,追求自动化云端发布到 Releases

方式一:在本地 Ubuntu 上编译。装好依赖后,在项目根目录执行:

sudo ./recompile -k 6.6.12

脚本会自动下载编译环境和内核源码,完成配置并产出内核文件。

方式二:直接在盒子里编译。先在 Armbian 系统内更新编译环境和配置文件,再指定版本:

armbian-kernel -u armbian-kernel -k 6.6.12

这种方式的好处是不用另找电脑,盒子自己就把活干了。

方式三:GitHub Actions 在线编译。在 Actions 页面选择"Compile the kernel"工作流,填写build_target: kernelkernel_versionkernel_sign等参数即可,适合需要定期编译、持续集成的玩家。

编译参数是核心玩法,几个最常用的说明如下:

参数默认值说明
-k6.12.y_6.18.y指定内核版本,多个版本用_连接
-atrue是否自动采用同系列最新版内核
-n-ophub内核自定义签名,例如-n -myserver
-tgcc工具链选择,可选 gcc 或 clang
-pfalse是否应用 tools/patch 下的自定义补丁
-mall构建内容,all 生成全部文件,dtbs 只生成设备树文件
-zxzinitrd 压缩格式,可选 xz/gzip/zstd/lzma
-lfalse是否把编译过程写入日志文件

举个例子,编译 5.15 系列最新版、带上你的专属签名,可以这样写:

sudo ./recompile -k 5.15 -a true -n -myserver

内核编译的参数说明和补丁制作方法,在 compile-kernel/README.cn.md 和 documents/README.cn.md 的第 9 章节都有完整讲解。

七、内存吃紧时的救急妙招:给盒子"借"点磁盘

盒子的内存普遍不大,跑几个 Docker 容器后 free 命令的结果往往触目惊心。这时候不必急着加预算换硬件,swap(虚拟内存)就能解燃眉之急——把一部分磁盘空间当作内存来用。

项目封装了一个贴心命令,单位是 GB:

armbian-swap 1

上面的命令会创建 1GB 的 swap 空间。如果跑的是 Docker、数据库这类内存大户,建议直接给到 2GB 以上。配合以下两个习惯,1~2GB 内存的盒子也能跑得比较从容:

  • systemctl停掉用不上的开机服务,让内存留给真正重要的进程;
  • 把缓存目录、日志目录挂到外部存储,避免 eMMC 被频繁写入拖累寿命。

八、翻车自救速查表:常见问题与排查思路

刷机路上不可能一帆风顺,这里把最常见的几类"翻车"场景整理成速查表,遇到问题可以对号入座:

症状可能原因处理思路
编译时报依赖缺失系统缺少开发库或工具链对照依赖清单compile-kernel/tools/script/ubuntu2404-build-armbian-depends逐条补齐
编译中途磁盘写满源码与中间文件占用过大清理/tmp与旧的编译输出,确保预留 20GB 以上空间
编译报工具链冲突本机 gcc/clang 版本不匹配-t gcc-t clang显式指定,或换干净环境重试
刷机后无法启动内核镜像、设备树或引导配置不匹配按"内核镜像完整性 → 设备树文件对应关系 → u-boot 引导配置"三步定位
更新内核后变砖新内核与设备不兼容armbian-update -sSOS 模式恢复系统内核

其中"启动失败三步定位法"是最常被问到的:第一步用读卡器挂载启动分区,检查内核镜像文件是否完整;第二步核对设备树(dtb)是否与你的盒子型号匹配,选错 dtb 是最常见的启动失败原因;第三步确认 u-boot 引导配置没有被误改。项目文档 documents/README.cn.md 的第 12 章收录了大量这类问题的解决方案,包括 dtb 与 u-boot 对应关系表、内存识别错误、I/O 写入错误等,遇到疑难杂症先翻这里,多半能直接找到答案。

九、进阶玩法:从批量编译到新设备支持

熟能生巧之后,你完全可以玩出更多花样。

🚀 给内核打上专属烙印。内核签名不只是为了好看——多台设备同时运行时,签名能帮你快速识别内核来源。比如情人节编译个5.10.99-valentines-day签名内核,运维的时候一眼就能分辨哪个是"特别版"。

🚀 一次编译,多设备共享。项目支持用_连接多个设备或内核进行批量打包,例如:

sudo ./rebuild -b s905x3_s905d -k 6.6.12_5.15.50

这条命令会同时为两个型号打包两个内核版本。更极致的用法是-b all(编译全部设备)或-b amlogic(编译整个 Amlogic 平台),配合 GitHub Actions 定时任务,就能构建一套持续更新的"全家桶"镜像仓库。

🚀 为冷门盒子添砖加瓦。如果你手上的设备不在官方支持列表里,也并非无路可走。项目的"如何添加新的支持设备"章节详细记录了从设备配置文件、系统文件到 u-boot 文件的完整添加流程,跟着文档走一遍,你的盒子就有机会被收录进设备库,惠及后来者。

写在最后

从给盒子"体检"确认芯片型号,到烧录镜像、写入 eMMC、维护内核、优化内存,再到亲手编译专属内核,这一整套流程走下来,你手里的电视盒子就不再是吃灰的摆件,而是一台真正能干活的小服务器。这个项目最大的价值在于:它把"非官方设备跑 Armbian"这件曾经门槛极高的事情,简化成了几个命令的事。

建议你从自己最感兴趣的一步开始实践——先跑通安装流程建立信心,再逐步尝试内核升级和编译。遇到问题不要慌,项目文档 documents/ 和 compile-kernel/ 就是你的随身手册,几乎每个已知问题都有对应的解法。折腾的乐趣,正在于此。

【免费下载链接】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),仅供参考

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询