{"id":13500630,"url":"https://github.com/willnode/forward-domain","last_synced_at":"2025-04-13T07:51:23.387Z","repository":{"id":49279406,"uuid":"398682889","full_name":"willnode/forward-domain","owner":"willnode","description":"Forward Domains, completely free and open source.","archived":false,"fork":false,"pushed_at":"2025-02-01T11:03:03.000Z","size":237,"stargazers_count":203,"open_issues_count":4,"forks_count":24,"subscribers_count":5,"default_branch":"main","last_synced_at":"2025-04-04T14:51:18.528Z","etag":null,"topics":["domain","forwarding","free-software","microserv","saas"],"latest_commit_sha":null,"homepage":"https://forwarddomain.net/","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/willnode.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGES.md","contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"github":"willnode"}},"created_at":"2021-08-22T00:35:27.000Z","updated_at":"2025-04-01T10:59:24.000Z","dependencies_parsed_at":"2024-01-13T19:20:58.229Z","dependency_job_id":"2fb3bfe0-32fe-4d07-9886-329bb8b1d201","html_url":"https://github.com/willnode/forward-domain","commit_stats":null,"previous_names":[],"tags_count":11,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/willnode%2Fforward-domain","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/willnode%2Fforward-domain/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/willnode%2Fforward-domain/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/willnode%2Fforward-domain/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/willnode","download_url":"https://codeload.github.com/willnode/forward-domain/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248681494,"owners_count":21144700,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["domain","forwarding","free-software","microserv","saas"],"created_at":"2024-07-31T22:01:07.710Z","updated_at":"2025-04-13T07:51:23.363Z","avatar_url":"https://github.com/willnode.png","language":"JavaScript","readme":"# Forward Domain\n\n[![GitHub Repo stars](https://img.shields.io/github/stars/willnode/forward-domain?style=for-the-badge)](https://github.com/willnode/forward-domain/stargazers)\n[![Uptime Robot ratio (30 days)](https://img.shields.io/uptimerobot/ratio/m790428156-91b88afc46cfb86ead3dc56e?style=for-the-badge)](https://stats.uptimerobot.com/AA77Xt9Jx8)\n\n\u003cimg src=\"https://dev-to-uploads.s3.amazonaws.com/uploads/articles/7lp67jpzvabtf8opyzaf.png\" alt=\"Banner\" width=\"600\"\u003e\n\n\u003e For hosting guide See [HOSTING.md](HOSTING.md) and [CHANGES.md](CHANGES.md)\n\nThis service forwards domains using HTTP(s) redirects.\n\nExample scenarios:\n\n+ Forward non-www to www domains or vice versa\n+ Forward old domains to new domains\n\nWhy using this service?\n\n+ No coding required\n+ No hosting required\n+ No registration required\n+ Completely anonymous\n+ Completely free\n\nHow does it works?\n\n+ Point your domain to us using CNAME or A/AAAA records\n+ Tell us where to forward using TXT records\n+ We handle HTTPS certificates for you\n\n## Get Started\n\nTo forward from `www.old.com` to `old.com`, add these records to your DNS:\n\n```\nwww.old.com     IN    CNAME   r.forwarddomain.net\n_.www.old.com   IN    TXT     forward-domain=https://old.com/*\n```\n\nBecause CNAME can't be used in apex domains, you can use A/AAAA records.\u003cbr\u003e\nTo forward from `old.com` to `new.net`, add these records to your DNS:\n\n```\nold.com     IN    A       167.172.5.31\n_.old.com   IN    TXT     forward-domain=https://new.net/*\n```\n\nThe star `*` at the end tells us that the remaining URL path is also need to be forwarded to the destination URL.\n\n\u003e 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.\n\nYou can choose the type of redirection you want to use by declaring the `http-status` value:\n\n```\nwww.old.com     IN    CNAME   r.forwarddomain.net\n_.www.old.com   IN    TXT     http-status=302;forward-domain=https://old.com/*\n```\n\nThe HTTP codes available for use include:\n\n+ `301` Permanent redirection (default)\n+ `302` Temporary redirection (may keeping SEO from indexing new location)\n+ `307` Temporary redirection while keeping HTTP verb\n+ `308` Permanent redirection while keeping HTTP verb\n\n## FAQ\n\n### Is it really free?\n\nForwarding domains should be easy to setup.\u003cbr\u003e\nI use this myself for [domcloud.io](https://domcloud.io).\u003cbr\u003e\n\n### How can I check redirects will work?\n\nThis service uses Google's [Public DNS Resolver](https://dns.google).\u003cbr\u003e\nOnce first accessed, values will be cached for a day.\u003cbr\u003e\nFor right now there's no way to flush the cache sorry.\n\n### Why it loads slowly?\n\nIt only slow at first time because it has to sign HTTPS certificates.\n\n### How about IPv6?\n\nIPv6 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.\n\n### What records do we keep?\n\nWe 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.\n\n### How can I support this service?\n\nStar our repo and spread the word, please :)\n\nAdditionally, you can also help us [cover hosting costs](https://github.com/sponsors/willnode).\n\n## Credits\n\nThings in `package.json`. I also borrow code from [zbo14/certnode](https://github.com/zbo14/certnode).\n\n## Usual Disclaimer\n\n```\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\nAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\nLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\nOUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\nSOFTWARE.\n```\n","funding_links":["https://github.com/sponsors/willnode"],"categories":["JavaScript"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwillnode%2Fforward-domain","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fwillnode%2Fforward-domain","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwillnode%2Fforward-domain/lists"}