diff --git a/content/en/1.about/1.welcome.md b/content/en/1.about/1.welcome.md index dfea7af..e307292 100644 --- a/content/en/1.about/1.welcome.md +++ b/content/en/1.about/1.welcome.md @@ -18,7 +18,7 @@ Special thanks to __Nipah__, __Xenio__, __KevOut__ and others for their patience ## About the documentation -The documentation provided here is experimental and shared in a spirit of open knowledge and experience. It is not intended to build production-grade or industrialized infrastructure. It may contain mistakes and/or approximations. +The documentation provided here is experimental and shared in a spirit of open knowledge and experience. It is not intended to build production-grade or industrialized infrastructure. It may contain mistakes and/or approximations. Naturally, this documentation should only be used within a strictly legal framework. diff --git a/content/en/2.general/2.networking/1.nat.md b/content/en/2.general/2.networking/1.nat.md index 4c50571..debe593 100644 --- a/content/en/2.general/2.networking/1.nat.md +++ b/content/en/2.general/2.networking/1.nat.md @@ -7,7 +7,7 @@ description: Learn how NAT, port forwarding, and DHCP work on a home router. Con :ellipsis{left=0px width=40rem top=10rem blur=140px zIndex=60} -![picture](/img/global/nat.svg) +![Diagram of NAT translating a private LAN address to a public IP address](/img/global/nat.svg) ## What is a "port"? diff --git a/content/en/2.general/2.networking/2.dns.md b/content/en/2.general/2.networking/2.dns.md index 585d573..871ed02 100644 --- a/content/en/2.general/2.networking/2.dns.md +++ b/content/en/2.general/2.networking/2.dns.md @@ -12,7 +12,7 @@ When you browse a website or use an app, requests are made to one or more domain The DNS zone is like a registry with signposts that direct your requests to the correct destination. -![Picture](/img/global/dns.svg) +![Diagram of a DNS zone directing requests to the right server](/img/global/dns.svg) ## The DNS Zone @@ -23,12 +23,13 @@ You can enter _records_ into this DNS zone to direct requests properly. You can Example of a DNS zone for the domain `mydomain.com`: ``` +$TTL 3600 @ IN SOA ns1.dns.me. dns.net. (2024051800 86400 3600 3600000 60) IN NS ns1.dns.me. IN NS ns2.dns.me. - IN A 203.0.113.0 -www IN CNAME mydomain.com -sousdomaine IN CNAME mydomain.com + IN A 203.0.113.10 +www IN CNAME mydomain.com. +subdomain IN CNAME mydomain.com. ``` In this example: @@ -36,8 +37,8 @@ In this example: - `$TTL 3600` tells global name servers that the records are valid for 1 hour (after which they need to re-check). - `IN SOA ns1.dns.me. dns.net. (...)` indicates `ns1.dns.me` as the primary DNS server, with refresh intervals. - `IN NS` records define the authoritative name servers for the domain. -- `IN A 203.0.113.0` means `mydomain.com` points to IP `203.0.113.0`. -- `subdomain IN CNAME mydomain.com` means `subdomain.mydomain.com` points to the same destination as `mydomain.com`. +- `IN A 203.0.113.10` means `mydomain.com` points to IP `203.0.113.10`. +- `subdomain IN CNAME mydomain.com.` means `subdomain.mydomain.com` points to the same destination as `mydomain.com`. So, if you want to point `mydomain.com` to your server, you can do it by adding an `A` record pointing to your server's public IP address. diff --git a/content/en/2.general/2.networking/3.samba.md b/content/en/2.general/2.networking/3.samba.md index 77cd2ae..c900106 100644 --- a/content/en/2.general/2.networking/3.samba.md +++ b/content/en/2.general/2.networking/3.samba.md @@ -6,7 +6,7 @@ description: Set up Samba on Debian to share folders over your local network and :ellipsis{left=0px width=40rem top=10rem blur=140px zIndex=60} -Samba is a protocol that allows access to a folder located on a network drive. It can be configured on macOS, Windows, or Linux. +Samba is a free implementation of the SMB/CIFS protocol, allowing access to a folder located on a network drive. It can be configured on macOS, Windows, or Linux. There are many tutorials for setting up Samba on Windows or on NAS systems like Synology, but here we focus on Debian. @@ -61,7 +61,7 @@ Then scroll to the end of the file and add the following configuration: ``` Press :kbd{value="Ctrl+O"}, then :kbd{value="Enter"} to save, and :kbd{value="Ctrl+X"} to exit. -### Done ! +### Done! :: ### Create a Samba User and Group @@ -111,7 +111,7 @@ sudo smbpasswd -a sambauser ```bash [Terminal] sudo smbpasswd -e sambauser ``` -### Done ! +### Done! :: ## Accessing a Shared Folder @@ -146,11 +146,11 @@ sudo nano /smb/.credentials Write: ```properties [.credentials] -username=smbuser +username=sambauser password=password ``` -* `smbuser`: the user we created on the `remote-machine` +* `sambauser`: the user we created on the `remote-machine` * `password`: the password set earlier Press :kbd{value="Ctrl+O"}, then :kbd{value="Enter"} to save, and :kbd{value="Ctrl+X"} to exit. @@ -199,7 +199,7 @@ sudo cp /etc/fstab /etc/fstab.bak Then add the mount configuration line: ```bash [Terminal] -sudo echo //remote-ip/video /mnt/video cifs _netdev,nofail,credentials=/smb/.credentials,x-systemd.automount,x-systemd.device-timeout=15 0 0 >> /etc/fstab +echo "//remote-ip/video /mnt/video cifs _netdev,nofail,credentials=/smb/.credentials,x-systemd.automount,x-systemd.device-timeout=15 0 0" | sudo tee -a /etc/fstab ``` Reboot the machine: diff --git a/content/en/2.general/3.storage/1.raid.md b/content/en/2.general/3.storage/1.raid.md index ff9bcf9..b7c0620 100644 --- a/content/en/2.general/3.storage/1.raid.md +++ b/content/en/2.general/3.storage/1.raid.md @@ -30,7 +30,7 @@ RAID is not a backup system but a service continuity system! It only allows hot- ### No RAID
- Image + Disks with no RAID redundancy