Hosterra/domain-forward
Hosterra/domain-forward
1
1
Fork 0
Code Issues Pull requests Releases 1 Activity

Typos fixes.

Browse source
This commit is contained in:
Pierre Lannoy 2024-03-08 19:26:17 +01:00
commit f83db758a8
1 changed files with 14 additions and 13 deletions
Download patch file Download diff file Expand all files Collapse all files

27
README.md
View file

@ -2,14 +2,15 @@
The service to forward domains using HTTP(s) redirects via Hosterra DoH.
> ATTENTION: THIS SERVICE IS NOT PUBLICLY AVAILABLE FOR NOW. EXPECT IT FOR FEBRUARY 2024.
Example scenarios:
#### Example scenarios:
+ Forward non-www to www domains or vice versa
+ Forward old domains to new domains
+ Forward "parked" domains to a bid platform
+ Forward you own domain to your LinkedIn page
+ …
How does it works?
#### How does it works?
+ Point your domain to Hosterra using CNAME or A/AAAA records
+ Tell us where to forward using TXT records
@ -20,28 +21,28 @@ How does it works?
To forward from `www.old.com` to `old.com`, add these records to your DNS:
```
www.old.com IN CNAME fwd.hosterra.tech
_forward.www.old.com IN TXT forward-to=https://old.com/*
www.old.com. IN CNAME fwd.hosterra.tech
_forward.www.old.com. IN TXT forward-to=https://old.com/*
```
Because CNAME can't be used in apex domains, you can use A/AAAA records.
To forward from `old.com` to `new.net`, add these records to your DNS:
```
old.com IN A 51.159.188.120
old.com IN AAAA 2001:bc8:1210:656:dc00:ff:fe26:bfdd
_forward.old.com IN TXT forward-to=https://new.net/*
old.com. IN A 51.159.188.120
old.com. IN AAAA 2001:bc8:1210:656:dc00:ff:fe26:bfdd
_forward.old.com. IN TXT forward-to=https://new.net/*
```
The star `*` at the end tells us that the remaining URL path is also forwarded to the destination URL.
The star `*` at the end tells us that the remaining URL path is also forwarded to the destination URL. If you want to forward to a unique url, just omit this star.
> If you use Cloudflare or any DNS which supports [CNAME Flattening](https://blog.cloudflare.com/introducing-cname-flattening-rfc-compliant-cnames-at-a-domains-root/), you still can use CNAME records pointing to `fwd.hosterra.tech`. It's recommended to use CNAME records rather than A/AAAA records.
> If you use Cloudflare or any DNS which supports [CNAME Flattening](https://blog.cloudflare.com/introducing-cname-flattening-rfc-compliant-cnames-at-a-domains-root/), you still can use CNAME records pointing to `fwd.hosterra.tech`. It is recommended to use CNAME records rather than A/AAAA records.
You can choose the type of redirection you want to use by declaring the `http-status` value:
```
www.old.com IN CNAME fwd.hosterra.tech
_forward.www.old.com IN TXT http-status=302;forward-to=https://old.com/*
www.old.com. IN CNAME fwd.hosterra.tech
_forward.www.old.com. IN TXT http-status=302;forward-to=https://new.com/*
```
> HTTP status codes 301, 302, 303, 307 and 308 are supported. By default it's 301, which is permanent redirection.