Docker 常用操作手册

# 卸载旧版本yum remove docker docker-client docker-client-latest docker-common docker-latest docker-latest-logrotate docker-logrotate docker-engine# 安装依赖yum install -y yum-utils# 添加 Docker 官方源（国内用阿里云镜像）yum-config-manager --add-repo https://mirrors.aliyun.com/docker-ce/linux/centos/docker-ce.repo# 安装yum install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin# 启动并设置开机自启systemctl start dockersystemctl enable docker# 验证docker --versiondocker run hello-world

# 更新包索引apt update# 安装依赖apt install -y ca-certificates curl gnupg lsb-release# 添加 Docker 官方 GPG keycurl -fsSL https://mirrors.aliyun.com/docker-ce/linux/ubuntu/gpg | gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg# 添加源echo "deb [arch=amd64 signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] https://mirrors.aliyun.com/docker-ce/linux/ubuntu $(lsb_release -cs) stable" | tee /etc/apt/sources.list.d/docker.list > /dev/null# 安装apt updateapt install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin# 启动systemctl start dockersystemctl enable docker

# 编辑配置文件mkdir -p /etc/dockercat > /etc/docker/daemon.json << 'EOF'{  "registry-mirrors": [    "https://mirror.ccs.tencentyun.com",    "https://docker.mirrors.ustc.edu.cn",    "https://hub-mirror.c.163.com"  ],  "log-driver": "json-file",  "log-opts": {    "max-size": "100m",    "max-file": "3"  }}EOF# 重启 Dockersystemctl daemon-reloadsystemctl restart docker

# 在 Docker Hub 搜索docker search mysqldocker search nginx --limit 5  # 只显示前 5 个# 输出列：# NAME          镜像名# DESCRIPTION   描述# STARS         点赞数（越高越热门）# OFFICIAL      是否官方 [OK]# AUTOMATED     是否自动构建

# 默认拉 latestdocker pull mysql# 指定版本docker pull mysql:8.0docker pull nginx:1.25-alpinedocker pull node:18# 指定完整路径（从其他仓库拉）docker pull registry.cn-hangzhou.aliyuncs.com/library/mysql:8.0

# 列出本地镜像docker images# 只显示镜像 IDdocker images -q# 过滤显示docker images --filter "dangling=true"  # 只显示悬空镜像（无标签的中间层）docker images --format "{{.Repository}}:{{.Tag}} {{.Size}}"  # 自定义格式

# 按 ID 删除docker rmi <image-id># 按名称:标签删除docker rmi mysql:8.0# 强制删除（即使有容器引用）docker rmi -f mysql:8.0# 批量删除所有镜像docker rmi $(docker images -q)# 清理悬空镜像（无标签的中间层）docker image prune# 清理所有未使用的镜像docker image prune -a

# 给镜像打标签docker tag mysql:8.0 my-mysql:v1# 推送到私有仓库前打标签docker tag my-app:latest registry.example.com/my-app:v1.0

# 保存镜像为 tar 文件（离线传输用）docker save -o mysql.tar mysql:8.0# 或docker save mysql:8.0 > mysql.tar# 加载 tar 文件docker load -i mysql.tar# 或docker load < mysql.tar# 查看镜像详情docker inspect mysql:8.0docker history mysql:8.0  # 查看镜像构建历史（每层）

# 查看镜像的完整信息docker inspect mysql:8.0# 查看镜像构建层docker history mysql:8.0# 查看 MySQL 镜像的架构信息docker inspect mysql:8.0 --format '{{.Architecture}} {{.Os}}'

docker run [OPTIONS] IMAGE [COMMAND]# 常用 OPTIONS--name        容器名-d            后台运行-it           交互式（进入容器终端）-p            端口映射 宿主端口:容器端口-P            随机端口映射-v            挂载数据卷 宿主路径:容器路径-e            设置环境变量--env-file    从文件读取环境变量--network     指定网络--restart     重启策略（no/always/on-failure/unless-stopped）--rm          容器退出后自动删除--entrypoint  覆盖入口点-w            设置工作目录

# 启动 Nginxdocker run -d --name my-nginx -p 80:80 nginx# 启动 MySQLdocker run -d --name my-mysql \  -p 3306:3306 \  -e MYSQL_ROOT_PASSWORD=123456 \  -e MYSQL_DATABASE=travel_db \  -v /data/mysql:/var/lib/mysql \  --restart unless-stopped \  mysql:8.0# 启动 Redisdocker run -d --name my-redis \  -p 6379:6379 \  -e REDIS_PASSWORD=YourRedisPass \  -v /data/redis:/data \  redis:7-alpine redis-server --requirepass YourRedisPass# 进入容器docker run -it --name my-ubuntu ubuntu /bin/bash# 一次性容器（退出即删）docker run --rm -it alpine sh

