下面是一份适合完全新手的 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 -d 和 down 命令,一键管理所有服务。 |
简而言之,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 打开终端并导航到项目目录
首先,根据您的操作系统,打开相应的终端工具:
| 系统 | 终端工具 |
|---|---|
| Windows | PowerShell / CMD |
| Mac / Linux | Terminal |
如何确定路径?
您需要告诉终端工具您的项目文件夹 wordpress-docker 位于电脑的哪个位置。
- 找到项目位置: 找到您在 步骤 2 中创建的
wordpress-docker文件夹。 - 复制完整路径:
- 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,则表示部署成功:
| 服务 | 状态 |
|---|---|
| db | running |
| wordpress | running |
| phpmyadmin | running |
5. 首次访问:通过浏览器完成 WordPress 首次安装
浏览器访问:
http://localhost
第一次访问会进入 WordPress 安装向导:
- 选择语言
- 输入站点名称、管理员账号密码
- 完成安装并进入后台
之后,你就能正常管理网站、安装主题、安装插件、写文章了。
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
发表回复