From 48a344c4f428246dfd28de925dade15173e2c881 Mon Sep 17 00:00:00 2001 From: William Harrison Date: Fri, 2 Dec 2022 08:24:06 +0800 Subject: [PATCH 1/6] Update README.md --- README.md | 52 ++++++++++++++++++++++++++-------------------------- 1 file changed, 26 insertions(+), 26 deletions(-) diff --git a/README.md b/README.md index ff315f6c..b5c00db5 100644 --- a/README.md +++ b/README.md @@ -1,13 +1,13 @@ [![Tests Status][badge-tests]][actions] [![Deploy Status][badge-deploy]][deploy] - +# Open Domains Free subdomains for personal sites, open-source projects, and more. Here is a list of supported domain names: -| Domain name | Features | -|:-------------------------------------:|:---------------------------------------------------------:| -| ⚡ [`*.localplayer.dev`](https://localplayer.dev/) | ![cf][badge-cf] ![dnssec][badge-dnssec] ![ssl][badge-ssl] | -| ⚡ [`*.is-not-a.dev`](https://is-not-a.dev/) | ![cf][badge-cf] ![dnssec][badge-dnssec] ![ssl][badge-ssl] | +| Domain | Features | +|-|-| +| [`*.localplayer.dev`](https://localplayer.dev) | ![cf][badge-cf] ![dnssec][badge-dnssec] ![ssl][badge-ssl] | +| [`*.is-not-a.dev`](https://is-not-a.dev) | ![cf][badge-cf] ![dnssec][badge-dnssec] ![ssl][badge-ssl] | > Wildcards (like `*.foo.is-not-a.dev`) are supported too, but the reason for their registration should be very clear and described in detail. @@ -56,28 +56,33 @@ First of all, I want to answer one important question - "Why are you giving out # How to get one? -1. Star and [fork](https://github.com/open-domains/Register/fork) this repository (follow [this guide](https://github.com/firstcontributions/first-contributions) if you don't know how to make a contributions) -2. Add a new file called `..json` in the `./domains` folder to register `` subdomain -3. Edit it (below is just an **example**, provide a **valid** JSON file with your needs, the format is very strict; format you can [check here](https://jsonlint.com/)): +1. Star and [fork](https://github.com/open-domains/register/fork) this repository (follow [this guide](https://github.com/firstcontributions/first-contributions) if you don't know how to make a contribution) +2. Add a new file called `example.domain.json` in the `/domains` folder to register `example` subdomain +3. Edit it (below is just an **example**, provide a **valid** JSON file with your needs, the format is very strict; format you can [check here](https://jsonlint.com)): ```json { "$schema": "../schemas/domain.schema.json", - "description": "", + + "description": "Project Description", + "domain": "is-not-a.dev", - "subdomain": "", + "subdomain": "example", + "owner": { - "repo": "", - "email": "" + "repo": "https://github.com/username/repo", + "email": "hello@example.com" }, + "record": { - "CNAME": "", - "TXT": ["list", "of", "required", "txt", "records"], - "A": ["list", "of", "IPv4", "addresses", "like", "a", "127.0.0.1"], - "AAAA": ["list", "of", "IPv6", "addresses", "like", "a", "::1"], - "NS": ["list", "of", "nameservers"] + "A": ["1.1.1.1", "1.0.0.1"], + "AAAA": ["::1", "::2"], + "CNAME": "example.com.", + "NS": ["ns1.example.com", "ns2.example.com"], + "TXT": ["example_verification=1234567890"] }, - "proxy": false // disable the CF proxy, proxying is always enabled by default + + "proxy": false } ``` @@ -85,20 +90,15 @@ First of all, I want to answer one important question - "Why are you giving out 5. After the pull request is merged, please allow up to 24 hours for the changes to propagate _(usually, it takes 5..15 minutes)_ 6. Enjoy your new domain! -> Domains, used for illegal purposes will be removed and permanently banned. Please, provide a clear description of your resource in the PR. +> Domains used for illegal purposes will be removed and permanently banned. Please, provide a clear description of your resource in the pull request. -## If you don't know... +### If you don't know... -- What is GitHub pages and how to set up a custom domain, read the [docs here](https://docs.github.com/en/pages/configuring-a-custom-domain-for-your-github-pages-site) +- What is GitHub Pages and how to set up a custom domain, read the [docs here](https://docs.github.com/en/pages/configuring-a-custom-domain-for-your-github-pages-site) - The difference between `A`, `CNAME`, and other record types, the article on Wikipedia [is here](https://en.wikipedia.org/wiki/List_of_DNS_record_types) -> 🔍 A few similar services can be [found here](https://free-for.dev/#/?id=domain). - [badge-tests]:https://img.shields.io/github/workflow/status/open-domains/Register/tests?label=tests&logo=github&style=for-the-badge [badge-deploy]:https://img.shields.io/github/workflow/status/open-domains/Register/deploy?label=deploy&logo=github&style=for-the-badge [actions]:https://github.com/open-domains/Register/actions [deploy]:https://github.com/open-domains/Register/actions/workflows/deploy.yml - -# This repo was forked from -https://github.com/tarampampam/free-domains From fccb8ded978ca06b1eb9191ac668f036e2559b61 Mon Sep 17 00:00:00 2001 From: William Harrison Date: Fri, 2 Dec 2022 08:58:22 +0800 Subject: [PATCH 2/6] Update README.md --- README.md | 38 +++++++++++++++++++------------------- 1 file changed, 19 insertions(+), 19 deletions(-) diff --git a/README.md b/README.md index b5c00db5..2d131365 100644 --- a/README.md +++ b/README.md @@ -21,25 +21,25 @@ First of all, I want to answer one important question - "Why are you giving out ## Domains settings -| Option | `*.localplayer.dev` | `*.is-not-a.dev` | -|:--------------------------------------------------------------------------:|:-------------------------:|:-------------------------:| -| [DNSSEC][dnssec] | ✅ | ✅ | -| Email | ❌ | ❌ | -| SSL/TLS * | [Full][ssl-full] | [Full][ssl-full] | -| Always Use HTTPS * | ✅ | ✅ | -| HTTP Strict Transport Security (HSTS) | ✅ | ✅ | -| Minimum TLS Version * | TLS 1.2 | TLS 1.2 | -| Opportunistic Encryption, TLS 1.3 * | ✅ | ✅ | -| WAF (Web Application Firewall) * | ✅ (Medium Security Level) | ✅ (Medium Security Level) | -| Browser Integrity Check * | ✅ | ✅ | -| [Caching Level][caching-levels], Browser Cache TTL * | Standard, 4 hours | Standard, 4 hours | -| [Crawler Hints][crawler-hints] * | ✅ | ✅ | -| [HTTP/2][http2], [HTTP/2 to Origin][http2-to-origin], HTTP/3 (with QUIC) * | ✅ | ✅ | -| [0-RTT Connection Resumption][0rtt] * | ✅ | ✅ | -| [gRPC][grpc], WebSockets * | ✅ | ✅ | -| [Pseudo IPv4][pseudo-ipv4] * | Add header | Add header | -| IP Geolocation (HTTP header `CF-IPCountry`) * | ✅ | ✅ | -| Maximum Upload Size * | 100 MB | 100 MB | +| Option | `*.is-not-a.dev` | `*.localplayer.dev` | +|-|-|-| +| [DNSSEC][dnssec]| ✅ | ✅ | +| Email | ❌ | ❌ | +| SSL/TLS * | [Full][ssl-full] | [Full][ssl-full] | +| Always Use HTTPS * | ✅ | ✅ | +| HTTP Strict Transport Security (HSTS) | ✅ | ✅ | +| Minimum TLS Version * | 1.2 | 1.2 | +| Opportunistic Encryption, TLS 1.3 * | ✅ | ✅ | +| WAF (Web Application Firewall) * | ✅ (Medium Security Level) | ✅ (Medium Security Level) | +| Browser Integrity Check * | ✅ | ✅ | +| [Caching Level][caching-levels], Browser Cache TTL * | Standard, 4 hours | Standard, 4 hours | +| [Crawler Hints][crawler-hints] * | ✅ | ✅ | +| [HTTP/2][http2], [HTTP/2 to Origin][http2-to-origin], HTTP/3 (with QUIC) * | ✅ | ✅ | +| [0-RTT Connection Resumption][0rtt] * | ✅ | ✅ | +| [gRPC][grpc], WebSockets * | ✅ | ✅ | +| [Pseudo IPv4][pseudo-ipv4] * | Add header | Add header | +| IP Geolocation (HTTP header `CF-IPCountry`) * | ✅ | ✅ | +| Maximum Upload Size * | 100 MB | 100 MB | > `*` Available only when proxying (`"proxy": true`) is enabled From 75eb63bdc0a4495e55047d9cadf22d7def3f73af Mon Sep 17 00:00:00 2001 From: William Harrison Date: Fri, 2 Dec 2022 09:47:53 +0800 Subject: [PATCH 3/6] Update README.md --- README.md | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/README.md b/README.md index 2d131365..bb3029df 100644 --- a/README.md +++ b/README.md @@ -6,8 +6,8 @@ Free subdomains for personal sites, open-source projects, and more. Here is a li | Domain | Features | |-|-| -| [`*.localplayer.dev`](https://localplayer.dev) | ![cf][badge-cf] ![dnssec][badge-dnssec] ![ssl][badge-ssl] | -| [`*.is-not-a.dev`](https://is-not-a.dev) | ![cf][badge-cf] ![dnssec][badge-dnssec] ![ssl][badge-ssl] | +| [`localplayer.dev`](https://localplayer.dev) | ![cf][badge-cf] ![dnssec][badge-dnssec] ![ssl][badge-ssl] | +| [`is-not-a.dev`](https://is-not-a.dev) | ![cf][badge-cf] ![dnssec][badge-dnssec] ![ssl][badge-ssl] | > Wildcards (like `*.foo.is-not-a.dev`) are supported too, but the reason for their registration should be very clear and described in detail. @@ -15,13 +15,13 @@ Free subdomains for personal sites, open-source projects, and more. Here is a li [badge-dnssec]:https://shields.io/badge/%20-DNSSEC-blue?logo=moleculer&logoColor=white&style=plastic?cacheSeconds=3600 [badge-ssl]:https://shields.io/badge/SSL-Required-blue?style=plastic?cacheSeconds=3600 -## Why? +### Why? First of all, I want to answer one important question - "Why are you giving out domains for free?". Because sometimes I need domains for my pet projects, and instead of buying new domains every time, I decided to buy one for everyone, and use subdomains. And why not share them with the community? -## Domains settings +## Domain Settings -| Option | `*.is-not-a.dev` | `*.localplayer.dev` | +| Option | `is-not-a.dev` | `localplayer.dev` | |-|-|-| | [DNSSEC][dnssec]| ✅ | ✅ | | Email | ❌ | ❌ | @@ -54,9 +54,9 @@ First of all, I want to answer one important question - "Why are you giving out [grpc]:https://support.cloudflare.com/hc/en-us/articles/360050483011 [pseudo-ipv4]:https://support.cloudflare.com/hc/en-us/articles/229666767 -# How to get one? +## Register a Domain -1. Star and [fork](https://github.com/open-domains/register/fork) this repository (follow [this guide](https://github.com/firstcontributions/first-contributions) if you don't know how to make a contribution) +1. **Star and [Fork](https://github.com/open-domains/register/fork)** this repository (follow [this guide](https://github.com/firstcontributions/first-contributions) if you don't know how to make a contribution) 2. Add a new file called `example.domain.json` in the `/domains` folder to register `example` subdomain 3. Edit it (below is just an **example**, provide a **valid** JSON file with your needs, the format is very strict; format you can [check here](https://jsonlint.com)): From 850b0047386a1bba54c46f8b9619c18dc34a752c Mon Sep 17 00:00:00 2001 From: William Harrison Date: Fri, 2 Dec 2022 09:54:52 +0800 Subject: [PATCH 4/6] Update README.md --- README.md | 23 +++++++++-------------- 1 file changed, 9 insertions(+), 14 deletions(-) diff --git a/README.md b/README.md index bb3029df..ec1b01d3 100644 --- a/README.md +++ b/README.md @@ -1,13 +1,11 @@ -[![Tests Status][badge-tests]][actions] -[![Deploy Status][badge-deploy]][deploy] - # Open Domains + Free subdomains for personal sites, open-source projects, and more. Here is a list of supported domain names: | Domain | Features | |-|-| -| [`localplayer.dev`](https://localplayer.dev) | ![cf][badge-cf] ![dnssec][badge-dnssec] ![ssl][badge-ssl] | | [`is-not-a.dev`](https://is-not-a.dev) | ![cf][badge-cf] ![dnssec][badge-dnssec] ![ssl][badge-ssl] | +| [`localplayer.dev`](https://localplayer.dev) | ![cf][badge-cf] ![dnssec][badge-dnssec] ![ssl][badge-ssl] | > Wildcards (like `*.foo.is-not-a.dev`) are supported too, but the reason for their registration should be very clear and described in detail. @@ -15,13 +13,9 @@ Free subdomains for personal sites, open-source projects, and more. Here is a li [badge-dnssec]:https://shields.io/badge/%20-DNSSEC-blue?logo=moleculer&logoColor=white&style=plastic?cacheSeconds=3600 [badge-ssl]:https://shields.io/badge/SSL-Required-blue?style=plastic?cacheSeconds=3600 -### Why? - -First of all, I want to answer one important question - "Why are you giving out domains for free?". Because sometimes I need domains for my pet projects, and instead of buying new domains every time, I decided to buy one for everyone, and use subdomains. And why not share them with the community? - ## Domain Settings -| Option | `is-not-a.dev` | `localplayer.dev` | +| Setting | `is-not-a.dev` | `localplayer.dev` | |-|-|-| | [DNSSEC][dnssec]| ✅ | ✅ | | Email | ❌ | ❌ | @@ -30,7 +24,7 @@ First of all, I want to answer one important question - "Why are you giving out | HTTP Strict Transport Security (HSTS) | ✅ | ✅ | | Minimum TLS Version * | 1.2 | 1.2 | | Opportunistic Encryption, TLS 1.3 * | ✅ | ✅ | -| WAF (Web Application Firewall) * | ✅ (Medium Security Level) | ✅ (Medium Security Level) | +| WAF (Web Application Firewall) * | ✅ Medium Security Level | ✅ Medium Security Level | | Browser Integrity Check * | ✅ | ✅ | | [Caching Level][caching-levels], Browser Cache TTL * | Standard, 4 hours | Standard, 4 hours | | [Crawler Hints][crawler-hints] * | ✅ | ✅ | @@ -90,15 +84,16 @@ First of all, I want to answer one important question - "Why are you giving out 5. After the pull request is merged, please allow up to 24 hours for the changes to propagate _(usually, it takes 5..15 minutes)_ 6. Enjoy your new domain! -> Domains used for illegal purposes will be removed and permanently banned. Please, provide a clear description of your resource in the pull request. +*Domains used for illegal purposes will be removed and permanently banned. Please, provide a clear description of your resource in the pull request.* + +### Why? + +First of all, I want to answer one important question - "Why are you giving out domains for free?". Because sometimes I need domains for my pet projects, and instead of buying new domains every time, I decided to buy one for everyone, and use subdomains. And why not share them with the community? ### If you don't know... - What is GitHub Pages and how to set up a custom domain, read the [docs here](https://docs.github.com/en/pages/configuring-a-custom-domain-for-your-github-pages-site) - The difference between `A`, `CNAME`, and other record types, the article on Wikipedia [is here](https://en.wikipedia.org/wiki/List_of_DNS_record_types) -[badge-tests]:https://img.shields.io/github/workflow/status/open-domains/Register/tests?label=tests&logo=github&style=for-the-badge -[badge-deploy]:https://img.shields.io/github/workflow/status/open-domains/Register/deploy?label=deploy&logo=github&style=for-the-badge - [actions]:https://github.com/open-domains/Register/actions [deploy]:https://github.com/open-domains/Register/actions/workflows/deploy.yml From 4408a385e62778357a0c21e6d96bc331a6eab90d Mon Sep 17 00:00:00 2001 From: William Harrison Date: Fri, 2 Dec 2022 10:04:56 +0800 Subject: [PATCH 5/6] Update README.md --- README.md | 30 +++++++++++++++--------------- 1 file changed, 15 insertions(+), 15 deletions(-) diff --git a/README.md b/README.md index ec1b01d3..5ae4de19 100644 --- a/README.md +++ b/README.md @@ -4,8 +4,8 @@ Free subdomains for personal sites, open-source projects, and more. Here is a li | Domain | Features | |-|-| -| [`is-not-a.dev`](https://is-not-a.dev) | ![cf][badge-cf] ![dnssec][badge-dnssec] ![ssl][badge-ssl] | -| [`localplayer.dev`](https://localplayer.dev) | ![cf][badge-cf] ![dnssec][badge-dnssec] ![ssl][badge-ssl] | +| [`is-not-a.dev`](https://is-not-a.dev) | ![cf][badge-cf] ![dnssec][badge-dnssec] | +| [`localplayer.dev`](https://localplayer.dev) | ![cf][badge-cf] ![dnssec][badge-dnssec] | > Wildcards (like `*.foo.is-not-a.dev`) are supported too, but the reason for their registration should be very clear and described in detail. @@ -19,23 +19,23 @@ Free subdomains for personal sites, open-source projects, and more. Here is a li |-|-|-| | [DNSSEC][dnssec]| ✅ | ✅ | | Email | ❌ | ❌ | -| SSL/TLS * | [Full][ssl-full] | [Full][ssl-full] | -| Always Use HTTPS * | ✅ | ✅ | +| SSL/TLS* | [Full][ssl-full] | [Full][ssl-full] | +| Always Use HTTPS* | ✅ | ✅ | | HTTP Strict Transport Security (HSTS) | ✅ | ✅ | -| Minimum TLS Version * | 1.2 | 1.2 | -| Opportunistic Encryption, TLS 1.3 * | ✅ | ✅ | -| WAF (Web Application Firewall) * | ✅ Medium Security Level | ✅ Medium Security Level | -| Browser Integrity Check * | ✅ | ✅ | +| Minimum TLS Version* | 1.2 | 1.2 | +| Opportunistic Encryption, TLS 1.3* | ✅ | ✅ | +| WAF (Web Application Firewall)* | ✅ Medium Security Level | ✅ Medium Security Level | +| Browser Integrity Check* | ✅ | ✅ | | [Caching Level][caching-levels], Browser Cache TTL * | Standard, 4 hours | Standard, 4 hours | -| [Crawler Hints][crawler-hints] * | ✅ | ✅ | +| [Crawler Hints][crawler-hints]* | ✅ | ✅ | | [HTTP/2][http2], [HTTP/2 to Origin][http2-to-origin], HTTP/3 (with QUIC) * | ✅ | ✅ | -| [0-RTT Connection Resumption][0rtt] * | ✅ | ✅ | -| [gRPC][grpc], WebSockets * | ✅ | ✅ | -| [Pseudo IPv4][pseudo-ipv4] * | Add header | Add header | -| IP Geolocation (HTTP header `CF-IPCountry`) * | ✅ | ✅ | -| Maximum Upload Size * | 100 MB | 100 MB | +| [0-RTT Connection Resumption][0rtt]* | ✅ | ✅ | +| [gRPC][grpc], WebSockets* | ✅ | ✅ | +| [Pseudo IPv4][pseudo-ipv4]* | Add header | Add header | +| IP Geolocation (HTTP header `CF-IPCountry`)* | ✅ | ✅ | +| Maximum Upload Size* | 100 MB | 100 MB | -> `*` Available only when proxying (`"proxy": true`) is enabled +###### * Only available when your domain has Cloudflare's proxy (`"proxy": true`) enabled* [dnssec]:https://developers.cloudflare.com/dns/additional-options/dnssec [ssl-full]:https://developers.cloudflare.com/ssl/origin-configuration/ssl-modes/full/ From 6f6f22b464ec51449e0e94f8bc7fa03ef0c074ea Mon Sep 17 00:00:00 2001 From: William Harrison Date: Fri, 2 Dec 2022 13:01:05 +0800 Subject: [PATCH 6/6] Update README.md --- README.md | 17 +++++++---------- 1 file changed, 7 insertions(+), 10 deletions(-) diff --git a/README.md b/README.md index 5ae4de19..9fce4d7d 100644 --- a/README.md +++ b/README.md @@ -1,19 +1,21 @@ -# Open Domains +

