bellsoft/alpaquita-linux-base 镜像文档

镜像概述与主要用途

Alpaquita Linux 是一款轻量级操作系统，专为云原生应用部署优化。它能高效运行各类工作负载，是构建轻量级、高性能容器的理想基础。该镜像由 BellSoft 开发维护，可直接使用或作为自定义镜像的基础，通过 Alpaquita apk 仓库安装额外模块和软件包以满足项目需求。Alpaquita Linux 提供基于优化 Musl libc 和 Glibc libc 的两个版本，分别针对兼容性和性能场景优化。

核心功能与特性

• 用户空间二进制保护：增强系统安全性。
• 四种 malloc 实现：提供内存分配的灵活性和性能优化选项。
• 优化的标准 C 库：包含 "musl perf" 实现，兼具体积小巧和高性能特点。
• 极小镜像体积：基础镜像大小仅 3.22MB，适合构建资源高效型容器。
• 广泛环境支持：兼容 Docker 和 QEMU，便于跨平台部署。
• 低资源占用：运行时资源需求低，提升容器部署密度。

使用场景与适用范围

• 轻量级容器基础：适用于对镜像体积和资源占用有严格要求的云原生应用。
• Alpine 迁移场景：Musl 版本与标准 Musl 100% 兼容，可无缝迁移原 Alpine 基础的应用。
• 高性能 Glibc 需求：Glibc 版本在部分场景下性能优于主流 Glibc 系统，适合需高性能 GLIBC 环境的应用。
• 定制化镜像构建：作为基础层，通过 APK 包管理器扩展功能，构建满足特定需求的容器环境。

使用方法与配置说明

基础使用

直接运行容器

# 启动交互式 shell（默认使用 musl 版本）
docker run -it --rm bellsoft/alpaquita-linux-base:latest sh

# 使用 Glibc 版本
docker run -it --rm bellsoft/alpaquita-linux-base:glibc sh

作为基础镜像构建自定义镜像

# 使用 Musl 版本作为基础
FROM bellsoft/alpaquita-linux-base:stream-musl

# 或使用 Glibc 版本
# FROM bellsoft/alpaquita-linux-base:glibc

安装额外软件

通过 APK 包管理器安装软件，语法与 Alpine Linux 的 APK 兼容。使用 --no-cache 选项可避免缓存 APK 索引文件，减小镜像体积。

安装软件示例

FROM bellsoft/alpaquita-linux-base:stream-musl

# 安装基础工具（如 curl、wget）
RUN apk add --no-cache curl wget

# 安装开发工具（如 gcc、make）
RUN apk add --no-cache gcc make libc-dev

# 设置工作目录
WORKDIR /app

# 添加应用并运行
COPY ./app /app
CMD ["./app"]

标签说明

镜像通过标签区分 libc 实现和版本，主要标签如下：

选择指引

BellSoft 提供交互式方案帮助选择适合项目的镜像，详情可参考：
!如何选择最优 Java 镜像

许可证信息

本镜像包含的软件可能分布在不同许可证下。已安装软件组件及其许可证列表可通过在镜像中执行以下命令获取：

apk list -I

使用本镜像时，用户有责任确保对其中所有软件的使用符合相关许可证要求。