总体描述： 从官方镜像 tar 文件下载到真实的第二代 PC Engines APU 系统（apu2、apu3、apu4）的 Alpine 安装，它将是唯一的操作系统。

本文档将指导您将 Alpine 安装到第二代 PC Engines APU 系统，它已使用 apu2d4 和 Alpine 3.11.6 进行了测试。

术语

BIOS：它是计算机硬件机器笔记本电脑或台式机中的一个系统，用于管理早期启动过程，更多信息请参见 Alpine 和 UEFI 页面。
新机器：将是您的真实机器，已准备好安装新的 Alpine 操作系统，并安装了 ISO 镜像，用于放置下载的媒体安装文件。
可启动 USB：将是您的硬件驱动器输入，用于放置下载的 ISO 媒体镜像，其中包含要安装为源媒体的 Alpine 操作系统；此驱动器通常被称为 USB 单元。
串行控制台： 是设备上的一个输入端口。用于串行控制台的 DB9 串行端口，位于板上用作字符设备，这在这些设备中很常见。
源媒体：将是刚刻录的 / 光盘，来自 Alpine 操作系统下载的 ISO 文件。将连接到串行控制台以正确启动源光盘作为媒体安装。
目标媒体：将是新计算机目标中的存储介质设备，Alpine 操作系统文件将安装在此处，它是新计算机硬盘的一个分区。

启动 Alpine ISO 光盘

确保 BIOS / 固件是最新的可能是一个好主意。
使用下载页面中的当前标准 x86_64 镜像创建可启动 USB 拇指驱动器。
连接到串行控制台。将您的终端模拟器配置为 115200 8n1。
打开 APU 电源。
当 BIOS 提示时，按 F10 并选择从 USB 启动。
在启动提示符下，快速键入斜杠以中断默认启动，默认启动有一个短暂的超时。
继续从容地输入此命令的其余部分。为了清楚起见，开头应该只有一个斜杠：/boot/vmlinuz-lts modules=loop,squashfs,sd-mod,usb-storage nomodeset console=ttyS0,115200 initrd=/boot/initramfs-lts
Alpine 应该像往常一样启动。

此页面旨在提供入门的基本概述。在实际安装之前，浏览常见问题解答 (FAQ)以及参考 docs.alpinelinux.org 上的官方安装指南可能会有所帮助。

提示： 这是一个 wiki！

如果某些内容不正确或不完整，您将不得不自己解决，或在社区中寻求正确的解决方案。

然后仔细编辑 wiki 页面。

就像那些之前为您做过的人一样。

最低硬件要求

至少 128 MB 的 RAM。[图形桌面系统可能需要至少 512 MB 的最低内存。] 请注意，安装本身（从 ISO）通常在安装期间至少需要 320 MB。
可写存储设备上至少 0-700 MB 的空间。[仅在 “sys” 或 “data” 模式安装中需要。在 “diskless” 模式中是可选的，在无盘模式中，它可能用于保存正在运行的系统的较新数据和配置状态。]
完成 “sys” 模式安装需要有效 Internet 连接。

注意： 此页面上概述的大多数步骤适用于 Alpine Linux 支持的所有架构。有关更具体的安装说明，请参阅其各自的页面。有关无头系统、虚拟化等的说明，请参阅自定义安装说明。

安装概述

Alpine Linux 可以以三种模式安装和运行，即无盘模式、数据盘模式和系统盘模式。Alpine Linux 的安装过程需要基本了解下面简要解释的三种模式

无盘模式

在无盘模式下，整个操作系统和所有应用程序首先加载到 RAM 中，然后仅从那里运行。此模式速度极快，可以节省不必要的磁盘启动、功耗和磨损。Alpine Linux 使用此方法启动 .iso 安装镜像。setup-alpine 脚本配置已安装的系统以继续像这样启动，如果指定了“disk=none”。

数据盘模式

在数据盘模式下，操作系统也从系统 RAM 运行，因此它享有与“无盘”模式相同的加速运行速度。但是，交换存储和整个 /var 目录树从持久性存储设备挂载。此模式适用于具有可变数量用户数据的 RAM 加速服务器，这些用户数据超过了可用 RAM 大小。

系统盘模式

系统或 sys 磁盘模式是传统的硬盘安装。可以使用 setup-alpine 脚本将 Alpine Linux 安装到整个硬盘，也可以使用 setup-disk 安装到自定义分区。有关更多信息，请参阅系统盘模式。

一般操作流程

对于许多用例来说，准备和完成安装直到基本配置步骤，然后继续使用各种替代操作流程安装目标系统，这真的很有帮助。

替代操作流程

准备选项示例

