Docker 是目前最主流的容器化工具:把应用和它的运行环境一起打包成一个「盒子」,在任何装好 Docker 的机器上用同样的方式运行。
本页按「是什么 → 怎么装 → 核心概念 → 常用命令 → 构建镜像 → 编排 → 实际部署 → 运维排错」的顺序组织,可以按需跳读。
一句话:Docker 把「程序和它的运行环境」打包成镜像,用容器的方式隔离运行。
传统的痛点是「在我机器上是好的」:Python 版本、系统库、环境变量、依赖版本对不上,换台机器就跑不起来。Docker 把这些东西一起固化进镜像,运行环境随程序走。
| 对比项 | 虚拟机(VM) | Docker 容器 |
|---|---|---|
| 隔离方式 | 硬件虚拟化,每台跑一个完整操作系统 | 共享宿主机内核,进程级隔离 |
| 启动速度 | 分钟级 | 毫秒到秒级 |
| 资源开销 | 每台通常几 GB 内存 | 通常几十 MB |
| 体积 | 镜像常见 GB 级 | 常见几十 MB 到几百 MB |
| 隔离强度 | 强(各自独立内核) | 较弱(共用内核,安全边界不如 VM) |
结论:容器不是轻量虚拟机,它就是一个被限制了视野的进程。
Dockerfile 构建出来,可以分层复用。配套的两个概念:
推荐用官方 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 重启服务。日志上限很重要,否则容器日志会把磁盘写满。
Windows 和 macOS 没有 Linux 内核,官方给出的图形化方案是 Docker Desktop:它内置了 Docker Engine、CLI、Compose、Buildx,还带一个可选的单节点 Kubernetes。
安装步骤(Windows 为例):
docker version 验证,CLI 与 Docker Desktop 是同一套,命令和在 Linux 上完全一样界面里几个主要页面:
| 页面 | 用途 |
|---|---|
| Containers | 查看和启停容器;点进去能看日志(Logs)、进终端(Exec)、浏览容器内文件(Files) |
| Images | 本地镜像列表,可以直接 Run 成容器,也能 Pull 新镜像 |
| Volumes / Builds | 管理数据卷、查看构建历史与缓存 |
| Settings | 资源分配、镜像加速、文件共享、Kubernetes 开关 |
常用操作:
8080:80 )和挂载卷,就起了一个容器docker exec -it几个容易踩的坑:
/home/you/project )里比放在 C 盘快很多localhost 不是你的电脑,要访问宿主机上的服务得用 host.docker.internal在 Docker Desktop 的终端里,本页后面所有命令都能直接执行,用法与 Linux 完全一致。
Docker 采用客户端/服务端架构:
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
要点:
dblocalhost 指的是容器自己,不是宿主机host.docker.internal 这个主机名(需要额外配置)bridge 网络不支持用容器名互访,所以务必建自定义网络或直接用 Compose有状态服务是最常自建的一类,套路基本一致:官方镜像 + 数据卷 + 环境变量初始化 + 只对内网暴露端口。
最小可用的启动命令:
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 是必填项,不写容器会直接退出MYSQL_USER 和 MYSQL_PASSWORD 建业务账号,应用不要用 root 连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 脚本只在数据目录为空的第一次启动时执行,之后放进去不会跑;想重跑得换一个新卷。
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'
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 换成强密码
几个关键点:
--requirepass 并只监听本机--appendonly yes 打开 AOF 持久化,数据落在 /data 卷里连接测试:
docker exec -it redis redis-cli -a 换成强密码 > PING PONG
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 非常方便,但生产环境这类有状态服务,优先考虑云数据库或托管服务;自建的话,备份、监控和内存上限一个都别省。
一个容器还好管,服务一多(应用 + 数据库 + 缓存 + 反向代理)就得用 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。
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,不要用 latestUSER ),只读挂载不需要写入的目录healthcheck 和 restart 策略--memory 、--cpus )trivy image )--platform linux/amd64,linux/arm64 ),构建缓存docker run -d -p 、docker ps 、docker logs -f 、docker exec -it 、docker build -tcompose.yaml 描述,docker compose up -d 一条命令起停.env 、日志设上限