Armbian / 岸边
查看英文说明 | View English description
Armbian(中文名:岸边) 系统是基于 Debian/Ubuntu 而构建的专门用于 ARM 芯片的轻量级 Linux 系统。Armbian 系统精益、干净,并且 100% 兼容并继承了 Debian/Ubuntu 系统的功能和丰富的软件生态,可以安全稳定地运行在 TF/SD/USB 及设备的 eMMC 里。
现在你可以将电视盒子的安卓 TV 系统更换为 Armbian 系统,让他成为一台功能强大的服务器。本项目为 Amlogic
,Rockchip
和 Allwinner
盒子构建 Armbian 系统。支持写入 eMMC 中使用,支持更新内核等功能。使用方法详见Armbian 使用文档。
最新的 Armbian 固件可以在 Releases 中下载。欢迎 Fork
并进行个性化定制。如果对你有用,可以点仓库右上角的 Star
表示支持。
Armbian 固件说明
💡提示:目前 s905 的盒子只能在 TF/SD/USB
中使用,其他型号的盒子支持写入 EMMC
中使用。更多信息请查阅支持的设备列表说明。
安装及升级 Armbian 的相关说明
选择和你的盒子型号对应的 Armbian 固件,不同设备的使用方法查看对应的说明。
Rockchip
平台的安装方法请查看说明文档中的 第 8 章节。Amlogic
和Allwinner
平台,使用 Rufus 或者 balenaEtcher 等工具将固件写入 USB 里,然后把写好固件的 USB 插入盒子。登录 Armbian 系统 (默认用户: root, 默认密码: 1234) → 输入命令:
armbian-install
可选参数 | 默认值 | 选项 | 说明 |
---|---|---|---|
-m | no | yes/no | 使用 Mainline u-boot |
-a | yes | yes/no | 使用 ampart 分区表调整工具 |
-l | no | yes/no | List. 显示全部设备列表 |
举例: armbian-install -m yes -a no
登录 Armbian 系统 → 输入命令:
# 使用 root 用户运行 (sudo -i) # 如果不指定参数,将更新为最新版本。 armbian-update
可选参数 | 默认值 | 选项 | 说明 |
---|---|---|---|
-k | 最新版 | 内核名称 | 设置更新内核名称 |
-v | stable | stable/rk3588/dev | 指定内核版本分支 |
-m | no | yes/no | 使用主线 u-boot |
-b | yes | yes/no | 更新内核时自动备份当前系统使用的内核 |
-r | “” | “” | [救援] 使用 USB 中的系统内核更新 eMMC |
举例: armbian-update -k 5.15.50 -v dev -m yes
如果当前目录下有成套的内核文件,将使用当前目录的内核进行更新(更新需要的 4 个内核文件是 header-xxx.tar.gz
, boot-xxx.tar.gz
, dtb-xxx.tar.gz
, modules-xxx.tar.gz
。其他内核文件不需要,如果同时存在也不影响更新,系统可以准确识别需要的内核文件)。如果当前目录没有内核文件,将从服务器查询并下载同系列的最新内核进行更新。在设备支持的可选内核里可以自由更新,如从 5.10.125 内核更新为 5.15.50 内核。
更新内核时会自动备份当前系统使用的内核,存储路径在 /ddbr/backup
目录里,如果不需要可以删除。
💡 因特殊原因导致的更新不完整等问题,造成系统无法从 eMMC 启动时,可以从 USB 中启动任意内核版本的 Armbian 系统,运行 armbian-update -r
命令可以把 USB 中的系统内核更新至 eMMC 中,实现救援的目的。
登录 Armbian 系统 → 输入命令:
armbian-software
使用 armbian-software -u
命令可以更新本地的软件中心列表。根据用户在 Issue 中的需求反馈,逐步整合常用软件,实现一键安装/更新/卸载等快捷操作。包括 docker 镜像
、桌面软件
、应用服务
等。详见更多说明。
登录 Armbian 系统 → 输入命令:
armbian-config
如果你在使用 docker
等内存占用较大的应用时,觉得当前盒子的内存不够使用,可以创建 swap
虚拟内存分区,将磁盘空间的一定容量虚拟成内存来使用。下面命令输入参数的单位是 GB
,默认为 1
。
登录 Armbian 系统 → 输入命令:
armbian-swap 1
登录 Armbian 系统 → 输入命令:
armbian-openvfd
根据 LED 屏显示控制说明 进行调试。
Amlogic
盒子需要手动激活 TF/SD/USB 的剩余空间(Rockchip 和 Allwinner 已自动激活),登录 Armbian 系统 → 输入命令:
armbian-tf
根据提示输入 e
将剩余空间扩容至当前系统分区和文件系统,输入 c
将创建新的第 3 分区。或者手动分配剩余空间
支持在 TF/SD/USB
中对盒子的 EMMC
分区进行备份/恢复。建议您在全新的盒子里安装 Armbian 系统前,先对当前盒子自带的安卓 TV 系统进行备份,以便日后在恢复电视系统等情况下使用。
请从 TF/SD/USB
启动 Armbian 系统 → 输入命令:
armbian-ddbr
根据提示输入 b
进行系统备份,输入 r
进行系统恢复。
在 Armbian 中编译内核的用法详见 编译内核 说明文档。登录 Armbian 系统 → 输入命令:
armbian-kernel -u armbian-kernel -k 5.10.125
将本地系统中的全部服务脚本更新到最新版本,可以登录 Armbian 系统 → 输入命令:
armbian-sync
在 Armbian 的使用中,一些可能遇到的常见问题详见 documents
本地化打包
- 克隆仓库到本地
git clone --depth 1 https://github.com/ophub/amlogic-s9xxx-armbian.git
- 安装必要的软件包(脚本仅在 x86_64 Ubuntu-20.04/22.04 下做过测试)
sudo apt-get update -y sudo apt-get full-upgrade -y # For Ubuntu-22.04 sudo apt-get install -y $(cat compile-kernel/tools/script/ubuntu2204-build-armbian-depends)
- 进入
~/amlogic-s9xxx-armbian
根目录,在根目录下创建文件夹build/output/images
,并上传 Armbian 镜像文件 ( 如:Armbian_21.11.0-trunk_Odroidn2_current_5.15.50.img
) 到~/amlogic-s9xxx-armbian/build/output/images
目录里。原版 Armbian 镜像文件名称中的发行版本号(如:21.11.0
)和内核版本号(如:5.15.50
)请保留,它将在重构后用作 Armbian 固件的名称。 - 进入
~/amlogic-s9xxx-armbian
根目录,然后运行sudo ./rebuild -b s905x3 -k 5.10.125
命令即可生成指定 board 的 Armbian 镜像文件。生成的文件保存在build/output/images
目录里。
参数 | 含义 | 说明 |
---|---|---|
-b | Board | 指定电视盒子型号,如 -b s905x3 . 多个型号使用 _ 进行连接,如 -b s905x3_s905d . 使用 all 表示全部型号。型号代码详见 model_database.conf 中的 BOARD 设置。 |
-k | Kernel | 指定 kernel 名称,如 -k 5.10.125 . 多个内核使用 _ 进行连接,如 -k 5.10.125_5.15.50 。通过 -k 参数自由指定的内核版本只对使用 stable 目录里的内核有效,其他例如 rk3588 等内核由 model_database.conf 文件指定。 |
-a | AutoKernel | 设置是否自动采用同系列最新版本内核。当为 true 时,将自动在内核库中查找在 -k 中指定的内核如 5.10.125 的同系列是否有更新的版本,如有 5.10.125 之后的最新版本时,将自动更换为最新版。设置为 false 时将编译指定版本内核。默认值:true |
-r | KernelRepo | 指定内核仓库地址,如 -r https://github.com/ophub/kernel/tree/main/pub |
-s | Size | 对固件的 ROOTFS 分区大小进行设置,默认大小为 2560MiB, 固件大小必须大于 2048MiB. 例如: -s 2560 |
-t | RootfsType | 对固件的 ROOTFS 分区的文件系统类型进行设置,默认为 ext4 类型,可选项为 ext4 或 btrfs 类型。例如: -t btrfs |
-n | CustomName | 设置固件名称中的签名部分。默认值为空。可根据需要添加签名如 _server ,_gnome_desktop 或 _ophub 等,设置自定义签名时请勿包含空格。 |
-g | GH_TOKEN | 可选项。设置 ${{ secrets.GH_TOKEN }},用于 api.github.com 查询。默认值:无 |
sudo ./rebuild
: 使用默认配置,对全部型号的电视盒子进行打包。sudo ./rebuild -b s905x3 -k 5.10.125
: 推荐使用. 使用默认配置进行相关内核打包。sudo ./rebuild -b s905x3_s905d -k 5.10.125_5.15.50
: 使用默认配置,进行多个内核同时打包。使用_
进行多内核参数连接。sudo ./rebuild -b s905x3 -k 5.10.125 -s 2560
: 使用默认配置,指定一个内核,一个型号进行打包,固件大小设定为2560MiB。sudo ./rebuild -b s905x3_s905d
使用默认配置,对多个型号的电视盒子进行全部内核打包, 使用_
进行多型号连接。sudo ./rebuild -k 5.10.125_5.15.50
: 使用默认配置,指定多个内核,进行全部型号电视盒子进行打包, 内核包使用_
进行连接。sudo ./rebuild -k 5.10.125_5.15.50 -a true
: 使用默认配置,指定多个内核,进行全部型号电视盒子进行打包, 内核包使用_
进行连接。自动升级到同系列最新内核。sudo ./rebuild -t btrfs -s 2560 -k 5.10.125
: 使用默认配置,设置文件系统为 btrfs 格式,分区大小为 2560MiB, 并指定内核为 5.10.125 ,对全部型号电视盒子进行打包。
使用 GitHub Actions 进行编译
- 关于 Workflows 文件的配置在 build-armbian.yml 文件里。
- 全新编译:在 Actions 页面里选择
Build armbian
,根据 Armbian 官方支持的 OS 版本,可以选择 Ubuntu 系列:jammy
,或者 Debian 系列:bullseye
等。点击Run workflow
按钮即可编译。更多参数的设置方法可以在 Armbian 官方文档 里查阅。 - 再次编译:如果 Releases 中有已经编译好的
Armbian_.*-trunk_.*.img.gz
文件,你只是想再次制作其他不同 board 的盒子,可以跳过 Armbian 源文件的编译,直接进行二次制作。在 Actions 页面中选择Use Releases file to build armbian
,点击Run workflow
按钮即可二次编译。 - 使用其他 Armbian 固件,如 Armbian 官方固件下载网站 armbian.tnahosting.net 提供的 odroidn2 固件,仅在流程控制文件 rebuild-armbian.yml 中引入本仓库的脚本进行 Armbian 重构,即可适配其他盒子的使用。在 Actions 页面里选择
Rebuild armbian
,输入 Armbian 的网络下载地址如https://dl.armbian.com/*/Armbian_*.img.xz
,或者在流程控制文件 rebuild-armbian.yml 中通过armbian_path
参数设定重构文件的加载路径。代码如下:
- name: Rebuild Armbian uses: ophub/amlogic-s9xxx-armbian@main with: build_target: armbian armbian_path: build/output/images/*.img armbian_board: s905d_s905x3_s922x_s905x armbian_kernel: 5.10.125_5.15.50 gh_token: ${{ secrets.GH_TOKEN }}
关于 GitHUB RELEASES_TOKEN 的相关设置可参考:RELEASES_TOKEN。相关参数与本地打包命令
相对应,请参考上面的说明。
参数 | 默认值 | 说明 |
---|---|---|
armbian_path | 无 | 设置原版 Armbian 文件的路径,支持使用当前工作流中的文件路径如 build/output/images/*.img ,也支持使用网络下载地址如: https://dl.armbian.com/*/Armbian_*.img.xz |
armbian_board | all | 设置打包盒子的 board ,功能参考 -b |
armbian_kernel | 6.1.1_5.15.1 | 设置内核 版本,功能参考 -k |
auto_kernel | true | 设置是否自动采用同系列最新版本内核,功能参考 -a |
kernel_repo | ophub/kernel | 指定内核仓库地址,功能参考 -r |
armbian_size | 2560 | 设置固件 ROOTFS 分区的大小,功能参考 -s |
armbian_fstype | ext4 | 设置固件 ROOTFS 分区的文件系统类型,功能参考 -t |
armbian_sign | 无 | 设置固件名称中的签名部分,功能参考 -n |
gh_token | 无 | 可选项。设置 ${{ secrets.GH_TOKEN }}。功能参考 -g |
上传到 Releases
需要给仓库添加 ${{ secrets.GITHUB_TOKEN }}
和 ${{ secrets.GH_TOKEN }}
并设置 Workflow 读写权限
,详见使用说明。
参数 | 默认值 | 说明 |
---|---|---|
${{ env.PACKAGED_OUTPUTPATH }} | out | 打包后的固件所在文件夹的路径 |
${{ env.PACKAGED_OUTPUTDATE }} | 04.13.1058 | 打包日期(月.日.时分) |
${{ env.PACKAGED_STATUS }} | success | 打包状态:success / failure |
Armbian 固件默认信息
名称 | 值 |
---|---|
默认 IP | 从路由器获取 IP |
默认账号 | root |
默认密码 | 1234 |
使用 GitHub Actions 编译内核
内核的编译方法详见 compile-kernel
- name: Compile the kernel uses: ophub/amlogic-s9xxx-armbian@main with: build_target: kernel kernel_version: 5.10.125_5.15.50 kernel_auto: true kernel_sign: -yourname
Armbian 贡献者
首先感谢 150balbes 为在 Amlogic 电视盒子中使用 Armbian 所做出的杰出贡献和奠定的良好基础。这里编译的 Armbian 系统直接使用了官方当前的最新源码进行实时编译。程序的开发思路来自 ebkso 等作者的教程。感谢各位的奉献和分享,让我们可以在更多盒子里使用 Armbian 系统。
本系统所使用的 kernel
/ u-boot
等资源主要从 unifreq/openwrt_packit 的项目中复制而来,部分文件由用户在 amlogic-s9xxx-openwrt / amlogic-s9xxx-armbian / luci-app-amlogic / kernel 等项目的 Pull 和 Issues 中提供分享。为感谢这些开拓者和分享者,从现在开始(本源代码库创建于2021-09-19),我统一在 CONTRIBUTORS.md 中进行了记录。再次感谢大家为盒子赋予了新的生命和意义。
其他发行版
- amlogic-s9xxx-openwrt 项目提供了在盒子中使用的
OpenWrt
系统,在支持 Armbian 的相关设备中同样适用。 - unifreq 为晶晨、瑞芯微和全志等更多盒子制作了
OpenWrt
系统,属于盒子圈的标杆,推荐使用。 - Scirese 在安卓电视盒子里测试了
Arch Linux ARM
/Manjaro
系统的制作、安装和使用,具体详见他仓库中的相关说明。 - 7Ji 在他的博客中发表了一些在 Amlogic 平台上的逆向工程和开发的文章,比如以 ArchLinux 的方式安装 ArchLinux ARM 系统,对 Amlogic 平台的启动机制的介绍等。在他的 ampart 项目中,提供了一款分区工具,能够读取并编辑 Amlogic 的 eMMC 分区表和 DTB 内分区,可以 100% 利用 eMMC 空间。在 amlogic-s9xxx-archlinuxarm 项目中提供了
Arch Linux ARM
系统的制作和使用方法。在 YAopenvfD 项目中提供了另一个 openvfd 守护进程。