woahbase/alpine-dood

alpine-dood

多架构Alpine Linux镜像，集成S6进程管理与Docker-outside-of-docker（DOOD）功能，提供轻量级容器化工具环境。

镜像概述

alpine-dood是基于Alpine Linux的多架构Docker镜像，整合了S6进程管理系统与Docker-outside-of-docker（DOOD）能力。该镜像旨在提供一个轻量级、跨架构的环境，允许容器内进程与宿主机Docker守护进程交互，适用于需要在容器化环境中管理外部Docker资源的场景。

维护方：WOAHBase
文档 | https://hub.docker.com/r/woahbase/alpine-dood | https://github.com/woahbase/alpine-dood

核心功能与特性

多架构支持

兼容多种硬件架构，包括：

• x86_64
• aarch64
• armv7l
• armhf
• ppc64le
• riscv64
• s390x

轻量级基础

基于Alpine Linux构建，镜像体积小，资源占用低，适合资源受限环境。

S6进程管理

集成S6进程管理系统，提供可靠的服务启停与进程监控能力，确保容器内服务稳定运行。

Docker-outside-of-docker（DOOD）

支持DOOD模式，允许容器内执行docker命令与宿主机Docker守护进程交互，实现对宿主机Docker资源的管理。

使用场景

• CI/CD流水线：在容器化CI/CD环境中构建、推送和管理Docker镜像
• 容器化工具链：作为轻量级基础镜像，集成Docker工具链用于开发或运维任务
• 多架构开发测试：在单一环境中测试跨架构Docker应用部署
• 自动化运维：通过容器化脚本管理宿主机Docker资源

使用方法

基本运行

通过以下命令启动容器，需挂载宿主机Docker套接字以启用DOOD功能：

bash
docker run -it --rm \
  -v /var/run/docker.sock:/var/run/docker.sock \
  docker.xuanyuan.run/woahbase/alpine-dood:x86_64

注意：根据宿主机架构选择对应镜像标签（如aarch64、armv7l等）

Docker Compose配置

创建docker-compose.yml文件：

yaml
version: '3'
services:
  alpine-dood:
    image: docker.xuanyuan.run/woahbase/alpine-dood:x86_64
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock
    tty: true
    stdin_open: true

启动服务：

bash
docker-compose up -d

进入容器：

bash
docker-compose exec alpine-dood sh

验证DOOD功能

容器内执行以下命令验证Docker可用性：

bash
docker info

若输出宿主机Docker守护进程信息，表明DOOD功能正常。

注意事项

• 权限要求：容器需具有访问宿主机/var/run/docker.sock的权限，生产环境中建议通过用户组权限控制而非直接挂载
• 架构匹配：确保使用与宿主机架构对应的镜像标签，避免兼容性问题
• 安全风险：DOOD模式会使容器获得宿主机Docker控制权限，需严格限制容器访问范围