提到建论坛，很多人第一反应是 Discuz，但 Discuz 已经多年不更新。Flarum 是新一代开源论坛，界面现代、移动端友好、扩展丰富。本篇讲怎么搭一个自己的 Flarum 论坛。

一、Flarum 好在哪里

  • 界面现代：单页应用，滑动流畅，手机端体验好。
  • 扩展机制：官方和社区有几百个插件，点赞、收藏、标签、积分都能装。
  • 轻量：PHP 写的，虚拟主机就能跑。
  • 中文社区活跃：国内有汉化包和中文扩展。

二、环境要求

  • PHP 8.1+，需要扩展 BCMath、CType、OpenSSL、PDO、Mbstring、Tokenizer、XML、JSON、Redis（可选）。
  • MySQL 5.7+ 或 MariaDB 10.3+。
  • Nginx 或 Apache。
  • HTTPS（强制建议）。

三、安装步骤

  1. 用 SSH 登录服务器，确保 Composer 已安装。
  2. 执行 composer create-project flarum/flarum . --stability=stable。
  3. 把 Nginx 根目录指向 public 文件夹。
  4. 浏览器访问域名，按向导填数据库信息和管理员账号。

四、必装扩展

  • Chinese 语言包：汉化界面。
  • Likes：点赞功能。
  • Tags：给帖子打标签分类。
  • Akismet：反垃圾发帖。
  • Editor：自带 Markdown 编辑器。

五、安全与运营建议

  • 关闭公开注册，或加人工审核，否则广告党秒来。
  • 定期备份数据库。
  • 开启 CDN 加速，帖子多了访问快。
  • Discuz 老站想迁移的话，有现成的迁移脚本，但建议新站直接用 Flarum。

Flarum 适合做垂直社区、行业交流、产品用户论坛。比 Discuz 年轻，比付费 SaaS 省钱，是 2026 年建论坛的首选。

二次开发与扩展

拿到源码后想改功能，建议遵循以下原则。

  • 先读文档：大部分开源项目有开发文档，先看懂架构再改代码。
  • 不要改核心文件：改之前备份，升级时才不会冲突。
  • 用 Git 管理：把源码放 Git 仓库，每改一个功能打 tag。
  • 社区求助：遇到问题去 GitHub Issues 或官方论坛搜，大概率有人遇到过。

部署常见问题排查

部署源码过程中最常见的问题集中在环境配置和权限上，遇到报错先按下面顺序排查。

  • 500 错误：先看 PHP 错误日志，90% 是扩展没装或版本不对。
  • 数据库连接失败：检查 .env 里的数据库地址、用户名、密码是否正确。
  • 伪静态不生效：Nginx 要配 thinkphp 或 laravel 规则，Apache 要确保 rewrite 模块开启。
  • 后台登录不进去：清除浏览器缓存，确认管理员账号密码正确。