minidocks/base 镜像文档

镜像概述和主要用途

minidocks/base 是一款基于Alpine的极小Docker基础镜像，总大小小于8MB，专为开发者设计。该镜像注册了多个版本的Alpine仓库，集成了多种实用工具，并支持主机用户ID/组ID映射、SSH服务、进程管理等功能，可作为轻量级开发环境或构建其他应用容器的基础。

核心功能和特性

Alpine仓库

所有镜像已注册以下apk仓库：

• @edge（包含@main、@community、@testing）
• @320（包含@main320、@community320）
• @319（包含@main319、@community319）
• @318（包含@main318、@community318）

实用工具

镜像包含以下额外软件包：

• tini：轻量级容器init系统
• monit：UNIX系统进程管理与监控工具
• inotify-tools：inotify的命令行接口工具
• dropbear：适用于小内存环境的SSH 2客户端/服务器
• envsubst：替换shell格式字符串中的环境变量
• ca-certificates：通用CA证书PEM文件
• su-exec：切换用户/组ID、设置组并执行命令
• wait-for：等待其他服务可用的工具
• libc6-compat：glibc兼容库
• flock：util-linux提供的文件锁定工具

核心特性

主机用户ID和组ID映射

镜像在运行时可匹配容器内用户ID/组ID与主机用户ID/组ID，确保权限一致性。

灵感来源：

• [***]
• [***]

rootfs

支持自定义根文件系统配置（具体细节未详述）。

SSH服务

集成SSH服务功能，支持远程访问（具体细节未详述）。

进程管理（Supervise）

集成以下进程管理工具：

• [***]
• [***]
• [***]

使用场景和适用范围

• 开发者环境：作为轻量级基础镜像用于开发和测试
• 基础镜像构建：减少最终应用镜像大小，适用于微服务、CLI工具等场景
• 轻量级部署：需要极小运行环境的服务部署，如资源受限环境

使用方法和配置说明

基本运行命令

bash
docker run --rm -it minidocks/base

运行GUI应用示例

bash
xhost +
docker run --rm -it -e DISPLAY=$DISPLAY -v /tmp/.X11-unix:/tmp/.X11-unix -v `pwd`:/app -w /app minidocks/gimp

环境变量

以下环境变量用于配置容器行为：

• ALIAS_*：设置别名（具体用法未详述）
• CLEAN：清理操作开关（具体用法未详述）
• ENV_FILE：指定环境变量文件路径
• AUTO_CHOWN：自动修改文件所有者
• PATH_PREFIX：添加到PATH的前缀路径
• PATH_SUFFIX：添加到PATH的后缀路径
• CRON_USER_*：cron任务执行用户
• CRON_SCHEDULE_*：cron任务调度时间
• CRON_COMMAND_*：cron任务执行命令
• STARTUP_COMMAND_*：容器启动时执行的命令
• FILE_*_PATH：文件路径
• FILE_*_CONTENT：文件内容
• SUEXEC：su-exec相关配置（具体用法未详述）
• ID：用户ID相关标识（具体用法未详述）
• USER_NAME：用户名，可使用$USERNAME获取当前用户名
• USER_ID：用户ID，可使用$UID获取当前用户ID
• GROUP_NAME：用户组名，可使用$(id -g -n $USERNAME)获取当前用户组名
• GROUP_ID：用户组ID，可使用$(id -g $USERNAME)获取当前用户组ID
• USER_SHELL：用户shell，默认值：/bin/bash
• USER_PASSWORD：用户密码，默认值：password
• USER_MASK：用户权限掩码

标签信息

灵感来源

• [***]
• [***]
• [***]
• [***]
• [***]
• [***]

替代方案

• [***]
• [***]
• [***]
• [***]

参考链接：

• [***]
• [***]