如何将树莓派改装为完整 WordPress 网站服务器？

树莓派不只是用来做实验的微型电脑，它性能完全足够搭建一台功能完整的网页服务器，托管并运行 WordPress 网站（wordpress.org）。无论你想搭建个人站点、作品集页面还是小型企业官网，树莓派 5 或计算模块 5 都能让你完全自主掌控服务，无需依赖第三方虚拟主机服务商。

本文将分步讲解，手把手教你在树莓派设备上搭建一套完整网页服务环境，采用 Apache 网页服务、MariaDB 数据库、PHP 程序语言搭配 WordPress 建站程序。整套流程无需编程或服务器运维基础，新手、硬件爱好者都能轻松上手。

---

为什么用树莓派搭建 WordPress 服务器？

树莓派 5 与计算模块 5 搭载性能更强的处理器、更大内存，IO 读写性能全面升级，非常适合承载小型网站。 优势如下：

优势如下：

完全自主掌控服务器与全部数据

功耗极低，适合 7×24 小时不间断家庭服务器

运行个人、小微企业网站性能充足

硬件、软件升级调试操作简单

相比 Micro SD 卡、eMMC 闪存，搭配固态硬盘（SSD）能大幅提升服务器运行速度、稳定性与可靠性。给树莓派加装散热风扇，可保证长时间满载运行时稳定发挥性能。

---

本项目所需硬件

本次搭建 WordPress 服务器，我们使用树莓派计算模块 5，搭配自研定制载板，充分发挥这款片上系统（SoM）硬件性能。系统本体运行在 CM5 自带 eMMC 闪存，整套网站服务文件全部外置固态硬盘存储，采用官方 256GB 树莓派专用 SSD。

你也可以使用普通树莓派 5 搭配 SSD 套件，操作步骤完全一致。

硬件清单：

树莓派 5 / 树莓派计算模块 5（本文使用 8GB 内存版本）

树莓派官方 256GB 固态硬盘

主动散热器 / 散热风扇

配套电源适配器

键盘、鼠标、显示器（仅首次初始化使用）

HDMI 视频线

网络（推荐有线以太网，稳定性更强）

---

步骤 1：安装树莓派轻量版系统（Raspberry Pi OS Lite）

系统本体部署在 CM5 的 eMMC 闪存，后续网页服务全部安装至外置固态硬盘。 若你使用普通树莓派 5 而非 CM5，文末会说明更简便的安装方法。

在 macOS 系统为 CM5 的 eMMC 烧录系统

要使用macOS将Raspberry Pi操作系统闪存到计算模块5 eMMC上，请执行以下步骤:

1.编译 RPI Boot 工具

打开 macOS 终端，拉取官方 usbboot 工具源码：

git clone --recurse-submodules --shallow-submodules --depth=1 https://github.com/raspberrypi/usbbootcd usbboot

安装依赖组件：

brew install libusbbrew install pkg-config

编译工具：

make

2.启动烧录引导程序

执行命令：

sudo ./rpiboot

终端会输出提示：

“Waiting for BCM2835/6/7/2711/2712…”

此时操作硬件：

通过 USB 线将搭载 CM5 的定制 IO 载板连接 Mac，再接通电源；

通电前务必按住载板上 USB BOOT 按键，或插上启动跳线帽。

引导程序加载成功后，载板指示灯亮起

绿灯常亮代表 eMMC 闪存已被 Mac 识别为外置存储设备

若操作失败，可以参考 Jeff Geerling 发布的配套教程。

https://www.jeffgeerling.com/blog/2020/flashing-raspberry-pi-compute-module-on-macos-usbboot/

3.将系统写入 eMMC 闪存

打开树莓派镜像烧录工具 Raspberry Pi Imager

系统选择：64 位 Raspberry Pi OS

存储设备选中刚刚识别到的 eMMC 磁盘

点击下一步，开始写入系统

写入完成后弹出磁盘，给载板接上电源、显示器、键盘，等待系统初始化完成。 此时设备将直接从 eMMC 启动纯净的轻量版树莓派系统。