# 查看运行中的容器docker ps# 查看所有容器（包括已停止的）docker ps -a# 只显示容器 IDdocker ps -q# 自定义格式docker ps --format "table {{.Names}}\t{{.Status}}\t{{.Ports}}"# 查看最近创建的容器docker ps -ldocker ps -n 5  # 最近 5 个

docker start   <容器名或ID>    # 启动docker stop    <容器名或ID>    # 停止（优雅关闭，发送 SIGTERM）docker kill    <容器名或ID>    # 强制停止（SIGKILL）docker restart <容器名或ID>    # 重启# 批量停止所有容器docker stop $(docker ps -q)# 批量删除所有已停止的容器docker container prune

# 方式 1：exec（推荐，不会新建进程）docker exec -it my-nginx /bin/bashdocker exec -it my-nginx sh       # alpine 镜像用 sh# 方式 2：attach（直接连到主进程，退出会导致容器停止）docker attach my-nginx# Ctrl+P, Ctrl+Q 退出而不停止容器# 方式 3：nsenter（高级，需安装）PID=$(docker inspect --format "{{.State.Pid}}" my-nginx)nsenter --target $PID --mount --uts --ipc --net --pid

# 查看全部日志docker logs my-nginx# 实时查看docker logs -f my-nginx# 查看最近 100 行docker logs --tail 100 my-nginx# 查看指定时间后的日志docker logs --since "2024-01-01" my-nginxdocker logs --since 30m my-nginx  # 最近 30 分钟# 带时间戳docker logs -t my-nginx# 导出日志到文件docker logs my-nginx > nginx.log 2>&1

# 从容器复制到宿主机docker cp my-nginx:/etc/nginx/nginx.conf /tmp/nginx.conf# 从宿主机复制到容器docker cp /tmp/nginx.conf my-nginx:/etc/nginx/nginx.conf# 复制整个目录docker cp my-nginx:/etc/nginx/ /tmp/nginx-config/

# 查看容器完整信息docker inspect my-nginx# 查看指定字段docker inspect my-nginx --format '{{.State.Status}}'docker inspect my-nginx --format '{{.NetworkSettings.IPAddress}}'docker inspect my-nginx --format '{{range .NetworkSettings.Networks}}{{.IPAddress}}{{end}}'# 查看容器资源使用（CPU、内存、网络、IO）docker statsdocker stats my-nginx  # 指定容器docker stats --no-stream  # 只输出一次# 查看容器内进程docker top my-nginx# 查看容器端口映射docker port my-nginx

# 把容器当前状态保存为新镜像docker commit -m "添加了 vim" -a "作者名" my-ubuntu my-ubuntu:vim# 用新镜像启动docker run -it my-ubuntu:vim /bin/bash

# 导出容器文件系统为 tar（不是镜像，是快照）docker export my-nginx > nginx.tar# 导入为镜像docker import nginx.tar my-nginx:custom

# CMD：可以被 docker run 后面的命令覆盖CMD ["node", "app.js"]# docker run my-app              # 执行 node app.js# docker run my-app ls           # 执行 ls，覆盖了 CMD# ENTRYPOINT：不会被覆盖，CMD 作为参数追加ENTRYPOINT ["node"]CMD ["app.js"]# docker run my-app              # 执行 node app.js# docker run my-app server.js    # 执行 node server.js# 推荐组合：ENTRYPOINT 定命令，CMD 定默认参数

# DockerfileFROM openjdk:17-jdk-slimLABEL maintainer="your-email@example.com"WORKDIR /appCOPY target/my-project.jar app.jarENV TZ=Asia/ShanghaiENV JAVA_OPTS="-Xms512m -Xmx512m"EXPOSE 8080ENTRYPOINT ["sh", "-c", "java $JAVA_OPTS -jar app.jar"]

# 构建docker build -t my-project:1.0 .# 带构建参数docker build --build-arg VERSION=1.0 -t my-project:1.0 .# 运行docker run -d --name my-api \  -p 8080:8080 \  -v /data/logs:/app/logs \  --restart unless-stopped \  my-project:1.0

# 阶段 1：构建FROM node:18-alpine AS builderWORKDIR /appCOPY package*.json ./RUN npm installCOPY . .RUN npm run build# 阶段 2：运行（多阶段构建减小体积）FROM nginx:alpineCOPY --from=builder /app/dist /usr/share/nginx/htmlCOPY nginx.conf /etc/nginx/conf.d/default.confEXPOSE 80CMD ["nginx", "-g", "daemon off;"]

