Misc improvements

This commit is contained in:
Alexandre Aubin 2020-04-26 00:52:12 +02:00 committed by GitHub
parent 0276cdafdb
commit c74796de23
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23

41
ipv6.md
View file

@ -1,4 +1,6 @@
# Guide to setup IPv6 on your server. # Setting up IPv6
IPv6 may work out of the box in many cases. But in some cases or some specific provider, you may need to tweak things manually to enable IPv6.
## With a VPS from OVH ## With a VPS from OVH
@ -6,6 +8,7 @@ OVH give one IPv4 address and one IPv6 address for VPS but by default, only IPv4
The OVH's documentation is here : https://docs.ovh.com/gb/en/vps/configuring-ipv6/ The OVH's documentation is here : https://docs.ovh.com/gb/en/vps/configuring-ipv6/
### Configure the DNS server ### Configure the DNS server
Here : https://yunohost.org/#/dns_subdomains Here : https://yunohost.org/#/dns_subdomains
### Configure the server ### Configure the server
@ -13,25 +16,31 @@ Here : https://yunohost.org/#/dns_subdomains
On the OVH panel, you will copy two element : On the OVH panel, you will copy two element :
- the IPv6 address - the IPv6 address
- the IPv6 gateway address - the IPv6 gateway address
And you need the prefix. On OVH's VPS SSD, prefix are /128 because you have only one IPv6 address. - the IPv6 prefix. On OVH's VPS SSD, prefixes are `/128` because you have only *one* IPv6 address.
On you're VPS create a backup of the file with : ''cp /etc/network/interfaces ~/interfaces'' in home directory. On your VPS, create a backup of the network configuration with : `cp /etc/network/interfaces ~/interfaces` in home directory.
Then, you can edit the configuration file (''/etc/network/interfaces) : Then, you can edit the configuration file (`/etc/network/interfaces`) with the following. It is assumed that :
iface <you're interface name, e.g 'eth0'> inet6 static <div class="alert alert-warning" markdown="1">
address <you're IPv6 address> In this example, it is assumed that your network interface is `eth0`. If it's different (check with `ip a`) you need to adapt the example below.
netmask <you're IPv6 prefix> </div>
post-up /sbin/ip -6 route add <the IPv6 gateway> dev <you're interface name, e.g 'eth0'>
post-up /sbin/ip -6 route add default via <the IPv6 gateway> dev <you're interface name, e.g 'eth0'>
pre-down /sbin/ip -6 route del default via <the IPv6 gateway> dev <you're interface name, e.g 'eth0'>
pre-down /sbin/ip -6 route del <the IPv6 gateway> dev <you're interface name, e.g 'eth0'>
Now, save the file and restart the network service with : ''service networking restart''. ```plaintext
iface eth0 inet6 static
address <your IPv6 address>
netmask <your IPv6 prefix>
post-up /sbin/ip -6 route add <the IPv6 gateway> dev eth0
post-up /sbin/ip -6 route add default via <the IPv6 gateway> dev eth0
pre-down /sbin/ip -6 route del default via <the IPv6 gateway> dev eth0
pre-down /sbin/ip -6 route del <the IPv6 gateway> dev eth0
```
Now, save the file and restart the network service with : `service networking restart`. (TODO : ideally we should find a way to validate the content of the configuration, otherwise it could fuck up the network stack and get disconnected from the VPS ?)
Check your configuration with these commands : Check your configuration with these commands :
- ''ip a'' to display address with interfaces - `ip a` to display network interfaces and addresses
- ''hostname -I'' to display address of the system - `hostname -I` to display the system IP addresses
- do a ping to a IPv6 serveur (for example you can use yunohost.org) - try to ping an IPv6 server (for example you can use `ping ip6.yunohost.org`)
- do a ping on your PC to your serveur - try to ping your server from your PC (assuming your PC has IPv6 enabled)
If it's ok, it's ok ! If it's ok, it's ok !