From 6689fb6bb6dbfd72303778bf84dec3f9aecaf4a5 Mon Sep 17 00:00:00 2001 From: "Tristan B. Kildaire" Date: Thu, 20 May 2021 13:03:30 +0200 Subject: [PATCH] WIP: New site --- docs/getting-started.md | 52 ++++++++++++++++++++++ docs/index.md | 95 +++++++++++++++++++++++++++++++++-------- docs/peopel.md | 6 +++ docs/people.md | 6 +++ docs/rules.md | 34 +++++++++++++++ mkdocs.yml | 4 ++ 6 files changed, 180 insertions(+), 17 deletions(-) create mode 100644 docs/getting-started.md create mode 100644 docs/peopel.md create mode 100644 docs/people.md create mode 100644 docs/rules.md diff --git a/docs/getting-started.md b/docs/getting-started.md new file mode 100644 index 0000000..c589845 --- /dev/null +++ b/docs/getting-started.md @@ -0,0 +1,52 @@ +Getting started +=============== + +Firstly we'd like to say that we're glad you'd like to join our network and +greater community! This document will provide you with the directions you +will need to follow in order to get connected. + +## Steps to follow + +Below you can follow the steps one-by-one to get yourself familiar with our +practices and inner-workings and by the end you should have all the information +and configuration details needed to get connected! + +1. [Rules](rules.md) + * TODO: Check again and finalise + * We have **few** but **strict** rules nonetheless + * Zero-tolerance for breaking them +2. Requirements + * TODO: Hardware, software, network connections +3. Assigning subnet + * TODO: IPs etc + * TODO: RPKI? +4. Setting up routing + 1. Setting up Bird + * TODO: Filtering etc + * TODO: Config + * TODO: Scripting + 1. Setting up lg_proxy + * TODO: Setting up lg_proxy + 2. Setting up Mikrotik + * TODO: Enabling graphs +5. General moniroting + * TOD: Like making your node have yggdrasil just for the sake of it? +6. Tunneling + * TODO: Setup tunnel(s) + * TODO: Fastd config +7. Getting peers + * TODO: Finding someone to tunnel to +8. Setting up your home nwtwork + * TODO: radv etc. + * TODO: COnfiguring hosts + * TODO: Dns + +## What's next? + +Once you're connected, what's there todo? + +1. Viewing the bird monitor + * TODO: Add +2. Services + * TODO: Gaming, IRC etc. + * TODO: Using netbox to add your own and find more \ No newline at end of file diff --git a/docs/index.md b/docs/index.md index 7d4e939..769ffb6 100644 --- a/docs/index.md +++ b/docs/index.md @@ -2,13 +2,59 @@
-CRXN stands for **C**ommunity **R**un e**X**pansive **N**etwork. It's a computer network run by the _community for the community_. -We are a dual-stack IP-based network supporting both IPv4 and IPv6. We are focused on having a network that is accessible to all, -reliable in terms of having redundant links and diverse. The first part means that we are welcome to anyone who wants to join, the -second part means that we focus on having a lot of links between adjacent routers such that if one is to fail there exists a fallback -(in the case where the route is only available through said router - if there are more routers then this is mitigated). We also strive -to have diverse links - this means linking over the Internet whether it be clearnet or via an overlay network such as Yggdrasil or CJDNS -or in the best case creating physical links. + CRXN +====== + +CRXN stands for **C**ommunity **R**un e**X**pansive **N**etwork. It's a computer network _run by the community for the community_. +We provide an IPv6 (that's the freshest Internet Protocol out there to date) and on CRXN anything that can speak IPv6 +will be able to function correctly - a network without borders! We are focused with having a network that really focuses +on the "end-to-end" principal of IP - that is to say that if you want to run something and make it available to other then +you won't have to worry about NAT-traversal, port fowarding, lack of raw IP support and all the other non-sense that IPv4 +created (due to lack of addresses). Compared to the clearnet (normal Internet) there isn't much fuss involved around getting +a network ID assigned to you and so forth, we truly are for the community and all our members take some of their own time +to work on their network and the greater CRXN inter-network as a whole. + +It's a great place to test out new protocols, networking projects, play games, exchange ideas and learn about networking, +routing and network sub-systems themselves. You also get to learn how CRXN is put toghether which is a great way to learn +networking with those that run networks already themselves. + +The network has a few goals that we always want to maintain as to not lose our allure: + +1. Be a network for learning + * We don't want to shun people away from using some new + routing protocol as it might be cool and interesting to + learn +2. Be reliable + * Of course when learning people should also make sure + their routers don't just accept any route without making + sure its valid - hence network operators should make sure + their networks operate even when some are causing mayhem + (malicious or learning by trial and error) + * Also shouldn't be painfully slow +3. Diverse routing + * We want to try out protocols like **ospf**, **babel**, **bgp** + and so on and so forth + * We want to build a network out of a mix and match of these all + working in harmony toghether + * Monocultures suck! +4. Usable + * We have DNS, we have voice chat servers and we have IRC (we + even have gaming!) but we can always do with much **much more**! + * We want the users, _you_, to make the network usable for your + needs - who knows it might provide a service that helps out + someone else +5. Peering + * We want people to setup redundant links using whatever protocols + they want, be it **wireguard**, **GRE**, **fastd** etc. + * We want there to be interesting links and diversity +6. _Chaos and Order_ + * The network should never stop experimenting + * But it should have 99% uptime and safety fallbacks + * If you want to experiment - then go ahead and try cuase + as little disruption as possible + * If you run a node - make it secure - sign routes etc. + to prevent others from experimenting from messing your + network up We aim to create a more open Internet available to everyone and a place to learn about IP routing and networking in general. @@ -19,28 +65,43 @@ mediums or routing daemon you choose to use is up to you - this falls in line wi ## About the network -### Ranges +### IPv6 Ranges -The subnets that we use so far are the below private ranges. +Aggregate prefixes are organized as /48 IPv6 ULAs by region: -* For **IPv4** we are running on the `10.0.0.0/8` range. -* For **IPv6** we are running on the `fd8a:6111:3b1a::/48` range. +1. European CRXN + * Space: `fd8a:6111:3b1a::/48` +2. Southern African CRXN + * Space: `fded:4178:23fe::/48` +3. Indian CRXN + * Space: `fdfa:1685:3d1::/48` +4. Russian CRXN + * Space: `fda1:8885:300d::/48` +5. American CRXN + * Space: `fd68:b488:442c::/48` -IPv4 note: If we run out we will simply use more private ranges but we will keep out the `192.168.0.0/16` range such that home networks (sane ones) will not have any clashes. +The regional range sare not fixed in the sense that, for example, you could +register a range in the Southern African range whilst your network is actaully +physically located in Europe. We only do this to organize the network more +easily. ### The state of the network ![CRXN babelweb map](map.png) -The network is currently at a mere ~10 nodes with a few services being run over the network such as Mumble and NFS. The only routing -daemon being used at this moment is babel and for tunnelling we are using fastd to establish VPN connections at an L2 layer between sites. +The network is currently made up of around ~10 nodes so far with a few services running on +the network, such as Mumble, [BonoboNET](/projects/bonobonet) (IRC), gaming (Xonotic, Minetest) +and a few websites. We even have DNS which can resolve `.crxn` domains (find out more about that here (TODO).) -In terms of transit we run fastd over clearnet, Yggdrasil and CJDNS. +You can see the looking glass here (TODO). -You can view the babel part of the network on the [live router map](http://deavmi.assigned.network:4444). +You can also see a live map of the subset of users who are only running +the original babel routing software, _babeld_, here, on the [live router map](http://deavmi.assigned.network:4444). ## Getting started ### Joining the network -There is a tutorial (which is done for the most part) [here](peering.md) which will help you get connected onto the inter-network. +Does it sound interesting enough for you already? Want to get connected? Then head on over +to our [Getting started] section where you can find all the guides you need in order to get connected, +follow the rules and have fun! diff --git a/docs/peopel.md b/docs/peopel.md new file mode 100644 index 0000000..f7495a0 --- /dev/null +++ b/docs/peopel.md @@ -0,0 +1,6 @@ +People +====== + +Get to know some familiar faces! + +## Tristan B. Kildaire `~deavmi` \ No newline at end of file diff --git a/docs/people.md b/docs/people.md new file mode 100644 index 0000000..f7495a0 --- /dev/null +++ b/docs/people.md @@ -0,0 +1,6 @@ +People +====== + +Get to know some familiar faces! + +## Tristan B. Kildaire `~deavmi` \ No newline at end of file diff --git a/docs/rules.md b/docs/rules.md new file mode 100644 index 0000000..9016fc6 --- /dev/null +++ b/docs/rules.md @@ -0,0 +1,34 @@ +Rules +===== + +## The no's + +* Nothing illegal in any of the countries our servers reside in + * No child pornography (you fucking degenerate) + * No conducting of illegal activities + * If you don't get the point, don't do illegal stuff + +* No pornography + +* Don't maliciously attack someone's infra + +* No piracy + +## The yes's + +* Free speech + * We all get offended from time to time but it's not worth stopping bad opinions + * It's also, on the other hand, nice to not a be a dick though (social consequences are there still) + +* If you see someone break the rules and have proof **speak up!** and notify us + +## Lastly... + +We really don't want the scum of internet degeneracy on here (see first subpoint of first point in "The no's" section). + + +--- + +You break the rules, you're going to get removed. We don't take shit here. + +**You will be reported to the authorities** \ No newline at end of file diff --git a/mkdocs.yml b/mkdocs.yml index bd8ad89..9ca08f2 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -3,6 +3,9 @@ theme: yeti nav: - Home: index.md + - Getting started: + - Guide: getting-started.md + - Rules: rules.md - Tutorial: - Peering: peering.md - CRXNv6: crxnv6.md @@ -12,3 +15,4 @@ nav: - Peers: peers.md - Services: services.md - Registrar: ipam.md + - People: peopel.md