diff --git a/docs/dragon/q8b/other-system/armbian.md b/docs/dragon/q8b/other-system/armbian.md index 54dfafee6..377cfa5e1 100644 --- a/docs/dragon/q8b/other-system/armbian.md +++ b/docs/dragon/q8b/other-system/armbian.md @@ -1,67 +1,122 @@ --- sidebar_position: 1 +doc_kind: page --- -# Armbian +# 安装 Armbian 26 -Armbian 是一个面向 ARM 主板的轻量级 Linux 发行版,以稳定性、高性能和良好的硬件支持而闻名。它提供了针对各种 ARM 主板优化的 Debian 和 Ubuntu 基础系统。 +Armbian Imager 是 Armbian 官方推出的系统镜像下载与烧录工具,支持在线下载官方镜像,也可以写入本地镜像文件。工具会自动完成镜像下载、解压、写入及数据校验。 -Radxa Dragon Q8B 基于高通骁龙 8cx Gen 3(高通 SC8280XP)计算平台,支持运行 Armbian 系统。 +:::caution +烧录操作会清除目标存储设备中的全部数据。请提前备份重要文件,并仔细确认目标设备。 +::: -## 系统镜像下载 +## 连接目标设备 -Armbian 为 Radxa Dragon Q8B 提供多个版本的系统镜像,提供 Linux 内核 **vendor 7.0.11**(稳定版)与 **edge 7.1.8**(滚动版)两种内核线: +将需要烧录的存储设备连接至电脑。 -### 稳定版镜像 +:::tip +Armbian Imager 支持将系统直接烧录到 UFS 模块。将 UFS 模块安装到主板,使主板[进入 EDL 模式](../low-level-dev/edl-mode),再通过 USB 数据线连接电脑,然后选择对应的 UFS 系统镜像进行烧录。 +::: -Armbian 官方推荐、经过充分测试的稳定版镜像(Stable): +## 下载 Armbian Imager -- **Armbian 26.8.1 - Ubuntu 26.04 (Gnome 桌面版)**:基于 vendor 7.0.11 内核,完整桌面环境,适合日常使用 -- **Armbian 26.8.1 - Debian 13 (最小化版)**:基于 vendor 7.0.11 内核,轻量级系统,适合物联网应用 +访问 [Armbian Imager](https://imager.armbian.com/) 官网,下载与你的操作系统和处理器架构相匹配的版本,并完成安装。 -### 其他版本 +## 使用 Armbian Imager -除稳定版外,Armbian 还提供以下版本: +打开 Armbian Imager,点击 `Start now` 进入设备与镜像选择界面。 -- **桌面版**:Ubuntu 26.04 的 Cinnamon / Gnome / KDE Plasma 桌面环境 -- **最小化版**:Ubuntu 26.04 / Debian 13 最小化系统(含支持 UFS 存储的版本) -- **专用版本**:Kali Linux、Home Assistant、OpenMediaVault 等 + -:::tip -- 推荐使用 [Armbian Imager](https://www.armbian.com/imager/) 下载并烧录镜像。 -- 滚动版(edge 内核)仅适合有经验的 Linux 用户,不推荐在生产环境中使用。 +### 选择厂商 + +在厂商列表中选择 `Radxa`。 + + + +### 选择主板 + +选择需要安装系统的产品型号,本教程以 `Dragon Q8B` 为例。 + +:::note +请务必选择与实际硬件一致的型号,以确保镜像及启动配置正确。 ::: -下载地址:[Armbian Radxa Dragon Q8B 下载页面](https://armbian.com/boards/radxa-dragon-q8b) + + +### 选择镜像 + +选择需要安装的 Armbian 系统镜像。本教程以 Armbian Ubuntu 26.04 为例,具体可用版本以软件界面显示为准。 + +如果烧录目标为 UFS 模块,请选择适用于 UFS 的镜像,其镜像选项通常包含 `UFS` 标识。 + + + +### 选择本地镜像(可选) + +如果已经下载了系统镜像,可以选择 `Custom Image`,导入本地镜像文件。 + +选择本地镜像后,无需再选择厂商、主板及在线镜像,可直接进入目标存储设备选择步骤。 + + + +### 选择目标存储设备 + +选择需要写入系统的存储设备,并仔细核对设备名称和容量。 + +:::caution +所选设备中的原有数据将被全部清除,请勿误选电脑系统盘或其他重要存储设备。 +::: + + + +### 开始烧录 + +确认镜像和目标设备无误后,点击 `Erase & Flash`。Armbian Imager 将依次下载镜像(使用本地镜像时跳过)、解压镜像、擦除目标设备、写入系统镜像并校验写入数据。 + + + +### 完成烧录 + +出现 `Flash Complete!` 提示后,表示系统镜像已经成功写入并完成校验。 + + + +## 使用系统 + +若通过 EDL 模式将系统镜像烧录至 UFS 模块,烧录完成后,上电即可自动启动系统。 + +若系统安装在 microSD 卡或 NVMe SSD 中,请先将相应存储介质安装至主板对应插槽,再连接电源适配器,设备将自动启动系统。 + +### 设置 root 密码 + +首次启动系统后,根据提示为 root 用户设置密码。 + + + +### 选择系统终端 + +选择默认使用的命令行 Shell。 + + -## 烧录系统 +### 设置用户名和密码 -Armbian 镜像的烧录方法与 Radxa OS 一致,可以参考以下页面: +根据提示创建普通用户并设置密码。 -- [安装系统到 microSD 卡](../getting-started/install-system/sd-system) -- [安装系统到 UFS](../getting-started/install-system/ufs-system/) -- [安装系统到 NVMe](../getting-started/install-system/nvme-system/) + -## 首次启动配置 +### 设置地区和时区 -首次启动时,系统会引导您完成基本配置: +根据所在地区选择语言环境、国家和时区,并确认设置。 -1. 设置 root 密码 -2. 创建普通用户账户 -3. 确认语言设置 -4. (可选)将系统转移到内部存储 + -您也可以使用 `armbian-config` 工具进行系统配置,包括: + -- 网络设置(静态/动态 IP、热点) -- 更换登录 Shell(ZSH) -- 启用 SSH 双因素认证 -- 安装常用软件 -- 系统优化等 +### 系统界面 -## 相关资源 +完成系统设置后,会进入 Armbian 系统桌面。 -- [官方文档](https://docs.armbian.com/) -- [技术支持论坛](https://forum.armbian.com/) -- [问题反馈](https://www.armbian.com/bugs/) -- [常见问题](https://docs.armbian.com/User-Guide_FAQ/) + diff --git a/i18n/en/docusaurus-plugin-content-docs/current/dragon/q8b/other-system/armbian.md b/i18n/en/docusaurus-plugin-content-docs/current/dragon/q8b/other-system/armbian.md index 26bd38fbb..1a5c7ed17 100644 --- a/i18n/en/docusaurus-plugin-content-docs/current/dragon/q8b/other-system/armbian.md +++ b/i18n/en/docusaurus-plugin-content-docs/current/dragon/q8b/other-system/armbian.md @@ -1,67 +1,121 @@ --- sidebar_position: 1 +doc_kind: page --- -# Armbian +# Install Armbian 26 -Armbian is a lightweight Linux distribution for ARM motherboards, known for its stability, high performance, and excellent hardware support. It provides Debian and Ubuntu-based systems optimized for various ARM single-board computers. +Armbian Imager is the official image download and flashing utility from Armbian. It can download official images online or write a local image file. The utility automatically downloads, decompresses, writes, and verifies the image. -The Radxa Dragon Q8B is based on the Qualcomm Snapdragon 8cx Gen 3 (Qualcomm SC8280XP) compute platform and supports running Armbian. +:::caution +Flashing erases all data on the target storage device. Back up important files and carefully confirm the target device before continuing. +::: -## System Image Downloads +## Connect the Target Device -Armbian provides multiple system images for the Radxa Dragon Q8B, offering two kernel lines: **vendor 7.0.11** (stable) and **edge 7.1.8** (rolling): +Connect the storage device that you want to flash to your computer. -### Stable Release Images +:::tip +Armbian Imager can flash a system directly to a UFS module. Install the UFS module on the board, put the board into [EDL mode](../low-level-dev/edl-mode), connect the board to your computer with a USB cable, and then select the corresponding UFS system image. +::: -Official Armbian images that are hand-selected and well-tested (Stable): +## Download Armbian Imager -- **Armbian 26.8.1 - Ubuntu 26.04 (Gnome Desktop)**: Based on the vendor 7.0.11 kernel, full desktop environment for daily use -- **Armbian 26.8.1 - Debian 13 (Minimal)**: Based on the vendor 7.0.11 kernel, lightweight system for IoT applications +Visit the [Armbian Imager](https://imager.armbian.com/) website, download the version that matches your operating system and processor architecture, and install it. -### Other Images +## Use Armbian Imager +Open Armbian Imager and click `Start now` to open the board and image selection screen. -In addition to the stable releases, Armbian also provides: + -- **Desktop**: Ubuntu 26.04 with Cinnamon / Gnome / KDE Plasma desktop environments -- **Minimal**: Ubuntu 26.04 / Debian 13 minimal systems (including versions supporting UFS storage) -- **Dedicated applications**: Kali Linux, Home Assistant, OpenMediaVault, and more +### Select the Manufacturer -:::tip -- It is recommended to use [Armbian Imager](https://www.armbian.com/imager/) to download and flash images. -- Rolling releases (edge kernel) are only suitable for experienced Linux users and not recommended for production environments. +Select `Radxa` from the manufacturer list. + + + +### Select the Board + +Select the product on which you want to install the system. This guide uses `Dragon Q8B` as an example. + +:::note +Select the model that matches your actual hardware to ensure that the image and boot configuration are correct. +::: + + + +### Select the Image + +Select the Armbian system image that you want to install. This guide uses Armbian Ubuntu 26.04 as an example. Available versions may change; refer to the versions shown in Armbian Imager. + +If the target is a UFS module, select an image designed for UFS. These image options usually include a `UFS` label. + + + +### Select a Local Image (Optional) + +If you have already downloaded a system image, select `Custom Image` and import the local image file. + +After selecting a local image, you do not need to select a manufacturer, board, or online image. You can proceed directly to selecting the target storage device. + + + +### Select the Target Storage Device + +Select the storage device to which the system will be written, and carefully verify its name and capacity. + +:::caution +All existing data on the selected device will be erased. Do not select your computer's system drive or another important storage device. ::: -Download: [Armbian Radxa Dragon Q8B Download Page](https://armbian.com/boards/radxa-dragon-q8b) + + +### Start Flashing + +After confirming the image and target device, click `Erase & Flash`. Armbian Imager downloads the image (skipped for a local image), decompresses it, erases the target device, writes the system image, and verifies the written data. + + + +### Complete Flashing + +When `Flash Complete!` appears, the system image has been written and verified successfully. + + + +## Use the System + +If you flashed the system image to a UFS module through EDL mode, power on the board after flashing and the system will start automatically. + +If the system is installed on a microSD card or NVMe SSD, install the storage device in the corresponding slot on the board, and then connect the power adapter. The device will start automatically. + +### Set the Root Password + +At first boot, follow the prompts to set a password for the root user. + + + +### Select the System Shell + +Select the default command-line shell. + + -## Flashing the System +### Set the Username and Password -The Armbian images are flashed in the same way as Radxa OS. Please refer to the following pages: +Follow the prompts to create a regular user and set its password. -- [Install system to microSD card](../getting-started/install-system/sd-system) -- [Install system to UFS](../getting-started/install-system/ufs-system/) -- [Install system to NVMe](../getting-started/install-system/nvme-system/) + -## First Boot Configuration +### Set the Locale and Time Zone -On first boot, the system will guide you through basic configuration: +Select the locale, country, and time zone for your region, and then confirm the settings. -1. Set root password -2. Create a regular user account -3. Confirm language settings -4. (Optional) Transfer system to internal storage + -You can also use the `armbian-config` tool for system configuration, including: + -- Network settings (static/dynamic IP, hotspot) -- Change login shell (ZSH) -- Enable SSH two-factor authentication -- Install common software -- System optimization, etc. +### System Desktop -## Related Resources +After completing the initial setup, the Armbian desktop appears. -- [Official Documentation](https://docs.armbian.com/) -- [Technical Support Forum](https://forum.armbian.com/) -- [Bug Reports](https://www.armbian.com/bugs/) -- [FAQ](https://docs.armbian.com/User-Guide_FAQ/) + diff --git a/static/img/dragon/q8b/armbian/01-start-now.webp b/static/img/dragon/q8b/armbian/01-start-now.webp new file mode 100644 index 000000000..8c719b25b Binary files /dev/null and b/static/img/dragon/q8b/armbian/01-start-now.webp differ diff --git a/static/img/dragon/q8b/armbian/02-vendor-radxa.webp b/static/img/dragon/q8b/armbian/02-vendor-radxa.webp new file mode 100644 index 000000000..84a70418e Binary files /dev/null and b/static/img/dragon/q8b/armbian/02-vendor-radxa.webp differ diff --git a/static/img/dragon/q8b/armbian/03-board.webp b/static/img/dragon/q8b/armbian/03-board.webp new file mode 100644 index 000000000..b11839048 Binary files /dev/null and b/static/img/dragon/q8b/armbian/03-board.webp differ diff --git a/static/img/dragon/q8b/armbian/04-image.webp b/static/img/dragon/q8b/armbian/04-image.webp new file mode 100644 index 000000000..a65e1d749 Binary files /dev/null and b/static/img/dragon/q8b/armbian/04-image.webp differ diff --git a/static/img/dragon/q8b/armbian/05-custom-image.webp b/static/img/dragon/q8b/armbian/05-custom-image.webp new file mode 100644 index 000000000..4a29f05d7 Binary files /dev/null and b/static/img/dragon/q8b/armbian/05-custom-image.webp differ diff --git a/static/img/dragon/q8b/armbian/06-target-device.webp b/static/img/dragon/q8b/armbian/06-target-device.webp new file mode 100644 index 000000000..763395947 Binary files /dev/null and b/static/img/dragon/q8b/armbian/06-target-device.webp differ diff --git a/static/img/dragon/q8b/armbian/07-erase-flash.webp b/static/img/dragon/q8b/armbian/07-erase-flash.webp new file mode 100644 index 000000000..c072ab2f6 Binary files /dev/null and b/static/img/dragon/q8b/armbian/07-erase-flash.webp differ diff --git a/static/img/dragon/q8b/armbian/08-flash-complete.webp b/static/img/dragon/q8b/armbian/08-flash-complete.webp new file mode 100644 index 000000000..61b9d6531 Binary files /dev/null and b/static/img/dragon/q8b/armbian/08-flash-complete.webp differ diff --git a/static/img/dragon/q8b/armbian/09-root-password.webp b/static/img/dragon/q8b/armbian/09-root-password.webp new file mode 100644 index 000000000..72f6bfb3c Binary files /dev/null and b/static/img/dragon/q8b/armbian/09-root-password.webp differ diff --git a/static/img/dragon/q8b/armbian/10-shell.webp b/static/img/dragon/q8b/armbian/10-shell.webp new file mode 100644 index 000000000..c7590e1ae Binary files /dev/null and b/static/img/dragon/q8b/armbian/10-shell.webp differ diff --git a/static/img/dragon/q8b/armbian/11-user-password.webp b/static/img/dragon/q8b/armbian/11-user-password.webp new file mode 100644 index 000000000..05ef8fa14 Binary files /dev/null and b/static/img/dragon/q8b/armbian/11-user-password.webp differ diff --git a/static/img/dragon/q8b/armbian/12-locale-select.webp b/static/img/dragon/q8b/armbian/12-locale-select.webp new file mode 100644 index 000000000..385849ada Binary files /dev/null and b/static/img/dragon/q8b/armbian/12-locale-select.webp differ diff --git a/static/img/dragon/q8b/armbian/13-locale-confirm.webp b/static/img/dragon/q8b/armbian/13-locale-confirm.webp new file mode 100644 index 000000000..66f1682c5 Binary files /dev/null and b/static/img/dragon/q8b/armbian/13-locale-confirm.webp differ diff --git a/static/img/dragon/q8b/armbian/14-desktop.webp b/static/img/dragon/q8b/armbian/14-desktop.webp new file mode 100644 index 000000000..34b420480 Binary files /dev/null and b/static/img/dragon/q8b/armbian/14-desktop.webp differ