53 lines
2.2 KiB
Markdown
53 lines
2.2 KiB
Markdown
# Domain Forward
|
|
|
|
The [service](https://hosterra.eu/projects/public/forwarder.php) to forward domains using HTTP(s) redirects via Hosterra DoH.
|
|
|
|
|
|
#### 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?
|
|
|
|
+ Point your domain to Hosterra using CNAME or A/AAAA records
|
|
+ Tell us where to forward using TXT records
|
|
+ We handle redirection and HTTPS certificates for you
|
|
|
|
## Get Started
|
|
|
|
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/*
|
|
```
|
|
|
|
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/*
|
|
```
|
|
|
|
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 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://new.com/*
|
|
```
|
|
|
|
> HTTP status codes 301, 302, 303, 307 and 308 are supported. By default it's 301, which is permanent redirection.
|
|
|
|
## Credits
|
|
|
|
This software is based on the invaluable work from [Wildan M](https://github.com/willnode/forward-domain) and [BYU Internet Measurement and Anti-Abuse Lab](https://github.com/byu-imaal/dohjs). Endless thanks to them and all the contributors to these two projects.
|