117 lines
4.8 KiB
Markdown
117 lines
4.8 KiB
Markdown
|
# 分域部署
|
|||
|
|
|
|||
|
|
本指南解释了如何使用 `@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
|
|||
|
|
}
|
|||
|
|
```
|