Getting Started with Alpine-Linux/zh

English

1 Alpine Linux 系统的简单介绍

Alpine Linux 是一个轻量级、基于 musl libc 和 busybox 的 Linux 发行版，专为安全性、简洁性和高效性设计。它的核心非常小巧，仅包含最基本的功能，适合嵌入式设备、容器（如 Docker）以及其他资源受限的应用场景。Alpine 的包管理器 apk 提供快速、简单的包安装和更新，支持广泛的软件包。

友善电子根据 Alpine Linux 系统的特点，提供了基于 GitHub Actions 构建的 Alpine Linux 系统镜像。用户可以直接下载并进行测试使用，也可以通过 fork 仓库，根据自身需求灵活定制系统。

2 支持的开发板

• RK3328
  
• RK3399
  
• RK3528
  
• RK3566
  
• RK3568
  
• RK3588
  

3 下载系统映像

你可以从这里下载到针对友善电子开发板，使用Github Action在线构建的Alpine Linux镜像：
https://github.com/friendlyarm/Actions-Alpine-Linux

用户根据所用开发板的CPU，选择下载适合的版本的镜像文件。
镜像文件以CPU型号开头（例如rk3568,rk3588)，文件名中的sd和eflasher代表文件的不同用途，其含义如下:

• sd: 安装系统到TF卡时使用
• eflasher: 需要通过TF卡烧写系统到eMMC时使用

4 安装Alpine Linux

4.1 通过TF卡运行系统

下载带 "-sd-" 字样的镜像文件，使用你熟悉的写卡工具将镜像文件写入TF卡，然后将TF卡插入开发板，上电启动开发板即可启动Alpine Linux系统。

4.2 烧写系统到eMMC

下载带 "-eflasher-" 字样的镜像文件，使用你熟悉的写卡工具将镜像文件写入TF卡，然后将TF卡插入开发板，上电启动开发板，会自动烧写系统到eMMC，烧写完成后，拨出TF卡会自动重启并进入eMMC中的Alpine Linux系统。
如果有连接HDMI显示器, 可通过图形界面观察烧写进度, 也可以通过板载LED灯来掌握烧写进度，以NanoPi-R5S/NanoPi-R3S/NanoPi-R5C为例，LED的行为如下：

进度	SYS灯 (红灯)	LAN灯(绿灯)	WAN灯(绿灯)
上电开机	长亮	灭	灭
系统启动	慢闪	灭	灭
正在烧写	快闪	灭	灭
烧写完成	慢闪	长亮	长亮

5 登录Alpine Linux

默认帐号:

用户名: root
密码: fa

有如下三种方法登录Alpine Linux:

• 串口：连接串口终端，使用如下设置：

Baud rate	1500000
Data bit	8
Parity check	None
Stop bit	1
Flow control	None

• HDMI：通过显示器连接，直接登录到 Alpine 系统。
• SSH：通过网络连接到设备后，可通过 SSH 登录。默认情况下，Alpine Linux 只配置了 eth0 网口。如果开发板有多个网口，请将网线连接到 WAN 口（某些开发板可能会标记为数字，请选择数字最小的网口）。

6 初始化设置

首次启动时，使用 setup-alpine 命令进行基本的系统设置，配置网络、时区、主机名等信息：

setup-alpine

7 安装软件包

Alpine 使用 apk 包管理器来安装软件包。你可以使用以下命令安装所需的软件包：

apk add <package_name>

例如，安装 vim 编辑器：

apk update
apk add vim

你可以通过修改 /etc/apk/repositories 文件配置软件包的源地址。

8 定制属于自已的 Alpine Linux 系统

• Fork 项目: 点击以下链接并点击右上角的 “Fork” 按钮，将项目复制到你的 GitHub 账户：

https://github.com/friendlyarm/Actions-Alpine-Linux

• 修改脚本文件 scripts/setup-alpine.sh，该文件用于初始化 Alpine Linux 系统。你可以通过修改该文件来自定义你的Alpine系统
• 修改仓库的权限，进入仓库的 Settings -> Actions -> General -> Workflow permissions, 修改选项为 “Read and write permissions”
• 触发 GitHub Actions 构建，默认是点击 Star 触发，你可以通过 GitHub 仪表盘查看构建进度和结果
• 构建完成后，你可以下载生成的定制 Alpine Linux 镜像，并将其用于安装到你的开发板上

9 Alpine Linux官方文档

更多详细的定制方法，请参考官方文档：
https://wiki.alpinelinux.org/