gaetanddr/baseimage-alpine

BoxHarbor基础镜像 - Alpine

https://img.shields.io/docker/pulls/gaetanddr/baseimage-alpine](https://hub.docker.com/r/gaetanddr/baseimage-alpine) https://img.shields.io/github/license/boxharbor/baseimage-alpine](https://github.com/BoxHarbor/baseimage-alpine)

一款基于Alpine Linux构建的轻量级、支持rootless模式的基础镜像，集成tini进程管理器，旨在构建可无缝兼容Docker和Podman rootless模式的容器化应用。

核心特征

• 🪶 轻量级：基于Alpine Linux
• 🔒 支持rootless模式：兼容Podman和Docker的无root运行方式
• 🎯 简单初始化系统：使用tini实现正确的信号处理
• 📁 标准化结构：/config目录用于持久化数据
• 🔧 可定制：易于通过初始化脚本和服务脚本扩展
• 🌍 多架构支持：适配amd64、arm64、armv7架构

快速开始

该镜像为基础镜像，用于作为其他应用镜像的构建底座：

dockerfile
FROM ghcr.io/boxharbor/baseimage-alpine:latest

# 安装应用依赖
RUN apk add --no-cache your-package

# 复制服务配置
COPY rootfs/ /

# 暴露应用端口
EXPOSE 8080

环境变量

目录结构

/app        - 应用程序文件目录  
/config     - 持久化配置目录（建议挂载宿主机目录）  
/defaults   - 默认配置模板目录  

扩展基础镜像

添加初始化脚本

在/etc/cont-init.d/目录下创建启动脚本（按数字前缀顺序执行）：

bash
#!/bin/bash
# /etc/cont-init.d/20-my-init
echo "执行自定义初始化逻辑..."
# 此处添加你的配置初始化代码

添加服务进程

在/etc/services.d/目录下创建服务目录（自动后台运行）：

bash
#!/bin/bash
# /etc/services.d/myapp/run
cd /app
exec /app/myapp-binary  # 启动应用二进制文件

使用示例

Docker部署

bash
docker run -d \
  --name myapp \
  -v ./config:/config \
  -e PUID=1000 \
  -e PGID=1000 \
  -e TZ=Asia/Shanghai \
  your-app:latest

Podman Rootless部署

bash
podman run -d \
  --name myapp \
  -v ./config:/config:Z \
  -e PUID=1000 \
  -e PGID=1000 \
  your-app:latest

注意：SELinux系统（如Fedora/RHEL）需添加:Z后缀以适配安全策略。

从源码构建

bash
git clone https://github.com/BoxHarbor/baseimage-alpine.git
cd baseimage-alpine
docker build -t boxharbor/baseimage-alpine:latest .

贡献指南

欢迎提交PR！请先阅读贡献规范。

许可证

GPL-3.0许可证 - 详情见LICENSE文件。

支持渠道

• 💬 GitHub Issues：https://github.com/BoxHarbor/baseimage-alpine/issues
• 📖 官方文档：https://github.com/BoxHarbor/baseimage-alpine/wiki

由BoxHarbor团队❤️打造