menu E4b9a6's blog
rss_feed
E4b9a6's blog
有善始者实繁，能克终者盖寡。

X96MaxPlus刷ArmbianLinux系统

作者：E4b9a6， 创建：2023-06-11， 字数：7515， 已阅：234， 最后更新：2025-02-10

1. 前言

之前买了一个外贸电视盒子X96 Max Plus，由于各种原因闲置了很长一段时间，于是考虑了下，给盒子刷了 Armbian 用于做旁路由

X96 Max Plus 电源是没有转换模块的，不可以使用 5V2A 以外的电源接入，否则大概率损坏电源导致黑砖，维修要 30 元

X96 Max Plus 的硬件配置如下：

处理器 RAM ROM 接口
S905X2 4G 64G 千兆网卡x1，usb2.0x1，usb3.0x1，内存卡插槽

这个配置刷入 Armbian 系统后跑 Docker/Qbittorrent 都是比较轻松的，系统可以刷入内置分区做到完美启动，实测 100 天没有不稳定重启的情况出现

要注意有 X96 Max 和 X96 Max Plus 2 个版本，刷入的方法是不一样，本文是基于 X96 Max Plus 刷入，以下简称 XMP

2. 安装 ArmBian Linux

安装不难，但过程比较折腾，一不小心就容易砖了，又不好重装，因为ARM大部分设备不像X86设备，出了问题往往是引导就进不去了，所以刷入过程务必谨慎小心

如刷入失败，可以参考使用Usb Tools工具来救活（救砖可看文末）

2.1. 材料准备

首先是要下载适合 XMP 的系统，这里直接从 ArmBian 官网地址下载

Armbian 官网的版本与 Ubuntu 发行版对应如下：

版本 对应
Bionic Ubuntu Bionic 18.04(LTS)
Disco Ubuntu Disco
Focal Ubuntu Focal 20.04, no end-user support
Stretch Debian Stretch (oldstable),limited support
Buster Debian Buster (stable)
Bullseye Debian Bullseye, no end-user support

如果需要 GUI 桌面可选择带 Desktop 关键词的版本，我选择的是Debian Buster (stable) 版本，文件名是 Armbian_20.10_Arm-64_buster_current_5.9.0.img.xz

XMP 的 ArmBian 系统存在 2 个问题，一个是网卡驱动是百兆的，一个是Bootloader有问题

所以需要给下载的ArmBian系统引入3个文件来解决这个问题，三个文件分别是

  • meson-sm1-x96-max-plus-100m.dtb
  • meson-sm1-x96-max-plus.dtb
  • hk1box-bootloader.img

可根据上述文件名自行Google获取下载地址

这里提供一个备份下载：

2.2. 制作U盘镜像

需要的文件准备妥善之后就可以制作启动U盘了，首先将 Armbian_20.10_Arm-64_buster_current_5.9.0.img.xz 解压并写入U盘

Bash
xz -d Armbian_20.10_Arm-64_buster_current_5.9.0.img.xz
sudo dd if=Armbian_20.10_Arm-64_buster_current_5.9.0.img of=/dev/sdb status=progress

Windows操作系统可借助 rufus/imagewrite 等工具写入U盘，效果是一样的

写入完成后，弹出 U 盘后重新插入 U 盘

接下来打开 BOOT 驱动器

在 BOOT 驱动器内，将 u-boot-s905x2-s922 文件重命名成 u-boot.ext

在 BOOT 驱动器内，打开 dtb/amlogic/ 文件夹，将 meson-sm1-x96-max-plus-100m.dtb 和 meson-sm1-x96-max-plus.dtb 放入其中

在 BOOT 驱动器内，修改 /boot/extlinux/extlinux.conf 文件如下：

Bash
LABEL Armbian
LINUX /zImage
INITRD /uInitrd
FDT /dtb/amlogic/meson-sm1-x96-max-plus-100m.dtb
APPEND root=LABEL=ROOTFS rootflags=data=writeback rw console=ttyAML0,115200n8 console=tty0 no_console_suspend consoleblank=0 fsck.fix=yes fsck.repair=yes net.ifnames=0

