本指南介绍隐藏站点设置，包括如何启用它们以及为何您可能需要调整它们。
所需用户级别：管理员
重要提示：部分步骤需要访问控制台。
在 Discourse 中，隐藏站点设置指的是那些无法通过标准管理员仪表板界面直接查看或访问的配置选项。这些设置属于后端配置的一部分，可控制网站的各种高级功能或具有潜在影响的功能。
这些隐藏设置已预配置了默认值，旨在基于常见用例和最佳实践确保最佳性能和安全性。
隐藏设置被隐藏于默认设置界面之外，以防止管理员因不完全理解其影响而误操作。它们适用于以下情况：
- 对 Discourse 内部机制有深入理解的管理员。
- 需要特殊或非常具体的站点配置的特殊情况。
- 测试或尚未准备好供一般使用的实验性功能。
希望修改隐藏设置的管理员通常是因为默认配置无法完全满足其需求。
如果不谨慎调整 Discourse 中的隐藏站点设置，可能会导致各种问题，例如安全漏洞、性能下降、用户体验恶化或数据丢失！
隐藏站点设置仅应由具备专业知识的 Discourse 管理员进行修改。在更改任何设置之前，请务必了解其功能及更改带来的影响。如可能，请在测试或开发环境中实施重大配置变更。在进行广泛或关键变更之前，请确保备份是最新的，以便在出现问题时恢复论坛状态。
如何编辑隐藏站点设置
选项 1：Rails 控制台
要修改隐藏站点设置，通常需要使用 Rails 控制台。这是一个命令行工具，允许您直接与 Discourse 安装的后端进行交互。通过 Rails 控制台调整设置的步骤如下：
- 访问 Rails 控制台：
cd /var/discourse
./launcher enter app
rails c
- 更改设置：
SiteSetting.your_setting_name = new_value
将 your_setting_name 替换为您要修改的设置名称，将 new_value 替换为您要设置的值。
- 退出控制台：
exit
选项 2：在 app.yml 中设置环境变量
您还可以使用环境变量来调整隐藏站点设置。app.yml 文件是 Discourse 基于 Docker 部署中使用的配置文件，通常位于 Discourse 安装的 /containers 目录下。以下是添加或修改环境变量的方法：
- 访问
app.yml文件：
使用您喜欢的文本编辑器打开app.yml文件：
nano /var/discourse/containers/app.yml
- 添加环境变量：
环境变量可在app.yml文件的env部分进行配置。它们遵循DISCOURSE_SETTING_NAME: value的模式。例如，要通过环境变量将max_category_nesting设置设为3，您可以使用：
env:
DISCOURSE_MAX_CATEGORY_NESTING: 3
- 重建容器：
保存app.yml文件的更改后，重建 Discourse Docker 容器以应用更改：
cd /var/discourse
./launcher rebuild app
为何启用隐藏设置
在 Discourse 中启用或调整隐藏站点设置，使管理员能够深入定制其论坛设置，以满足特定的技术要求、提升性能或确保安全性和合规性，从而支持精细定制的用户体验和运营效率。
隐藏站点设置的示例包括：
- 徽章 SQL：启用
enable_badge_sql允许站点管理员创建自定义 SQL 查询以定义徽章标准，从而根据复杂条件灵活分配徽章。 - S3 备份设置：通过
include_s3_uploads_in_backups将 S3 上传包含在备份中，可用于增强备份策略。 - 搜索速率限制：通过
rate_limit_search_user等设置调整搜索速率限制，以防止在高使用场景下出现节流问题。
常见问题解答
问：能否在 UI 中显示隐藏设置？
答：出于安全和复杂性的考虑，Discourse 中的隐藏设置无法直接通过 UI 进行配置。
问：我在哪里可以找到每个隐藏设置的信息？
答：每个设置的详细信息可在 隐藏站点设置参考指南 和 Discourse 源代码中找到，具体位于 GitHub 仓库 中的 site_settings.yml 文件。此外，Discourse Meta 论坛上也提供了一些设置的额外信息。
问：通过环境变量进行的更改在更新后是否保留？
答：是的，如果在 app.yml 或系统的永久配置文件中设置，这些设置将在更新后保留，除非被其他配置覆盖。
问：我如何知道哪些设置可以通过环境变量控制？
答：通常，任何 Discourse 站点设置都可以加上 DISCOURSE_ 前缀并作为环境变量进行设置。
问：通过环境变量配置敏感信息是否安全？
答：环境变量通常被认为在配置管理方面是安全的。但请确保它们不会在共享或不安全的环境中暴露。
问：切换站点设置后是否需要重建？
答：在大多数情况下，通过 Rails 控制台切换站点设置不需要重建 Discourse 设置。这些更改通常立即生效或在实例刷新后生效。然而，某些特定设置，尤其是影响系统基础架构的设置，可能需要重启或重建才能生效。对于在 app.yml 文件中进行的更改，必须重建 Discourse 容器才能生效。
问：我是否可以轻松还原设置更改？
答：是的，大多数设置都可以还原，除非涉及数据删除。