Docker 入门与实践

Docker 是目前最主流的容器化工具:把应用和它的运行环境一起打包成一个「盒子」,在任何装好 Docker 的机器上用同样的方式运行。

本页按「是什么 → 怎么装 → 核心概念 → 常用命令 → 构建镜像 → 编排 → 实际部署 → 运维排错」的顺序组织,可以按需跳读。

一句话:Docker 把「程序和它的运行环境」打包成镜像,用容器的方式隔离运行。

传统的痛点是「在我机器上是好的」:Python 版本、系统库、环境变量、依赖版本对不上,换台机器就跑不起来。Docker 把这些东西一起固化进镜像,运行环境随程序走。

对比项 虚拟机(VM) Docker 容器
隔离方式 硬件虚拟化,每台跑一个完整操作系统 共享宿主机内核,进程级隔离
启动速度 分钟级 毫秒到秒级
资源开销 每台通常几 GB 内存 通常几十 MB
体积 镜像常见 GB 级 常见几十 MB 到几百 MB
隔离强度 强(各自独立内核) 较弱(共用内核,安全边界不如 VM)

结论:容器不是轻量虚拟机,它就是一个被限制了视野的进程。

  • 镜像 image:只读的应用模板,包含文件系统 + 启动命令 + 元数据。用 Dockerfile 构建出来,可以分层复用。
  • 容器 container:镜像的运行实例。镜像可以起无数个容器,容器内写入的数据默认随容器删除而消失。
  • 仓库 registry:镜像的分发中心,官方的叫 Docker Hub,公司内部常用 Harbor、GitLab Registry 等。

配套的两个概念:

  • 数据卷 volume:把需要长期保存的数据放在容器之外,容器删掉数据还在。
  • 网络 network:容器之间、容器和外部世界互通的方式,同一自定义网络内的容器可以用容器名互相访问。
  • 统一开发、测试、生产环境,减少「环境不一致」类问题
  • 快速部署开源软件(数据库、中间件、监控、博客系统等)
  • 把自研服务打包成镜像,交给 CI/CD 自动发布
  • 在一台机器上跑多个互不干扰的服务

推荐用官方 apt 仓库安装,这样能跟着系统一起升级:

sudo apt update
sudo apt install -y ca-certificates curl gnupg
sudo install -m 0755 -d /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/ubuntu/gpg \
  | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg
echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] \
https://download.docker.com/linux/ubuntu $(. /etc/os-release && echo $VERSION_CODENAME) stable" \
  | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
sudo apt update
sudo apt install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

只想在个人测试机上快速装完,也可以执行官方一键脚本(不适合生产环境):

curl -fsSL https://get.docker.com | sh
docker version          # 客户端 + 服务端版本
docker info             # 服务端详情:存储驱动、镜像数、根目录
docker run hello-world  # 跑一个最小镜像,能输出提示就说明通了
sudo usermod -aG docker $USER
# 重新登录(或 newgrp docker)后生效

注意:加入 docker 组等于给了这台机器的 root 权限,生产服务器上要谨慎。

编辑 /etc/docker/daemon.json 这个文件:

{
  "registry-mirrors": ["https://docker.m.daocloud.io"],
  "log-driver": "json-file",
  "log-opts": { "max-size": "10m", "max-file": "3" }
}

改完用 sudo systemctl restart docker 重启服务。日志上限很重要,否则容器日志会把磁盘写满。

Docker 采用客户端/服务端架构:

  • docker CLI:你敲的命令行,负责把请求发给守护进程
  • dockerd(守护进程):真正干活的,管理镜像、容器、网络、卷
  • containerd / runc:底层运行时,负责实际创建和启动容器进程
  • registry:镜像仓库,docker pull 从这里下载镜像,docker push 推上去

镜像采用分层存储:Dockerfile 里每条构建指令生成一层,层可以被多个镜像共享。容器启动时在镜像最上面加一个可写层,所有修改都写在这层里,因此:

  • 容器删掉,可写层的改动就没了
  • 需要保留的数据必须放到数据卷或挂载目录里
docker pull nginx:1.27-alpine     # 下载镜像,不写 tag 默认 latest(不建议)
docker images                     # 列出本地镜像
docker image inspect nginx:1.27   # 查看镜像详情
docker rmi nginx:1.27             # 删除镜像
docker tag myapp:1.0 registry.example.com/myapp:1.0
docker push registry.example.com/myapp:1.0
docker run -d --name web -p 8080:80 nginx:1.27-alpine   # 后台运行并映射端口
docker run -it --rm ubuntu:22.04 bash                   # 交互式临时容器,退出即删
docker ps                       # 运行中的容器
docker ps -a                    # 包括已停止的
docker logs -f --tail 100 web   # 跟踪日志
docker exec -it web sh          # 进入容器
docker stop web / docker start web / docker restart web
docker rm web                   # 删除容器(先 stop)
docker cp web:/etc/nginx/nginx.conf ./nginx.conf
docker inspect web              # 完整信息(JSON)
docker stats                    # 实时资源占用

