XenForo
平台 · 详解依据官方 页面编写,包括平台自身与辅助服务的页面。
概览
XenForo 不是社交网络,也不是注册账号的平台。它是一款付费论坛引擎:你购买授权, 把程序装在自己的服务器上,得到一个由自己拥有的社区。广告规则、内容审核以及让谁 进来的决定权都在你手里,而不在别人手里。
运营方是 XenForo Ltd.:文档页脚署有一行 «Community platform by XenForo® © 2010‑2026 XenForo Ltd.»。
对社区运营专家来说,XenForo 只在一种场景下有意义:品牌需要属于自己的论坛,而不是 在别人的地盘上露面。本手册通常所说的推广,在这里全部变成了管理工作。
这里有谁
XenForo 没有受众——只有购买了授权的管理员。
文档语言是英文。引擎本身支持多语言:界面通过一套«短语»系统翻译, 一次安装中可以并存多种语言,访客自行选择,管理员设定默认语言。 开发方建议在自家的资源目录中寻找现成的译本。
如何开始
服务器需要什么
安装说明要求你 «ensure that your server meets XenForo's requirements»。 从文档可以看出:
- 需要一个空的 MySQL 数据库及其访问信息,还需要服务器的 FTP 访问权限—— 这是«To install XenForo you will need»清单上最前面的几项;
data与internal_data目录必须可写 (在 Linux 上是«chmod 0777»,在 Windows/IIS 上是给 IUSR_ 账户 «Full Control»);- 如果安装程序报的不是权限问题,那么正如说明中直白写到的, «your server does not meet XenForo's requirements and your host will need to make changes to their PHP configuration»;
- 要支持 emoji 和完整 Unicode,需要 MySQL 5.5 或更高版本以及 UTF8mb4 编码;
- «Enhanced Search»插件需要 Elasticsearch 2.0 或更高版本,开发方提醒:大多数 虚拟主机上并没有它。
安装
流程很简单:在买家后台下载压缩包,解压,把 upload 目录中的内容上传到服务器, 在浏览器中打开形如 example.com/community/install/ 的地址,然后走完向导 (分步说明)。 有两种办法可以不必亲自动手:请 XenForo 的员工代为安装——购买时或事后通过后台 提出——或者选用 XenForo Cloud,那里的安装与升级都是自动的。
价格如何
价格由卖方在自己的购买页面上给出——xenforo.com/purchase/ 和 xenforo.com/pricing/。产品线在文档页脚可以看到: 论坛、媒体图库、资源管理器、增强搜索、导入工具。
可以发布什么
内容限制由论坛所有者设定。引擎给出的是框架:主题、帖子、附件、BB 代码排版。 允许的文件类型通过«Allowed attachment file extensions» 选项配置,同一处还有附件管理器,可按类型、所有者和日期筛选,并附有提醒:已删除的 附件无法恢复。
面向论坛用户的规则同样属于你。XenForo 自带 两份文件,«Terms and rules»和«Privacy policy»,用户在注册时接受;其文本可通过 短语系统修改,也可替换为指向外部页面的链接。
如何增长
这里没有把你的内容«展示»给陌生受众的信息流算法——这是你自己的网站。与广告有关的 只有一项:内置的投放系统。广告在 Setup > Advertising 一节中添加:从现成列表里选 位置,粘贴广告主的 HTML,需要时还可按用户组限制展示。 文档直接给出了一种搭配思路:对购买了付费账号升级的人隐藏广告。
变现路径
XenForo 不向作者付钱——付钱给你的是你自己的论坛。官方工具是 «paid user upgrades»:用户付费进入权限更多的用户组,而通过权限可以出售任意版块或 功能的访问权。先配置支付 档案,再配置升级本身:价格、期限、自动续期。
支付通过外部服务完成。文档列出了 Stripe、PayPal、BrainTree 和 2Checkout; 提现覆盖的国家和地区由这些服务决定,而非 XenForo。
工具与自动化
REST API 是有的,而且是官方的。[它自 XenForo 2.1 起出现,地址形如 https://example.com/community/api/,默认开启,可在 src/config.php 中用 $config['enableApi'] = false; 一行关闭](https://docs.xenforo.com/manual/reference/rest-api)。 响应为 JSON,错误以 400 段的状态码返回。
密钥只能在管理后台由超级管理员创建; 创建密钥时所有超级管理员都会收到邮件,密钥本身分三种——访客型、用户型和«super user»型,最后一种可以以任意用户的身份行事并绕过其权限。 API 不存在未授权访问,普通用户无法给自己签发密钥。开发方建议 为每一个 API 客户端单独建一把密钥,并只授予它所需的 scope。
API 的覆盖面可从参考手册的章节清单看出:版块、主题、帖子、用户、附件、私信会话、 媒体图库、资源管理器、搜索、统计、OAuth2 和 oEmbed。 同一处还列出了形如 alert:read、attachment:write、conversation:read、 node:delete 的 scope——权限切分得相当细。
限制与规则
论坛内部的纪律靠积分运作:版主发出警告,积分累积,而«warning actions»会在达到阈值 时自动施加限制或封禁;每条警告有各自的分值和各自的«失效»期限。
反垃圾是另一套工具:按 StopForumSpam 数据库核查注册者、DNS 黑名单、注册计时器、 带有形如 watch * online 模板的«垃圾短语»、通过 Akismet 检查文本并送入审核 队列。 验证码方面——要么用 reCAPTCHA,要么用自定义问答,但同一时间只能启用其中 一种。
主要的法律限制显而易见,但仍值得说明:服务器、用户数据以及遵守当地法律都归你负责。 引擎只提供工具。
适合谁
XenForo 适合需要一个完全受控的自有论坛、并且愿意为授权付费和维护服务器(或选用云 版本)的公司或媒体。它不适合寻找现成受众的人:按产品的构造,这里没有受众。它同样 不适合看重预算可预测性的人:编制预算只能依据直接从卖方取得的数据。
来自事实库的已核实数据
本详解所依据的已核实数据摘要。
平台简介
平台如此自述:«XenForo is a compelling community forum platform with a premium user experience, reliability, flexibility and security.»
自述:这是平台对自身的表述,不是独立评价
来源, 已核查 2026-07-28
文档页脚标注 «Community platform by XenForo® © 2010-2026 XenForo Ltd.»
唯一可访问的官方域名
来源, 已核查 2026-07-28
从何开始
安装需要购买者账户资料、FTP 客户端和服务器访问权限,以及一个空的 MySQL 数据库;data 与 internal_data 目录必须可写(Linux 下为«chmod 0777»,Windows/IIS 下为 IUSR_ 的«Full Control»)
可访问的页面上没有 PHP 与数据库版本要求的表格
来源, 已核查 2026-07-28
完整的 Unicode 与 emoji 支持需要 MySQL 5.5 或更高版本以及 UTF8mb4 编码;对已有数据库提供了脚本 php cmd.php xf:convert-utf8mb4
这是唯一得到确认的数据库版本要求
来源, 已核查 2026-07-28
XenForo Enhanced Search 插件需要 Elasticsearch 2.0 或更高版本;开发方提醒在多数主机上需自行部署
文档中的直接提醒
来源, 已核查 2026-07-28
内容
允许的附件类型由 «Allowed attachment file extensions» 选项设定;附件管理器可按类型、所有者和日期筛选;已删除的附件无法恢复
«Attachments» 章节
来源, 已核查 2026-07-28
广告
内置广告系统:Setup > Advertising 板块,从现成列表中选择版位,插入广告主的 HTML,按用户组限制展示,设定展示顺序和启用开关;模板中版位以标签 <xf:ad position="..." /> 标记
文档直接建议对购买了付费升级的用户隐藏广告
来源, 已核查 2026-07-28
这里的资金规则
内置的变现方式是 «paid user upgrades»:用户付费进入拥有更多权限的用户组,可自行配置
«User upgrades»一节
来源, 已核查 2026-07-28
支付通过 Stripe、PayPal、BrainTree 和 2Checkout 完成;在 Options > Service providers 中配置
可结算的地域由这些服务决定,而非由 XenForo 决定
来源, 已核查 2026-07-28
限制
纪律管理基于分值:版主发出带权重和失效期限的警告,«warning actions» 会自动执行相应处置
«Warnings»一节
来源, 已核查 2026-07-28
反垃圾措施:按 StopForumSpam 数据库核查注册者、DNS 黑名单(例如 Tornevall DNSBL)、注册计时器、带通配符的垃圾短语(如«watch * online»)、通过 Akismet 检查文本并送入审核队列
«Spam management»一节
来源, 已核查 2026-07-28
提供两套 CAPTCHA 系统 —— reCAPTCHA 和自有的问答,同时只有一套生效
«CAPTCHA» 章节
来源, 已核查 2026-07-28
法律
引擎自带两份面向用户的文件 —— «Terms and rules» 和 «Privacy policy»,在注册时予以接受;其文本可通过短语系统编辑,或替换为指向外部页面的链接
平台规则由论坛所有者制定,而非 XenForo
来源, 已核查 2026-07-28
API 访问
首页上有指向开发者文档的链接:https://docs.xenforo.com/api — 页面可以打开,并且含有文档的特征
已更正:先前的版本把首页上出现的任何含 api 或 dev 字样的地址都算作开发者板块。全部 57 条记录已逐一打开地址核对:其中确为文档的有 24 条。
来源, 已核查 2026-07-28
REST API 自 XenForo 2.1 加入,地址形如 <基础 URL>/api/,默认启用,可用 $config('enableApi') = false; 一行关闭;响应为 JSON,错误以 400 系列代码返回
REST API 参考文档
来源, 已核查 2026-07-28
不存在未经授权的 API 访问,用户无法自行签发密钥;密钥只能由超级管理员创建,所有超级管理员都会收到创建通知邮件;密钥类型为访客、用户和 super user(可以任意用户身份行事并绕过其权限)
«API keys»与«Key types»两节
来源, 已核查 2026-07-28
API 按访问范围(scopes)划分,形如 alert:read、alert:write、attachment:delete、conversation:read、media:delete_hard、node:write、profile_post:read;相关部分涵盖论坛、主题、帖子、用户、附件、私信、媒体库、资源管理器、搜索、统计、OAuth2 和 oEmbed
端点参考文档与 OAuth2 方案
来源, 已核查 2026-07-28
语言
首页界面语言:en-US
语言取自标记属性,各语言版本取自 hreflang
来源, 已核查 2026-07-28
整个界面通过 «фраз» 系统翻译;一次安装中可以有多种语言,访问者自行选择,管理员设定默认语言并可禁止选择个别语言
«User interface text: Language» 章节
来源, 已核查 2026-07-28
各来源不一致:在 facts.tsv 中,xenforo 的界面语言按 https://xenforo.com/ 地址记为 en-US;今天该地址返回的不是网站,而是 Cloudflare 的校验页面,它的 lang="en-US" 也是如此 —— 库中的值可能指的是这个占位页面
按任务的要求,该差异以单独一条记录固定下来
来源, 已核查 2026-07-28