标签： Linux

下面是一份适合完全新手的 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 位于电脑的哪个位置。

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，则表示部署成功：

服务	状态
db	running
wordpress	running
phpmyadmin	running

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