mirror of
https://github.com/superseriousbusiness/gotosocial.git
synced 2024-12-04 22:20:53 +01:00
38a08cd25a
* [docs] add zh docs * [docs] add lang dropdown * [docs] update mkdocs zh config * [docs] migrate assets * [docs] update overrides dir in mkdocs zh config * [docs] exclude locales director in main mkdocs config * [docs] rename assets to public to avoid conflicting with template * [docs] extra_css change followup * [docs] add theme.palette.toggle.icon back into mkdocs zh config * [docs] fix zh readme reference + migrate language-specific repo markdown to docs * [docs] translate remaining repo docs + update reference * [docs] update zh index.md reference * [docs/zh] wording alignment
116 lines
5.0 KiB
Markdown
116 lines
5.0 KiB
Markdown
# 站点
|
||
|
||
## 设置
|
||
|
||
```yaml
|
||
###########################
|
||
##### 站点配置 #####
|
||
###########################
|
||
|
||
# 与实例间联合、隐藏/显示页面等相关的配置。
|
||
|
||
# 字符串数组。BCP47 语言标签，用于指示本站用户的首选语言。
|
||
#
|
||
# 如果你提供了这些标签，请按照从最优先到最次优先的顺序提供。
|
||
# 但请注意，从此数组中省略某种语言并不意味着该语言不能在本站使用，
|
||
# 而只是表示不会将其作为为本站的首选语言展示。
|
||
#
|
||
# 这里可以不提供任何条目；这样的话，你的站点将没有特定的首选语言。
|
||
#
|
||
# 常用标签参考此处：https://en.wikipedia.org/wiki/IETF_language_tag#List_of_common_primary_language_subtags
|
||
# 所有当前标签参考此处：https://www.iana.org/assignments/language-subtag-registry/language-subtag-registry
|
||
#
|
||
# 示例: ["zh", "zh-Hans", "zh-Hans-CN", "zh-Hant", "zh-Hant-TW", "en"]
|
||
# 默认值: []
|
||
instance-languages: []
|
||
|
||
# 字符串。用于本站的联合模式。
|
||
#
|
||
# "blocklist" -- 默认开放联合。只有被明确屏蔽的站点会被拒绝（除非它们被另外明确设定的允许规则放行）。
|
||
#
|
||
# "allowlist" -- 默认关闭联合。只有被明确允许的站点才能与本站互动。
|
||
#
|
||
# 关于屏蔽列表和允许列表模式的更多详细信息，请查阅文档：
|
||
# https://docs.gotosocial.org/zh-cn/latest/admin/federation_modes
|
||
#
|
||
# 选项: ["blocklist", "allowlist"]
|
||
# 默认值: "blocklist"
|
||
instance-federation-mode: "blocklist"
|
||
|
||
# 布尔值。启用针对通过联合 API 进入本站的消息的启发式垃圾过滤。无论你在此处设置什么，
|
||
# 都仍将执行基本的相关性检查，但如果你被其他站点的垃圾信息骚扰，并希望更严格地过滤掉垃圾信息，
|
||
# 可以尝试启用此设置。
|
||
#
|
||
# 这是一个实验性设置，可能会过滤掉合法信息，或未能过滤掉垃圾信息。建议仅在
|
||
# Fediverse 出现垃圾信息潮时启用此设置，以保持站点的可用性。
|
||
#
|
||
# 判断消息是否为垃圾信息的决策基于以下启发规则，依次进行，接收者 = 收到消息的账户，发送者 = 发送消息的外站账户。
|
||
#
|
||
# 首先执行基本相关性检查
|
||
#
|
||
# 1. 接收者关注了发送者。返回 OK。
|
||
# 2. 贴文未提及接收者。返回 NotRelevant。
|
||
#
|
||
# 如果 instance-federation-spam-filter = false，则现在返回 OK。
|
||
# 否则进一步检查：
|
||
#
|
||
# 3. 接收者已锁定账号并被发送者关注。返回 OK。
|
||
# 4. 提及五人或以上。返回 Spam。
|
||
# 5. 接收者关注（请求关注）一个被提及账户。返回 OK。
|
||
# 6. 贴文有媒体附件。返回 Spam。
|
||
# 7. 贴文包含非提及、非话题标签的链接。返回 Spam。
|
||
#
|
||
# 被识别为垃圾的信息将从本站删除，不会插入数据库或主页时间线或通知中。
|
||
#
|
||
# 选项: [true, false]
|
||
# 默认值: false
|
||
instance-federation-spam-filter: false
|
||
|
||
# 布尔值。允许未经认证的用户查询 /api/v1/instance/peers?filter=open 以查看与本站联合的站点列表。
|
||
# 即使设置为 'false'，认证用户（本站成员）仍然可以查询该端点。
|
||
# 选项: [true, false]
|
||
# 默认值: false
|
||
instance-expose-peers: false
|
||
|
||
# 布尔值。允许未经认证的用户查询 /api/v1/instance/peers?filter=suspended 以查看被本站屏蔽/封禁的站点列表。
|
||
# 即使设置为 'false'，认证用户（本站成员）仍然可以查询该端点。
|
||
#
|
||
# 警告：将此变量设置为 'true' 可能导致你的站点被屏蔽列表爬虫攻击。
|
||
# 参考: https://docs.gotosocial.org/zh-cn/latest/admin/domain_blocks/#block-announce-bots
|
||
#
|
||
# 选项: [true, false]
|
||
# 默认值: false
|
||
instance-expose-suspended: false
|
||
|
||
# 布尔值。允许未经认证的用户查看 /about/suspended，
|
||
# 显示本站屏蔽/封禁站点的 HTML 渲染列表。
|
||
# 选项: [true, false]
|
||
# 默认值: false
|
||
instance-expose-suspended-web: false
|
||
|
||
# 布尔值。允许未经认证的用户查询 /api/v1/timelines/public 以查看本站的公共贴文列表。
|
||
# 即使设置为 'false'，认证用户（本站成员）仍然可以查询该端点。
|
||
# 选项: [true, false]
|
||
# 默认值: false
|
||
instance-expose-public-timeline: false
|
||
|
||
# 布尔值。此标志是否将 GoToSocial 的 ActivityPub 消息发送到收件人的共享收件箱（如果可用），
|
||
# 而不是将每条消息分别发送给应接收消息的每个主体。
|
||
#
|
||
# 当发送给共享收件箱的多个收件人时，共享收件箱传递能显著减少网络负载（例如，大型 Mastodon 实例）。
|
||
#
|
||
# 参考: https://www.w3.org/TR/activitypub/#shared-inbox-delivery
|
||
#
|
||
# 选项: [true, false]
|
||
# 默认值: true
|
||
instance-deliver-to-shared-inboxes: true
|
||
|
||
# 布尔值。此标志将在 /api/v1/instance 中包含的版本字段中注入一个 Mastodon 版本。
|
||
# 这个版本通常被 Mastodon 客户端用于 API 功能检测。通过注入一个与 Mastodon 兼容的版本，
|
||
# 可以促使那些客户端在 GoToSocial 上正常运行。
|
||
#
|
||
# 选项: [true, false]
|
||
# 默认值: false
|
||
instance-inject-mastodon-version: false
|
||
```
|