**这是本文档旧的修订版!**
Docker 入门与实践
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 自动发布
- 在一台机器上跑多个互不干扰的服务
二、安装与环境准备
Linux(以 Ubuntu / Debian 为例)
推荐用官方 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 使用
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
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里相关的命令,并及时清理包管理器缓存
六、数据持久化与网络
数据卷 vs 绑定挂载
| 方式 | 写法 | 典型场景 |
|---|---|---|
| 具名卷 | -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
要点:
- 在同一个自定义网络里,容器之间可以直接用容器名当主机名,例如数据库地址写成
postgres:app@db:5432/app* 容器里的localhost指的是容器自己,不是宿主机 * 需要访问宿主机上的服务时,Linux 下用宿主机在网桥上的 IP(通常是 172.17.0.1),或者用host.docker.internal这个主机名(需要额外配置) * 默认的bridge网络不支持用容器名互访,所以务必建自定义网络或直接用 Compose ===== 七、Docker Compose 编排 ===== 一个容器还好管,服务一多(应用 + 数据库 + 缓存 + 反向代理)就得用 Compose 把配置写进compose.yaml,一条命令起停整套。 <code yaml> services: web: build: . ports: - “8080:3000” environment: DATABASEURL: postgres:app:secret@db:5432/app dependson: db: condition: servicehealthy restart: unless-stopped db: image: postgres:16-alpine environment: POSTGRESUSER: app POSTGRESPASSWORD: secret POSTGRESDB: app volumes: - db-data:/var/lib/postgresql/data healthcheck: test: [“CMD-SHELL”, “pgisready -U app”] interval: 5s timeout: 3s retries: 10 volumes: db-data: </code> 常用命令: <code bash> 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 # 检查配置是否正确 </code> 旧的sudo certbot –nginx -d example.comdocker-compose(带连字符)是 v1,已停止维护;现在统一用 v2 插件形式docker compose。restart策略值得记住:no、always、on-failure、unless-stopped。生产环境一般用unless-stopped,机器重启后服务能自动回来。 ===== 八、实战:部署一个 Web 应用 ===== 下面是最常见的一套流程:一台云服务器 + 域名 + 应用容器 + 数据库容器 + Nginx 反向代理 + HTTPS。 ==== 1. 准备服务器 ==== - 一台 Linux 服务器(1 核 2G 起,把域名 A 记录解析到它的公网 IP) - 开放 80、443 端口;不要对公网暴露数据库端口 - 按第二章安装 Docker 并配置镜像加速、日志上限 ==== 2. 放置项目 ==== <code bash> sudo mkdir -p /srv/myapp && cd /srv/myapp # 上传代码,或 git clone 仓库 </code> 目录结构大致是: <code> /srv/myapp ├── compose.yaml ├── Dockerfile ├── .env └── src/ </code> ==== 3. 用 .env 管理密码 ==== <code> POSTGRESPASSWORD=换成你的强密码 DATABASEURL=postgres:app:换成你的强密码@db:5432/app </code>.env要放到compose.yaml同级目录,并在compose.yaml里用${POSTGRES_PASSWORD}引用。凭据绝不写进镜像,也不提交到 Git。 ==== 4. 启动 ==== <code bash> docker compose up -d –build docker compose ps docker compose logs -f </code> 看到服务状态正常、日志没有报错,应用就在 8080 上跑起来了。 ==== 5. 配置 Nginx 反向代理 ==== <code nginx> server { listen 80; servername example.com; location / { proxypass http://127.0.0.1:8080; proxysetheader Host $host; proxysetheader X-Real-IP $remoteaddr; proxysetheader X-Forwarded-For $proxyaddxforwardedfor; proxysetheader X-Forwarded-Proto $scheme; } } </code> 再执行自动签发并续期 HTTPS 证书。 也可以把 Nginx 本身做成一个 Compose 服务,放到同一个网络里,proxy_pass直接写应用的服务名。 ==== 6. 上线后的更新流程 ==== <code bash> cd /srv/myapp git pull docker compose pull # 若基础镜像有更新 docker compose up -d –build docker compose ps </code> ==== 7. 备份(以 PostgreSQL 为例)==== <code bash> docker compose exec -T db pg_dump -U app app | gzip > /srv/backup/app-$(date +%F).sql.gz </code> 用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重建容器 | ==== 几个好用的小命令 ==== <code bash> docker inspect -f 'state.status' web # 只看状态 docker inspect -f 'json_.networksettings.networks' web docker compose top # 看容器里的进程 docker compose down && docker compose up -d # 配置改动后的干净重启 </code> ===== 十、最佳实践与进阶方向 ===== ==== 最佳实践清单 ==== * 一个容器只跑一个主进程,别把应用和数据库塞进同一个镜像 * 基础镜像选精简版(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,最后进容器手工验证