查看英文说明 | View English description
OpenWrt 项目是一个针对嵌入式设备的 Linux 路由器操作系统。OpenWrt 不是一个单一且不可更改的固件,而是提供了具有软件包管理功能的完全可写的文件系统,让您可以自由选择需要的软件包来定制路由器系统。对于开发人员来说,OpenWrt 是一个无需围绕它构建完整固件就能开发应用程序的框架;对于普通用户来说,这意味着拥有了完全定制的能力,能以意想不到的方式使用该设备。它拥有超过 3000+ 个标准化应用软件包和非常丰富的第三方插件支持,让您可以轻松地将他们应用于各种支持的设备。
现在你可以将使用 Amlogic 芯片的电视盒子的安卓 TV 系统更换为 OpenWrt 系统,让他成为一台功能强大的路由器。本项目支持 github.com 一站式完整编译(从自定义软件包进行编译,到打包固件,完全在 github.com 一站式完成);支持本地化打包(在本地Ubuntu等环境中进行固件打包)。支持的Amlogic S9xxx系列型号有 a311d, s922x, s905x3, s905x2, s905l3a, s912, s905d, s905x, s905w, s905
等,例如 Belink GT-King, Belink GT-King Pro, UGOOS AM6 Plus, X96-Max+, HK1-Box, H96-Max-X3, Phicomm-N1, Octopus-Planet, Fiberhome HG680P, ZTE B860H
等电视盒子。
最新的固件可以在 Releases 中下载。欢迎你 Fork
并进行 个性化软件包定制 。如果对你有用,可以点仓库右上角的 Star
表示支持。
芯片 | 设备 | 可选内核 | OpenWrt 固件 |
---|---|---|---|
a311d | Khadas-VIM3 | 全部 | openwrt_a311d_k*.img |
s922x | Beelink-GT-King, Beelink-GT-King-Pro, Ugoos-AM6-Plus, ODROID-N2 | 全部 | openwrt_s922x_k*.img |
s905x3 | X96-Max+, HK1-Box, H96-Max-X3, Ugoos-X3, TX3, X96-Air, A95XF3-Air, Tencent-Aurora-3Pro(s905x3-b) | 全部 | openwrt_s905x3_k*.img |
s905x2 | X96Max-4G, X96Max-2G, MECOOL-KM3-4G | 全部 | openwrt_s905x2_k*.img |
s912 | Tanix-TX8-Max, Tanix-TX9-Pro, Tanix-TX92, Nexbox-A1, Nexbox-A95X-A2, A95X, H96-Pro-Plus, VORKE-Z6-Plus, Mecool-M8S-PRO-L, Vontar-X92, T95Z-Plus, Octopus-Planet, Phicomm-T1 | 全部 | openwrt_s912_k*.img |
s905d | MECOOL-KI-Pro, Phicomm-N1 | 全部 | openwrt_s905d_k*.img |
s905x | HG680P, B860H, TBee-Box, TX9 | 全部 | openwrt_s905x_k*.img |
s905w | X96-Mini, TX3-Mini, W95 | 5.4.y/5.15.y | openwrt_s905w_k*.img |
s905 | Beelink-Mini-MX-2G, Sunvell-T95M, MXQ-PRO+4K | 全部 | openwrt_s905_k*.img |
s905l3a | E900V22C/D, CM311-1a-YST, M401A, M411A, UNT403A, UNT413A | 全部 | openwrt_s905l3a_k*.img |
s905l3b/l2 | M302A/M304A(s905l3-b), MGV2000(s905l2), Wojia-TV-IPBS9505(s905l2) | 全部 | openwrt_s905l2_k*.img |
rk3588 | Radxa-Rock5B, HinLink-H88K | rk3588 | openwrt_box-name.img |
rk3568 | R66S, R68S, e25, h68k | 6.0.y | openwrt_box-name.img |
rk3328 | beikeyun, l1pro | 全部 | openwrt_box-name.img |
allwinner | vplus(h6) | 全部 | openwrt_vplus_*.img |
KVM | qemu | 全部 | openwrt_qemu_*.img |
💡提示:当前 s905w
系列的盒子只支持使用 5.4.y/5.15.y
内核,其他型号的盒子可任选内核版本使用。当前 s905
的盒子只能在 TF/SD/USB
中使用,其他型号的盒子同时支持写入 EMMC
中使用。每个盒子的 dtb 和 u-boot 请查阅说明。
选择和你的电视盒子型号对应的 OpenWrt 固件,使用 Rufus 或者 balenaEtcher 等工具将固件写入USB里,然后把写好固件的USB插入电视盒子。
从浏览器访问 OpenWrt 的默认 IP: 192.168.1.1 → 使用默认账户登录进入 OpenWrt
→ 系统菜单
→ 晶晨宝盒
→ 安装 OpenWrt
,在支持的设备下拉列表中选择你的盒子,点击 安装 OpenWrt
按钮进行安装。
从浏览器访问 OpenWrt 的 IP 如: 192.168.1.1 → 使用账户登录进入 OpenWrt
→ 系统菜单
→ 晶晨宝盒
→ 手动上传更新 / 在线下载更新
如果选择 手动上传更新
OpenWrt 固件,可以将编译好 OpenWrt 固件压缩包,如 openwrt_s9xxx_k5.15.50_xxx.img.gz 进行上传(推荐上传压缩包,系统会自动解压。如果上传解压缩后的 xxx.img 格式的文件,可能会因为文件太大而上传失败),上传完成后界面将显示 更新固件
的操作按钮,点击即可更新。
如果选择 手动上传更新
OpenWrt 内核,可以将 boot-xxx.tar.gz
, dtb-amlogic-xxx.tar.gz
, modules-xxx.tar.gz
这 3 个内核文件上传(其他内核文件不需要,如果同时上传也不影响更新,系统可以准确识别需要的内核文件),上传完成后界面将显示 更新内核
的操作按钮,点击即可更新。
如果选择 在线下载更新
OpenWrt 固件或内核,将根据插件设置
中的固件下载地址
和内核下载地址
进行下载,你可以自定义修改下载来源,具体操作方法详见 luci-app-amlogic 的编译与使用说明。
提示:安装/升级等功能由 luci-app-amlogic 提供可视化操作支持。也支持命令操作。
从浏览器访问 OpenWrt 的默认 IP: 192.168.1.1 → 使用默认账户登录进入 OpenWrt
→ 系统菜单
→ TTYD 终端
→ 输入命令
openwrt-tf
激活剩余空间后,支持在 TF/SD/USB 中升级内核和 OpenWrt 系统。
如果你在使用 docker
等内存占用较大的应用时,觉得当前盒子的内存不够使用,可以创建 swap
虚拟内存分区,将 /mnt/*4
磁盘空间的一定容量虚拟成内存来使用。下面命令输入参数的单位是 GB
,默认为 1
。
从浏览器访问 OpenWrt 的默认 IP: 192.168.1.1 → 使用默认账户登录进入 OpenWrt
→ 系统菜单
→ TTYD 终端
→ 输入命令
openwrt-swap 1
支持在 TF/SD/USB
中对盒子的 EMMC
分区进行备份/恢复。建议您在全新的盒子里安装 OpenWrt 系统前,先对当前盒子自带的安卓 TV 系统进行备份,以便日后在恢复电视系统等情况下使用。
请从 TF/SD/USB
启动 OpenWrt 系统,浏览器访问 OpenWrt 的默认 IP: 192.168.1.1 → 使用默认账户登录进入 OpenWrt
→ 系统菜单
→ TTYD 终端
→ 输入命令
openwrt-ddbr
根据提示输入 b
进行系统备份,输入 r
进行系统恢复。
💡提示:须使用 /mnt/*4/
空间进行存放 BACKUP-arm-64-emmc.img.gz
备份文件,未创建 TF/SD/USB
扩展分区的用户,须先使用 openwrt-tf
命令创建扩展分区。
从浏览器访问 OpenWrt 的默认 IP: 192.168.1.1 → 使用默认账户登录进入 OpenWrt
→ 系统菜单
→ TTYD 终端
→ 输入命令
openwrt-led
根据 LED 屏显示控制说明 进行调试。
使用 firstboot
命令可以恢复系统至初始化状态。在 OpenWrt 的使用中,一些可能遇到的常见问题详见 router-config
- 安装必要的软件包(如 Ubuntu 22.04 LTS 用户)
sudo apt-get update -y
sudo apt-get full-upgrade -y
# For Ubuntu-22.04
sudo apt-get install -y $(curl -fsSL https://is.gd/depend_ubuntu2204_openwrt)
- Clone 仓库到本地
git clone --depth 1 https://github.com/ophub/amlogic-s9xxx-openwrt.git
- 在
~/amlogic-s9xxx-openwrt
根目录下创建openwrt-armvirt
文件夹, 并将openwrt-armvirt-64-default-rootfs.tar.gz
文件上传至此目录。 - 在
~/amlogic-s9xxx-openwrt
根目录中输入打包命令,如sudo ./make -d -b s905x3 -k 5.10.125
。打包完成的 OpenWrt 固件放在根目录下的out
文件夹里。
参数 | 含义 | 说明 |
---|---|---|
-d | Defaults | 使用默认配置 |
-b | Board | 指定电视盒子型号,如 -b s905x3 . 多个型号使用 _ 进行连接,如 -b s905x3_s905d 。使用 all 表示全部型号。可以指定的型号有: a311d , s905x3 , s905x3-b , s905x2 , s905l3a , s905x , s905w , s905d , s905d-ki , s905l2 , s905 , s922x , s922x-n2 , s912 , s912-m8s 。说明:s922x-reva 是 s922x-gtking-pro-rev_a ,s922x-n2 是 s922x-odroid-n2 ,s912-m8s 是 s912-mecool-m8s-pro-l ,s905d-ki 是 s905d-mecool-ki-pro ,s905x2-km3 是 s905x2-mecool-km3 |
-k | Kernel | 指定 kernel 名称,如 -k 5.10.125 . 多个内核使用 _ 进行连接,如 -k 5.10.125_5.15.50 |
-a | AutoKernel | 设置是否自动采用同系列最新版本内核。当为 true 时,将自动在内核库中查找在 -k 中指定的内核如 5.10.125 的同系列是否有更新的版本,如有 5.10.125 之后的最新版本时,将自动更换为最新版。设置为 false 时将编译指定版本内核。默认值:true |
-v | VersionBranch | 指定内核 版本分支 名称,如 -v stable 。指定的名称须与分支目录名称相同。默认使用 stable 分支版本。 |
-s | Size | 对固件的 ROOTFS 分区大小进行设置(MiB),默认大小为 960 MiB, 固件大小必须大于 512 MiB. 例如: -s 960 |
sudo ./make -d
: 使用默认配置,使用内核库中的最新内核包,对全部型号的电视盒子进行打包。sudo ./make -d -b s905x3 -k 5.10.125
: 推荐使用. 使用默认配置进行相关内核打包。sudo ./make -d -b s905x3_s905d -k 5.10.125_5.15.50
: 使用默认配置,进行多个内核同时打包。使用_
进行多内核参数连接。sudo ./make -d -b s905x3 -k 5.10.125 -s 960
: 使用默认配置,指定一个内核,一个型号进行打包,固件大小设定为 960 MiB。sudo ./make -d -b s905x3 -v dev -k 5.10.125
: 使用默认配置,指定型号,指定版本分支 和内核进行打包。sudo ./make -d -b s905x3_s905d
使用默认配置,对多个型号的电视盒子进行全部内核打包, 使用_
进行多型号连接。sudo ./make -d -k 5.10.125_5.15.50
: 使用默认配置,指定多个内核,进行全部型号电视盒子进行打包, 内核包使用_
进行连接。sudo ./make -d -k 5.10.125_5.15.50 -a true
: 使用默认配置,指定多个内核,进行全部型号电视盒子进行打包, 内核包使用_
进行连接。自动升级到同系列最新内核。sudo ./make -d -s 960 -k 5.10.125
: 使用默认配置,设置固件大小为 960 MiB, 并指定内核为 5.10.125 ,对全部型号电视盒子进行打包。
你可以通过修改 router-config
目录的相关个性化固件配置文件,以及 .yml
文件, 自定义和编译适合你的 OpenWrt 固件, 固件可以上传至 github.com 的 Actions
和 Releases
等处.
- 你可以在 router-config 中查看个性化固件配置说明。编译流程控制文件是 .yml
- 全新编译:在 github.com 的 Action 选择
Build OpenWrt
. 点击Run workflow
按钮进行固件一站式编译和打包。 - 再次编译:如果 Releases 中有已经编译好的
openwrt-armvirt-64-default-rootfs.tar.gz
文件,你只是想再次制作其他不同 board 的盒子,可以跳过 OpenWrt 源文件的编译,直接进行二次制作。在 Actions 页面中选择Use Releases file to Packaging
,点击Run workflow
按钮即可二次编译。 - 更多支持:编译好的
openwrt-armvirt-64-default-rootfs.tar.gz
文件是制作各种不同 board 固件的通用文件,也适用于使用 unifreq 的打包脚本制作 OpenWrt 固件。他作为在盒子里使用 OpenWrt 和 Armbian 系统的开创者,对更多的设备进行了支持,如在 Armbian 系统中通过KVM
虚拟机使用的 OpenWrt(qemu 版)、Allwinner (微加云
)、Rockchip (贝壳云
、我家云
),以及 Amlogic 系列等。打包方法详见他的仓库说明,在 Actions 中通过 packaging-openwrt-for-qemu-etc.yml 可以调用他的打包脚本制作更多固件。
- name: Package Armvirt as OpenWrt
uses: ophub/amlogic-s9xxx-openwrt@main
with:
openwrt_path: openwrt/bin/targets/*/*/*rootfs.tar.gz
openwrt_board: s905x3_s905x2_s905x_s905w_s905d_s922x_s912
openwrt_kernel: 5.10.125_5.15.50
相关参数与本地打包命令
相对应,请参考上面的说明。
参数 | 默认值 | 说明 |
---|---|---|
openwrt_path | no | 设置 openwrt-armvirt-64-default-rootfs.tar.gz 的文件路径,可以使用相对路径如 openwrt/bin/targets/*/*/*rootfs.tar.gz 或网络文件下载地址如 https://github.com/*/releases/*/*rootfs.tar.gz |
openwrt_board | s905d_s905x3 | 设置打包盒子的 board ,功能参考 -b |
openwrt_kernel | 5.10.125_5.15.50 | 设置内核版本,功能参考 -k |
auto_kernel | true | 设置是否自动采用同系列最新版本内核。功能参考 -a |
version_branch | stable | 指定内核 版本分支 名称,功能参考 -v |
openwrt_size | 960 | 设置固件 ROOTFS 分区的大小,功能参考 -s |
上传到 Releases
需要给仓库添加 GITHUB_TOKEN
和 GH_TOKEN
并设置 Workflow 读写权限
,详见使用说明。
参数 | 默认值 | 说明 |
---|---|---|
${{ env.PACKAGED_OUTPUTPATH }} | out | 打包后的固件所在文件夹的路径 |
${{ env.PACKAGED_OUTPUTDATE }} | 04.13.1058 | 打包日期(月.日.时分) |
${{ env.PACKAGED_STATUS }} | success / failure | 打包状态。成功 / 失败 |
Option | Value |
---|---|
Target System | QEMU ARM Virtual Machine |
Subtarget | QEMU ARMv8 Virtual Machine(cortex-a53) |
Target Profile | Default |
Target Images | tar.gz |
更多信息请查阅 router-config
名称 | 值 |
---|---|
默认 IP | 192.168.1.1 |
默认账号 | root |
默认密码 | password |
默认 WIFI 名称 | OpenWrt |
默认 WIFI 密码 | none |
内核的编译方法详见 compile-kernel
- name: Compile the kernel for Amlogic s9xxx
uses: ophub/amlogic-s9xxx-armbian@main
with:
build_target: kernel
kernel_version: 5.10.125_5.15.50
kernel_auto: true
kernel_sign: -ophub
制作 OpenWrt 系统时,所使用的 kernel 和 u-boot 等文件,与制作 Armbian 系统使用的是相同的文件。为了不重复维护,相关内容归类放在了对应的资源仓库,在使用时将自动从相关仓库进行下载。
本系统所使用的 kernel
/ u-boot
等资源主要从 unifreq/openwrt_packit 的项目中复制而来,部分文件由用户在 amlogic-s9xxx-openwrt / amlogic-s9xxx-armbian / luci-app-amlogic / kernel 等项目的 Pull 和 Issues 中提供分享。unifreq
为我们开启了在电视盒子中使用 OpenWrt 的大门,深受其影响,我的固件在制作和使用中继承了他一贯的标准。为感谢这些开拓者和分享者,我统一在 CONTRIBUTORS.md 中进行了记录。再次感谢大家为盒子赋予了新的生命和意义。
- unifreq 为晶晨、瑞芯微和全志等更多盒子制作了
OpenWrt
系统,属于盒子圈的标杆,推荐使用。 - amlogic-s9xxx-armbian 项目提供了在盒子中使用的
Armbian
系统,在支持 OpenWrt 的相关设备中同样适用。 - rockchip-armbian 中提供了 Rockchip 的 Armbian 系统的制作、安装和使用方法。
The amlogic-s9xxx-openwrt © OPHUB is licensed under GPL-2.0