本地部署

FastComments On Prem 允许您在您自己的硬件上部署我们的实时评论解决方案，包括所有审核和管理工具，

这意味着您可以控制您的数据，并且评论系统可以限制在您的本地 LAN 或企业网络中。

所需组件

对于本地部署（On-Prem），FastComments 仅由一个应用服务器和一个数据库组成。我们简化了部署方式，使应用可以直接处理所有流量，无需添加其他组件。

应用服务器以 Docker 镜像的形式提供，可以使用任何容器管理方案进行部署。

数据库 MongoDB 可以自行运行，也可以由其他提供商托管，例如 AWS DocumentDB 或 MongoDB Atlas。

FastComments 目前使用 MongoDB 7 进行测试，不过我们的目标是保持与 DocumentDB 的兼容性，以便简化部署。

实例规格

你会发现 FastComments 的优化相当到位，应用本身不需要大型机器就能保持较低的 P99 延迟。

所有批处理和定时任务都使用流式处理来限制总内存占用。

下面关于应用服务器和数据库的表格可以帮助你进行容量规划。

应用服务器实例

例如，单个核心每秒处理约 100 个评论线程时，RSS 通常不会超过 250mb。

数据库服务器实例

数据库的容量规划取决于工作集大小，即你在某一时间点访问的数据量，以及并发请求数。

FastComments 对 Mongo 相当友好：对于热点查询，它使用索引提示、流式游标，并在多个环节设置了并发限制，以防止下游系统过载。

以下是数据库实例规格的一般性指导。请注意，这是__每个实例__的规格，而不是集群的总资源。

以上表格是保守估计。实际需求可能因你的具体配置（页面大小、评论量等）而有所不同。

FastComments 使用环境变量进行配置。以下列表概述了与 On-Prem 相关的所有受支持变量。

注意，所有与域相关的变量使用 _HOST 或 _ADDR 后缀。区别是：

• _HOST: example.com
• _ADDR: https://example.com

EMAIL_CONFIG_PATH 应包含一个指向 JSON 文件的路径，该文件具有以下示例格式：

电子邮件配置

Copy

1

2{

3 "defaultDKIM": {

4 "domainName": "mycompany.org",

5 "keySelector": "2024",

6 "privateKey": "-----BEGIN PRIVATE KEY-----\nABCDEFG\n-----END PRIVATE KEY-----"

7 },

8 "providerTransports": {

9 "yahoo.com": "specialTransport"

10 },

11 "defaultTransport": "mailgun",

12 "transports": {

13 "mailgun": {

14 "host": "smtp.mailgun.org",

15 "port": 587,

16 "secure": false,

17 "auth": {

18 "user": "admin@somewhere.com",

19 "pass": "password"

20 },

21 "tls": {

22 "ciphers": "SSLv3"

23 }

24 },

25 "specialTransport": {

26 "host": "smtp.someplace.org",

27 "port": 587,

28 "secure": false,

29 "auth": {

30 "user": "admin@example.com",

31 "pass": "password"

32 },

33 "tls": {

34 "ciphers": "SSLv3"

35 }

36 }

37 }

38}

39

在上述示例中，我们定义了一个名为 mailgun 的默认 SMTP 邮件传输。我们还为 @yahoo.com 的电子邮件专门定义了一个特殊传输。在某些场景中，希望针对某个域使用特定提供商或发送 IP 以优化投递。这是可选的。

DocumentDB

当连接到 DocumentDB 时，您需要指定 MONGO_ENABLE_SSL=true MONGO_SSL_CA=/some/path.pem 以兼容默认设置。

FastComments 支持自动维护模式。如果数据库宕机，它仍然可以继续为热门评论线程提供服务。

另外，在维护模式下，所有评论都会保存到 BACKUP_DIR。系统恢复上线后，这些评论会被处理（例如检查垃圾评论等）并保存。

其实现方式是每小时确定前 100 个最受欢迎的评论线程并将其内容缓存到磁盘上。确定前 100 个线程 是基于预先计算的状态完成的，因此不是一个开销大的定期任务。

这是完全可选的，只有在设置了 CACHE_DIR 和 BACKUP_DIR 时才会启用。当然，这会使应用节点变为有状态，但这是可以随时丢失且不会导致应用异常的状态。

请注意，在维护模式下无法对评论线程进行适当的身份验证，因此只有被安全地视为公开的线程会被定期备份。

在维护模式下，许多功能不可用。

用于 On-Prem 的前端代码片段和库与 SaaS 产品相同。但是，您必须指定 apiHost 和正确的脚本路径：

本地部署的评论代码

Copy

1

2<script async src="https://my.host.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5 window.fcConfigs = [{

6 target: '#fastcomments-widget',

7 tenantId: "demo",

8 apiHost: "https://my.host.com"

9 // ... 也可以传递 SSO 有效载荷等。

10 }];

11</script>

12

以上是一个非常简单的示例。我们也可以使用第一方的 React、Angular、Vue、Svelte 等库。

可以像常规的 SaaS 产品一样访问该 API：您可以登录 On-Prem 仪表板以创建 API 密钥，并使用这些密钥访问该 API。 API 端点在 on-prem 与 SaaS 产品相同。

您的 On-Prem FastComments 安装可以向多个内部域提供评论，例如 app.mycorp.org 和 hr.mycorp.org。您可以配置这些 分别，但可以通过在同一 On-Prem 部署上创建单独的 Customization Rules 来托管它们并配置它们各自的行为。

默认情况下，FastComments 假定评论线程是公开的。要增加一层安全性，建议创建一个自定义规则，并在 Requires SSO 选项上勾选。这将导致所有与评论相关的端点都需要 SSO 身份验证。