phusion/baseimage

baseimage-docker 镜像文档

概述

baseimage-docker是基于Ubuntu的Docker专用优化镜像，旨在解决原生Ubuntu镜像在容器环境中的兼容性问题。通过精简系统组件、优化初始化流程及修复底层配置，为容器化应用提供稳定、高效的基础运行环境。更多详情可参考https://github.com/phusion/baseimage-docker%E3%80%82

Ubuntu基础镜像的问题

原生Ubuntu镜像并非为容器环境设计，主要存在以下问题：

• 初始化系统不适配：其默认初始化系统Upstart假设运行于物理或虚拟硬件，而非容器环境，导致冗余进程和资源浪费。
• 最小化配置复杂：容器环境需精简系统，但手动配置过程中易触发Unix系统的历史遗留"角落情况"，引发难以排查的异常行为。

为什么使用baseimage-docker

相较于手动配置原生Ubuntu镜像，baseimage-docker具有显著优势：

• 降低配置门槛：容器化系统配置涉及进程管理、信号处理等细节，自行实现易遗漏关键步骤，本镜像已完成全部适配工作。
• 系统配置合规：Unix系统存在诸多历史兼容性问题，错误配置可能导致僵尸进程堆积、日志丢失等隐性故障，本镜像已针对容器场景优化所有关键路径。
• 加速开发迭代：减少Dockerfile中基础系统配置步骤，缩短docker build时间，提升镜像构建效率。
• 降低部署成本：基础镜像仅需首次部署时完整下载，后续更新仅传输增量变更，减少网络带宽消耗。

镜像内容

baseimage-docker仅包含容器运行必需的核心组件，具体包括：

• 基础系统：基于Ubuntu 16.04 LTS构建，保留核心系统工具。
• 初始化进程：优化的init系统，解决Docker环境中经典的PID 1僵尸进程回收问题。
• APT兼容性修复：修正Ubuntu APT包管理器在容器环境中的锁机制和缓存问题。
• 日志系统：集成syslog-ng轻量级日志收集服务，支持容器内日志管理。
• 定时任务：内置cron守护进程，支持常规定时任务调度。
• 可选SSH服务（默认禁用）：适用于docker exec无法满足的调试场景：
  • 仅支持密钥认证，默认禁用密码和挑战响应认证。
  • 预置调试密钥（生产环境需立即替换，详见GitHub文档）。
• 服务管理：采用Runit作为进程监控工具，简化容器内多服务管理。

使用方法

基本部署示例

快速启动容器

bash
# 启动交互式shell（基础测试用例）
docker run -it --rm phusion/baseimage:latest /sbin/my_init -- bash -l

集成到Dockerfile

以构建自定义应用镜像为例：

dockerfile
FROM phusion/baseimage:latest

# 禁用SSH服务（默认已禁用，显式声明可选）
RUN rm -rf /etc/service/sshd /etc/my_init.d/00_regen_ssh_host_keys.sh

# 添加自定义服务（示例：启动Nginx）
RUN mkdir /etc/service/nginx
ADD nginx-run.sh /etc/service/nginx/run
RUN chmod +x /etc/service/nginx/run

# 执行应用初始化命令
RUN apt-get update && apt-get install -y nginx

# 容器启动入口（使用baseimage的init系统）
CMD ["/sbin/my_init"]

扩展资源

• 官方社区：***
• 技术博客：Phusion Blog