Flarum 是一款现代化的开源论坛软件

Flarum 简介

Flarum 是一款现代化的开源论坛软件，设计简洁、轻量且易于扩展。它采用 PHP 和 JavaScript 构建，适用于小型到中型社区。

特点

• 响应式设计，适配移动设备

• 简洁直观的用户界面

• 支持 Markdown 格式

• 丰富的扩展系统

• 实时更新（如帖子动态加载）

最新更新内容及时间

• 最新稳定版本：v1.8.0（2023年11月发布）

• 主要更新：性能优化、安全修复、扩展兼容性改进

镜像下载地址

• 官方 GitHub 发布页：https://github.com/flarum/flarum/releases

官网地址

• 官方网站：https://flarum.org

文档地址

• 官方文档：https://docs.flarum.org

Docker 安装示例

docker run -d \
  --name flarum \
  -p 8080:80 \
  -v /path/to/assets:/flarum/app/public/assets \
  -v /path/to/extensions:/flarum/app/extensions \
  -e FLARUM_URL=http://yourdomain.com \
  -e DB_HOST=mysql \
  -e DB_NAME=flarum \
  -e DB_USER=flarum \
  -e DB_PASS=password \
  flarum/flarum:latest

.yaml 设置教程（以 Nginx 为例）

server {
    listen 80;
    server_name yourdomain.com;
    root /var/www/flarum/public;
    index index.php;

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

    location ~* \.php$ {
        fastcgi_pass unix:/run/php/php8.0-fpm.sock;
        include fastcgi_params;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
    }
}

常用错误问题

1. 500 服务器错误

• 检查文件权限（chmod -R 755 public）

• 确保 PHP 扩展已安装（pdo_mysql, openssl, gd, dom, fileinfo）

2. 数据库连接失败

• 检查数据库配置（.env 文件）

• 确认数据库服务运行中

3. 安装后空白页面

• 清除缓存（php flarum cache:clear）

• 检查 PHP 版本（要求 PHP 8.0+）

4. 扩展不兼容

• 确保扩展版本与 Flarum 核心版本匹配

• 查看扩展的兼容性说明

5. 邮件发送失败

• 检查 SMTP 配置

• 测试邮件设置（使用 Mailtrap 等服务调试）