Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/willnode/forward-domain
Forward Domains, completely free and open source.
https://github.com/willnode/forward-domain
domain forwarding free-software microserv saas
Last synced: 5 days ago
JSON representation
Forward Domains, completely free and open source.
- Host: GitHub
- URL: https://github.com/willnode/forward-domain
- Owner: willnode
- License: mit
- Created: 2021-08-22T00:35:27.000Z (about 3 years ago)
- Default Branch: main
- Last Pushed: 2024-07-26T02:46:22.000Z (3 months ago)
- Last Synced: 2024-07-26T03:58:00.222Z (3 months ago)
- Topics: domain, forwarding, free-software, microserv, saas
- Language: JavaScript
- Homepage: https://forwarddomain.net/
- Size: 229 KB
- Stars: 155
- Watchers: 5
- Forks: 17
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGES.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
# Forward Domain
[](https://github.com/willnode/forward-domain/stargazers)
[](https://stats.uptimerobot.com/AA77Xt9Jx8)
> For hosting guide See [HOSTING.md](HOSTING.md) and [CHANGES.md](CHANGES.md)
This service forwards domains using HTTP(s) redirects.
Example scenarios:
+ Forward non-www to www domains or vice versa
+ Forward old domains to new domains
Why using this service?
+ No coding required
+ No hosting required
+ No registration required
+ Completely anonymous
+ Completely free
How does it works?
+ Point your domain to us using CNAME or A/AAAA records
+ Tell us where to forward using TXT records
+ We handle 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 r.forwarddomain.net
_.www.old.com IN TXT forward-domain=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 167.172.5.31
_.old.com IN TXT forward-domain=https://new.net/*
```
The star `*` at the end tells us that the remaining URL path is also need to be forwarded to the destination URL.
> 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 `r.forwarddomain.net`. It's 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 r.forwarddomain.net
_.www.old.com IN TXT http-status=302;forward-domain=https://old.com/*
```
The HTTP codes available for use include:
+ `301` Permanent redirection (default)
+ `302` Temporary redirection (may keeping SEO from indexing new location)
+ `307` Temporary redirection while keeping HTTP verb
+ `308` Permanent redirection while keeping HTTP verb
## FAQ
### Is it really free?
Forwarding domains should be easy to setup.
I use this myself for [domcloud.io](https://domcloud.io).
### How can I check redirects will work?
This service uses Google's [Public DNS Resolver](https://dns.google).
Once first accessed, values will be cached for a day.
For right now there's no way to flush the cache sorry.
### Why it loads slowly?
It only slow at first time because it has to sign HTTPS certificates.
### How about IPv6?
IPv6 record is added in `r.forwarddomain.net` so subdomain redirects will simply work with IPv6. We don't guarantee that its IPv6 address will be persistent though. See [#2](https://github.com/willnode/forward-domain/issues/2#issuecomment-1003831835) for apex domains setup.
### What records do we keep?
We only keep caches of DNS records and SSL certs. This also means we can see how many users and what domains are using our service from the software cache, but that's all. We don't keep log traffic nor keep any user data anywhere on our server.
### How can I support this service?
Star our repo and spread the word, please :)
Additionally, you can also help us [cover hosting costs](https://github.com/sponsors/willnode).
## Credits
Things in `package.json`. I also borrow code from [zbo14/certnode](https://github.com/zbo14/certnode).
## Usual Disclaimer
```
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.
```