xtulnx/alpine repository overview

⁠Alpine Base Image

这是一个基于官方 alpine 的基础镜像，额外预装了这些常用组件：

• tzdata
• gosu
• libcap

当前版本为 xtulnx/alpine:1.1.0，基于 Alpine 3.24，内置 gosu 1.20；latest 指向同一版本。

适合用作其他业务镜像的基础层，尤其是这些场景：

• 需要用 gosu 在容器启动时切换运行用户
• 需要用 setcap 给二进制授予 Linux capability
• 需要时区数据库，但又不想在每个项目里重复安装

⁠快速体验

IMAGE=xtulnx/alpine:latest

docker run --rm -it "$IMAGE" sh

进入容器后可以直接检查内置版本信息：

cat /VERSION
gosu --version

⁠作为基础镜像使用

FROM xtulnx/alpine:latest

RUN addgroup -S app && adduser -S -G app app
COPY my-app /usr/local/bin/my-app

ENTRYPOINT ["gosu", "app", "/usr/local/bin/my-app"]

⁠libcap 使用示例

如果你的程序要绑定 1024 以下端口，但又不想直接用 root 运行，可以在构建阶段给二进制增加 capability：

FROM xtulnx/alpine:latest

COPY my-app /usr/local/bin/my-app
RUN setcap cap_net_bind_service=+ep /usr/local/bin/my-app

⁠说明

• 这个镜像本身不预置业务进程。
• 没有默认暴露端口，也没有预设数据卷。