CRXN
/
docs
mirror of http://deavmi.assigned.network/git/CRXN/docs
1
0
Fork 0
Code Releases Activity

Merge pull request 'add explantion for method and add fallback ciphers' (#21) from mark22k/docs:fastd_enc into master 

Reviewed-on: https://codeberg.org/CRXN/docs/pulls/21
This commit is contained in:
Marek Küthe 2023-01-08 12:45:43 +00:00
parent 245ab23cac e1e738e8cb
commit 280bb875ac
1 changed files with 15 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

15
docs/tunneling/fastd.md
View File

@ -31,6 +31,9 @@ mode multitap;
# The encryption method (don't change this unless you need to) # The encryption method (don't change this unless you need to)
method "salsa2012+umac"; method "salsa2012+umac";
method "salsa2012+poly1305";
method "salsa20+umac";
method "salsa20+poly1305";
# Bind to and listen for incoming connections on this address and port # Bind to and listen for incoming connections on this address and port
bind [::]:<port>; bind [::]:<port>;
@ -103,6 +106,17 @@ Now we need to fill in the peer details of the node you are connecting to:
Fastd can provide a tunnel with `multitap` mode on layer 2 or a tunnel with `tun` mode on layer 3. Note that the fatsd has 20 bytes less overhead when using tun. Fastd can provide a tunnel with `multitap` mode on layer 2 or a tunnel with `tun` mode on layer 3. Note that the fatsd has 20 bytes less overhead when using tun.
### Methods
fastd supports various transmission encryptions. The encryption and authentication recommended by fastd is `salsa2012+umac`. If you specify multiple encryption methods, the first one specified is preferred. The others are used as fallbacks if the peer does not support the preferred one.
fastd has three groups of transmission ciphers:
- Encrypt and Authenticate
- Authenticate Only
- Transfer Only without Authentication
It should be noted that poly1305 is very slow on embedded systems and AES is very slow without OpenSSL.
When fastd is used without encryption or authentication, the data is authenticated only by the sender IP address. This authentication can be disabled with `float yes;`.
### MTU ### MTU
The default MTU of a fastd tunnel is 1500 bytes. However, this can be problematic if the Internet uplink also has an MTU of 1500 or less. In this case IP fragmentation can occur. This is usually something you want to avoid. The default MTU of a fastd tunnel is 1500 bytes. However, this can be problematic if the Internet uplink also has an MTU of 1500 or less. In this case IP fragmentation can occur. This is usually something you want to avoid.
@ -139,3 +153,4 @@ To enable the systemd unit on startup run `systemctl enable fastd@crxn`
- [fastd documentation](https://fastd.readthedocs.io/en/stable/) - [fastd documentation](https://fastd.readthedocs.io/en/stable/)
- [fastd mtu documentation](https://fastd.readthedocs.io/en/stable/manual/mtu.html) - [fastd mtu documentation](https://fastd.readthedocs.io/en/stable/manual/mtu.html)
- [Encryption & authentication methods in fastd](https://fastd.readthedocs.io/en/stable/manual/methods.html)