普通树莓派 5 安装系统（无需 CM5）

流程大幅简化：

1.打开 Raspberry Pi Imager

2.选择 64 位轻量版 Raspberry Pi OS Lite

3.将系统烧录至 Micro SD 存储卡

4.存储卡插入树莓派 5

5.接通电源开机

设备直接启动，即可进行后续操作。

---

步骤 2：格式化并挂载固态硬盘作为服务器存储

识别固态硬盘设备标识

lsblk

执行后会出现类似 nvme0n1 的磁盘设备名。

格式化磁盘（仅全新空白硬盘执行）

sudo mkfs.ext4 /dev/nvme0n1

创建挂载目录

sudo mkdir -p /mnt/ssd

临时挂载硬盘

sudo mount /dev/nvme0n1 /mnt/ssd

设置开机自动永久挂载 编辑挂载配置文件：

sudo nano /etc/fstab

在文件末尾添加一行：

/dev/nvme0n1 /mnt/ssd ext4 defaults,noatime 0 2

保存退出，重启设备生效：

sudo reboot

固态硬盘现已固定挂载至 /mnt/ssd，用于存放整套 WordPress 网站服务。

---

步骤 3：查看树莓派 IP 并开启远程 SSH 访问

为方便在电脑远程操作树莓派，先获取设备局域网 IP，在树莓派终端执行：

hostname -I

输出设备内网 IP，示例：192.168.1.50 在个人电脑终端通过 SSH 远程连接：

ssh yourPiuser@YOUR_PI_IP

更新系统（安装服务前必做）

sudo apt updatesudo apt full-upgrade -y

设置静态内网 IP

网页服务器需要固定不变的局域网 IP，编辑网络配置文件：

sudo nano /etc/dhcpcd.conf

文件末尾添加以下配置，根据自家路由器网段修改地址：

interface eth0static ip_address=192.168.1.50/24static routers=192.168.1.1static domain_name_servers=192.168.1.1 8.8.8.8

保存重启设备：

sudo reboot

重启后重新 SSH 连接即可。

---

步骤 4：安装 LAMP 服务栈（Linux+Apache+MariaDB+PHP）

WordPress 运行需要网页服务、数据库、PHP 运行环境，一键安装全部依赖：

sudo apt install -y apache2 mariadb-server php libapache2-mod-php php-mysql php-xml php-curl php-gd php-mbstring php-zip php-intl

启用 Apache 核心功能模块：

sudo a2enmod rewrite headers

设置服务开机自启并立即运行：

sudo systemctl enable --now apache2sudo systemctl enable --now mariadb

将 Apache 网站根目录迁移至固态硬盘并配置权限

sudo systemctl stop apache2sudo mkdir -p /mnt/ssd/www/html/sudo rsync -av /var/www/html/ /mnt/ssd/www/html/sudo chown -R www-data:www-data /mnt/ssd/wwwsudo chmod -R 755 /mnt/ssd/wwwsudo find /mnt/ssd/www -type d -exec chmod 755 {} ;sudo find /mnt/ssd/www -type f -exec chmod 644 {} ;

修改 Apache 配置，指向固态存储目录

sudo nano /etc/apache2/sites-available/000-default.conf

找到配置项：

DocumentRoot /var/www/html

修改为：

DocumentRoot /mnt/ssd/www/html/

重启 Apache 服务：

sudo systemctl start apache2

将 MariaDB 数据库文件迁移至固态硬盘

停止数据库服务

sudo systemctl stop mariadb

迁移数据库数据文件

sudo rsync -av /var/lib/mysql /mnt/ssd/

修改数据库配置指定新存储路径

sudo nano /etc/mysql/mariadb.conf.d/50-server.cnf

找到：

datadir = /var/lib/mysql

修改为：

datadir = /mnt/ssd/mysql

修正文件夹权限

sudo chown -R mysql:mysql /mnt/ssd/mysql

启动数据库

sudo systemctl start mariadb

---

步骤 5：加固 MariaDB 数据库安全配置

进入数据库控制台：

