archlinux Docker镜像文档

镜像概述和主要用途

immawanderer/archlinux 是一个基于 Arch Linux 的 Docker 基础镜像，旨在提供持续更新的系统环境。该镜像每晚自动重建，确保包含 Arch Linux 官方仓库中的最新软件包，适用于作为依赖最新 Arch Linux 环境的应用、服务或开发工作流的基础镜像。

核心功能和特性

• 每晚自动更新：镜像每日夜间重建，确保集成 Arch Linux 官方仓库的最新软件包，保持环境时效性和安全性。
• 基础精简架构：基于 Arch Linux 官方基础配置，仅包含核心系统组件，适合作为上层应用的轻量级基础环境。
• 多平台支持：提供 linux-amd64 架构支持（可通过镜像标签指定）。

使用场景和适用范围

• 开发与测试环境：需要基于最新 Arch Linux 依赖进行应用开发、调试或测试的场景。
• CI/CD 工作流：作为持续集成/部署流程中的基础镜像，确保构建和测试环境使用最新系统包。
• 轻量级服务运行：运行依赖 Arch Linux 特定版本或最新软件包的轻量级服务（如自定义工具链、脚本执行等）。

详细使用方法和配置说明

基本使用（docker run 命令）

通过以下命令启动一个交互式容器，用于临时测试或环境探索：

docker run -it --rm immawanderer/archlinux:latest

• -it：启用交互式终端。
• --rm：容器退出后自动删除，避免残留。
• latest：默认标签，对应最新 nightly 构建版本（也可指定架构标签如 linux-amd64）。

作为基础镜像构建自定义镜像（Dockerfile 示例）

在 Dockerfile 中使用该镜像作为基础，安装额外依赖并构建自定义环境：

# 基于最新 nightly 构建的 archlinux 镜像
FROM immawanderer/archlinux:latest

# 更新系统并安装必要软件包（示例：安装 Python 和 Git）
RUN pacman -Syu --noconfirm \
    && pacman -S --noconfirm python3 git \
    && pacman -Scc --noconfirm  # 清理缓存以减小镜像体积

# 设置工作目录
WORKDIR /app

# 定义默认启动命令
CMD ["bash"]

构建并运行自定义镜像：

docker build -t my-archlinux-app .
docker run -it --rm my-archlinux-app

Docker Compose 配置示例

创建 docker-compose.yml 文件定义基础服务：

version: '3'
services:
  archlinux-base:
    image: immawanderer/archlinux:latest
    tty: true        # 保持容器后台运行
    stdin_open: true # 支持交互式操作
    # 可选：挂载本地目录到容器（如持久化数据）
    volumes:
      - ./local-data:/app/data

启动服务：

docker-compose up -d  # 后台运行
docker-compose exec archlinux-base bash  # 进入容器终端

配置说明

该镜像为标准 Arch Linux 基础环境，无特殊环境变量或配置参数。用户可通过以下方式自定义环境：

• 使用 pacman 包管理器安装额外软件（需先运行 pacman -Syu 更新索引）。
• 通过 Dockerfile 或 docker-compose.yml 挂载 volumes、设置环境变量或暴露端口。

镜像信息与链接

状态指标

![Build Status]([]
![Docker Image Version (latest by date)]([]
![Docker Image Size (tag)]([]
![Docker pulls]([]

代码仓库

• 镜像推送镜像库：GitHub 仓库
• 开发仓库：Gitea 实例