hetzner_rocky_linux_lemp_wordpress_moodle
Hetzner Rocky Linux:LEMP + WordPress (Multisite) + Moodle 完整部署手冊
本手冊適用於在 Hetzner Cloud 虛擬主機或獨立伺服器上,使用 Rocky Linux 架設高相容性、高安全性的 LEMP 堆疊,並同時運行 WordPress 多站點模式 (Multisite Network) 與 Moodle 4.x。
目錄
- 架構規劃與版本相容性需求
- Hetzner 伺服器初始化與基礎防護
- 安裝與配置 MariaDB 11.4 LTS
- 安裝與配置 PHP 8.2 / 8.3 與必要擴充模組
- 安裝與配置 Nginx 核心服務
- 部署 WordPress 多站點模式 (Multisite)
- 部署 Moodle 4.x (隔離埠口與安全性路徑)
- SELinux 與權限深度調教重點
- 日常維護與 Cron 定時任務
1. 架構規劃與版本相容性需求
| 元件 | 推薦版本 | 說明 |
|---|---|---|
| 作業系統 | Rocky Linux 9 / 10 | 企業級 RHEL 衍生發行版,預設啟用強制 SELinux |
| Web 伺服器 | Nginx (Mainline 或 Stable) | 高併發處理靜態資源與反向代理 |
| 資料庫 | MariaDB 11.4 LTS | Moodle 4.x 嚴格要求 MariaDB |
| PHP 運行環境 | PHP 8.2 或 8.3 (Remi Repo) | 同時兼顧 WordPress 最新版與 Moodle 4.4+ 的相容支援 |
| WordPress | 根目錄 / 或特定子目錄 |
啟用 Sub-directory / Sub-domain 多站點網路 |
| Moodle | 獨立埠口 (Port 8080) 或獨立子網域 | 根目錄必須指向 public/ 目錄,避免全域洩漏安全性檢查報錯 |
2. Hetzner 伺服器初始化與基礎防護
2.1 系統更新與基礎工具安裝
以 SSH 登入 Hetzner 實例後,更新所有既有套件:
sudo dnf update -y
sudo dnf install -y epel-release vim curl wget tar bzip2 unzip git firewalld policycoreutils-python-utils
2.2 防火牆設定 (Firewalld)
啟用 Rocky Linux 內建防火牆,並放行 HTTP、HTTPS 及後續 Moodle 預計使用的連接埠:
sudo systemctl enable --now firewalld
sudo firewall-cmd --permanent --add-service=ssh
sudo firewall-cmd --permanent --add-service=http
sudo firewall-cmd --permanent --add-service=https
sudo firewall-cmd --permanent --add-port=8080/tcp
sudo firewall-cmd --reload
注意:安全防護備註
Hetzner 控制台內建「Cloud Firewall」,建議搭配伺服器本機的firewalld雙層過濾。若 Hetzner 防火牆未放行 8080 埠口,外部連線將無法觸達本機。
3. 安裝與配置 MariaDB 11.4 LTS
Moodle 4.x 對資料庫版本與字元集有嚴格規範。Rocky Linux 內建 AppStream 的 MariaDB 版本往往過舊,因此我們直接引入 MariaDB 官方 Repository。
3.1 引入 MariaDB 11.4 官方儲存庫
使用 vim 建立官方套件來源:
sudo vim /etc/yum.repos.d/mariadb.repo
在 vim 中按 i 進入編輯模式,貼上以下內容:
[mariadb]
name = MariaDB
baseurl = https://rpm.mariadb.org/11.4/rhel/$releasever/$basearch
module_hotfixes = 1
gpgkey = https://yum.mariadb.org/RPM-GPG-KEY-MariaDB
gpgcheck = 1
按 Esc,輸入 :wq 儲存並離開。
3.2 安裝並啟動 MariaDB
sudo dnf clean all
sudo dnf install -y MariaDB-server MariaDB-client
sudo systemctl enable --now mariadb
3.3 初始化安全設定
執行安全初始化腳本,設定 Root 密碼並移除測試庫:
sudo mariadb-secure-installation
(依序依照指示設定強密碼,並移除 anonymous users、禁止 remote root 登入、刪除 test 資料庫。)
3.4 配置 Moodle 必備資料庫參數
Moodle 要求資料庫必須支援 Barracuda 格式與全字元 UTF-8(utf8mb4)。
sudo vim /etc/my.cnf.d/server.cnf
在 [mysqld] 區段下方加入以下參數:
[mysqld]
innodb_file_per_table = 1
innodb_large_prefix = 1
character-set-server = utf8mb4
collation-server = utf8mb4_unicode_ci
innodb_buffer_pool_size = 512M
max_allowed_packet = 64M
按 Esc,輸入 :wq 儲存離開,並重新啟動資料庫:
sudo systemctl restart mariadb
3.5 建立 WordPress 與 Moodle 資料庫
登入 MariaDB 控制台:
sudo mariadb -u root -p
在 SQL 提示字元下執行(請自行替換 YourSecurePasswordHere):
-- 建立 WordPress 資料庫與使用者
CREATE DATABASE wordpress DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_520_ci;
CREATE USER 'wp_user'@'localhost' IDENTIFIED BY 'Wp_Password_123!';
GRANT ALL ON wordpress.* TO 'wp_user'@'localhost';
-- 建立 Moodle 資料庫與使用者
CREATE DATABASE moodle DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
CREATE USER 'moodle_user'@'localhost' IDENTIFIED BY 'Moodle_Password_123!';
GRANT ALL ON moodle.* TO 'moodle_user'@'localhost';
FLUSH PRIVILEGES;
EXIT;
4. 安裝與配置 PHP 8.2 / 8.3 與必要擴充模組
WordPress 與 Moodle 皆需要特定的 PHP 擴充模組(特別是 Moodle 必須的 sodium, intl, max_input_vars 等)。
4.1 啟用 Remi PHP 儲存庫
sudo dnf install -y https://rpms.remirepo.net/enterprise/remi-release-9.rpm
sudo dnf module reset php -y
sudo dnf module enable php:remi-8.2 -y
(若需使用 PHP 8.3,可將指令改為 sudo dnf module enable php:remi-8.3 -y)
4.2 安裝 PHP-FPM 及所有必要模組
sudo dnf install -y php-fpm php-cli php-mysqlnd php-gd php-xml php-mbstring \
php-zip php-soap php-intl php-opcache php-curl php-sodium php-bcmath php-imagick
4.3 調整 php.ini 全域設定
針對 Moodle 表單與大型檔案上傳調優:
sudo vim /etc/php.ini
搜尋並修改下列參數(在 vim 普通模式下可按 / 搜尋關鍵字):
memory_limit = 512M
upload_max_filesize = 100M
post_max_size = 100M
max_execution_time = 300
max_input_vars = 5000
date.timezone = Asia/Taipei
4.4 設定 PHP-FPM 連線池(Pool)權限
在 Rocky Linux 中,Nginx 與 PHP-FPM 預設的使用者分工不同。為了與 Nginx 協同運作,需將運行權限指定給 nginx 使用者。
sudo vim /etc/php-fpm.d/www.conf
將以下設定修改或確認:
user = nginx
group = nginx
listen = /run/php-fpm/www.sock
listen.owner = nginx
listen.group = nginx
listen.mode = 0660
啟動並啟用 PHP-FPM:
sudo systemctl enable --now php-fpm
5. 安裝與配置 Nginx 核心服務
sudo dnf install -y nginx
sudo systemctl enable --now nginx
6. 部署 WordPress 多站點模式 (Multisite)
6.1 下載並配置 WordPress 檔案
sudo mkdir -p /var/www/html/wordpress
cd /tmp
wget https://wordpress.org/latest.tar.gz
tar -zxvf latest.tar.gz
sudo cp -r wordpress/* /var/www/html/wordpress/
6.2 建立與設定 wp-config.php
cd /var/www/html/wordpress
sudo cp wp-config-sample.php wp-config.php
sudo vim wp-config.php
填寫資料庫連線資訊:
define( 'DB_NAME', 'wordpress' );
define( 'DB_USER', 'wp_user' );
define( 'DB_PASSWORD', 'Wp_Password_123!' );
define( 'DB_HOST', 'localhost' );
define( 'DB_CHARSET', 'utf8mb4' );
define( 'DB_COLLATE', '' );
// 啟用多站點網路 (WP Multisite) 核心支援開關
define( 'WP_ALLOW_MULTISITE', true );
6.3 建立 WordPress Nginx 設定檔 (Port 80)
sudo vim /etc/nginx/conf.d/wordpress.conf
寫入針對 WordPress 多站點(子目錄 Sub-directory 模式)相容的重寫規則:
server {
listen 80;
server_name _; # 或填寫您的 WordPress 網域名稱
root /var/www/html/wordpress;
index index.php index.html index.htm;
client_max_body_size 100M;
# 全域阻擋隱藏檔案存取
location ~ /\. {
deny all;
}
# WordPress 多站點(子目錄)專用重寫規則
location / {
try_files $uri $uri/ /index.php?$args;
}
# 針對多站點 uploads 虛擬路徑的靜態資源重定向
location ~ ^(/[^/]+)?/files/(.+) {
try_files /wp-content/blogs.dir/$blogid/files/$2 /wp-includes/ms-files.php?file=$2;
access_log off;
log_not_found off;
expires max;
}
# 子目錄多站點靜態資源轉發
if (!-e $request_filename) {
rewrite ^/[_0-9a-zA-Z-]+(/wp-(content|admin|includes).*) $1 last;
rewrite ^/[_0-9a-zA-Z-]+(/.*\.php)$ $1 last;
}
location ~ \.php$ {
try_files $uri =404;
fastcgi_split_path_info ^(.+\.php)(/.+)$;
fastcgi_pass unix:/run/php-fpm/www.sock;
fastcgi_index index.php;
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
include fastcgi_params;
fastcgi_read_timeout 300;
}
}
7. 部署 Moodle 4.x (隔離埠口與安全性路徑)
重要安全架構說明:Moodle 4.x 根目錄限制
Moodle 4.x 要求網頁伺服器的 Document Root 不得 直接指向程式庫根目錄,必須指向其子目錄/public。此外,為了避免與 WordPress 產生路徑衝突,建議將 Moodle 部署在獨立埠口(如8080)或獨立子網域。
7.1 下載 Moodle
sudo mkdir -p /var/www/html/moodle
sudo mkdir -p /var/www/moodledata
cd /tmp
wget https://download.moodle.org/download.php/direct/stable404/moodle-latest-404.tgz -O moodle.tgz
tar -zxvf moodle.tgz
sudo cp -r moodle/* /var/www/html/moodle/
7.2 建立 Moodle Nginx 設定檔 (Port 8080)
sudo vim /etc/nginx/conf.d/moodle.conf
寫入完整設定內容:
server {
listen 8080;
server_name _; # 或填寫您的 Moodle 網域名稱
# 關鍵:指向 public 目錄符合安全標準
root /var/www/html/moodle/public;
index index.php index.html index.htm;
client_max_body_size 100M;
# 路由導向
location / {
try_files $uri $uri/ /index.php?$query_string;
}
# FastCGI 處理 Moodle 複雜的路由請求
location ~ [^/]\.php(/|$) {
fastcgi_split_path_info ^(.+?\.php)(/.*)$;
if (!-f $document_root$fastcgi_script_name) {
return 404;
}
fastcgi_pass unix:/run/php-fpm/www.sock;
fastcgi_index index.php;
include fastcgi_params;
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
fastcgi_param PATH_INFO $fastcgi_path_info;
fastcgi_read_timeout 300;
}
location ~ /\. {
deny all;
}
}
8. SELinux 與權限深度調教重點
在 Rocky Linux / RHEL 架構下,最常見的 500 Internal Server Error 或 Permission Denied 幾乎都是由 檔案權限 與 SELinux 標籤 引起的。
8.1 檔案與目錄所有權配置
# WordPress 權限
sudo chown -R nginx:nginx /var/www/html/wordpress
sudo find /var/www/html/wordpress -type d -exec chmod 755 {} \;
sudo find /var/www/html/wordpress -type f -exec chmod 644 {} \;
# Moodle 程式碼與數據目錄權限
sudo chown -R nginx:nginx /var/www/html/moodle
sudo chown -R nginx:nginx /var/www/moodledata
sudo chmod -R 775 /var/www/moodledata
8.2 SELinux 安全標籤與規則配置 (不可跳過)
Rocky Linux 預設開啟強制模式(Enforcing)。若未放行網路連線與設定正確上下文,網頁將無法連線資料庫或對目錄進行寫入。
# 允許 Nginx 與 PHP 發送網路請求 (用於外掛更新、下載語言包等)
sudo setsebool -P httpd_can_network_connect 1
sudo setsebool -P httpd_can_network_connect_db 1
# 設定 WordPress 內容與上傳目錄的 SELinux 標籤
sudo semanage fcontext -a -t httpd_sys_rw_content_t "/var/www/html/wordpress/wp-content(/.*)?"
sudo restorecon -Rv /var/www/html/wordpress/wp-content
# 設定 Moodle 專用資料目錄 moodledata 的寫入標籤
sudo semanage fcontext -a -t httpd_sys_rw_content_t "/var/www/moodledata(/.*)?"
sudo restorecon -Rv /var/www/moodledata
# 設定 Moodle 本體設定檔允許動態建立
sudo semanage fcontext -a -t httpd_sys_rw_content_t "/var/www/html/moodle/config.php"
sudo restorecon -v /var/www/html/moodle/config.php 2>/dev/null || true
8.3 測試 Nginx 配置並重啟
sudo nginx -t
sudo systemctl restart nginx
sudo systemctl restart php-fpm
9. 日常維護與 Cron 定時任務
WordPress 與 Moodle 均高度依賴定時排程執行排隊信件、快取清除與備份任務。
sudo vim /etc/crontab
在檔案末尾加入以下排程:
# 每小時執行一次 WordPress 排程工作 (避免依賴訪客點擊觸發)
*/15 * * * * nginx /usr/bin/php /var/www/html/wordpress/wp-cron.php >/dev/null 2>&1
# 每分鐘執行一次 Moodle 後台排程維護
* * * * * nginx /usr/bin/php /var/www/html/moodle/admin/cli/cron.php >/dev/null 2>&1
儲存離開後,重啟 Crond 服務:
sudo systemctl restart crond
結語與驗證
- WordPress 驗證:在瀏覽器中造訪
http://<您的伺服器IP>/完成基本站點安裝,接著進入後台「工具」>「網路設定」正式啟動多站點網路。 - Moodle 驗證:在瀏覽器中造訪
http://<您的伺服器IP>:8080/,系統將引導進入環境檢測畫面,由於環境擴充與資料庫均已調優,檢測將全數亮起綠燈。