# nginx.confserver {    listen 80;    location / {        root /usr/share/nginx/html;        try_files $uri $uri/ /index.html;    }}

# 多阶段构建：最终镜像只包含最后阶段的产物，体积更小FROM node:18 AS buildWORKDIR /appCOPY . .RUN npm ci && npm run buildFROM nginx:alpineCOPY --from=build /app/dist /usr/share/nginx/html# 最终镜像只有 nginx + 静态文件，不带 node_modules

# 1. 具名卷（推荐生产用）—— Docker 管理docker run -d -v my-data:/var/lib/mysql mysql:8.0# 2. 匿名卷 —— 自动生成随机名docker run -d -v /var/lib/mysql mysql:8.0# 3. 绑定挂载 —— 直接挂宿主路径（开发用）docker run -d -v /data/mysql:/var/lib/mysql mysql:8.0

# 列出所有数据卷docker volume ls# 查看数据卷详情docker volume inspect my-data# 创建数据卷docker volume create my-data# 删除数据卷docker volume rm my-data# 清理未使用的数据卷docker volume prune

# 备份：把数据卷内容打包到宿主机docker run --rm \  -v my-data:/data:ro \  -v /backup:/backup \  alpine tar czf /backup/my-data.tar.gz -C /data .# 恢复：把备份解压到新数据卷docker run --rm \  -v my-data:/data \  -v /backup:/backup \  alpine sh -c "cd /data && tar xzf /backup/my-data.tar.gz"

# MySQL 数据持久化docker run -d -v /data/mysql:/var/lib/mysql mysql:8.0# Redis 数据持久化docker run -d -v /data/redis:/data redis:7-alpine# Nginx 配置和日志docker run -d \  -v /data/nginx/conf:/etc/nginx/conf.d \  -v /data/nginx/html:/usr/share/nginx/html \  -v /data/nginx/logs:/var/log/nginx \  nginx# 开发热更新（源码挂载进容器）docker run -d \  -v /my-project/src:/app/src \  -p 3000:3000 \  my-node-app

# 列出网络docker network ls# 创建自定义网络（推荐）docker network create my-network# 创建时指定子网和网关docker network create --subnet=172.20.0.0/16 my-network# 查看网络详情docker network inspect my-network# 容器加入网络docker run -d --network my-network --name my-app my-image# 已运行的容器加入网络docker network connect my-network my-container# 断开网络docker network disconnect my-network my-container# 删除网络docker network rm my-networkdocker network prune  # 清理未使用网络

# 创建网络docker network create app-net# 启动 MySQL（在同一网络）docker run -d --network app-net --name mysql mysql:8.0# 启动后端应用（用容器名作为主机名访问 MySQL）docker run -d --network app-net --name api my-app# 在 api 容器内可以用 mysql:3306 连接数据库# Docker 内置 DNS 会把容器名解析为容器 IP

docker compose version

# .env 文件（与 docker-compose.yml 同目录）MYSQL_ROOT_PASSWORD=rootpasswordAPI_PORT=8080# docker-compose.yml 中引用services:  mysql:    environment:      MYSQL_ROOT_PASSWORD: ${MYSQL_ROOT_PASSWORD}  api:    ports:      - "${API_PORT}:8080"

# 使用不同 env 文件docker compose --env-file .env.production up -d

my-project/├── docker-compose.yml├── .env├── mysql/│   └── init.sql├── api/│   ├── Dockerfile│   ├── target/my-project.jar│   └── application.yml├── web/│   ├── Dockerfile│   ├── dist/│   └── nginx.conf└── nginx/    ├── conf.d/    │   └── default.conf    └── cert/

# 一键启动整个项目cd my-projectdocker compose up -d --build# 查看状态docker compose ps# 查看日志docker compose logs -f# 停止docker compose down# 更新某个服务（重新构建）docker compose up -d --build api

docker run -d --name mysql \  -p 3306:3306 \  -e MYSQL_ROOT_PASSWORD=123456 \  -e MYSQL_DATABASE=travel_db \  -e MYSQL_USER=travel_user \  -e MYSQL_PASSWORD=TravelUserPassword \  -v /data/mysql:/var/lib/mysql \  -v /path/to/init.sql:/docker-entrypoint-initdb.d/init.sql \  --restart unless-stopped \  mysql:8.0 \  --character-set-server=utf8mb4 \  --collation-server=utf8mb4_unicode_ci

docker run -d --name redis \  -p 6379:6379 \  -v /data/redis:/data \  --restart unless-stopped \  redis:7-alpine \  redis-server --requirepass YourRedisPass \  --maxmemory 256mb \  --maxmemory-policy allkeys-lru \  --appendonly yes

