使用 Docker 一键部署本地 WordPress 开发环境

下面是一份适合完全新手的 WordPress 本地安装教程(使用 Docker Desktop + docker compose)

1. 为什么选择 Docker 部署 WordPress?

对于初学者来说,Docker 就像是一个“虚拟打包盒”。它将 WordPress 运行所需的所有组件(数据库、PHP、Web服务器等)打包在隔离的环境中运行,完全不干扰你的电脑主机系统。

主要优势对比:传统环境 vs. Docker 容器

特性传统安装 Docker 容器化部署
环境配置需手动安装和配置 PHP、MySQL、Nginx/Apache,易出现版本冲突和依赖错误。仅需一个配置文件 (docker-compose.yml),环境自动搭建,保证一次成功。
系统侵入安装组件会修改操作系统配置,可能与其他软件冲突。环境完全隔离,零侵入主机系统,不产生任何“数字垃圾”。
可移植性难以将环境从一台电脑迁移到另一台,或从本地迁移到云服务器。极高的可移植性。只需复制项目文件夹,即可在任何支持 Docker 的机器上一键还原
启动/停止需要分别启动和关闭 Web 服务、数据库服务等多个进程。使用 docker compose up -ddown 命令,一键管理所有服务。

简而言之,Docker 是现代本地开发的首选方案。它帮你彻底告别环境配置的噩梦,让你将所有精力集中在 WordPress 本身,实现真正的即开即用。

2. 安装 Docker Desktop 与创建独立项目目录

2.1 安装 Docker Desktop (核心工具)

访问 Docker 官方网站下载并安装适用于您操作系统的版本:

https://www.docker.com/products/docker-desktop/

安装完成后,请打开 Docker Desktop 应用程序,并确保左下角的状态显示为 Running(正在运行)。

2.2 创建项目工作目录

在您喜欢的位置(如桌面或文档文件夹),创建一个新的空文件夹,作为您的 WordPress 项目目录。所有配置文件和数据都将保存在这里。

wordpress-docker

3. 核心配置:编写 docker-compose.yml 文件

进入 wordpress-docker 文件夹,新建一个名为 docker-compose.yml 的文件。

把下面内容完整粘贴进去:

services:

  db:
    image: mysql:8.0
    restart: always
    environment:
      MYSQL_DATABASE: wordpress
      MYSQL_USER: wordpress
      MYSQL_PASSWORD: wordpress
      MYSQL_ROOT_PASSWORD: qixinlee.com
    volumes:
      - ./mysql:/var/lib/mysql
    networks:
      - wordpress_network

  wordpress:
    image: wordpress:latest
    restart: always
    ports:
      - "80:80"
    environment:
      WORDPRESS_DB_HOST: db
      WORDPRESS_DB_USER: wordpress
      WORDPRESS_DB_PASSWORD: wordpress
      WORDPRESS_DB_NAME: wordpress
    volumes:
      - ./web:/var/www/html
      - ./logs:/var/log/apache2  
    networks:
      - wordpress_network

  phpmyadmin:
    image: phpmyadmin:latest
    restart: always
    ports:
      - "8080:80"
    environment:
      PMA_HOST: db
    networks:
      - wordpress_network

networks:
  wordpress_network:

保存文件即可。

4. 执行部署:启动容器并验证服务状态

这是最关键的一步,我们将通过终端命令启动 WordPress 环境。

4.1 打开终端并导航到项目目录

首先,根据您的操作系统,打开相应的终端工具:

系统终端工具
WindowsPowerShell / CMD
Mac / LinuxTerminal

如何确定路径?

您需要告诉终端工具您的项目文件夹 wordpress-docker 位于电脑的哪个位置。

  1. 找到项目位置: 找到您在 步骤 2 中创建的 wordpress-docker 文件夹。
  2. 复制完整路径:
  • Windows 用户: 在文件管理器中,点击地址栏并复制完整的路径(例如 C:\Users\YourName\Desktop\wordpress-docker)。
  • Mac / Linux 用户: 右键点击文件夹,选择“获取信息”或“属性”,然后复制路径。

执行导航(cd 命令):

使用 cd (Change Directory) 命令进入该文件夹。请将下面的示例路径替换为您自己电脑上的实际路径(YourName 也要替换)。

  • 如果您的文件夹在 Windows 桌面:
cd C:\Users\YourName\Desktop\wordpress-docker
  • 如果您的文件夹在 Mac/Linux 桌面:
cd /Users/YourName/Desktop/wordpress-docker

成功进入文件夹后,您就可以进行下一步的启动操作了。

4.2 执行启动命令

运行以下命令来启动所有服务。-d 参数表示在后台(分离模式)运行容器:

docker compose up -d

提示: 第一次运行会自动下载 WordPress、MySQL 和 phpMyAdmin 的镜像文件——请耐心等待下载和创建过程完成。

4.3 验证服务状态

启动完成后,运行以下命令检查容器状态:

docker compose ps

如果看到以下三个服务都显示为 running,则表示部署成功:

服务状态
dbrunning
wordpressrunning
phpmyadminrunning

5. 首次访问:通过浏览器完成 WordPress 首次安装

浏览器访问:

http://localhost

第一次访问会进入 WordPress 安装向导:

  1. 选择语言
  2. 输入站点名称、管理员账号密码
  3. 完成安装并进入后台

之后,你就能正常管理网站、安装主题、安装插件、写文章了。

6. 数据库管理:通过 phpMyAdmin 图形界面管理数据库

phpMyAdmin 是一个流行的、基于 Web 的 MySQL 数据库管理工具。如果你需要手动检查 WordPress 的数据表结构、备份数据,或进行高级的数据库操作,可以使用这个工具。

浏览器访问:

http://localhost:8080

登录时,请使用您在 docker-compose.yml 文件中为 db 服务配置的凭证:

字段
用户名wordpress
密码wordpress

7. 容器操作:停止、重启与日志查看

动作命令
停止所有服务docker compose down
重启所有服务docker compose restart
查看日志docker compose logs -f

停止不会删除数据,因为数据库文件和网站文件都保存在你本地文件夹里。

现在你成功拥有了本地 WordPress 环境

以后开发或者测试主题、插件,都只需要:

docker compose up -d

就能一键启动 WordPress

评论

发表回复

您的邮箱地址不会被公开。 必填项已用 * 标注