giftery/runit-nginx-php-fpm

一体化轻量级初始化系统Docker镜像文档

镜像概述和主要用途

本镜像基于轻量级初始化系统（如tini、dumb-init等）构建，采用一体化设计理念，集成多种常用功能组件，旨在简化多服务应用的部署与管理流程。通过单一容器即可运行需要多个关联组件的应用，避免复杂的容器编排，降低运维成本，适用于对资源占用敏感且追求部署简洁性的场景。

主要用途包括：

• 作为单一容器运行包含多个服务/组件的应用系统
• 简化开发、测试环境的快速搭建与一致性保障
• 减少生产环境中的容器数量，降低编排复杂度
• 提供统一的进程管理和生命周期控制

核心功能和特性

轻量级基础架构

• 基于精简的初始化系统，相比传统操作系统镜像资源占用更低（通常镜像大小<100MB）
• 优化的启动流程，缩短容器启动时间，提升资源利用效率

一体化组件集成

• 预集成常用服务组件（如Web服务器、数据库客户端、缓存服务等），支持按需启用
• 组件间默认配置协同工作，减少手动配置成本

增强的进程管理

• 轻量级init系统负责进程生命周期管理，支持多进程并发运行
• 自动处理僵尸进程回收、信号转发（如SIGTERM、SIGINT），确保应用优雅停止

简化的部署流程

• 单一容器替代多容器部署模式，减少网络配置和容器间通信复杂性
• 统一的日志收集和管理入口，简化问题排查

使用场景和适用范围

适用场景

• 小型应用系统部署：需要Web服务+数据库+缓存等多组件的简单应用（如个人博客、小型管理系统）
• 开发/测试环境：快速搭建包含完整依赖的本地开发环境，确保环境一致性
• 边缘计算环境：资源受限的边缘设备，需在有限容器数量下运行多服务
• 演示/原型验证：快速展示应用功能，避免复杂的多容器编排配置

不适用场景

• 大规模生产环境：需要高可用性、水平扩展的核心业务系统（推荐采用单容器单服务架构）
• 强隔离需求场景：服务间需严格资源隔离或安全隔离的场景
• 高并发服务：单容器多服务可能导致资源竞争，影响性能稳定性

使用方法和配置说明

基本使用流程

1. 拉取镜像

bash
docker pull [镜像仓库地址]/all-in-one-lightweight-init:latest

2. 运行容器

基础运行命令（默认启用核心组件）：

bash
docker run -d \
  --name all-in-one-app \
  -p 80:80 \  # 映射Web服务端口
  -v ./data:/app/data \  # 挂载数据持久化目录
  [镜像仓库地址]/all-in-one-lightweight-init:latest

核心配置参数

环境变量配置

通过-e参数设置环境变量，控制组件启用和行为：

配置示例：启用Web+缓存服务

bash
docker run -d \
  --name all-in-one-with-cache \
  -p 8080:8080 \  # 自定义Web端口
  -p 6379:6379 \  # 映射缓存服务端口
  -e ENABLE_WEB_SERVER=true \
  -e WEB_SERVER_PORT=8080 \
  -e ENABLE_CACHE=true \
  -v ./app-data:/app/data \
  [镜像仓库地址]/all-in-one-lightweight-init:latest

高级配置：自定义组件配置

如需修改组件默认配置，可通过挂载自定义配置文件覆盖容器内默认配置：

bash
docker run -d \
  --name all-in-one-custom-config \
  -v ./custom-web-config.conf:/etc/webserver/config.conf \  # 挂载Web服务器自定义配置
  -v ./custom-cache.conf:/etc/cache/config.conf \  # 挂载缓存服务自定义配置
  [镜像仓库地址]/all-in-one-lightweight-init:latest

日志与监控

容器日志默认输出至标准输出，可通过docker logs命令查看：

bash
docker logs -f all-in-one-app  # 实时查看日志

如需持久化日志，可配置日志驱动（如json-file、local）：

bash
docker run -d \
  --log-driver=local \
  --log-opt max-size=10m \
  --name all-in-one-app \
  [镜像仓库地址]/all-in-one-lightweight-init:latest

注意事项

1. 资源限制：运行时建议通过--memory、--cpus参数设置资源限制，避免多服务资源竞争

   bash
   docker run -d --memory=512m --cpus=0.5 ...
   

2. 数据备份：通过数据卷挂载的持久化目录需定期备份，避免数据丢失

3. 安全考虑：生产环境使用时需限制容器权限（如--read-only、--user非root用户），减少安全风险

4. 组件冲突：同时启用多个组件时需确保端口不冲突，可通过环境变量自定义各组件端口