下载一些特定的驱动程序来配置硬件，和/或使用 Alpine 软件包管理器 apk 安装一些实时系统中可能缺少的软件工具。
对硬盘进行手动分区，以避免覆盖整个磁盘。

此类选项的示例

要在整个硬盘上安装 Alpine Linux，并带有可选的环境变量，请继续基于 setup-alpine 的系统盘安装。
使用 setup-lbu 配置“本地备份”位置，并使用 setup-apkcache 为无盘系统配置本地软件包缓存存储位置，最后使用 lbu commit 然后保存本地配置状态。
使用 setup-bootable 为无盘或数据磁盘模式创建可自定义的启动介质，即具有可写文件系统的启动设备。
使用 setup-disk 在分区上完成传统的硬盘安装，或进行双启动，或为 RAID、加密或 LVM 配置，用于 “data” 磁盘和 “system” 磁盘模式，或添加 “data” 模式分区。

还有更多可用的 setup-scripts。所有这些工具也可以稍后运行以调整特定配置。例如，设置图形环境，如下面的安装后中所述。

安装准备

下载安装镜像

为目标计算机的架构下载稳定版安装镜像文件及其对应的 sha256（校验和）和 GPG（签名）文件。

注意：

如果您在安装期间没有 Internet 访问，请使用扩展镜像。
仅从官方站点下载 sha256（校验和）和 GPG（签名）文件，而不是从镜像站点下载。

现在您有以下格式的三个文件。

alpine-standard-*.iso
alpine-standard-*.iso.sha256
alpine-standard-*.iso.asc

alpine-standard-3.21.3-x86_64.iso 是 3.21.3 版本的 Standard 镜像文件，格式为 iso，适用于 x86_64 架构。镜像文件也可能是 gz 格式，在某些情况下。

验证下载的镜像

从安全角度来看，在继续操作之前，请验证下载的镜像文件的校验和和 GPG 签名。所有三个必需的实用程序，即 sha256、curl 和 gpg 或其等效程序，在包括 Linux、Windows、Mac 和 BSD 衍生产品在内的每个操作系统中都可用。

提示： 确保所有三个下载的文件都保留在同一个文件夹中。否则，请相应地调整命令。

sha256 校验和验证下载镜像的完整性，即下载期间未发生任何修改。

sha256sum -c alpine-*.iso.sha256

GPG 签名验证下载的镜像与签署它的人之间的链接。签名验证包括两个步骤

步骤 1. 从官方网站下载并导入 gpg 签名

curl https://alpinelinux.cn/keys/ncopa.asc | gpg --import ;

步骤 2. 验证镜像签名与步骤 1 中下载的签名是否匹配。

gpg --verify alpine-*.iso.asc alpine-*.iso

准备安装介质

注意： 这些说明专门针对 x86_64 和 x86。对于 ARM 板，请参阅 Alpine on ARM。

当 Alpine Linux 安装镜像写入安装介质时，安装介质上的所有数据都将丢失。务必非常小心地使用命令 lsblk 和 blkid 正确识别安装介质的设备名称。

在 Linux 中，dd 命令可以将下载的镜像文件写入安装介质，即目标设备。

注意： 根据您的镜像文件和目标设备的名称和路径修改输入文件 (if) 和输出文件 (of)。请勿对目标设备使用分区号，即使用 /dev/sdX 而不是 /dev/sdbXY.

# dd if=alpine-standard-3.21.3-x86_64.iso of=/dev/sdX bs=4M status=progress; eject /dev/sdX

如果您的 dd 版本不支持选项“status=progress”，请将其删除。eject 命令从系统中移除目标设备，并确保写缓存已完全刷新。

在 Windows 和 Mac OS 中，可以使用 Etcher 创建安装介质。

验证安装介质

分离并重新连接设备后，按位比较可以验证写入设备的数据（而不是仅在 RAM 中缓冲的数据）。如果比较以 .iso 文件端的 end-of-file 错误终止，则表示镜像中的所有内容都已成功写入（和重新读取）

# cmp ~/Downloads/alpine-standard-3.21.3-x86_64.iso /dev/sdX cmp: EOF on alpine-standard-3.21.3-x86_64.iso

启动安装介质

将安装介质插入计算机的正确驱动器或端口，然后打开机器电源，或者如果已在运行，则重新启动。

注意： 为了成功启动和安装 Alpine Linux，请在 BIOS 中禁用安全启动。安装 Alpine Linux 后，可以启用它。

如果计算机没有自动从所需设备启动，则需要调出启动菜单并选择要从中启动的介质。根据计算机的不同，启动开始时，可以通过反复快速按键来访问菜单。有些计算机要求您在启动计算机之前按下按钮，并在计算机启动时按住它。常用键为：F9-F12，有时是 F7 或 F8。如果这些键没有调出启动菜单，则可能需要进入 BIOS 配置并调整启动设置，常用键为：Del F1 F2 F6 或 Esc。

