Flarum

井水玉藻

常用命令

sudo -u www-data -g www-data /bin/bash

systemctl restart php8.5-fpm && systemctl restart nginx

php flarum migrate && php flarum cache:clear && php flarum assets:publish

sudo chmod 755 /home && sudo chmod 755 /home/2233/ && sudo chown -R www-data:www-data /home

井水玉藻

Nginx配置文件示例

server {
    listen 80;
    listen [::]:80;
    server_name love4z.cn;

    return 301 https://$host$request_uri;
}

server {
    listen 443 ssl;
    listen [::]:443 ssl;
    http2 on;
    
    server_name love4z.cn;
    root /home/2233;
    index index.php index.html index.htm;
 
    # SSL 安全配置
    ssl_certificate /etc/nginx/ssl/2233/love4z.cn.crt;
    ssl_certificate_key /etc/nginx/ssl/2233/love4z.cn.key;
    ssl_protocols TLSv1.3;
    ssl_conf_command Options PrioritizeChaCha;
    ssl_session_cache shared:SSL:10m;
    ssl_session_timeout 1d;
    ssl_early_data on;

    # 日志
    access_log /var/log/nginx/2233_access.log;
    error_log /var/log/nginx/2233_error.log;

    # ================= 性能加速优化 =================
    sendfile            on;
    tcp_nopush          on;
    tcp_nodelay         on;
    keepalive_timeout   65;

    # ================= 全局安全响应头 =================
    add_header Strict-Transport-Security "max-age=63072000; includeSubDomains; preload" always;
    add_header X-Frame-Options "SAMEORIGIN" always;
    add_header X-Content-Type-Options "nosniff" always;
    add_header Referrer-Policy "strict-origin-when-cross-origin" always;

    # 主页及静态路由
    location / {
        try_files $uri $uri/ /index.php?$query_string;
    }

    # 标准 PHP-FPM 解析
    location ~ \.php$ {
        try_files $uri =404;
        fastcgi_pass unix:/run/php/php8.5-fpm.sock;
        fastcgi_index index.php;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
        include fastcgi_params;
        
        fastcgi_param HTTP_EARLY_DATA $ssl_early_data;
 
        fastcgi_buffers 16 16k; 
        fastcgi_buffer_size 32k;
        fastcgi_hide_header X-Powered-By;
 
        # 仅保留 FastCGI 特有的响应头
        add_header X-FastCGI-Cache $upstream_cache_status;
    }
 
    # 静态资源缓存加速
    location ~* \.(?:jpg|jpeg|gif|png|ico|cur|gz|svg|mp4|ogg|ogv|webm|webp|htc|css|js|ttf|ttc|otf|eot|woff|woff2)$ {
        expires 30d;
        add_header Cache-Control "public, no-transform";
        access_log off;
    }

    # ================= 安全屏蔽规则 =================
 
    location ~* ^/(?:\.git|\.env|composer\.(json|lock)|auth\.json|config\.php|storage|vendor) {
        return 404;
    }
 
    location ~ /\.(?!well-known).* {
        return 404;
    }
}

井水玉藻

拓展安装

https://floxum.com/extension/

cd /path/to/you/flarum

#简体中文
composer require "flarum-lang/chinese-simplified:*"

php flarum cache:clear

井水玉藻

社区支持

https://discuss.flarum.org.cn/

拓展
https://floxum.com/extensions

井水玉藻

Flarum v2.0

https://discuss.flarum.org/d/39118-flarum-200-rc1-released-the-last-mile-to-20

composer update -W && php flarum migrate && php flarum cache:clear && php flarum assets:publish

井水玉藻

Mail 驱动邮件发送失败

# Ubuntu/Debian
sudo apt-get install postfix

# CentOS/AlmaLinux
sudo yum install postfix

Gmail 不收解决方式：
https://love4z.cn/d/8-postfix

井水玉藻

文件权限

sudo chmod 755 /home/www && sudo chmod 755 /home/www/ && sudo chown -R www-data:www-data /home/www

井水玉藻

井水玉藻
V2.0X 内核提供了基于数据库的队列 QUEUE

在 config.php 中设置：

'queue' => [
    'driver' => 'database',
],

~~未尝试调度器，文档里说要开调度器才行，观望~~

The database queue re-uses the scheduler to process jobs, so you must have the scheduler configured to run every minute for it to work. See the scheduler guide for setup instructions.

井水玉藻

井水玉藻
无Cron调度器时发帖为即时发帖，验证码缓存在数据库无法发送
有Cron调度器，验证码以调度器定时间隔发送

~~且产生文件权限问题~~
权限解决：https://love4z.cn/d/4/14

井水玉藻

游客缓存

1.网站配置详见：
https://love4z.cn/d/18

编辑nginx.cong 启用nginx缓存

http {
    fastcgi_cache_path /var/cache/nginx/fastcgi levels=1:2 keys_zone=flarum_cache:10m max_size=1g inactive=7d;
    fastcgi_cache_key "$scheme$request_method$host$request_uri";
}

建立并授权缓存目录：

sudo mkdir -p /var/cache/nginx/fastcgi
sudo chown -R www-data:www-data /var/cache/nginx/fastcgi

语法检查：

sudo nginx -t

此时应该输出完全正常的提示。
重新加载服务：

sudo systemctl reload nginx

效果验证：
使用浏览器的无痕模式（不登录 Flarum 账号）访问你的网站，按 F12 打开网络面板查看网站首页请求的响应头（Response Headers），第二次刷新时应当能看到 X-FastCGI-Cache: HIT，这就表示 Nginx 直接从内存/缓存里把页面丢给用户，完全不需要惊动 PHP 8.5 和数据库了！

井水玉藻

启用Redis

composer require fof/redis:"*"

systemctl restart php8.5-fpm && systemctl restart nginx

[2026-05-20T02:38:50.622192+00:00] flarum.ERROR: Error: Call to undefined method Flarum\Queue\QueueFactory::getPausedQueues() in /home/www//vendor/illuminate/queue/Worker.php:476

Flarum 核心代码与它依赖的 Laravel 组件（illuminate/queue）之间发生了版本冲突

解决办法：在 extend.php 中使用 ->disable(['queue'])|
https://discuss.flarum.org/d/37228-friendsofflarum-redis-sessions-cache-queues

井水玉藻

井水玉藻
切换到 www-data 用户（php，nginx用户）并编辑其 crontab：

# 使用 root 权限执行此命令来编辑 www-data 的定时任务
crontab -u www-data -e

sudo apt-get update && sudo apt-get install cron

In case you are using a RHEL based Linux distribution (CentOS, AlmaLinux, Rocky Linux...), install cron like this:

sudo dnf update && sudo dnf install crontabs

Once you have cron installed, let's create the one and only entry you need for Flarum:

crontab -e

This will open the cron editor. You may or may not have other entries there. Add this line, and remember to leave an empty line at the bottom.

* * * * * cd /path-to-your-project && php flarum schedule:run >> /dev/null 2>&1

井水玉藻

井水玉藻
详细见：https://github.com/flarum/framework/issues/4671
已修复在2.x-dev