瀏覽代碼

Starting on mesh documentation

Bob Mottram 9 年之前
父節點
當前提交
ed52903b5d
共有 3 個文件被更改,包括 43 次插入4 次删除
  1. 1
    2
      README.md
  2. 41
    0
      doc/EN/mesh.org
  3. 1
    2
      doc/EN/variants.org

+ 1
- 2
README.md 查看文件

@@ -10,8 +10,7 @@ The Freedombone system can be installed onto a Beaglebone Black, or any system c
10 10
  - **Writer**: Host your blog and wiki
11 11
  - **Chat**: Encrypted IRC, XMPP, Tox and VoIP services for one-to-one and many-to-many chat
12 12
  - **Developer**: Host your own git projects with a Github-like user interface
13
- - **Mesh**: mesh network bridge to the internet
14
- - **Nonmailbox**: Installs eveything except for the email server
13
+ - **Mesh**: A wireless mesh network which is like the internet, but not the internet
15 14
 
16 15
 Freedombone has an emphasis on security and privacy, and when installed on a Beaglebone Black it uses the built-in hardware random number generator as an entropy source.  All communications with the box are encrypted by default using the recommendations from https://bettercrypto.org. The firewall is configured to only allow communications on the necessary ports and to drop all other packets, icmp is disabled by default, emails are stored in encrypted form using your public key and time synchronisation occurs via TLS only.  Backups are also encrypted and can be local or remote.
17 16
 

+ 41
- 0
doc/EN/mesh.org 查看文件

@@ -0,0 +1,41 @@
1
+#+TITLE:
2
+#+AUTHOR: Bob Mottram
3
+#+EMAIL: bob@robotics.uk.to
4
+#+KEYWORDS: freedombox, debian, beaglebone, red matrix, email, web server, home server, internet, censorship, surveillance, social network, irc, jabber
5
+#+DESCRIPTION: Turn the Beaglebone Black into a personal communications server
6
+#+OPTIONS: ^:nil toc:nil
7
+#+BEGIN_CENTER
8
+[[./images/logo.png]]
9
+#+END_CENTER
10
+
11
+| [[What is a mesh network?]] | [[The Freedombone Mesh]] | [[Installation]] |
12
+
13
+* What is a mesh network?
14
+The internet as it currently exists is mostly organised according to a client/server model. Servers run the web services and store the data and clients are the laptops, desktops and other devices accessing the servers. In a mesh network there isn't any clear division between clients and servers. The computers on a mesh network are known as "peers" and they can perform the functions of both clients and servers. Commonly this is also known as a "peer to peer" network.
15
+
16
+The client/server and mesh network models have advantages and disadvantages. If the server in a client/server system fails then you can have catastrophic service outages which affect many users. If a peer in a mesh network fails then the other peers may be mostly unaffected and communications can continue. The disadvantage of mesh networks is that each peer relays data for other peers and so the bandwidth usage by each peer may be higher than for a client in a client/server system. However, with modern hardware that's not much of an issue.
17
+
18
+Mesh networks are useful for building local and highly resillient communications infrastructure which can be put together rapidly, in situations where the ordinary internet is either unavailable or untrustworthy.
19
+
20
+Example use cases would be:
21
+
22
+ * Conferences / Exhibitions
23
+ * Local community networks, not run by telcos or ISPs
24
+ * Emergency services / Disaster relief
25
+ * Camp sites
26
+ * War zones
27
+ * Scientific expeditions to remote areas
28
+ * Onboard ships
29
+ * Underground (mines/caves)
30
+ * Protests
31
+
32
+* The Freedombone Mesh
33
+The Freedombone mesh is offline - in the sense of not being part of the larger internet - and consists of a set of computers with the system installed communicating wirelessly using ordinary wifi. Peers can enter or leave the network and it will adjust automatically. All communications between peers is end-to-end encrypted, so although it's easy to join the network it's not easy to passively evesdrop.
34
+* Installation
35
+** Two types of system
36
+Installation is split into two categories, /routers/ and /user devices/.
37
+
38
+A router is a computer which is dedicated to moving network traffic and building out the mesh infrastructure. It's not primarily intended to have a user interface. Hardware such as the Beaglebone Black is ideal for this, because it's small, inexpensive and doesn't consume much electrical power and so can be fitted in any location where an electricity supply is available. Small computers can also be battery operated or solar powered so that the mesh need not be statically sited. They could be included in a backpack for camping, fitted within moving vehicles, or on protest placards to help provide a local and transient communications system.
39
+
40
+User devices are the computers with which you would typically access the internet - laptops, desktop machines, netbooks or any other device which can run a Debian-based distro with a working wifi connection.
41
+** Installing on routers

+ 1
- 2
doc/EN/variants.org 查看文件

@@ -19,5 +19,4 @@ Freedombone may be installed either in its entirety or as different variants wit
19 19
 | *Writer*     | Host your blog and wiki                                                  |
20 20
 | *Chat*       | Encrypted IRC and XMPP services for one-to-one and many-to-many chat     |
21 21
 | *Developer*  | Github-like system to host your software projects                        |
22
-| *Mesh*       | Mesh network bridge to the internet                                      |
23
-| *Nonmailbox* | Installs eveything except for the email server                           |
22
+| *Mesh*       | A wireless mesh network which is like the internet, but not the internet |