Flarum 这论坛程序，颜值在开源圈里是出了名的。但我这次实测发现一个事：GitHub 上那份源码包，直接上传到服务器是跑不起来的——它是开发框架仓库，不是完整程序，里面缺 vendor 依赖。
要跑起来，得先用 composer 构建一遍。我把整个过程和踩的坑都记下来了，跟着走，半小时内能发出第一个帖子。
Flarum 能干什么
它想取代的是 Discuz 那一代论坛。同样是「板块-帖子」，但它把「板块」换成了「标签」，界面按现代 Web 应用重做了一遍。
按用途对号入座——
- 产品用户社区：用户提问、互相解答、官方置顶公告，比 QQ 群能沉淀内容
- 兴趣小组、爱好者论坛：标签一分，摄影、器材、后期各归各的
- 技术支持论坛：配合标签做「已解决/未解决」，比邮箱工单好查
- 团队内部讨论区：分组权限能卡到「谁能看哪个标签」，当内部 BBS 用没问题
- Discuz 老站迁移：受够了 Discuz 那套模板和广告位，想换个清爽的，它是最常被选的那个
它不适合做「水区型」大社区——没有签到、没有积分商城、没有勋章体系，那套运营玩法它一概没有。
核心功能亮点
- SPA 前端：Mithril 写的，点帖子、切标签都不整页刷新，用起来像现代 App
- 标签代替板块：一个讨论可以挂多个标签，找内容比翻版块快
- 十几个自带扩展：点赞、Emoji、标签、订阅、置顶、BBCode、标记最佳答案，装完就能用，不用到处找插件
- 分组权限：管理员、版主、普通用户、游客分开配，能细到单个标签
- 后台扩展管理：装了什么、开没开，一屏看完，开关直接点
- 语言包体系：官方维护了几十种语言，简体中文有现成的
- Markdown 发帖：标题一行、正文 Markdown，写完就发
- 搜索内置：顶部搜索框直接搜讨论和用户
底子怎么样
- 版本：1.8.10（稳定版；2.0 还在 beta，别急着上）
- 协议：MIT，随便商用
- 技术栈：PHP + MySQL，前端 Mithril
- GitHub：6.7k star
- 依赖：vendor 一百多个包，偏重
我的测试环境
| 项目 | 配置 |
|---|---|
| 系统 | Windows |
| PHP | 8.2 |
| 数据库 | MySQL 8.0 |
本地 PHP 内置服务器实测。宝塔、服务器上装，流程一模一样。
上手搭建：一屏表单，装完就能发帖
如果你是从本站拿的包，composer 那步已经替你做好了（vendor 依赖都打进去了），所以流程很简单：
- 上传解压到网站根目录
- 建一个空数据库，记下库名/用户/密码
- 浏览器访问站点，出安装向导
一屏表单，要填三类信息：论坛标题、MySQL 连接信息、管理员账号。不用像有些程序那样分好几步。
数据库地址本地填 127.0.0.1，服务器上通常是 localhost，按你主机的实际情况来：
点最下面那个 Install Flarum，等它建表（大概十几秒），装完自动用管理员身份登录，直接进论坛。
有个小提示：安装过程中页面顶部可能刷一串 Deprecated 警告（PHP 8.2 下的弃用提示），这是 Flarum 1.8 在 PHP 8.2 上的已知小毛病，不影响安装，装完就不再出现。看着烦的话，可以在 php.ini 里把 error_reporting 里的 E_DEPRECATED 去掉。
如果你非要用 GitHub 原包
原包（flarum/framework）是 monorepo 框架仓库，不能直接跑。得用 composer 构建骨架：
php composer.phar create-project flarum/flarum:^1.8 flarum-site --no-interaction --no-security-blocking这里我踩了四个坑，说一下给要自己折腾的人：
- composer 别从官网下 phar——我下了一次签名校验坏了。换阿里云镜像的 phar（
mirrors.aliyun.com/composer/composer.phar）就好了 - 版本选 1.8。2.0 现在只有 beta，create-project 装不了正式版
- 它会拦安全通告。构建时 composer 报 flarum/core 的安全通告，要求确认，加
--no-security-blocking参数放行 - PHP 必须有 zip 扩展。没有的话 composer 解压时报错
Failed to extract ... unzip.EXE，装得很像环境问题。宝塔用户去 PHP 设置里把 zip 扩展打开就行
坑踩完了构建就顺了，vendor 有一百多个包，依赖确实重。
界面实拍：论坛和后台
刚装好长这样（游客视角）：
页面结构一眼就清楚：顶部搜索 + 登录注册，中间讨论列表，左边筛选。「Start a Discussion」就是发帖入口。
管理后台在 /admin：
左边一整列菜单，分成核心配置（仪表盘、常规、邮箱、权限、外观、用户）和功能（BBCode、Emoji、点赞、标签等十几个自带扩展）。右边仪表盘直接告诉你版本、PHP、MySQL 的情况。
「常规」页就是改论坛标题、副标题这些的地方：
用户管理页，管理员能改用户名、分组、禁用账号：
点「Start a Discussion」弹出发帖面板：
标题一行，正文支持 Markdown。写完点 Post Discussion，秒发：
帖子页右侧有回复按钮和楼层导航，底下直接是回复框。发完回首页，讨论列表里能看到：
从点按钮到帖子出来，全程没有卡顿和刷新感，SPA 的优势就在这。
切成中文：三步
默认全英文，对国内用户不友好。但这事好办——Flarum 有官方语言包体系，我实测装了简体中文包：
我的成品包里已经内置了这个语言包（v1.6.0），你只需要启用它：
- 后台左侧菜单拉到最底下，「语言包」分组里点「简体中文」
- 把那个「Disabled」开关点开，变成「Enabled」
- 再到「常规」页，把 Default Language 下拉从 English 改选「简体中文 (zh-Hans)」，点底部 Save Changes
如果你是自己在服务器上从原包构建的，启用前还得先装包（在站点目录下执行）：
php composer.phar require flarum-lang/chinese-simplified
php flarum cache:clear切完的效果——前台：
后台：
搜索、发帖、筛选、后台菜单，全部中文化。
一个细节：「Welcome to」那行横幅文案还是英文的，因为那是安装时自己填的自定义文本，不属于界面翻译，你在「常规」页改掉就行。
说缺点
好话说完了，讲我自己用下来真实感受到的短板：
1. 默认全英文，中文要自己装语言包。 这是劝退小白的第一道坎，而且语言包不在「扩展」页里点一下就能装，得理解「语言包也是扩展」这个概念。
2. 从 GitHub 原包部署必须过 composer。 还依赖 zip 扩展这类环境细节，比「解压即用」的程序门槛高一大截。
3. PHP 8.2 下安装时会刷弃用警告。 虽然不碍事，但满屏红字看着膈应，第一印象就差了。
4. 中文生态小。 中文插件、中文教程比 Discuz、phpBB 少得多，遇到问题多半要翻英文文档。
5. 2.0 还在 beta。 想等大版本更新的，有的等；1.8 虽然稳，但眼看着要成上一代了。
常见问题
源码获取
上面教程用到的完整源码包（已过 composer 构建 + 内置简体中文语言包 + 原版 LICENSE + 免责声明），我放夸克网盘了，免费取：
两个小提醒：
- 建议先「转存到自己网盘」再下载——直接下载的链接容易失效，转存后就是你自己的了，随时能下；
- 手机上操作：点开链接 → 右下角「保存到网盘」→ 回夸克 App 的「我的网盘」里下载。
自己动手的成本：官方原包是框架仓库，光 composer 构建这一关就能劝退一半人，再加上 zip 扩展、安全通告、语言包三个坑，纯手工走一遍少说两小时。上面记的那些步骤，一步都省不了。包里是我这边全部跑通之后才打的，解压就能装。
装之前先确认两件事：PHP ≥ 8.1（8.2 可以，8.3 没试）、有 MySQL 8.0 可用且提前建好空库。