docker run -d --name nginx \  -p 80:80 -p 443:443 \  -v /data/nginx/conf.d:/etc/nginx/conf.d \  -v /data/nginx/html:/usr/share/nginx/html \  -v /data/nginx/logs:/var/log/nginx \  -v /data/nginx/cert:/etc/nginx/cert \  --restart unless-stopped \  nginx:1.25-alpine

docker run -d --name api \  -p 8080:8080 \  -v /data/logs:/app/logs \  -v /data/uploads:/app/uploads \  --env-file /path/to/.env \  --restart unless-stopped \  my-project:1.0

FROM node:18-alpineWORKDIR /appCOPY package*.json ./RUN npm ci --productionCOPY . .EXPOSE 3000CMD ["node", "dist/main.js"]

docker run -d --name node-app \  -p 3000:3000 \  -v /data/logs:/app/logs \  --restart unless-stopped \  my-node-app:1.0

# 编辑 /etc/docker/daemon.json{  "registry-mirrors": [    "https://mirror.ccs.tencentyun.com",    "https://docker.mirrors.ustc.edu.cn",    "https://hub-mirror.c.163.com"  ]}# 重启systemctl daemon-reloadsystemctl restart docker# 验证docker info | grep -A 5 "Registry Mirrors"

# 登录docker login registry.example.com# 打标签docker tag my-app:1.0 registry.example.com/my-app:1.0# 推送docker push registry.example.com/my-app:1.0# 拉取docker pull registry.example.com/my-app:1.0

# 启动私有仓库docker run -d -p 5000:5000 --name registry \  -v /data/registry:/var/lib/registry \  --restart always \  registry:2# 使用（HTTP 不安全，需配置 insecure-registries）# /etc/docker/daemon.json 添加：# { "insecure-registries": ["your-server-ip:5000"] }

# 查看 Docker 占用docker system df# 清理悬空镜像docker image prune# 清理所有未使用镜像docker image prune -a# 清理停止的容器docker container prune# 清理未使用的数据卷docker volume prune# 一键清理docker system prune -a# 查看 /var/lib/docker 大文件du -sh /var/lib/docker/*

# 查看端口被谁占用lsof -i:8080# 或netstat -tlnp | grep 8080# 停止占用端口的容器或进程docker stop <container># 或kill <PID># 修改容器端口映射docker stop my-containerdocker rm my-containerdocker run -d -p 9090:8080 ...  # 换个端口

# 进入容器后设置 localedocker exec -it my-container env LANG=C.UTF-8 LC_ALL=C.UTF-8# 或在 Dockerfile 中设置ENV LANG=C.UTF-8ENV LC_ALL=C.UTF-8

# 检查网络docker network lsdocker network inspect bridge# 重启 Docker 服务systemctl restart docker# 检查 iptablesiptables -L -n# 如果规则丢失，重启 Docker 会自动重建# 使用 host 网络测试docker run --rm --network host alpine ping 8.8.8.8

# 挂载目录权限不足chmod -R 755 /data/mysql# SELinux 导致挂载失败# 临时关闭setenforce 0# 或挂载时加 :Zdocker run -v /data/mysql:/var/lib/mysql:Z mysql:8.0# 以非 root 用户运行docker run -u 1000:1000 ...

# 查看退出原因docker inspect <container> --format '{{.State.ExitCode}} {{.State.Error}}'docker logs <container># 常见原因：# 1. CMD 命令执行完就退出（前台进程结束）# 2. 容器内应用崩溃# 3. 内存不足被 OOM Killer 杀掉docker inspect <container> --format '{{.State.OOMKilled}}'

# 方式 1：环境变量docker run -e TZ=Asia/Shanghai ...# 方式 2：挂载宿主机时区文件docker run -v /etc/localtime:/etc/localtime:ro \           -v /etc/timezone:/etc/timezone:ro \           ...# Dockerfile 中ENV TZ=Asia/ShanghaiRUN ln -snf /usr/share/zoneinfo/$TZ /etc/localtime && echo $TZ > /etc/timezone

# 好的写法（利用缓存）COPY package*.json ./RUN npm ciCOPY . .              # 源码变了不会重新 npm install# 不好的写法（每次都重新 install）COPY . .RUN npm ci

# .dockerignorenode_modulesnpm-debug.log.git.gitignore.envdistcoverage*.md

# 资源限制示例docker run -d \  --memory=512m \  --memory-swap=1g \  --cpus=1.5 \  --restart unless-stopped \  my-app

docker ps                    # 看有哪些容器在跑docker logs -f <name>        # 看日志docker exec -it <name> sh    # 进容器docker compose up -d         # 一键启动docker compose down          # 一键停止docker system prune -a       # 清理磁盘