**这是本文档旧的修订版!**
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 Desktop(Windows / macOS)
Windows 和 macOS 没有 Linux 内核,官方给出的图形化方案是 Docker Desktop:它内置了 Docker Engine、CLI、Compose、Buildx,还带一个可选的单节点 Kubernetes。
安装步骤(Windows 为例):
- 到 Docker 官网下载 Docker Desktop 安装包
- 安装时勾选使用 WSL2 后端(也可以在设置里切换),比旧的 Hyper-V 后端更快、更省资源
- 启动后任务栏出现鲸鱼图标,状态显示 Engine running 就绪
- 打开终端执行
docker version验证,CLI 与 Docker Desktop 是同一套,命令和在 Linux 上完全一样
界面里几个主要页面:
| 页面 | 用途 |
|---|---|
| Containers | 查看和启停容器;点进去能看日志(Logs)、进终端(Exec)、浏览容器内文件(Files) |
| Images | 本地镜像列表,可以直接 Run 成容器,也能 Pull 新镜像 |
| Volumes / Builds | 管理数据卷、查看构建历史与缓存 |
| Settings | 资源分配、镜像加速、文件共享、Kubernetes 开关 |
常用操作:
- 在 Images 页面点 Run,填上端口映射(如
8080:80)和挂载卷,就起了一个容器 - 容器详情页的 Logs 是排错第一现场,Exec 相当于执行
docker exec -it - Settings → Resources 里调整 CPU、内存、磁盘上限(默认内存偏小,跑 MySQL 建议给到 4 GB 以上)
- Settings → Docker Engine 里可以直接改 daemon.json,把镜像加速地址粘进去,Apply & restart 生效
- Settings → Resources → File sharing 里配置可以与容器共享的宿主机目录,否则绑定挂载会失败
- 出问题时用 Troubleshoot 看诊断日志,实在不行 Reset to factory defaults 重置
几个容易踩的坑:
- Windows 下的绑定挂载:路径要用 Docker Desktop 认得的写法,或直接用 WSL2 里的路径;项目放在 WSL2 文件系统(如
/home/you/project)里比放在 C 盘快很多 - Docker Desktop 的 Linux 容器实际跑在一个小虚拟机里,所以容器里的
localhost不是你的电脑,要访问宿主机上的服务得用host.docker.internal - 它只适合开发和测试;生产服务器请直接在 Linux 上安装 Docker Engine
- 公司规模较大时,Docker Desktop 的商业授权需要先确认
在 Docker Desktop 的终端里,本页后面所有命令都能直接执行,用法与 Linux 完全一致。
三、架构与工作原理
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
要点:
- 在同一个自定义网络里,容器之间可以直接用容器名当主机名,例如应用连数据库时,主机名直接写数据库的容器名
db - 容器里的
localhost指的是容器自己,不是宿主机 - 需要访问宿主机上的服务时,Linux 下用宿主机在网桥上的 IP(通常是 172.17.0.1),或者用
host.docker.internal这个主机名(需要额外配置) - 默认的
bridge网络不支持用容器名互访,所以务必建自定义网络或直接用 Compose
七、部署 MySQL 与 Redis
有状态服务是最常自建的一类,套路基本一致:官方镜像 + 数据卷 + 环境变量初始化 + 只对内网暴露端口。
MySQL
最小可用的启动命令:
docker run -d --name mysql \ -e MYSQL_ROOT_PASSWORD=换成强密码 \ -e MYSQL_DATABASE=app \ -e MYSQL_USER=app \ -e MYSQL_PASSWORD=换成强密码 \ -e TZ=Asia/Shanghai \ -p 127.0.0.1:3306:3306 \ -v mysql-data:/var/lib/mysql \ --restart unless-stopped \ mysql:8.4
几个关键点:
- 数据必须落在
/var/lib/mysql对应的卷里,容器删了数据还在 - 端口写成
127.0.0.1:3306:3306,只监听本机;直接写3306:3306就等于对公网开放数据库 MYSQL_ROOT_PASSWORD是必填项,不写容器会直接退出- 用
MYSQLUSER建业务账号,应用不要用 root 连和MYSQLPASSWORD - 初次启动初始化要几秒到几十秒,用
docker logs -f mysql看进度
进去验证:
docker exec -it mysql mysql -uroot -p # 输入密码后 SHOW DATABASES;
初始化建表脚本:把 sql 文件挂到镜像约定的目录,首次启动会自动执行。
docker run -d --name mysql \ -e MYSQL_ROOT_PASSWORD=换成强密码 \ -v mysql-data:/var/lib/mysql \ -v /srv/mysql/init:/docker-entrypoint-initdb.d:ro \ mysql:8.4
注意:init 脚本只在数据目录为空的第一次启动时执行,之后放进去不会跑;想重跑得换一个新卷。
用 Compose 管理
services: mysql: image: mysql:8.4 restart: unless-stopped environment: MYSQL_ROOT_PASSWORD: ${MYSQL_ROOT_PASSWORD} MYSQL_DATABASE: app MYSQL_USER: app MYSQL_PASSWORD: ${MYSQL_PASSWORD} TZ: Asia/Shanghai command: - --character-set-server=utf8mb4 - --collation-server=utf8mb4_unicode_ci ports: - "127.0.0.1:3306:3306" volumes: - mysql-data:/var/lib/mysql healthcheck: test: ["CMD", "mysqladmin", "ping", "-h", "127.0.0.1"] interval: 10s timeout: 5s retries: 10 volumes: mysql-data:
应用连接时,主机名写服务名 mysql (在同一个 Compose 网络里),不要写 localhost 。
备份与恢复
# 备份 docker exec mysql sh -c 'exec mysqldump -uroot -p"$MYSQL_ROOT_PASSWORD" app' \ | gzip > /srv/backup/app-$(date +%F).sql.gz # 恢复 gunzip < /srv/backup/app-2026-01-01.sql.gz \ | docker exec -i mysql sh -c 'exec mysql -uroot -p"$MYSQL_ROOT_PASSWORD" app'
Redis
docker run -d --name redis \ -p 127.0.0.1:6379:6379 \ -v redis-data:/data \ --restart unless-stopped \ redis:7-alpine \ redis-server --appendonly yes --requirepass 换成强密码
几个关键点:
- Redis 默认没有密码,一旦暴露到公网很快会被扫到并植入挖矿程序,务必设
--requirepass并只监听本机 --appendonly yes打开 AOF 持久化,数据落在/data卷里- 只当缓存用、丢了也无所谓的场景,可以不挂卷,性能更好
- 生产环境要设内存上限和淘汰策略,避免把宿主机内存吃光
连接测试:
docker exec -it redis redis-cli -a 换成强密码 > PING PONG
用 Compose 管理
services: redis: image: redis:7-alpine restart: unless-stopped command: - redis-server - --appendonly - "yes" - --requirepass - ${REDIS_PASSWORD} - --maxmemory - 512mb - --maxmemory-policy - allkeys-lru ports: - "127.0.0.1:6379:6379" volumes: - redis-data:/data healthcheck: test: ["CMD", "redis-cli", "-a", "${REDIS_PASSWORD}", "PING"] interval: 10s timeout: 3s retries: 5 volumes: redis-data:
想用配置文件,可以把 redis.conf 挂到 /usr/local/etc/redis/redis.conf ,启动命令改成 redis-server /usr/local/etc/redis/redis.conf 。
常见问题
| 现象 | 处理 |
|---|---|
| 应用连不上这两个服务 | 确认在同一网络里;主机名写服务名,不要写 localhost |
| 容器起来就退出 | 多半缺必需的环境变量(MySQL 的 root 密码、Redis 的密码),看 docker logs |
| 数据不见了 | 没挂卷,或者容器内路径写错了(MySQL 是 /var/lib/mysql ,Redis 是 /data ) |
| 中文乱码 | MySQL 启动参数加上 utf8mb4 相关设置 |
| 宿主机内存被打满 | Redis 设 maxmemory 和淘汰策略,容器也可加内存限制 |
一点提醒:本地开发用 Docker 跑 MySQL、Redis 非常方便,但生产环境这类有状态服务,优先考虑云数据库或托管服务;自建的话,备份、监控和内存上限一个都别省。
八、Docker 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 ,机器重启后服务能自动回来。
九、实战:部署一个 Web 应用
下面是最常见的一套流程:一台云服务器 + 域名 + 应用容器 + 数据库容器 + Nginx 反向代理 + HTTPS。
1. 准备服务器
- 一台 Linux 服务器(1 核 2G 起,把域名 A 记录解析到它的公网 IP)
- 开放 80、443 端口;不要对公网暴露数据库端口
- 按第二章安装 Docker 并配置镜像加速、日志上限
2. 放置项目
sudo mkdir -p /srv/myapp && cd /srv/myapp # 上传代码,或 git clone 仓库
目录结构大致是:
/srv/myapp ├── compose.yaml ├── Dockerfile ├── .env └── src/
3. 用 .env 管理密码
POSTGRES_PASSWORD=换成你的强密码 DATABASE_URL=postgres://app:换成你的强密码@db:5432/app
.env 要放到 compose.yaml 同级目录,并在 compose.yaml 里用 ${POSTGRES_PASSWORD} 引用。凭据绝不写进镜像,也不提交到 Git。
4. 启动
docker compose up -d --build docker compose ps docker compose logs -f
看到服务状态正常、日志没有报错,应用就在 8080 上跑起来了。
5. 配置 Nginx 反向代理
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 直接写应用的服务名。
6. 上线后的更新流程
cd /srv/myapp git pull docker compose pull # 若基础镜像有更新 docker compose up -d --build docker compose ps
7. 备份(以 PostgreSQL 为例)
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,最后进容器手工验证