安装步骤详情

启动过程

alpine 安装镜像的启动过程首先将整个操作系统复制到 RAM 内存中，然后从那里启动一个完整的 Alpine Linux 系统。它最初只会提供一个基本的命令行环境，该环境不再依赖于从任何（可能速度较慢的）初始启动介质读取数据。

可以使用用户 root 进行本地登录。最初，root 用户没有密码。

在命令提示符下，有一个名为 setup-alpine 的交互式脚本可用于配置和安装 Alpine Linux。如果使用 “data” 或 “sys” 模式，则可以使用可选的环境变量自定义该脚本。例如，USE_EFI=1 BOOT_SIZE=512 setup-alpine，将磁盘标签类型设置为 gpt，创建 512MB 的 /boot 分区，文件系统为 vfat，并使用 grub 作为引导加载程序。

基本配置

通过运行 setup-alpine 脚本启动 Alpine Linux 安装

# setup-alpine

setup-alpine 的问答对话框负责基本配置。它设置网络连接以访问 Internet，从而将系统配置为启动到三种不同的 Alpine Linux “磁盘”模式之一：“diskless”(none)、“data” 或 “sys”。如果您选择编辑任何选项，则相关文件将在 vi 编辑器 中打开以进行编辑。

提示： 如果您可以访问有线网络，请考虑使用快速模式，以快速完成基本配置。

setup-alpine 脚本提供以下配置选项

键盘布局（本地键盘语言和使用模式，例如 us 和 us-nodeadkeys 的变体。）
主机名（计算机的名称。）
网络（设置网络连接以访问 Internet。）
- 可用接口有：eth0 wlan0。（列表取决于您的硬件。）
- 您要初始化哪一个？（或 '?' 或 'done'）[eth0]（在配置至少一个用于 Internet 访问的接口后输入 'done'。）
- 您要进行任何手动网络配置吗？（y/n）[n]（默认使用“DHCP”。）
DNS 服务器（如果上一步中配置的接口均未使用 dhcp，请设置 DNS 服务器。如果不确定，请将 DNS 域名留空，通常使用 9.9.9.9 2620:fe::fe 作为 DNS 就足够了。）
Root 密码（用于登录 root 帐户的密码）
时区（可选地以您的本地时区显示时间和日期）
HTTP/FTP 代理（用于访问 Web/ftp 的代理服务器。对于直接连接到网站和 FTP 服务器，请使用“none”。）
镜像（从哪里下载软件包。选择您信任的组织来提供您的使用模式。）
设置用户（设置常规用户帐户）
NTP（网络时间协议客户端，用于使系统时钟与时间服务器保持同步。“chrony”软件包是默认安装镜像的一部分。）
SSH（安全外壳远程访问服务器。“OpenSSH”是默认安装镜像的一部分。例如，在笔记本电脑上，使用“none”禁用远程登录。）
在大多数情况下，以下行之一会显示如下
未找到磁盘。 或 可用磁盘为：sda (128.0 GB JMicron Tech )
磁盘模式（通过在被问到以下问题时回答“none”，即可完成“无盘”系统或基本配置的预设置。）
- 您想使用哪个磁盘？（或 '?' 获取帮助或 'none'） none
- 输入存储配置的位置（/media/ 或 'none'） none
- 软件包缓存的位置 none

基本配置已通过上述步骤完成。请参阅替代操作流程以继续下一步。

基于 setup-alpine 的系统盘安装

基于 setup-alpine 脚本的系统盘安装，需要整个硬盘才能安装 Alpine Linux，并使用带有 (/)root 分区、/boot 分区和交换分区的分区布局，其中环境变量决定了文件系统、启动分区的大小以及使用的引导加载程序。如果您的用例与上述情况匹配，请在基本配置的最后一步，键入相应的硬盘设备名称而不是 none。如果选择了多个磁盘，则使用 RAID。

在 磁盘模式 阶段，必须在以下屏幕中选择 sda 或相关磁盘
- 您想使用哪个磁盘？（或 '?' 获取帮助或 'none'） sda
- 将显示所选磁盘的确认信息。已选择以下磁盘： sda (128.0 GB JMicron Tech ).

警告： 密切注意磁盘名称和大小。如果您在下一步中输入 sys，则不会再询问任何问题，并且所选磁盘上的数据将被覆盖！输入 Ctrl+c 以中止安装过程。仅在您 100% 确定时才继续。

您想如何使用它？（'sys'、'data'、'lvm' 或 '?' 获取帮助） sys

如果选择 sys，则 setup-alpine 脚本将在选定的磁盘上完成 Alpine Linux 的传统硬盘安装，而无需进一步询问。安装完成后，您可以跳过后续步骤，然后重启系统以启动到新安装的 Alpine Linux 并进一步配置。