FDT 采用 meson-sm1-x96-max-plus-100m.dtb 才能在系统安装阶段启动网卡

最后打开 ROOTFS 驱动器，将 hk1box-bootloader.img 放入其中，这样一个 Armbian 的系统镜像就制作完成了

2.3. 替换bootloader

XMP 的启动方式有两种，分别是 adb 启动和硬启动，无论哪一种，都要提前插入制作完的 U 盘

adb 方法：

  • 打开XMP的设置，打开开发者选项，允许usb调试
  • 连接机器的网线（Wifi也可以，但重启到U盘之后是没有Wifi的，所以建议还是用网线操作）
  • 连接 adb connect 192.168.1.100 （IP 从路由器分配表中查看）
  • 执行 adb shell 进入命令模式
  • 执行 su 获得超级管理员权限
  • 执行 reboot update 进入引导模式

硬启动方法：

  • 断开电源，找一根牙签
  • 戳中AV孔，里面有一个小按钮，戳中按钮后接入电源
  • 看到启动画面即可松开

等待开机加载后，第一次启动会要求输入Root用户的密码，请自行设置密码

2.4. 写入bootloader

在启动成功后，我们先刷入事先准备好的 Bootloader

Bash
dd if=/root/hk1box-bootloader.img of=/dev/mmcblk2 bs=1 count=442
dd if=/root/hk1box-bootloader.img of=/dev/mmcblk2 bs=512 skip=1 seek=1
sync
shutdown now

等待关机，关机后断开电源，拔出U盘，将U盘插入PC中，打开 BOOT 驱动器修改BOOT分区中 extlinux/extlinux.conf 文件，全量替换为以下内容：

Bash
LABEL Armbian
LINUX /zImage
INITRD /uInitrd
FDT /dtb/amlogic/meson-sm1-x96-max-plus.dtb
APPEND root=LABEL=ROOTFS rootflags=data=writeback rw console=ttyAML0,115200n8 console=tty0 no_console_suspend consoleblank=0 fsck.fix=yes fsck.repair=yes net.ifnames=0

这里替换了 FDT 的内容，这样安装后的 XMP 就是千兆网卡的驱动

修改后保存，然后弹出U盘并插入 XMP 中，无需再按AV孔，直接插入电源即可

2.5. 更换网卡驱动并写入系统

启动之后，直接运行刷写系统的脚本即可

Bash
bash /root/install-aml.sh

3. 简单初始化

安装完成后，使用SSH进入系统，更新操作系统

Bash
sudo apt update

3.1. Oh-My-Zsh

安装ZSH并切换到Oh-My-Zsh

Bash
sudo apt install zsh
chsh -s /bin/zsh
wget https://github.com/robbyrussell/oh-my-zsh/raw/master/tools/install.sh
bash ./install.sh

3.2. Docker

Docker容器可以极大的扩展ARM设备的运行场景，ARM设备现在也支持官方脚本直接安装Docker

Bash
curl -fsSL https://get.docker.com -o get-docker.sh
bash get-docker.sh --mirror Aliyun

有 Docker 的加持，再搭配 4G+64G 的硬件配置可以运行很多容器了

3.3. Openwrt

ARM 设备的低功耗很合适跑 openwrt，在 Docker 中安装 Openwrt 比较复杂，XMP 是单网口只能考虑做旁路由

首先需要做一些网络环境的准备工作，这里假定网络环境信息如下

  • XMP IP：192.168.1.10/24
  • 主路由器IP：192.168.1.1/24
  • OpenwrtIP：192.168.1.100/24
  • Openwrt Docker虚拟网卡名称：macvlan

以下配置是根据上面列出的网络信息进行配置，具体实践需要参考自己的网络环境自行配置

首先编辑 /etc/network/interfaces 设置静态 IP：