端口映射的写法是 -p 宿主机端口:容器端口 ,比如 8080:80 表示访问宿主机 8080 就打到容器里的 80。

docker volume create app-data
docker volume ls
docker network create appnet
docker network ls
docker system df                # 先看看占了多少
docker system prune             # 清理停止的容器、悬空镜像、未用网络
docker system prune -a --volumes  # 更彻底,慎用

Dockerfile 是构建镜像的说明书。一个 Node.js 服务的例子:

FROM node:20-alpine
WORKDIR /app
COPY package*.json ./
RUN npm ci --omit=dev
COPY . .
ENV NODE_ENV=production
EXPOSE 3000
USER node
CMD ["node", "server.js"]

构建并运行:

docker build -t myapp:1.0 .
docker run -d --name myapp -p 3000:3000 myapp:1.0
指令 作用
FROM 基础镜像,必须是第一条有效指令
WORKDIR 设置后续指令的工作目录
COPY 从构建上下文拷贝文件进镜像
ADD 类似 COPY,还能解压 tar、拉远程 URL(一般优先用 COPY)
RUN 构建时执行命令,结果固化进镜像层
ENV 设置镜像内的环境变量(运行时可被覆盖)
ARG 构建期参数,只在构建时可见
EXPOSE 声明监听端口,只是文档性质,不发布端口
VOLUME 声明匿名数据卷挂载点
USER 切换运行用户,避免用 root
HEALTHCHECK 定义健康检查命令
CMD 容器启动的默认命令,可被 docker run 后面的参数覆盖
ENTRYPOINT 容器入口,不易被覆盖,常配合 CMD 传默认参数

把编译环境和运行环境分开,最终镜像只留运行需要的文件:

FROM golang:1.22 AS builder
WORKDIR /src
COPY go.mod go.sum ./
RUN go mod download
COPY . .
RUN CGO_ENABLED=0 go build -o /out/app ./cmd/app
 
FROM gcr.io/distroless/static
COPY --from=builder /out/app /app
ENTRYPOINT ["/app"]
  • 把变化少的内容放前面:先拷贝依赖清单并安装依赖,最后才拷贝源码
  • 写 .dockerignore 文件,排除不需要进构建上下文的文件:
node_modules
.git
.env
dist
*.log
  • 合并 RUN 里相关的命令,并及时清理包管理器缓存
方式 写法 典型场景
具名卷 -v app-data:/var/lib/postgresql/data 数据库等需要长期保存的数据,由 Docker 管理
绑定挂载 -v /srv/app/logs:/app/logs 需要直接在宿主机上查看或编辑的文件(配置、日志)
匿名卷 只写容器内路径 临时使用,不推荐依赖

一句话原则:容器里只放代码,数据一律放卷或挂载目录。

docker network create appnet
docker run -d --name api --network appnet myapp:1.0
docker run -d --name db --network appnet postgres:16-alpine

要点:

  • 在同一个自定义网络里,容器之间可以直接用容器名当主机名,例如应用连数据库时,主机名直接写数据库的容器名 db
  • 容器里的 localhost 指的是容器自己,不是宿主机
  • 需要访问宿主机上的服务时,Linux 下用宿主机在网桥上的 IP(通常是 172.17.0.1),或者用 host.docker.internal 这个主机名(需要额外配置)
  • 默认的 bridge 网络不支持用容器名互访,所以务必建自定义网络或直接用 Compose

一个容器还好管,服务一多(应用 + 数据库 + 缓存 + 反向代理)就得用 Compose 把配置写进 compose.yaml ,一条命令起停整套。

services:
  web:
    build: .
    ports:
      - "8080:3000"
    environment:
      DATABASE_URL: postgres://app:secret@db:5432/app
    depends_on:
      db:
        condition: service_healthy
    restart: unless-stopped

  db:
    image: postgres:16-alpine
    environment:
      POSTGRES_USER: app
      POSTGRES_PASSWORD: secret
      POSTGRES_DB: app
    volumes:
      - db-data:/var/lib/postgresql/data
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U app"]
      interval: 5s
      timeout: 3s
      retries: 10

volumes:
  db-data:

常用命令:

docker compose up -d          # 后台启动整套
docker compose up -d --build  # 重新构建镜像再启动
docker compose ps             # 查看状态
docker compose logs -f web    # 看某个服务的日志
docker compose exec web sh    # 进某个服务
docker compose restart web    # 重启单个服务
docker compose down           # 停止并删除容器(卷默认保留)
docker compose config         # 检查配置是否正确

旧的 docker-compose (带连字符)是 v1,已停止维护;现在统一用 v2 插件形式 docker compose 。

restart 策略值得记住:no 、always 、on-failure 、unless-stopped 。生产环境一般用 unless-stopped ,机器重启后服务能自动回来。