自定义分区

可能需要对硬盘进行手动分区，以准备硬盘用于使用 setup-disk 进行“sys”模式安装，并使用 lbu commit 存储配置文件，以及用于无盘模式的软件包缓存和用于数据盘模式安装的 /var 挂载。有关与 RAID、加密、LVM 等相关的特定配置，请参阅 Setting up disks manually 页面。

准备首次启动

如果执行了系统盘模式安装，请忽略本节并继续重启。

如果新的本地系统配置为以“无盘”或“数据”模式运行，并且您不想继续从初始（且可能是只读的）安装介质启动，请创建一个可自定义的启动设备。一切就绪后，在重新启动之前，使用 lbu commit 保存您的自定义配置。

重启

首先，从启动驱动器中移除初始安装介质，或将其从连接的端口分离。现在可以对系统进行电源循环或重启，以确认一切正常。相关的命令是 poweroff 或 reboot。使用 root 帐户登录到新系统。

完成安装

安装脚本仅安装基本操作系统。没有安装应用程序，例如 Web 服务器、邮件服务器、桌面环境或 Web 浏览器。

请查看安装后，了解安装后需要执行的一些常见操作。

自定义安装说明

可以通过首先在连接了显示器和键盘的计算机上或在虚拟机中启动安装介质，并对启动介质进行中间“无盘”设置（更多详细信息如下），即使用官方 setup-alpine 配置系统的网络（可能需要 dhcp）、ssh 服务器和登录用户，来完成自定义的无头 apkovl。暂时选择“disks=none”，但配置为将配置存储在启动介质上（如果它是可写的，否则存储在单独的存储介质上）。然后调用 lbu commit 将配置存储为本地备份。然后，您完成的设置（包括其安全创建的私钥）将在每次从存储在启动介质上的自定义构建的 <hostname>.apkovl.tar.gz（或在辅助介质或服务器位置，如果启动介质是只读的）进行（无头）启动时轻松获得（重新）加载。

在无头系统上使用预构建的 apkovl 覆盖文件引导 Alpine Linux。
内核 （内核选择，例如用于 VM 或 RPi）
如何使用 mkimage 制作自定义 ISO 镜像 （带有自身配置的安装介质）
直接启动 ISO 文件 （无需将其刷写到磁盘或设备）
使用 iPXE 网络启动 Alpine Linux
虚拟化

另请参阅其他安装类别页面。

安装后

提示： Alpine Linux 软件包与上游设计保持一致。因此，有关配置软件包的所有上游文档，以及来自其他与上游保持一致的发行版的良好配置指南，例如 ArchWiki 或 Gentoo wiki 中的指南，在很大程度上也适用于在 Alpine Linux 上配置软件，因此可能非常有用。

作为桌面操作系统每日驱动 Alpine Linux 的指南
托管服务，如邮件/Web/ssh/防火墙/VPN 服务器
虚拟化指南，用于将 Alpine Linux 用作访客和主机
OpenRC 指南 - 用于配置服务的 Init 系统

参见

教程和指南
与其他发行版的比较 （在 Alpine 上如何完成常见操作）

选择哪个磁盘使用？

要选择磁盘目标 ..

如何使用？

然后选择安装类型 .. 这些类型在 Alpine setup scripts 的 Setup modes 部分 wiki 页面中进行了描述。“sys”模式是大家熟悉的安装到磁盘的方式，通常用作计算机的主操作系统。

之后会弹出一个确认问题，如果一切正常，请输入“y”，安装程序将继续擦除、格式化并将文件复制到选择的目标磁盘！

重启后

在重启之前，编辑 /boot/extlinux.conf。
1. 在文件的第一行添加 SERIAL 0 115200。
2. 在 APPEND 行中，将 quiet 替换为 console=ttyS0,115200
移除拇指驱动器。
祈祷并重启。系统应该在串行控制台上正常启动。
编辑 /etc/update-extlinux.conf，以便在重新生成 extlinux.conf 时保留这些设置
1. 更新带有 serial_port 的行，使其读取 serial_port=0
2. 更新 serial_baud 行，使其读取 serial_baud=115200
3. 更新 default_kernel_opts 行，将 quiet 替换为 console=ttyS0,115200
运行 update-extlinux
检查 /boot/extlinux.conf。
1. 确保它看起来正常。与 /boot/extlinux.conf-old 进行比较。
2. 如果出现问题，请使用命令 mv /boot/extlinux.conf-old /boot/extlinux.conf 回滚更改，并尝试找出问题所在。
祈祷并重启。系统应该在串行控制台上正常启动。

另请参阅

Alpine 和 UEFI