Cloudflare Tunnel+Apache部署Moodle 4.2遇空白页与重定向问题求助

核心原因：Cloudflare Tunnel作为反向代理，将外部HTTPS请求转为内部HTTP请求传递给Apache，但Moodle默认无法识别代理后的真实协议和域名，导致协议不匹配（外部HTTPS vs 内部HTTP），进而出现空白页或重定向循环。

解决方案步骤 #

1. 配置Apache传递代理头 #

修改Moodle对应的Apache虚拟主机配置文件（例如/etc/apache2/sites-available/moodle.conf），添加代理头相关配置，确保Apache将Cloudflare传递的真实协议和域名转发给Moodle：

<VirtualHost *:80>
    ServerName localhost
    DocumentRoot /var/www/html/moodle

    # 识别Cloudflare Tunnel的HTTPS代理请求
    SetEnvIf X-Forwarded-Proto "https" HTTPS=on
    RequestHeader set X-Forwarded-Proto "https"
    RequestHeader set X-Forwarded-Host "moodle.mydomain.com"

    # 允许Moodle目录的权限和重写规则
    <Directory /var/www/html/moodle>
        Options Indexes FollowSymLinks MultiViews
        AllowOverride All
        Require all granted
    </Directory>

    ErrorLog ${APACHE_LOG_DIR}/moodle_error.log
    CustomLog ${APACHE_LOG_DIR}/moodle_access.log combined
</VirtualHost>

启用Apacheheaders模块并重启服务：

sudo a2enmod headers
sudo systemctl restart apache2

2. 修改Moodle config.php支持反向代理 #

编辑/var/www/html/moodle/config.php，添加或修改以下配置项，让Moodle识别反向代理环境：

// 保持外网访问的域名
$CFG->wwwroot = 'https://moodle.mydomain.com';
// 启用反向代理支持
$CFG->reverseproxy = true;
// 识别外部HTTPS协议
$CFG->sslproxy = true;
// 信任本地回环IP（Cloudflare Tunnel的本地请求来源）
$CFG->trusted_proxies = array('127.0.0.1', '::1');

3. 修复Moodle文件权限 #

确保Apache用户对Moodle目录有读写权限：

sudo chown -R www-data:www-data /var/www/html/moodle
sudo chmod -R 755 /var/www/html/moodle

4. 清除Moodle缓存 #

Moodle会缓存URL相关配置，需要手动清除缓存：

sudo -u www-data php /var/www/html/moodle/admin/cli/purge_caches.php

验证 #

完成以上步骤后，访问https://moodle.mydomain.com即可正常加载Moodle站点，不会出现空白页或重定向至localhost的问题。

内容的提问来源于stack exchange，提问作者林冠曄KyleLin