[docs] add zh docs (#3507)

* [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
2025-11-18 10:07:29 -06:00 · 2024-11-05 13:36:43 +00:00 · 2024-11-05 13:36:43 +00:00 · 38a08cd25a
commit 38a08cd25a
parent e953d80dff
139 changed files with 20407 additions and 24 deletions
--- a/docs/locales/zh/advanced/host-account-domain.md
+++ b/docs/locales/zh/advanced/host-account-domain.md
@ -0,0 +1,116 @@
+# 分域部署
+
+本指南解释了如何使用 `@me@example.org` 这样的用户名，但将 GoToSocial 实例本身运行在例如 `social.example.org` 这样的子域名的方法。这种部署布局的配置**必须**在第一次启动 GoToSocial 前完成。
+
+!!! danger
+    一旦与他人联合后就无法更改域名布局。服务器会因此产生混淆，而你需要说服每个与你联合的实例管理员修改其数据库来解决问题。同时，你还需要在本地重新生成数据库，创建一个新的实例账户和加密密钥对。
+
+## 背景
+
+ActivityPub 实现通过一个称为 [webfinger](https://www.rfc-editor.org/rfc/rfc7033) 的协议来发现如何将你的账户域映射到你的主机域。这种映射通常会被服务器缓存，因此在事后无法更改。
+
+它的工作原理是请求 `https://<账户域>/.well-known/webfinger?resource=acct:@me@example.org`。此时，服务器可以返回重定向到实际的 webfinger 端点 `https://<主机域>/.well-known/webfinger?resource=acct:@me@example.org` 或直接响应。返回的 JSON 文档告知应查询的用户端点：
+
+```json
+{
+  "subject": "acct:me@example.org",
+  "aliases": [
+    "https://social.example.org/users/me",
+    "https://social.example.org/@me"
+  ],
+  "links": [
+    {
+      "rel": "http://webfinger.net/rel/profile-page",
+      "type": "text/html",
+      "href": "https://social.example.org/@me"
+    },
+    {
+      "rel": "self",
+      "type": "application/activity+json",
+      "href": "https://social.example.org/users/me"
+    }
+  ]
+}
+```
+
+ActivityPub 客户端和服务器将使用 `links` 数组中 `rel` 为 `self` 和 `type` 为 `application/activity+json` 的条目来查询更多信息，比如在哪里找到 `inbox` 以进行联合消息的传递。
+
+## 配置
+
+你需要关注两个配置设置：
+
+* `host`，API 运行的域名，以及客户端和服务器与实例通信时使用的域
+* `account-domain`，用户账户所属的域名
+
+为了实现引言中描述的设置，你需要相应地设置这两个配置选项：
+
+```yaml
+host: social.example.org
+account-domain: example.org
+```
+
+!!! info
+    `host` 必须始终是运行 GoToSocial 实例的 DNS 名称。它不影响 GoToSocial 实例绑定的 IP 地址。该地址由 `bind-address` 控制。
+
+## 反向代理
+
+使用[反向代理](../getting_started/reverse_proxy/index.md)时，需要确保能够处理这两个域的流量。你需要将一些端点从账户域重定向到主机域。
+
+重定向通常用于客户端侧检测域变化。需要从账户域重定向到主机域的端点是：
+
+* `/.well-known/webfinger`
+* `/.well-known/host-meta`
+* `/.well-known/nodeinfo`
+
+!!! tip
+    不要将 API 端点 `/api/...` 的请求从账户域代理或重定向到主机域。这会混淆某些客户端用来检测分域部署的启发式方法，导致登录流程中断及其他异常行为。
+
+### nginx
+
+为了配置重定向，你需要在账户域上进行配置。假设账户域为 `example.org`，主机域为 `social.example.org`，以下配置代码展示了如何做到这一点：
+
+```nginx
+server {
+  server_name example.org;                                                      # account-domain
+
+  location /.well-known/webfinger {
+    rewrite ^.*$ https://social.example.org/.well-known/webfinger permanent;    # host
+  }
+
+  location /.well-known/host-meta {
+    rewrite ^.*$ https://social.example.org/.well-known/host-meta permanent;  # host
+  }
+
+  location /.well-known/nodeinfo {
+    rewrite ^.*$ https://social.example.org/.well-known/nodeinfo permanent;   # host
+  }
+}
+```
+
+### Traefik
+
+如果 `example.org` 运行在 [Traefik](https://doc.traefik.io/traefik/) 上，可以使用类似以下的标签设置重定向。
+
+```yaml
+myservice:
+  image: foo
+  # 其他配置
+  labels:
+    - 'traefik.http.routers.myservice.rule=Host(`example.org`)'                                 # account-domain
+    - 'traefik.http.middlewares.myservice-gts.redirectregex.permanent=true'
+    - 'traefik.http.middlewares.myservice-gts.redirectregex.regex=^https://(.*)/.well-known/(webfinger|nodeinfo|host-meta)(\?.*)?'  # host
+    - 'traefik.http.middlewares.myservice-gts.redirectregex.replacement=https://social.${1}/.well-known/${2}${3}'                # host
+    - 'traefik.http.routers.myservice.middlewares=myservice-gts@docker'
+```
+
+### Caddy 2
+
+确保在你的 `Caddyfile` 中在账户域上配置重定向。以下示例假设账户域为 `example.com`，主机域为 `social.example.com`。
+
+```
+example.com {                                                                    # account-domain
+        redir /.well-known/host-meta* https://social.example.com{uri} permanent  # host
+        redir /.well-known/webfinger* https://social.example.com{uri} permanent  # host
+        redir /.well-known/nodeinfo* https://social.example.com{uri} permanent   # host
+}
+```