[docs] Annotate split-domain setup (#2372)

This adds account-domain and host comments next to each config line to
hopefully make it easier for folks to understand what goes where.
This commit is contained in:
Daenney 2023-11-21 11:36:31 +01:00 committed by GitHub
parent 42d8011ff4
commit 1f962372af
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23

View file

@ -71,18 +71,18 @@ In order to configure the redirect, you'll need to configure it on the account d
```nginx
server {
server_name example.org;
server_name example.org; # account-domain
location /.well-known/webfinger {
rewrite ^.*$ https://social.example.org/.well-known/webfinger permanent;
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;
rewrite ^.*$ https://social.example.org/.well-known/host-meta permanent; # host
}
location /.well-known/nodeinfo {
rewrite ^.*$ https://social.example.org/.well-known/nodeinfo permanent;
rewrite ^.*$ https://social.example.org/.well-known/nodeinfo permanent; # host
}
}
```
@ -96,10 +96,10 @@ myservice:
image: foo
# Other stuff
labels:
- 'traefik.http.routers.myservice.rule=Host(`example.org`)'
- '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)$$'
- 'traefik.http.middlewares.myservice-gts.redirectregex.replacement=https://social.$${1}/.well-known/$${2}'
- '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}' # host
- 'traefik.http.routers.myservice.middlewares=myservice-gts@docker'
```
@ -108,10 +108,10 @@ myservice:
Ensure that the redirect is configured on the account domain in your `Caddyfile`. The following example assumes the account domain as `example.com`, and host domain as `social.example.com`.
```
example.com {
redir /.well-known/host-meta* https://social.example.com{uri} permanent
redir /.well-known/webfinger* https://social.example.com{uri} permanent
redir /.well-known/nodeinfo* https://social.example.com{uri} permanent
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
}
```