Portainer 基础 Docker 镜像文档

1. 镜像概述

本镜像为 Portainer 的基础 Docker 镜像，采用多阶段构建方式构建，基于 scratch 镜像。主要用途是作为 Portainer 应用的底层基础环境，提供精简的运行时基础，支持 Portainer 核心功能的部署与扩展。

2. 核心功能与特性

2.1 多阶段构建优化

通过多阶段构建流程，剥离构建过程中的临时依赖，仅保留运行时必需文件，减少镜像体积。

2.2 基于 scratch 的最小化设计

基于 scratch 空镜像构建，不含多余系统组件，实现极致精简的镜像体积，降低资源占用。

2.3 高安全性

最小化镜像减少攻击面，仅包含 Portainer 运行必需的核心文件，提升部署环境的安全性。

3. 使用场景

• Portainer 开发者：用于构建自定义或扩展版本的 Portainer 镜像，作为基础层集成额外功能或依赖。
• 高级用户：需要定制 Portainer 运行环境时，基于此基础镜像进行二次构建，优化部署体积或安全性。

4. 使用方法

4.1 多阶段构建示例

通常用于 Dockerfile 中作为基础层，配合多阶段构建复制必要文件至目标镜像。示例 Dockerfile 如下：

# 阶段1：使用 Portainer 基础镜像
FROM portainer/base-image:latest AS base

# 阶段2：构建应用层（示例：添加自定义配置）
FROM alpine:latest
# 从基础镜像复制 Portainer 核心文件
COPY --from=base / /app/
# 设置工作目录
WORKDIR /app
# 运行 Portainer（根据实际可执行文件调整命令）
CMD ["./portainer"]

4.2 直接运行（注意事项）

由于本镜像基于 scratch，不含 shell 及基础系统工具，直接运行可能无法交互，通常仅用于构建流程：

# 直接运行示例（仅验证镜像完整性，实际无业务功能）
docker run --rm portainer/base-image:latest

5. 配置参数说明

5.1 环境变量

当前基础镜像暂无预设环境变量，如需自定义，可在构建或运行时通过 ENV 指令或 docker run -e 参数添加。

5.2 配置文件

默认不含额外配置文件，需在二次构建时从外部集成或通过构建参数注入。

6. 注意事项

• 本镜像为基础依赖层，不建议直接用于生产环境部署，需结合 Portainer 应用层镜像使用。
• 构建时需确保多阶段流程正确复制基础镜像中的核心文件，避免功能缺失。
• 基于 scratch 特性，运行时需确保目标环境包含必要的动态链接库（如依赖 libc 等）。