龙芯 Alpine Linux FAQ

1. Alpine Linux 在龙芯平台有哪些版本选择？

龙架构已随 Alpine 社区陆续发布了 v3.21、v3.22、v3.23 和 v3.24 四个系列稳定版本。

各版本的发布时间及所集成的内核版本情况如下：

版本	发布时间	发布时内核版本
Alpine Linux v3.21	2024/12/5	6.12.10
Alpine Linux v3.22	2025/05/30	6.12.31
Alpine Linux v3.23	2025/12/3	6.18.0
Alpine Linux v3.24	2026/06/09	6.18.42

龙芯将携手 Alpine 社区继续演进和完善龙芯架构发行版，更多发布信息请关注 Alpine 官网。

2. 龙芯 Alpine Linux 发布件有哪些？

官方为龙架构发布了 Minirootfs 和标准 ISO。

更多发布件信息查询：Alpine Linux 官方 mirror

3. 在哪里获取龙芯 Alpine docker 镜像？

龙芯 Alpine docker 镜像可以从两种途径获取。

a. 途径一：从 Alpine 私有仓库 registry.alpinelinux.org 中获取

版本 tag 标记为 3.21, 3.22, 3.23，3.24 及 latest，执行以下命令：

docker pull registry.alpinelinux.org/img/alpine:tag

b. 途径二：从龙芯容器镜像仓库获取

以拉取 3.24.0 版本为例，执行以下命令：

docker pull lcr.loongnix.cn/library/alpine:3.24.0

龙芯容器仓库中有更多的 Alpine 版本选择，可通过以下地址查看： https://lcr.loongnix.cn/repository/library/alpine?tab=tags

4. Alpine 软件仓库、发行版本间对应关系？

Alpine 目前存在三个软件仓库：
- main 仓库：官方支持的软件包，这些软件包包含在基本系统中。
- community 仓库：已经过测试的软件包。
- testing 仓库：需要测试的新增、损坏或过时的软件包，仅在 edge 版本中可用。
Alpine 有两种发布版本：
- 稳定版（stable）（例如 3.24）：每 6 个月发布一次，支持包括针对特定功能版本的安全补丁。每个稳定版都有自己的 main 仓库和 community 仓库。 main 仓库的支持期限为 2 年。community 仓库的支持期限仅为相应版本发布后的 6 个月。当 main 仓库的支持到期时，该版本即被视为 EOL（生命周期结束）。
- edge 版本（edge）：滚动发布分支，也可理解为开发分支。包含从 aports 仓库 master 分支构建的最新软件包。它不如发布分支稳定，但足以满足日常使用，并且适用于开发或需要最新软件的情况。它与 stable 版本一样，拥有自己的 main 仓库和 community 仓库。此外，它还包含 testing 仓库，也显著增加了可用软件包的数量。

5. 如何为龙芯 Alpine 配置软件源？

软件仓库可以在 /etc/apk/repositories 文件中配置。每一行对应一个软件仓库。编辑 /etc/apk/repositories，默认仓库源为 Alpine 社区仓库源，建议使用清华、阿里云等国内镜像加速。

配置方法：
a. 编辑 /etc/apk/repositories
b. 使用阿里源，将里面 dl-cdn.alpinelinux.org 改为 mirrors.aliyun.com；使用清华源，则改成 mirrors.tuna.tsinghua.edu.cn。
c. 保存退出即可

6. 在哪里可以找到 Alpine 龙芯的代码和补丁？

Alpine 的源码位于 gitlab.alpinelinux.org，主项目为 aports，Alpine 系统中大部分软件包都源自软件官方上游直接构建，部分软件的龙芯补丁提交至 Alpine 的 aports 项目中。可拉取 aports 项目，通过 git log 查看关于 loongarch64 的提交历史信息，也可到具体软件目录下查看补丁内容。

步骤如下：

git clone https://gitlab.alpinelinux.org/alpine/aports.git
cd aports && git log

以查看 musl 补丁为例：

cd aports/main/musl
ls

通过 ls 命令即可查看 loongarch64 相关的补丁。

7. 如何为龙芯架构编译 Alpine 软件包？

通常在 Alpine 环境中编译 alpine 软件包，使用 abuild 工具。abuild 是 Alpine Linux 的包构建工具，用于构建 Alpine 软件包。常用方式：

abuild -r  # 构建并打包

8. 如何为 Alpine 龙芯版报告 bug？

一般可通过以下两种方式报告 bug：

a. 在 IRC #alpine-loongarch、#alpine-devel 或 #alpine-linux 频道发布 loongarch64 相关问题。
b. 创建 bug work items，可以在 aports 项目下创建 work items 以便于跟踪，请尽可能附上 loongarch64 信息、bug 日志信息、dmesg、apk 等全貌信息，以便我们更快的复现并为您解决。

建议优先通过创建一个 issue 的方式记录问题，同时在 IRC 频道中跟进。

9. 龙芯版 Alpine 的 Docker 镜像如何构建？

基于 minirootfs 可构建自己的龙芯容器镜像。

一个简单的 Dockerfile 示例：

FROM scratch
ADD alpine-minirootfs-v3.24.1-loongarch64.tar.gz /
CMD ["sh"]

您可根据自己的需求丰富 Dockerfile 的内容，最后通过 docker 命令构建镜像：

docker build -t alpine:3.24.1 .

Alpine