Flarum 安装指南（中文教程）

Flarum 是一个轻量、快速且易于定制的现代论坛软件，适合开发者、社区管理员以及任何希望搭建在线社区的用户。本文会介绍如何在服务器上部署 Flarum。

一、系统要求

在安装 Flarum 之前，您需要确保服务器满足以下最低要求：

1. Web 服务器：
   • 支持 Apache（推荐使用 mod_rewrite 模块）或 Nginx。
   • 确保服务器能够处理 PHP 请求。
2. PHP 环境：
   • PHP 版本 7.3 或更高。
   • 需要安装以下 PHP 扩展：
     • PDO 和 MySQL 扩展（用于数据库连接）。
     • mbstring（处理多字节字符串）。
     • tokenizer（PHP 代码解析）。
     • gd（图像处理）。
     • json（JSON 数据处理）。
     • curl（网络请求）。
     • openssl（安全通信）。
     • fileinfo（文件类型检测）。
     • zip（处理压缩文件）。
3. 数据库：
   • 支持 MySQL 5.7+ 或 MariaDB 10.1+。
   • 确保数据库已创建并准备好接收 Flarum 数据。
4. 其他要求：
   • 一个域名或子域名（推荐使用 HTTPS）。
   • SSH 访问服务器（用于运行命令行操作）。
   • Composer（PHP 的依赖管理工具）。

建议：使用支持最新 PHP 版本的服务器，并确保启用 HTTPS 以提高安全性。

二、安装步骤

以下是安装 Flarum 的详细步骤。请按照顺序操作，确保环境配置正确。

1. 获取 Flarum

Flarum 使用 Composer 进行安装。您需要通过命令行操作，在服务器上下载并安装 Flarum 及其依赖项。

• 打开终端，连接到您的服务器。
• 导航到 Web 服务器的根目录（例如 /var/www/html）。
• 运行以下命令以安装 Flarum：

composer create-project flarum/flarum .

说明：

• create-project 会下载 Flarum 和其依赖项。
• . 表示在当前目录安装。如果需要安装到特定文件夹，请替换为目标路径（例如 flarum）。

注意：运行此命令可能需要一些时间，具体取决于服务器性能和网络速度。

2. 配置 Web 服务器

安装完成后，您需要配置 Web 服务器以正确指向 Flarum 的 public 目录。以下是两种常见 Web 服务器的配置方法：

（1）Apache

如果使用 Apache，Flarum 会自动包含一个 .htaccess 文件，通常无需额外配置。但您需要确保以下条件：

• 启用 mod_rewrite 模块。
• 在 Apache 配置文件中允许 .htaccess 文件覆盖（AllowOverride All）。

示例虚拟主机配置：

<VirtualHost *:80>
    ServerName your-domain.com
    DocumentRoot /path/to/flarum/public
    <Directory /path/to/flarum/public>
        Options Indexes FollowSymLinks
        AllowOverride All
        Require all granted
    </Directory>
</VirtualHost>

（2）Nginx

对于 Nginx，您需要手动配置指向 Flarum 的 public 目录。以下是一个示例配置：

server {
    listen 80;
    server_name your-domain.com;
    root /path/to/flarum/public;
    index index.php;

    location / {
        try_files $uri $uri/ /index.php?$query_string;
    }

    location ~ \.php$ {
        include fastcgi_params;
        fastcgi_pass unix:/var/run/php/php7.4-fpm.sock; # 根据您的 PHP 版本调整
        fastcgi_index index.php;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
    }
}

保存配置后，重新加载 Web 服务器：

• Apache：sudo systemctl reload apache2
• Nginx：sudo systemctl reload nginx

3. 设置文件权限

Flarum 需要对某些目录有写权限，以确保正常运行。运行以下命令设置权限：

chmod 775 -R /path/to/flarum
chown -R www-data:www-data /path/to/flarum

说明：

• www-data 是 Web 服务器的默认用户组，具体名称可能因系统不同而异（例如 CentOS 使用 apache）。
• 确保以下目录可写：
  • storage
  • public/assets
  • public/favicon.ico
  • public/robots.txt

4. 运行安装向导

完成上述配置后，您可以通过浏览器访问您的域名（例如 http://your-domain.com），进入 Flarum 的安装向导。向导将引导您完成以下步骤：

• 输入数据库信息（主机、数据库名、用户名、密码）。
• 设置管理员账户（用户名、密码、邮箱）。
• 配置论坛的基本信息（标题、语言等）。

注意：

• 确保数据库已创建，并提供正确的凭据。
• 安装完成后，建议删除 install.php 文件以提高安全性。

三、安装后的优化

1. 启用 HTTPS：
   • 使用 Let’s Encrypt 或其他 SSL 证书提供商为您的论坛启用 HTTPS。
   • 更新 Web 服务器配置以强制重定向到 HTTPS。
2. 设置定时任务：
   • Flarum 需要定期运行计划任务（例如清理临时文件）。您可以配置 cron 任务：

     * * * * * php /path/to/flarum schedule:run >> /dev/null 2>&1
     

3. 安装扩展：
   • Flarum 支持丰富的扩展生态。您可以通过 Composer 或 Flarum 的管理面板安装扩展，增强论坛功能。
4. 备份：
   • 定期备份数据库和 Flarum 文件夹，以防止数据丢失。

四、常见问题

1. 安装卡住或报错：
   • 检查 PHP 扩展是否完整。
   • 确保 Composer 使用的是最新版本（composer self-update）。
   • 查看 Web 服务器和 PHP 的错误日志。
2. 页面显示 404 或 500 错误：
   • 确认 Web 服务器配置正确，指向 public 目录。
   • 检查文件权限是否设置正确。
3. 数据库连接失败：
   • 验证数据库凭据是否正确。
   • 确保数据库服务正在运行。

五、获取帮助

如果您在安装过程中遇到问题，可以参考以下资源：

• Flarum 社区：访问 discuss.flarum.org，与其他用户交流。
• 官方文档：查阅 docs.flarum.org，获取更详细的技术信息。
• GitHub：在 github.com/flarum 提交问题或查看源码。
• 本站Flarum专区：在 https://www.bzmzz.com/tag/flarumyuedu 阅读更多Flarum的相关教程。