下面是最常见的一套流程:一台云服务器 + 域名 + 应用容器 + 数据库容器 + Nginx 反向代理 + HTTPS。

  • 一台 Linux 服务器(1 核 2G 起,把域名 A 记录解析到它的公网 IP)
  • 开放 80、443 端口;不要对公网暴露数据库端口
  • 按第二章安装 Docker 并配置镜像加速、日志上限
sudo mkdir -p /srv/myapp && cd /srv/myapp
# 上传代码,或 git clone 仓库

目录结构大致是:

/srv/myapp
├── compose.yaml
├── Dockerfile
├── .env
└── src/
POSTGRES_PASSWORD=换成你的强密码
DATABASE_URL=postgres://app:换成你的强密码@db:5432/app

.env 要放到 compose.yaml 同级目录,并在 compose.yaml 里用 ${POSTGRES_PASSWORD} 引用。凭据绝不写进镜像,也不提交到 Git。

docker compose up -d --build
docker compose ps
docker compose logs -f

看到服务状态正常、日志没有报错,应用就在 8080 上跑起来了。

server {
    listen 80;
    server_name example.com;
 
    location / {
        proxy_pass http://127.0.0.1:8080;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}

再执行 sudo certbot --nginx -d example.com 自动签发并续期 HTTPS 证书。

也可以把 Nginx 本身做成一个 Compose 服务,放到同一个网络里,proxy_pass 直接写应用的服务名。

cd /srv/myapp
git pull
docker compose pull        # 若基础镜像有更新
docker compose up -d --build
docker compose ps
docker compose exec -T db pg_dump -U app app | gzip > /srv/backup/app-$(date +%F).sql.gz

用 cron 定时执行,并定期验证备份文件能不能恢复。

  • docker compose ps 看容器是不是在跑、有没有反复重启
  • docker compose logs --tail 200 服务名 看日志,90% 的问题在这里
  • docker inspect 容器名 看退出码、挂载、环境变量、网络
  • docker exec -it 容器名 sh 进去手工验证(能不能连数据库、文件在不在)
现象 原因与处理
容器起来几秒就退出 主进程执行完或报错,先看 docker logs ;容器需要一个前台进程撑着
端口被占用 ss -lntp 找到占用者,或换一个宿主机端口
容器里连不上宿主机服务 容器内的 localhost 是自己,用服务名或网桥 IP
容器之间互相访问失败 不在同一自定义网络里,用 Compose 或 docker network connect
挂载目录没有权限 容器内用户 uid/gid 与宿主机目录属主不匹配,chown 或指定 user
时区不对 加参数 -e TZ=Asia/Shanghai ,或挂载 /etc/localtime
磁盘被占满 docker system df 定位,限制日志大小,用 docker system prune 清理
拉取镜像超时 配置 registry 镜像加速,或给 dockerd 设置 HTTP 代理
.env 改了不生效 环境变量在容器创建时注入,需要 docker compose up -d 重建容器
docker inspect -f '{{.State.Status}}' web        # 只看状态
docker inspect -f '{{json .NetworkSettings.Networks}}' web
docker compose top                                # 看容器里的进程
docker compose down && docker compose up -d       # 配置改动后的干净重启
  • 一个容器只跑一个主进程,别把应用和数据库塞进同一个镜像
  • 基础镜像选精简版(alpine 、slim 、distroless ),并固定版本 tag,不要用 latest
  • 用多阶段构建缩小产物体积
  • 用非 root 用户运行(USER ),只读挂载不需要写入的目录
  • 敏感信息用环境变量、secret 或外部配置中心,不进镜像、不进 Git
  • 数据一律放卷,容器本身当作可随时丢弃的
  • 给关键服务配 healthcheck 和 restart 策略
  • 限制日志大小与容器资源(--memory 、--cpus )
  • 定期清理与更新镜像,扫描漏洞(如 trivy image )
  • 编排:单机用 Compose,多机再上 Kubernetes(Docker Swarm 已较少用于新项目)
  • CI/CD:GitHub Actions / GitLab CI 里 build 并 push 镜像,服务器上只做 pull + up
  • 镜像仓库:自建 Harbor,做镜像签名、复制和权限管理
  • 可观测性:cAdvisor + Prometheus + Grafana 看资源,Loki 收日志
  • 构建优化:BuildKit、Buildx 多平台构建(--platform linux/amd64,linux/arm64 ),构建缓存
  • 安全:Rootless 模式、镜像漏洞扫描、最小权限运行
  • Docker 的核心是镜像—容器—仓库三件套,加上卷和网络
  • 日常操作记牢几条:docker run -d -p 、docker ps 、docker logs -f 、docker exec -it 、docker build -t
  • 多服务用 compose.yaml 描述,docker compose up -d 一条命令起停
  • 上线要做的三件事:数据放卷、凭据放 .env 、日志设上限
  • 出问题先看日志,再 inspect,最后进容器手工验证

该主题尚不存在

您访问的页面并不存在。如果允许,您可以使用创建该页面按钮来创建它。

  • docker.1791452533.txt.gz
  • 最后更改: 2026/10/08 17:42
  • 由 张叶安