第21章 Flarum 管理后台

版本：2.x 管理后台

Flarum 管理后台是一个用户友好的界面，用于管理你的论坛。

该功能仅对“Admin”组中的用户可见。

要访问管理后台，请点击屏幕右上角的用户名称，然后选择 Administration（管理）。

管理后台包含以下部分：

• Dashboard（仪表盘）：显示管理后台主界面，包含统计信息和其他相关数据。
• Basics（基础设置）：提供设置论坛基本信息的选项，如名称、描述和欢迎横幅。
• Email（邮箱）：允许配置邮件设置。更多信息请参考此处。
• Permissions（权限）：显示每个用户组的权限，并允许配置全局及特定范围的权限。
• Appearance（外观）：允许自定义论坛颜色、品牌标识，并添加额外的 CSS 进行定制。
• Users（用户）：提供论坛所有用户的分页列表，允许编辑用户或执行管理操作。
• Advanced（高级设置）：允许配置维护模式、搜索驱动、队列驱动等高级设置。该部分默认隐藏，需手动开启，详见 The Advanced page。

除上述部分外，管理后台还允许你在 Features（功能）部分管理扩展（包括 Tags 等 Flarum 核心扩展）。修改论坛主题的扩展归类于 Themes（主题）部分，支持多语言的扩展则归类于 Languages（语言）部分。

The Advanced page

Advanced（高级设置）页面保存了大多数论坛无需修改的设置，因此默认从管理菜单中隐藏，需手动开启。

要显示该页面，请前往 Dashboard，打开 Tools（工具）菜单并选择 Toggle Advanced Page（切换高级页面）。Advanced 随后将出现在管理菜单中。再次选择 Toggle Advanced Page 即可隐藏该页面。隐藏页面不会更改其中的任何设置。

即使页面处于隐藏状态，你也可以直接在论坛地址后添加 /admin#/advanced 来访问该页面，例如 https://example.com/admin#/advanced。

Search Drivers

扩展可以添加其他搜索驱动，例如使用 Elasticsearch 的驱动。安装后，可在此选择哪种内容类型（如讨论或用户）使用哪种驱动进行搜索。在此之前，该部分会显示没有其他驱动可用。

在 MySQL 和 MariaDB 中，勾选“Optimise search for CJK languages”（优化 CJK 语言搜索）可让搜索支持中文、日文和韩文文本。基于数据库的词法搜索无法匹配 CJK 句子的一部分，因此此选项会切换为匹配文本的任意部分。在非常大的论坛上，这会降低速度。

Maintenance

将论坛设置为其中一种维护模式：

模式	谁可以使用论坛
无维护 (No maintenance)	所有人
低维护 (Low maintenance)	仅限管理员
安全模式 (Safe mode)	仅限管理员，且不加载任何扩展
高维护 (High maintenance)	无人。此模式只能在 config.php 中设置

在安全模式下，你可以选择允许加载的扩展。如果 config.php 中的 safe_mode_extensions 键列出了扩展，则优先使用该列表。

如果 config.php 通过 offline 键设置了维护模式，则其优先级最高。页面显示当前设置的模式，在此进行的更改仅在 config.php 不再设置维护模式时才生效。

Extension Bisect

如果遇到问题且怀疑是某个扩展造成的，点击 Begin Bisect（开始二分排查）可找出罪魁祸首：

• 论坛进入低维护模式，因此仅管理员可以使用。
• 在每一步中，部分扩展会被禁用。请在另一个浏览器标签页中尝试复现问题，然后回答是否仍发生。在此过程中，被禁用扩展的功能缺失，论坛外观可能不同。
• 经过几步操作后（对话框会提示大致步数），它会指出导致问题的扩展。

完成排查或选择 Stop bisect（停止排查）后，之前启用的扩展将重新启用，论坛退出维护模式。如果在排查过程中关闭了对话框，点击 Continue Bisect（继续排查）可从上次中断处继续。

当论坛处于低维护模式以外的其他维护模式时，无法启动排查。

FontAwesome Icons

配置图标加载源（内置图标、CDN 或 FontAwesome Kit）、强制应用于所有图标的样式，以及用于检查配置的预览。详情请参见 FontAwesome。如果 config.php 设置了这些值，页面将显示其数值，且无法在此处更改。

PostgreSQL

仅在论坛使用 PostgreSQL 时显示。从数据库可用配置中，选择用于搜索的文本搜索配置。

Queue

显示论坛使用的队列驱动。

使用默认的 sync 驱动时，任务在请求期间运行，无需设置。

使用其他驱动时，可以暂停所有队列或每个队列的任务处理。详见 Pausing a queue（暂停队列）。

使用 database 驱动时，还可以调整 worker（工作进程）设置：

设置项	默认值	描述
Job Retries（任务重试次数）	1	任务被标记为失败前的尝试次数
Memory Limit (MB)（内存限制）	128	worker 重启前可使用的最大内存
Job Timeout (seconds)（任务超时时间）	60	单个任务运行超时的时长（秒）
Rest Time (seconds)（休息间隔）	0	任务之间的等待时间（秒）
Backoff (seconds)（退避时间）	0	重试失败任务前的等待时间（秒）