Docker 入门到进阶：容器化部署 Nginx + MySQL + WordPress 实战（附 Dockerfile、docker-compose.yml 详解）

前言在云原生时代Docker 已成为开发与运维人员的必备技能。本文将带你从零开始系统学习 Docker 核心概念与实战技巧最终使用 Docker Compose 一键部署一套高可用的 WordPress 站点其中包含 Nginx 作为反向代理、MySQL 作为数据库并深入剖析 Dockerfile 与 docker-compose.yml 的每一处细节。全文约 2 万字兼顾基础与进阶适合新手入门及有经验者查漏补缺。第一章 Docker 简介与核心概念1.1 什么是 DockerDocker 是一个开源的应用容器引擎它允许开发者将应用及其依赖打包到一个轻量级、可移植的容器中然后发布到任何支持 Docker 的 Linux/Windows/macOS 机器上。容器之间相互隔离但共享操作系统内核因此比传统虚拟机更节省资源、启动更快。传统虚拟机 vs Docker 容器特性虚拟机Docker 容器资源占用GB 级完整 OSMB 级仅应用依赖启动速度分钟级毫秒~秒级隔离级别硬件虚拟化强隔离进程级隔离Namespace内核共享否是1.2 Docker 核心组件镜像Image只读模板包含运行应用所需的代码、库、环境变量、配置文件。类比“类”或“安装光盘”。容器Container镜像的运行实例可被启动、停止、删除。类比“对象”或“安装后的系统”。仓库Repository存储镜像的地方Docker Hub 是官方公共仓库。Dockerfile描述如何构建镜像的脚本文件。Docker Compose定义和运行多容器 Docker 应用的工具通过 YAML 文件配置服务、网络、卷。1.3 为什么选择容器化部署 WordPress传统 LAMP/LNMP 部署需要手动安装 PHP、MySQL、Nginx配置依赖版本极易出现环境不一致问题。而容器化后开发环境、测试环境、生产环境完全一致。升级或回滚 WordPress、PHP、MySQL 版本只需更换镜像标签。隔离性即使服务器上运行其他服务也不互相干扰。弹性伸缩配合编排工具K8s可轻松扩展。第二章 Docker 安装与环境配置2.1 LinuxUbuntu 20.04/22.04安装bash# 更新 apt 索引并安装依赖 sudo apt update sudo apt install -y ca-certificates curl gnupg lsb-release # 添加 Docker 官方 GPG 密钥 sudo mkdir -p /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 $(lsb_release -cs) stable | sudo tee /etc/apt/sources.list.d/docker.list /dev/null # 安装 Docker Engine sudo apt update sudo apt install -y docker-ce docker-ce-cli containerd.io docker-compose-plugin # 将当前用户加入 docker 组避免每次 sudo sudo usermod -aG docker $USER newgrp docker # 或者重新登录 # 验证安装 docker --version docker compose version # 注意 compose v2 命令2.2 Windows / macOSWindows安装 Docker Desktop for Windows需要 WSL2 或 Hyper-V启用 WSL2 后端性能更佳。macOS安装 Docker Desktop for MacIntel 或 Apple Silicon。安装完成后打开终端执行docker run hello-world测试。2.3 配置镜像加速器国内推荐创建或修改/etc/docker/daemon.jsonLinux或通过 Docker Desktop 设置json{ registry-mirrors: [ https://docker.mirrors.ustc.edu.cn, https://hub-mirror.c.163.com ] }重启 Dockersudo systemctl restart dockerLinux。第三章 Docker 基础命令实战3.1 镜像管理bash# 搜索镜像 docker search nginx # 拉取镜像 docker pull nginx:latest docker pull mysql:8.0 # 列出本地镜像 docker images # 删除镜像 docker rmi nginx:latest # 导出/导入镜像 docker save -o nginx.tar nginx:latest docker load -i nginx.tar3.2 容器生命周期bash# 运行容器前台 docker run nginx:latest # 后台运行-d映射端口-p 宿主机:容器命名--name docker run -d --name mynginx -p 8080:80 nginx:latest # 查看运行中容器 docker ps # 查看所有容器含停止 docker ps -a # 停止、启动、重启、删除 docker stop mynginx docker start mynginx docker restart mynginx docker rm mynginx # 强制删除运行中的容器 docker rm -f mynginx # 进入容器内部交互式 shell docker exec -it mynginx /bin/bash # 查看容器日志 docker logs -f mynginx # 查看容器资源占用 docker stats mynginx3.3 实践运行一个简单的 Nginx 并访问bashdocker run -d --name web -p 80:80 nginx:alpine curl localhost # 应看到 Welcome to nginx!第四章 Dockerfile 详解与镜像构建Dockerfile 是构建镜像的蓝图。我们将以 WordPress 运行所需的 PHP-FPM 环境为例讲解常用指令并最终编写一个优化的 WordPress Dockerfile。4.1 Dockerfile 常用指令指令用途示例FROM指定基础镜像FROM ubuntu:22.04RUN构建时执行命令如安装软件包RUN apt update apt install -y nginxCOPY复制本地文件到镜像COPY ./app /var/www/htmlADD类似 COPY但支持 URL 和自动解压 tarADD https://example.com/file.tar.gz /tmpWORKDIR设置工作目录WORKDIR /var/www/htmlENV设置环境变量ENV NODE_ENV productionEXPOSE声明容器监听的端口仅文档作用EXPOSE 80CMD容器启动时的默认命令可被覆盖CMD [nginx, -g, daemon off;]ENTRYPOINT容器启动时的入口命令不可覆盖可追加参数ENTRYPOINT [docker-entrypoint.sh]USER切换执行用户非 root 安全实践USER www-dataVOLUME声明匿名卷用于持久化VOLUME [/var/lib/mysql]4.2 编写 WordPress 专用 DockerfileWordPress 官方镜像基于php:apache但我们想用 Nginx PHP-FPM因此需要自定义。我们将构建一个包含 PHP-FPM 及必要扩展的镜像。dockerfile# 使用官方 PHP-FPM 8.2 镜像基于 Alpine 更小 FROM php:8.2-fpm-alpine # 安装系统依赖与 PHP 扩展 RUN apk update apk add --no-cache \ libzip-dev \ libpng-dev \ libjpeg-turbo-dev \ freetype-dev \ imagemagick-dev \ git \ unzip \ docker-php-ext-configure gd --with-freetype --with-jpeg \ docker-php-ext-install -j$(nproc) gd mysqli pdo_mysql zip exif \ pecl install imagick docker-php-ext-enable imagick \ apk del --no-cache *-dev # 清理开发依赖减小体积 # 安装 WP-CLIWordPress 命令行工具 RUN curl -o /usr/local/bin/wp https://raw.githubusercontent.com/wp-cli/builds/gh-pages/phar/wp-cli.phar \ chmod x /usr/local/bin/wp # 设置工作目录 WORKDIR /var/www/html # 复制 WordPress 源码此处假设源码在本地 build context 的 wordpress/ 目录 # 生产环境建议从官方下载并校验 COPY --chownwww-data:www-data ./wordpress /var/www/html # 使用官方入口脚本保留原 PHP-FPM 入口 COPY docker-entrypoint.sh /usr/local/bin/ ENTRYPOINT [docker-entrypoint.sh] CMD [php-fpm] # 切换非 root 用户 USER www-data # 暴露 PHP-FPM 端口 EXPOSE 9000解释使用 Alpine 基础镜像约 5MB比 Debian 版小很多。安装gd、mysqli、pdo_mysql、zip、exif、imagick等 WordPress 常用扩展。WP-CLI 方便后续管理更新插件、数据库操作。--chownwww-data:www-data确保文件权限正确。docker-entrypoint.sh可以做一些初始化操作如等待数据库就绪、wp-config.php 生成。示例脚本bash#!/bin/sh # docker-entrypoint.sh set -e if [ ! -f /var/www/html/wp-config.php ]; then wp config create --dbname$WORDPRESS_DB_NAME \ --dbuser$WORDPRESS_DB_USER \ --dbpass$WORDPRESS_DB_PASSWORD \ --dbhost$WORDPRESS_DB_HOST \ --allow-root chown www-data:www-data /var/www/html/wp-config.php fi # 执行传入的命令通常是 php-fpm exec $4.3 构建镜像bash# 先下载 WordPress 源码到 wordpress/ 目录 wget https://wordpress.org/latest.tar.gz tar -xzf latest.tar.gz -C ./wordpress --strip-components1 # 构建镜像注意末尾的点 docker build -t my-wordpress:php8.2-fpm .4.4 多阶段构建进阶对于需要编译的场景如安装 PHP 扩展时可以利用多阶段构建分离编译环境与运行时环境进一步减小最终镜像大小。例如dockerfileFROM php:8.2-fpm-alpine AS builder RUN apk add --no-cache $PHPIZE_DEPS \ pecl install redis \ docker-php-ext-enable redis FROM php:8.2-fpm-alpine COPY --frombuilder /usr/local/lib/php/extensions/*/redis.so /usr/local/lib/php/extensions/ RUN docker-php-ext-enable redis第五章 数据持久化Volume 与 Bind Mount容器销毁后内部数据也会丢失如数据库文件、上传的图片。因此需要持久化存储。5.1 Volume推荐由 Docker 管理的存储卷独立于容器生命周期。bash# 创建卷 docker volume create wordpress_data # 挂载卷到容器-v 或 --mount docker run -d --name wpdb -v wordpress_data:/var/lib/mysql mysql:8.0 # 查看卷列表 docker volume ls # 删除卷先停止使用它的容器 docker volume rm wordpress_data5.2 Bind Mount绑定挂载将宿主机目录映射到容器内适合开发时热更新。bashdocker run -d -p 80:80 -v /host/path:/usr/share/nginx/html nginx5.3 实战中的卷规划对于 WordPress 项目MySQL 数据 → 命名卷mysql_dataWordPress 上传文件wp-content/uploads→ 命名卷wp_uploads自定义主题/插件可选→ Bind Mount 或卷第六章 容器网络6.1 默认网络bridge默认网络模式容器通过虚拟网桥通信可访问外网但无法被宿主机外部直接访问除非端口映射。host容器直接使用宿主机网络栈性能高但端口冲突。none隔离网络。自定义网络提供自动 DNS 解析容器名可作为主机名互相访问推荐使用。6.2 自定义桥接网络示例bashdocker network create mynet # 运行两个容器在同一网络 docker run -d --name nginx1 --network mynet nginx docker run -d --name nginx2 --network mynet nginx # 进入 nginx1 测试 ping nginx2 docker exec -it nginx1 ping nginx2 # 成功解析6.3 多容器编排中的网络在 docker-compose.yml 中每个项目默认会创建一个以项目名命名的桥接网络服务之间可以通过服务名互相访问例如wordpress服务可以通过db:3306连接 MySQL。第七章 Docker Compose 入门Compose 通过一个 YAML 文件定义多个容器服务、网络、卷然后一条命令启动所有。7.1 安装 Composev2Docker Desktop 和 Linux 新版本已内置docker compose插件注意不是docker-compose没有连字符。若无可手动安装bashsudo apt install docker-compose-plugin # Ubuntu验证docker compose version7.2 compose.yml 基础结构yamlversion: 3.8 # 版本号目前主流 3.8 services: web: image: nginx:latest ports: - 80:80 volumes: - ./html:/usr/share/nginx/html db: image: mysql:8.0 environment: MYSQL_ROOT_PASSWORD: example volumes: - db_data:/var/lib/mysql volumes: db_data:启动docker compose up -d停止并删除容器docker compose down查看日志docker compose logs -f第八章 实战目标与架构设计我们要部署一个生产可用的 WordPress 站点包含Nginx处理静态文件反向代理 PHP 请求到 PHP-FPM。MySQL数据库存储文章、用户等。WordPress (PHP-FPM)运行 WordPress 核心代码。可选Redis 缓存、HTTPS 终结。架构图textInternet | [Nginx:80/443] / \ 静态文件 proxy_pass (直接返回) to PHP-FPM | [WordPress:9000] | [MySQL:3306]为什么要加 NginxWordPress 官方镜像使用 Apache但 Nginx 处理静态文件效率更高。统一入口便于配置 SSL、限流、缓存。第九章 逐步实现配置与 Dockerfile 编写9.1 准备目录结构textwordpress-docker/ ├── docker-compose.yml ├── nginx/ │ └── default.conf # Nginx 虚拟主机配置 ├── wordpress/ │ ├── Dockerfile # 自定义 WordPress 镜像 │ └── docker-entrypoint.sh ├── mysql/ │ └── init.sql # 初始化脚本可选 └── .env # 环境变量不提交 git9.2 Nginx 配置nginx/default.confnginxserver { listen 80; server_name yourdomain.com localhost; root /var/www/html; index index.php; client_max_body_size 100M; location / { try_files $uri $uri/ /index.php?$args; } location ~ \.php$ { fastcgi_pass wordpress:9000; # 注意服务名 fastcgi_index index.php; fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name; include fastcgi_params; } location ~* \.(js|css|png|jpg|jpeg|gif|ico|svg)$ { expires max; log_not_found off; } # 禁止访问隐藏文件 location ~ /\. { deny all; } }解释fastcgi_pass指向wordpress:9000其中wordpress是 docker-compose 中 WordPress 服务的名称由于它们在同一自定义网络DNS 会自动解析。静态文件缓存策略。9.3 WordPress Dockerfile 与 entrypoint已在第四章完善确保wordpress/目录下有Dockerfile内容见 4.2docker-entrypoint.sh内容见 4.2并赋予执行权限chmod x或者使用官方 WordPress 镜像但加上 Nginx 需要 PHP-FPM 独立所以自建更合适。9.4 MySQL 初始化脚本可选mysql/init.sql可用于创建数据库、用户但通常通过环境变量即可。注意如果使用卷脚本只会首次执行。sqlCREATE DATABASE IF NOT EXISTS wordpress; CREATE USER IF NOT EXISTS wpuser% IDENTIFIED BY strongpassword; GRANT ALL PRIVILEGES ON wordpress.* TO wpuser%; FLUSH PRIVILEGES;9.5 环境变量文件.env存储敏感信息不提交到版本控制。envMYSQL_ROOT_PASSWORDrootpass123 MYSQL_DATABASEwordpress MYSQL_USERwpuser MYSQL_PASSWORDwppass123 WORDPRESS_DB_HOSTdb:3306 WORDPRESS_DB_USERwpuser WORDPRESS_DB_PASSWORDwppass123 WORDPRESS_DB_NAMEwordpress第十章 编写 docker-compose.yml 详细注释最终docker-compose.yml文件包含四个服务nginx、wordpress、db以及可选的phpmyadmin便于管理数据库。yamlversion: 3.8 services: nginx: image: nginx:alpine container_name: wp_nginx ports: - 80:80 - 443:443 # 若配置 SSL 则开启 volumes: - ./nginx/default.conf:/etc/nginx/conf.d/default.conf:ro - wp_uploads:/var/www/html/wp-content/uploads # 共享上传文件 depends_on: - wordpress networks: - wp_network restart: unless-stopped wordpress: build: ./wordpress # 使用当前目录下的 Dockerfile 构建 # 也可以直接使用官方镜像但需调整 Nginx 配置指向 9000 # image: wordpress:php8.2-fpm container_name: wp_php environment: WORDPRESS_DB_HOST: ${WORDPRESS_DB_HOST} WORDPRESS_DB_USER: ${WORDPRESS_DB_USER} WORDPRESS_DB_PASSWORD: ${WORDPRESS_DB_PASSWORD} WORDPRESS_DB_NAME: ${WORDPRESS_DB_NAME} volumes: - wp_uploads:/var/www/html/wp-content/uploads # 可选将主题/插件目录绑定到宿主机便于开发 - ./themes:/var/www/html/wp-content/themes - ./plugins:/var/www/html/wp-content/plugins networks: - wp_network depends_on: - db restart: unless-stopped db: image: mysql:8.0 container_name: wp_db environment: MYSQL_ROOT_PASSWORD: ${MYSQL_ROOT_PASSWORD} MYSQL_DATABASE: ${MYSQL_DATABASE} MYSQL_USER: ${MYSQL_USER} MYSQL_PASSWORD: ${MYSQL_PASSWORD} volumes: - db_data:/var/lib/mysql - ./mysql/init.sql:/docker-entrypoint-initdb.d/init.sql:ro networks: - wp_network restart: unless-stopped command: --default-authentication-pluginmysql_native_password # 以上解决 MySQL 8.0 的 caching_sha2_password 兼容问题 phpmyadmin: image: phpmyadmin/phpmyadmin container_name: wp_pma environment: PMA_HOST: db PMA_PORT: 3306 UPLOAD_LIMIT: 100M ports: - 8080:80 networks: - wp_network depends_on: - db restart: unless-stopped volumes: db_data: name: wp_db_data wp_uploads: name: wp_uploads networks: wp_network: name: wp_network driver: bridge关键点详解服务依赖depends_on确保启动顺序但不会等待服务完全就绪需要应用自己重试连接entrypoint 脚本中已经处理。卷共享wp_uploads卷被 Nginx 和 WordPress 服务共享这样上传的图片才能被 Nginx 直接提供。环境变量使用${VAR}从.env文件读取避免明文写在 yaml 中。网络所有服务加入同一自定义网络wp_network相互通过服务名通信。重启策略unless-stopped保证意外退出后自动重启。phpMyAdmin可选方便管理数据库生产环境建议不对外暴露或加上访问控制。第十一章 启动与验证11.1 启动所有服务bashcd wordpress-docker docker compose up -d首次启动会构建 WordPress 镜像如果使用build拉取 Nginx、MySQL、phpMyAdmin 镜像并创建卷、网络。11.2 查看日志bashdocker compose logs -f观察 MySQL 是否初始化完成、WordPress 是否成功连接数据库。如果 WordPress entrypoint 脚本成功生成wp-config.php你会看到类似 WordPress installed 的信息需自定义。11.3 访问站点WordPress 主页http://localhostphpMyAdminhttp://localhost:8080服务器db用户名wpuser密码见 .env首次访问 WordPress 会要求设置站点标题、管理员账号等。安装完成后尝试上传一张图片到媒体库验证wp-content/uploads卷是否持久化。11.4 常用管理命令bash# 停止所有服务 docker compose down # 停止并删除卷危险会丢失数据 docker compose down -v # 重新构建镜像并启动修改 Dockerfile 后 docker compose up -d --build # 进入容器调试 docker exec -it wp_php /bin/sh第十二章 进阶优化12.1 健康检查Healthcheck在 compose 文件中为服务添加健康检查便于编排工具判断状态。yamlservices: wordpress: healthcheck: test: [CMD, curl, -f, http://localhost:9000/ping] # 需要安装 curl interval: 30s timeout: 10s retries: 3 db: healthcheck: test: [CMD, mysqladmin, ping, -h, localhost] interval: 10s timeout: 5s retries: 512.2 资源限制防止某个容器耗尽主机资源。yamlservices: wordpress: deploy: resources: limits: cpus: 0.5 memory: 512M reservations: cpus: 0.25 memory: 256M注意deploy仅适用于 swarm 模式在普通 compose 中可用cpus和mem_limit旧语法但推荐使用yamlservices: wordpress: mem_limit: 512m cpus: 0.512.3 使用环境变量文件管理不同环境创建.env.production、.env.staging启动时指定bashdocker compose --env-file .env.production up -d12.4 日志管理限制日志大小避免磁盘爆满yamlservices: nginx: logging: driver: json-file options: max-size: 10m max-file: 312.5 加入 Redis 缓存加速WordPress 可以通过 Redis 缓存对象查询提升性能。添加 Redis 服务并配置 WordPress 插件如 Redis Object Cache。yamlservices: redis: image: redis:alpine container_name: wp_redis networks: - wp_network restart: unless-stopped volumes: - redis_data:/data volumes: redis_data:然后在 WordPress 中安装 Redis Object Cache 插件并配置wp-config.phpphpdefine(WP_REDIS_HOST, redis); define(WP_REDIS_PORT, 6379);第十三章 安全实践13.1 以非 root 用户运行我们在 Dockerfile 中已使用USER www-dataMySQL 镜像默认使用mysql用户Nginx 镜像默认使用nginx用户但官方 Alpine 版是以 root 运行主进程需检查。对于 Nginx建议在配置中指定用户nginxuser nginx;13.2 避免在镜像中硬编码密钥使用 Docker secretsswarm或环境变量注入但环境变量在docker inspect中可见有泄露风险。生产环境建议使用 secrets 管理工具如 HashiCorp Vault或 docker-compose 的secrets需要 swarm 或 buildkit。简单场景下确保.env文件权限为 600且不提交到仓库。13.3 网络隔离只将 Nginx 的 80/443 端口暴露到宿主机WordPress 和 MySQL 内部通信不对外暴露。使用防火墙如 ufw仅允许必要端口。13.4 定期更新镜像bashdocker pull nginx:alpine docker compose up -d --build13.5 设置 MySQL 安全选项在docker-compose.yml中添加 MySQL 配置yamlcommand: --max_allowed_packet64M --innodb_buffer_pool_size256M --skip_name_resolveskip_name_resolve可禁用 DNS 反向解析提升性能并避免潜在攻击。第十四章 备份与恢复14.1 备份数据库bashdocker exec wp_db sh -c exec mysqldump --all-databases -uroot -p$MYSQL_ROOT_PASSWORD backup.sql14.2 备份卷上传文件bashdocker run --rm -v wp_uploads:/data -v $(pwd):/backup alpine tar czf /backup/uploads_backup.tar.gz -C /data .14.3 恢复bash# 恢复数据库 docker exec -i wp_db mysql -uroot -p$MYSQL_ROOT_PASSWORD backup.sql # 恢复上传文件 docker run --rm -v wp_uploads:/data -v $(pwd):/backup alpine tar xzf /backup/uploads_backup.tar.gz -C /data14.4 自动化备份脚本使用cron每日备份并保留最近 7 天。bash#!/bin/bash BACKUP_DIR/backups DATE$(date %Y%m%d) docker exec wp_db sh -c exec mysqldump wordpress -uwpuser -p$WORDPRESS_DB_PASSWORD $BACKUP_DIR/wp_db_$DATE.sql find $BACKUP_DIR -name wp_db_*.sql -mtime 7 -delete第十五章 扩展与替代方案15.1 使用 Traefik 作为反向代理Traefik 是云原生反向代理支持自动服务发现、Lets Encrypt 证书自动生成。可以替代 Nginx。yamlservices: traefik: image: traefik:v2.10 command: --api.insecuretrue --providers.docker ports: - 80:80 - 443:443 volumes: - /var/run/docker.sock:/var/run/docker.sock wordpress: labels: - traefik.http.routers.wordpress.ruleHost(example.com) - traefik.http.services.wordpress.loadbalancer.server.port900015.2 使用 Docker Swarm 或 Kubernetes 实现高可用对于更大规模可以将 compose 文件转换为 swarm stack 或 K8s Deployment。15.3 替换 MySQL 为 MariaDBMariaDB 与 MySQL 兼容镜像更小。只需更改 image 为mariadb:10.11。第十六章 故障排查与常见问题16.1 容器无法启动查看日志docker compose logs service检查端口冲突netstat -tulpn | grep 80检查卷权限确保 MySQL 数据目录可写通常自动处理16.2 WordPress 连接数据库超时确认 MySQL 服务已完全启动可加depends_on和健康检查检查.env中的WORDPRESS_DB_HOST是否为db:3306进入 WordPress 容器 ping dbdocker exec wp_php ping db16.3 上传文件大小限制需要在 Nginx 配置中增加client_max_body_size同时在 PHP 配置中修改upload_max_filesize和post_max_size。可以自定义 PHP-FPM 镜像添加dockerfileRUN echo upload_max_filesize 100M /usr/local/etc/php/conf.d/uploads.ini \ echo post_max_size 100M /usr/local/etc/php/conf.d/uploads.ini16.4 性能优化建议使用nginx:alpine和php:8.2-fpm-alpine减小体积。启用 PHP OpCache在镜像中添加opcache.enable1。为静态资源配置 CDN。使用 MySQL 慢查询日志分析。第十七章 总结通过本文你从零开始掌握了 Docker 的核心概念、Dockerfile 编写、数据持久化、网络模型以及如何使用 Docker Compose 编排 Nginx、WordPress、MySQL 三容器应用。我们还深入探讨了生产环境所需的安全、备份、监控、优化策略。