4
0

Dockerfile 多阶段构建、Docker Compose 与私有仓库

2026-11-01
2026-11-01
Dockerfile 多阶段构建、Docker Compose 与私有仓库

一、USER:以普通用户运行容器

1. 手动测试命令

adduser -u 2024 demo -D
sed -i '/^user/s#nginx#demo#' /etc/nginx/nginx.conf

要点:

  • adduser -u 2024 demo -D 创建 UID 为 2024 的普通用户;
  • 普通用户启动 nginx 前,要先准备好运行所需的目录和日志文件,例如 /var/lib/nginx/tmp/client_body、/var/lib/nginx/logs/error.log,并把属主改成该用户。

2. Dockerfile 示例

FROM alpine:3.20.2

LABEL school=demo \
      class=demo-class \
      auther=demo

WORKDIR /usr/share/nginx/html
VOLUME /usr/share/nginx/html

RUN sed -i 's/dl-cdn.alpinelinux.org/mirrors.tuna.tsinghua.edu.cn/g' \
      /etc/apk/repositories && \
    apk update && \
    apk add nginx openssh-server curl && \
    sed -i 's@#PermitRootLogin prohibit-password@PermitRootLogin yes@' /etc/ssh/sshd_config && \
    ssh-keygen -A && \
    rm -rf /var/cache/* /usr/share/nginx/html/*

EXPOSE 80 22

ADD code/demo-chengbao.tar.gz /usr/share/nginx/html/chengbao

COPY config/games.conf /etc/nginx/http.d/default.conf
COPY config/nginx.conf /etc/nginx/nginx.conf

# 创建普通用户,并准备 nginx 运行所需的目录、日志及属主
RUN adduser -u 2024 demo -D && \
    install -d /var/lib/nginx/tmp/client_body -o demo -g demo && \
    touch /var/lib/nginx/logs/error.log /var/log/nginx/access.log && \
    chown demo:demo -R /run/nginx/ /var/lib/nginx/logs/error.log \
      /var/log/nginx/access.log /var/lib/nginx/

# 指定容器进程的运行用户(默认 root),指定普通用户前要确保该用户已存在
USER demo

COPY scripts/start.sh /

HEALTHCHECK --interval=1s \
            --timeout=1s \
            --start-period=10s \
            --retries=5 \
            CMD curl -H "host: game01.example.com" 127.0.0.1

ENTRYPOINT ["/bin/sh", "-x", "/start.sh"]

3. nginx 配置

config/games.conf:

server {
    listen        0.0.0.0:80;
    root          /usr/share/nginx/html/chengbao;
    server_name   game01.example.com;
}

config/nginx.conf 第一行指定运行用户:

user demo;
worker_processes auto;
# 其余为 nginx 默认配置...

4. 验证

docker exec -it c1 sh
whoami
# demo

ps -ef
# PID USER COMMAND
# 1   demo /bin/sh -x /start.sh
# 12  demo nginx: master process nginx
# 13  demo tail -f /etc/hosts
# 14  demo nginx: worker process nginx

nginx 以普通用户可以正常启动;但 sshd 用普通用户启动可能存在问题,需要进一步排查(如 22 端口需要 root 权限绑定、sshd 需要特权等)。

二、ONBUILD:子镜像构建时触发

1. 指令说明

ONBUILD 定义的指令在当前镜像构建时不执行,只有当其他镜像以当前镜像为基础镜像(FROM 引用它)时才会触发。

父镜像 Dockerfile 末尾:

ONBUILD RUN mkdir /demo-tiaoyitiao && \
         touch /demo-tiaoyitiao/xixi.log && \
         touch /demo-tiaoyitiao/haha.log

ONBUILD LABEL blog=https://www.example.com/blog

子镜像 haha.dockerfile:

FROM demo-games:v2.19

RUN mkdir /demo-class

2. 用 -f 同时构建多个 Dockerfile

#!/bin/bash

# 不指定 -f 时,默认使用名为 Dockerfile 的文件
docker image build -t demo-games:v2.19 ..
# -f 指定 Dockerfile 的名称
docker image build -t demo-games:v2.20 -f ../haha.dockerfile ..

docker container rm -f `docker container ps -qa` 2>/dev/null

3. 查看 OnBuild 与 Labels 的差异

docker inspect -f "{{.Config.OnBuild}}" demo-games:v2.19
# [RUN mkdir /demo-tiaoyitiao && ... LABEL blog=https://www.example.com/blog]

docker inspect -f "{{.Config.OnBuild}}" demo-games:v2.20
# []

docker inspect -f "{{.Config.Labels}}" demo-games:v2.20
# map[auther:demo blog:https://www.example.com/blog class:demo-class ...]

解释:v2.19 是父镜像,本身带 OnBuild 指令;v2.20 以它为基镜像构建,OnBuild 指令被触发执行,所以 v2.20 的 OnBuild 为空,而 Labels 里多出了 blog。

4. 容器验证

docker run -d --name c1 demo-games:v2.19
docker run -d --name c2 demo-games:v2.20

docker exec c1 ls -l /
# 根目录没有 /demo-tiaoyitiao、/demo-class

docker exec c2 ls -l /
# 根目录多出 /demo-tiaoyitiao 和 /demo-class

三、用 -f 指定多个 Dockerfile

docker image build -t demo-games:v2.20 -f ../xixi.dockerfile ..
docker image build -t demo-games:v2.21 -f ../haha.dockerfile ..

说明:-f 指定要使用的 Dockerfile 文件名,不指定时默认找 Dockerfile。

四、多阶段构建

1. 目的

把「编译/准备阶段」和「最终运行阶段」拆开,最终镜像只保留运行需要的产物,从而显著减小镜像体积。

2. 示例 Dockerfile

# 阶段一:准备 bigfile 和日志
FROM alpine:3.20.2 AS xixi
RUN mkdir /demo-xixi && \
    dd if=/dev/zero of=/demo-xixi/bigfile.txt count=1024 bs=1M && \
    echo "xixi ~" > /demo-xixi/xixi.log

# 阶段二:准备另一个大文件
FROM alpine:3.20.2 AS haha
RUN mkdir /demo-haha && \
    dd if=/dev/zero of=/demo-haha/bigfile.txt count=2048 bs=1M && \
    echo "haha ~" > /demo-haha/haha.log

# 最终阶段:只拷贝前两个阶段里需要的小文件
FROM alpine:3.20.2

LABEL school=demo class=demo-class office=www.example.com

RUN mkdir /demo-hehe
COPY --from=xixi /demo-xixi/xixi.log /demo-hehe
COPY --from=haha /demo-haha/haha.log /demo-hehe

ENTRYPOINT ["tail", "-f", "/etc/hosts"]

3. 结果

docker image build -t demo-games:v3.0 .
docker image ls demo-games:v3.0
# REPOSITORY  TAG  SIZE
# demo-games  v3.0 7.8MB

虽然前两个阶段各自生成了 1GB、2GB 的 bigfile.txt,但最终阶段没有拷贝它们,所以最终镜像只有 7.8MB。

五、多阶段构建案例:Golang SDK

1. 只放 SDK 的镜像

FROM alpine:3.20.2

LABEL auther=demo school=demo class=demo-class office=www.example.com

ADD go1.22.5.linux-amd64.tar.gz /demo/softwares
RUN ln -svf /demo/softwares/go/bin/* /usr/local/bin/

CMD ["tail", "-f", "/etc/hosts"]

这种写法只验证了 SDK 能解压、工具能链接,最终镜像约 230MB,没有实际意义,真正有价值的是下一节的两阶段编译。

六、多阶段构建案例:Golang 二进制程序

1. Go 源码(开发人员提供)

package main

import "fmt"

type School struct {
  Name   string
  Office string
}

func (s *School) SayHi() {
  fmt.Printf("%s的公司官网是%s\n", s.Name, s.Office)
}

func main() {
  school := &School{}
  school.Name = "示例"
  school.Office = "https://www.example.com"
  school.SayHi()
}

2. 两阶段 Dockerfile

# 编译阶段:装 Go 工具链,编译出二进制
FROM alpine:3.20.2

ADD go1.22.5.linux-amd64.tar.gz /demo/softwares

RUN ln -svf /demo/softwares/go/bin/* /usr/local/bin/ && \
    mkdir /demo/code

COPY hello.go /demo/code
RUN go build -o /demo/src/hello /demo/code/hello.go

# 运行阶段:只拷贝编译产物
FROM alpine:3.20.2

LABEL auther=demo school=demo class=demo-class office=www.example.com

COPY --from=0 /demo/src/hello /

CMD ["tail", "-f", "/etc/hosts"]

3. 镜像大小对比

docker image ls demo-games:v3.1
# 230MB  (只装 SDK 的版本)

docker image ls demo-games:v3.2
# 9.71MB (两阶段构建,只保留二进制)

4. 验证二进制

docker exec -it go sh
./hello
# 示例的公司官网是https://www.example.com

七、容器日志输出到 stdout / stderr

容器内的服务尽量把日志写到标准输出、标准错误,这样 docker logs 才能看到。

在 Dockerfile 里用软链接把 nginx 日志指向 stdout / stderr:

RUN sed -i 's/dl-cdn.alpinelinux.org/mirrors.tuna.tsinghua.edu.cn/g' \
      /etc/apk/repositories && \
    apk update && \
    apk add nginx openssh-server curl && \
    sed -i 's@#PermitRootLogin prohibit-password@PermitRootLogin yes@' /etc/ssh/sshd_config && \
    ssh-keygen -A && \
    rm -rf /var/cache/* /usr/share/nginx/html/* && \
    ln -svf /dev/stderr /var/log/nginx/error.log && \
    ln -svf /dev/stdout /var/log/nginx/access.log

之后访问 nginx,docker logs <容器> 就能看到访问日志。

八、docker-compose 基础

1. 什么是 docker-compose

docker-compose 是用来管理一组容器运行的工具:一个 docker-compose.yaml 定义多个服务,一条命令统一编译镜像、启动/停止/重启容器。

2. 实战案例:斗地主 + 摩托两个服务

version: '3.8'

services:
  doudizhu:
    image: demo-games:doudizhu-v0.1
    build:
      context: ./dockerfile
      dockerfile: doudizhu.dockerfile

  motuo:
    image: demo-games:motuo-v0.1
    build:
      context: ./dockerfile
      dockerfile: motuo.dockerfile

字段说明:

字段含义
versionCompose 文件版本
services定义的服务集合
image服务使用的镜像名
build.context构建上下文,相当于 docker build 的 PATH
build.dockerfileDockerfile 文件名,相当于 -f

3. 常用命令

命令作用
docker-compose build编译配置中声明的镜像
docker-compose up -d后台创建并启动容器
docker-compose ps查看服务状态
docker-compose stop -t 0停止服务,-t 0 不等待
docker-compose start启动已存在的服务
docker-compose restart <服务名>重启指定服务
docker-compose down -t 0停止并删除容器和网络
docker-compose build
docker-compose up -d
docker-compose ps
docker-compose stop -t 0
docker-compose start
docker-compose restart doudizhu
docker-compose down -t 0

restart 后面跟的是 docker-compose.yaml 里定义的服务名(如 doudizhu),不是容器名。

九、docker-compose 端口映射和重启策略

services:
  doudizhu:
    image: demo-games:doudizhu-v0.1
    ports:
      - 2481:80
      - 2422:22
    restart: always
    build:
      context: ./dockerfile
      dockerfile: doudizhu.dockerfile

  motuo:
    image: demo-games:motuo-v0.1
    ports:
      - :80
      - :22
    build:
      context: ./dockerfile
      dockerfile: motuo.dockerfile

说明:

  • 2481:80 表示宿主机 2481 映射容器 80;
  • :80 表示宿主机随机端口映射容器 80;
  • restart: always 配置容器重启策略。

十、docker-compose 一键启动 Zabbix

version: '3.8'

services:
  mysql-server:
    image: mysql:8.3.0-oracle
    container_name: mysql-server
    restart: unless-stopped
    environment:
      MYSQL_ROOT_PASSWORD: demo
      MYSQL_DATABASE: zabbix
      MYSQL_USER: demo-class
      MYSQL_PASSWORD: "123456"
    networks:
      - zabbix-net
    command: ["--character-set-server=utf8", "--collation-server=utf8_bin", "--default-authentication-plugin=mysql_native_password"]

  zabbix-java-gateway:
    container_name: zabbix-java-gateway
    image: zabbix/zabbix-java-gateway:alpine-6.4-latest
    restart: unless-stopped
    networks:
      - zabbix-net

  zabbix-server:
    container_name: zabbix-server-mysql
    depends_on:
      - mysql-server
    image: zabbix/zabbix-server-mysql:alpine-6.4-latest
    restart: unless-stopped
    environment:
      DB_SERVER_HOST: mysql-server
      MYSQL_DATABASE: zabbix
      MYSQL_USER: demo-class
      MYSQL_PASSWORD: "123456"
      MYSQL_ROOT_PASSWORD: demo
      ZBX_JAVAGATEWAY: zabbix-java-gateway
    networks:
      - zabbix-net
    ports:
      - "10051:10051"

  zabbix-web-nginx-mysql:
    container_name: zabbix-web-nginx-mysql
    depends_on:
      - zabbix-server
    image: zabbix/zabbix-web-nginx-mysql:alpine-6.4-latest
    ports:
      - "80:8080"
    restart: unless-stopped
    environment:
      DB_SERVER_HOST: mysql-server
      MYSQL_DATABASE: zabbix
      MYSQL_USER: demo-class
      MYSQL_PASSWORD: "123456"
      MYSQL_ROOT_PASSWORD: demo
    networks:
      - zabbix-net

networks:
  zabbix-net:
    name: demo-zabbix
    ipam:
      driver: default
      config:
        - subnet: 172.20.100.0/16
          gateway: 172.20.100.254

关键点:

  • depends_on 声明启动顺序依赖;
  • 各服务通过自定义网络 zabbix-net 互联,可直接用服务名(如 mysql-server)作为主机名;
  • ipam 配置网络子网和网关。

十一、私有镜像仓库

1. 为什么要用私有仓库

  1. 拉取镜像速度快;
  2. 便于内部用户统一获取镜像;
  3. 安全,部分镜像只允许内部使用。

2. 私有仓库方案对比

方案说明建议
Docker Hub(官方)国内访问受限一般不建议直接使用
docker registryDocker 官方开源,启动约 20MB,轻量但管理不便不推荐
VMware Harbor基于 registry 二次开发,带 WebUI、权限、项目等企业使用推荐
第三方云仓库阿里云、华为云等按需选择

十二、docker registry 搭建与使用

1. 部署

docker run -dp 5000:5000 \
  --restart=always \
  --name demo-registry \
  -v /var/lib/registry \
  registry

访问 WebUI 查看仓库目录:

http://10.0.0.101:5000/v2/_catalog

2. 客户端配置不安全的存储库

registry 默认走 HTTP,Docker 默认走 HTTPS,需要在客户端配置信任:

{
  "insecure-registries": ["10.0.0.101:5000"]
}
systemctl restart docker
docker info | grep "Insecure Registries" -A 2

常见报错 http: server gave HTTP response to HTTPS client,就是没配 insecure-registries。

3. 打包并推送镜像

镜像名格式:私有仓库地址/项目地址/镜像名称:版本号。

docker tag mysql:8.3.0-oracle 10.0.0.101:5000/demo-db/mysql:8.3.0-oracle
docker push 10.0.0.101:5000/demo-db/mysql:8.3.0-oracle

再次访问 http://10.0.0.101:5000/v2/_catalog,能看到:

{"repositories":["demo-db/mysql"]}

4. 下载镜像

docker pull 10.0.0.101:5000/demo-db/mysql:8.3.0-oracle

registry 本身不带友好的 Web 管理界面,删除、浏览镜像都比较麻烦,这也是企业更倾向 Harbor 的原因。

5. 删除镜像

先删除元数据,再执行垃圾回收释放存储:

docker exec -it demo-registry sh
cd /var/lib/registry/docker/registry/v2/

rm -rf repositories/demo-db/

registry garbage-collect /etc/docker/registry/config.yml

十三、部署 Harbor(HTTP)

1. 下载并解压

wget http://<下载服务器>/softwares/harbor-offline-installer-v2.7.4.tgz
tar xf harbor-offline-installer-v2.7.4.tgz -C /demo/softwares/
mkdir -pv /demo/data/harbor

2. 配置 harbor.yml

cd /demo/softwares/harbor/
cp harbor.yml{.tmpl,}
vim harbor.yml

关键配置:

# Harbor 服务器地址
hostname: harbor.example.com

# 注释掉 https 配置(走 http)
#https:
#  port: 443

# admin 用户密码
harbor_admin_password: 1

# 数据存储目录
data_volume: /demo/data/harbor

3. 安装

./install.sh --with-chartmuseum

安装过程会:检查 docker / docker-compose 环境 → 导入 Harbor 镜像 → 准备配置 → 启动 docker-compose。

4. 访问 WebUI

http://10.0.0.102/harbor/projects

用户名 admin,密码为 harbor.yml 中配置的密码。

十四、Harbor 推送镜像

1. 配置 hosts 解析

echo 10.0.0.102 harbor.example.com >> /etc/hosts

不配 hosts 会报 dial tcp: lookup harbor.example.com ... no such host。

2. 配置 HTTP 信任

{
  "insecure-registries": ["harbor.example.com"]
}
systemctl restart docker

3. 在 WebUI 新建项目

略(新建一个项目,例如 demo)。

4. 打包并登录

docker tag demo-games:motuo-v0.1 harbor.example.com/demo/demo-games:motuo-v0.1

docker login harbor.example.com
# Username: admin
# Password: 1

也可用:

echo 1 | docker login -u admin --password-stdin harbor.example.com

不登录直接 push 会报 unauthorized。登录后密码会以明文形式存到 /root/.docker/config.json,用完记得 docker logout。

5. 推送

docker push harbor.example.com/demo/demo-games:motuo-v0.1

6. 退出登录

docker logout harbor.example.com

十五、Harbor 下载镜像

在另一台节点上:

echo "10.0.0.102 harbor.example.com" >> /etc/hosts

# daemon.json 中加入 insecure-registries
systemctl restart docker

docker pull harbor.example.com/demo/demo-games:motuo-v0.1

Harbor 镜像删除通过 WebUI 操作(略)。

十六、总结

  1. USER 让容器以普通用户运行,使用前要确保用户存在,并准备好所需目录和日志的属主;
  2. ONBUILD 定义的指令只在子镜像构建时触发,配合 -f 可以实现一次构建多个镜像;
  3. 多阶段构建把编译和运行分离,最终镜像只保留产物,能把体积从几百 MB 降到几 MB;
  4. 容器日志应输出到 stdout / stderr,docker logs 才能查看;
  5. docker-compose 用一份 YAML 统一管理多服务:build / up -d / ps / stop / start / restart / down;
  6. 私有仓库选择:轻量场景用 registry,企业生产推荐 Harbor;
  7. 使用 HTTP 私有仓库要配置 insecure-registries,使用域名要配置 hosts 解析,推送前要 docker login,用完要 docker logout。

支持与分享

如果这篇文章对你有帮助,欢迎分享给更多人或者给予支持!