sudo mysql

依次执行下方语句，替换自定义数据库 root 密码：

USE mysql;DELETE FROM mysql.user WHERE User='';ALTER USER 'root'@'localhost'IDENTIFIED VIA mysql_native_passwordUSING PASSWORD('CHANGE_THIS_PASSWORD');UPDATE mysql.user SET Host='localhost' WHERE User='root';DROP DATABASE IF EXISTS test;DELETE FROM mysql.db WHERE Db='test' OR Db LIKE 'test_%';FLUSH PRIVILEGES;EXIT;

该操作会删除匿名访问用户、加固管理员 root 账号、删除测试数据库，大幅提升数据库安全性。

---

步骤 6：创建 WordPress 专用数据库与数据库账号

重新登录数据库（输入刚才设置的 root 密码）：

sudo mysql -u root -p

创建网站专属数据库与访问账号：

CREATE DATABASE wordpress CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;CREATE USER 'wpuser'@'localhost' IDENTIFIED BY 'YOUR_WP_PASSWORD';GRANT ALL PRIVILEGES ON wordpress.* TO 'wpuser'@'localhost';FLUSH PRIVILEGES;EXIT;

注意：务必修改设置你的WP数据库密码为自定义密码。

---

步骤 7：下载 WordPress 程序并安装至固态硬盘

cd /tmpwget https://wordpress.org/latest.tar.gztar xzf latest.tar.gzsudo rm -rf /mnt/ssd/www/html/*sudo mv wordpress/* /mnt/ssd/www/html/sudo chown -R www-data:www-data /mnt/ssd/www/html/

复制配置文件示例：

sudo cp /mnt/ssd/www/html/wp-config-sample.php /mnt/ssd/www/html/wp-config.php

---

步骤 8：修改 WordPress 核心配置文件

打开配置文件：

sudo nano /mnt/ssd/www/html/wp-config.php

修改数据库连接信息，与上一步创建的账号匹配：

define('DB_NAME', 'wordpress');define('DB_USER', 'wpuser');define('DB_PASSWORD', 'YOUR_WP_PASSWORD');define('DB_HOST', 'localhost');

生成网站安全密钥（加密盐值）：

curl -s https://api.wordpress.org/secret-key/1.1/salt/

将命令输出的全部代码粘贴到 wp-config.php，替换原有默认密钥，提升网站安全。

---

步骤 9：Apache 开启伪静态链接（固定链接）

编辑 Apache 全局配置：

sudo nano /etc/apache2/apache2.conf

找到 <Directory /var/www/> 配置块，修改目录路径为 /mnt/ssd/www/html/，同时修改：

AllowOverride None

改为

AllowOverride All

重启 Apache 生效：

sudo systemctl restart apache2

---

步骤 11：浏览器完成 WordPress 可视化安装

打开电脑浏览器，访问树莓派静态 IP 地址：

http://192.168.1.50

填写建站信息：

网站标题

管理员用户名（不建议使用 admin）

高强度登录密码

邮箱地址

点击「安装 WordPress」，网站即刻搭建完成！

---

搭建完成后可实现的用途

树莓派 WordPress 服务器部署完毕后，你可以：

本地开发调试网站

搭建测试预发布服务器，上线前测试插件、主题更新

托管个人博客、小型企业官网

自由调试各类插件、主题、服务器底层配置

搭配 Cloudflare 隧道、HTTPS 证书，配置公网安全访问

树莓派 5 与 CM5 性能完全可以承载常规企业官网、个人博客，搭配固态硬盘 + 有线网络后访问体验更佳。

欢迎在评论区分享你对本项目的看法，以及你搭建私有网页服务器的创意用途！

 

Tip：对于刚接触树莓派的新手来说，面对英文文档、零散教程和复杂配置，很容易无从下手。pidoc.cn（ https://pidoc.cn/ ）就是为解决这些痛点而生的树莓派中文一站式学习平台，界面清晰、内容系统、更新及时，堪称新手入门的“保姆级” 网站，让零基础用户也能轻松上手树莓派。