Open Domains

-Free subdomains for personal sites, open-source projects, and more. Here is a list of supported domain names: +

Free subdomains for personal sites, open-source projects, and more. Here is a list of supported domain names:

+ +## Domains | Domain | Features | |-|-| | [`is-not-a.dev`](https://is-not-a.dev) | ![cf][badge-cf] ![dnssec][badge-dnssec] | | [`localplayer.dev`](https://localplayer.dev) | ![cf][badge-cf] ![dnssec][badge-dnssec] | -> Wildcards (like `*.foo.is-not-a.dev`) are supported too, but the reason for their registration should be very clear and described in detail. +Wildcard domains (like `*.example.is-not-a.dev`) are supported too, but the reason for their registration should be very clear and described in detail. [badge-cf]:https://shields.io/badge/%20-cloudflare-blue?logo=cloudflare&style=plastic?cacheSeconds=3600 [badge-dnssec]:https://shields.io/badge/%20-DNSSEC-blue?logo=moleculer&logoColor=white&style=plastic?cacheSeconds=3600 [badge-ssl]:https://shields.io/badge/SSL-Required-blue?style=plastic?cacheSeconds=3600 -## Domain Settings +### Settings | Setting | `is-not-a.dev` | `localplayer.dev` | |-|-|-| @@ -35,7 +37,7 @@ Free subdomains for personal sites, open-source projects, and more. Here is a li | IP Geolocation (HTTP header `CF-IPCountry`)* | ✅ | ✅ | | Maximum Upload Size* | 100 MB | 100 MB | -###### * Only available when your domain has Cloudflare's proxy (`"proxy": true`) enabled* +\*Only available when your domain has Cloudflare's proxy (`"proxy": true`) enabled [dnssec]:https://developers.cloudflare.com/dns/additional-options/dnssec [ssl-full]:https://developers.cloudflare.com/ssl/origin-configuration/ssl-modes/full/ @@ -90,10 +92,5 @@ Free subdomains for personal sites, open-source projects, and more. Here is a li First of all, I want to answer one important question - "Why are you giving out domains for free?". Because sometimes I need domains for my pet projects, and instead of buying new domains every time, I decided to buy one for everyone, and use subdomains. And why not share them with the community? -### If you don't know... - -- What is GitHub Pages and how to set up a custom domain, read the [docs here](https://docs.github.com/en/pages/configuring-a-custom-domain-for-your-github-pages-site) -- The difference between `A`, `CNAME`, and other record types, the article on Wikipedia [is here](https://en.wikipedia.org/wiki/List_of_DNS_record_types) - [actions]:https://github.com/open-domains/Register/actions [deploy]:https://github.com/open-domains/Register/actions/workflows/deploy.yml