本文介绍如何安装Flarum论坛，包括安装Composer、安装Flarum、配置Nginx等步骤。

前提

详情请查看官方文档，包括但不限于数据库、Nginx或者Apache、PHP。

安装 composer

bash
123456
php -r "copy('https://install.phpcomposer.com/installer', 'composer-setup.php');"
php composer-setup.php
php -r "unlink('composer-setup.php');"
mv composer.phar /usr/local/bin/composer

composer selfupdate

安装PHP扩展

以下是必须安装的PHP扩展：

bash
1
apt install -y php8.3-curl php8.3-xml php8.3-mbstring php8.3-mysql php8.3-zip php8.3-gd

升级（可选）

首先你要确定现有的 Composer 的安装目录，然后通过下面的链接下载 composer.phar 文件（复制以下地址到浏览器地址栏可直接下载），

https://install.phpcomposer.com/composer.phar

将前面下载的 composer.phar 文件覆盖系统中已经安装的 composer.phar 文件即可。注意，有可能在安装时将 composer.phar 改名为 composer 了，注意用同样的名字覆盖即可。

安装Flarum

bash
123
mkdir /opt/flarum
chmod -R 777 /opt/flarum
composer create-project flarum/flarum:^1.8.0 /opt/flarum

/etc/nginx/sites-available/flarum：

ini
12345678910111213141516171819202122232425262728293031323334
server {
    listen 80;
    listen [::]:80;
    server_name your-domain.com;  # 替换为你的域名

    # 网站根目录（Flarum 的 public 目录）
    root /opt/flarum/public;
    index index.php index.html index.htm;

    # 引入 Flarum 提供的配置片段（包含重写规则、静态资源缓存、安全保护等）
    include /opt/flarum/.nginx.conf;

    # PHP 请求处理
    location ~ \.php$ {
        include snippets/fastcgi-php.conf;
        # 根据你的 PHP 版本修改以下路径（例如 php8.3-fpm.sock）
        fastcgi_pass unix:/run/php/php8.3-fpm.sock;
    }

    # 禁止访问隐藏文件（如 .git, .env 等）
    location ~ /\. {
        deny all;
        return 404;
    }

    # 可选：增加一些安全头
    add_header X-Frame-Options "SAMEORIGIN" always;
    add_header X-Content-Type-Options "nosniff" always;
    add_header X-XSS-Protection "1; mode=block" always;

    # 日志配置（可选）
    access_log /var/log/nginx/flarum_access.log;
    error_log /var/log/nginx/flarum_error.log;
}
bash
1234
ln -s /etc/nginx/sites-available/flarum /etc/nginx/sites-enabled/
rm /etc/nginx/sites-enabled/default
nginx -t
systemctl reload nginx
bash
123
cd /opt/flarum
composer require flarum-lang/chinese-simplified
php flarum cache:clear