Bash
source /etc/network/interfaces.d/*

# Wired adapter #1
allow-hotplug eth0
no-auto-down eth0
#iface eth0 inet dhcp
iface eth0 inet static
address 192.168.1.10
netmask 255.255.255.0
gateway 192.168.11.1
dns-nameservers 223.5.5.5

...

然后打开 XMP 网卡的混杂模式，再创建 Docker 的 macvlan 接口：

Bash
sudo ip link set eth0 promisc on
sudo docker network create -d macvlan --subnet=192.168.1.0/24 --gateway=192.168.1.1 -o parent=eth0 macnet

检查创建的结果：

Bash
$ sudo docker network ls
NETWORK ID     NAME      DRIVER    SCOPE
8fdad37c414a   bridge    bridge    local
692be2914400   host      host      local
e6aeaf2d3d0e   macnet    macvlan   local
d7f7cea61064   none      null      local

网络基础配置完成后，拉一个 Openwrt 的镜像（2 选 1）：

不对任何 openwrt 镜像的安全性负责，请斟酌使用或者自己寻找信得过的镜像

第三方 Openwrt 的镜像请注意网络安全，谨防财产损失

以运行 buddyfly/openwrt-aarch64 容器为例：

Bash
sudo docker run --restart always --name openwrt -d --network macnet --privileged buddyfly/openwrt-aarch64:latest

进入容器内部并修改 /etc/config/network ， 如下：

TEXT
config interface 'lan'
        option type 'bridge'
        option ifname 'eth0'
        option proto 'static'
        option ipaddr '192.168.1.100'
        option netmask '255.255.255.0'
        option ip6assign '60'

...

重启网络：

Bash
/etc/init.d/network restart

访问 http://192.168.1.100 ，进入 openwrt 后台管理页面

在后台管理页面中调整：

  • 网络-防火墙-基本设置-防火墙区域设置-转发，更改为 接受
  • 网络-防火墙-基本设置-自定义规则，填入 iptables -t nat -I POSTROUTING -j MASQUERADE
  • 网络-接口-lan-修改界面-基本设置，网管设置 192.168.1.1，DNS 设置填入 192.168.1.1，DHCP 服务器勾选忽略，取消桥接 eth0 接口

保存以上设置后刷新页面

注意：如果刷新后后无法打开页面，进入容器内部查看network配置对比下面的配置，尤其是 _orig_ifname 与 _orig_bridge 配置是否存在

正常的文件参考如下：

Bash
config interface 'loopback'
        option ifname 'lo'
        option proto 'static'
        option ipaddr '127.0.0.1'
        option netmask '255.0.0.0'

config globals 'globals'
        option ula_prefix 'fd13:c13b:3718::/48'

config interface 'lan'
        option proto 'static'
        option netmask '255.255.255.0'
        option ipaddr '192.168.1.100'
        option gateway '192.168.1.1'
        option dns '192.168.1.1'
        option _orig_ifname 'eth0' # Openwrt有时保存后会丢失该项，可手动填入并重启网络
        option _orig_bridge 'true' # Openwrt有时保存后会丢失该项，可手动填入并重启网络
        option ifname 'eth0'

4. 救砖

如果不幸刷入失败，机器无法正常启动或开机画面闪烁，无法正常引导到U盘中，那只能刷入出厂固件

准备：

固件下载后必须放在盘符根目录下面，刷回原厂系统步骤如下：

  1. 打开 Usb Burning Tool，选择 file->import image 导入下载固件
  2. 选择擦除 flash、擦除 Bootloader，点 Start
  3. XMP 接入 PC，再接入电源会自动开始刷机

5. 引用

参考如下

[[replyMessage== null?"发表评论":"发表评论 @ " + replyMessage.m_author]]

account_circle
email
web_asset
textsms

评论列表([[messageResponse.total]])

还没有可以显示的留言...
gravatar
[[messageItem.m_author]] [[messageItem.m_author]]
[[messageItem.create_time]]
[[getEnviron(messageItem.m_environ)]]
[[subMessage.m_author]] [[subMessage.m_author]] @ [[subMessage.parent_message.m_author]] [[subMessage.parent_message.m_author]]
[[subMessage.create_time]]
[[getEnviron(messageItem.m_environ)]]