Documentation CloudZH

Tout ce qu’il te faut pour installer CloudZH, configurer tes apps médias, inviter tes amis et garder le serveur en bonne santé.

Guide clientNouveau ici ? De ton compte à un serveur qui tourne, étape par étape. Guides illustrésChaque étape avec une capture d'écran, de la première connexion aux sauvegardes. Installer CloudZHD’un Ubuntu 24.04 tout neuf à un tableau de bord qui tourne. Premiers pasL’ordre qui t’épargne le plus de clics. Assistants de configuration & connexion automatiqueCe que CloudZH relie pour toi, app par app. Référence des commandes zhToutes les commandes sur le serveur, avec exemples. Obtenir de l’aideDemandes de support, Discord et quoi envoyer.

Ce qu’est CloudZH

CloudZH transforme une machine Linux à la maison (Ubuntu, Debian ou Raspberry Pi OS) en serveur géré. Il apporte un tableau de bord web, un App Store avec 30+ apps, une médiathèque pour tes amis, un VPN WireGuard, des contrôles de santé avec réparations sûres, et la commande zh sur le serveur.

Comment il est construit

Composant	Ce qu’il fait
Caddy	Le seul point d’entrée. HTTPS pour chaque sous-domaine avec un certificat wildcard. Les apps d’administration ne sont accessibles qu’après la connexion au tableau de bord.
Tableau de bord	L’interface web. Tourne sans privilèges dans un conteneur durci.
Agent	Un petit service root avec une liste fixe de commandes, joint via un socket Unix. Installe les apps, lance les réparations, lit les journaux.
Apps	Docker Compose, un dossier par app sous `/opt/cloudzh/apps`, les données sous `/srv/data`.
Composants natifs	WireGuard et UniFi OS Server tournent hors de Docker. Ils s’installent uniquement avec `zh` sur le serveur.

Ce que CloudZH n’inclut pas

Pas de médias, pas d’indexeurs et pas de clients torrent. Tu apportes un fournisseur Usenet et les indexeurs de ton choix, et tu utilises les apps avec des contenus que tu as le droit d’utiliser.

Valeurs à remplacer

Les commandes et adresses de cette documentation utilisent des valeurs à remplacer. Remplace-les, chevrons compris, par tes propres valeurs.

Valeur à remplacer	Représente	Exemple
`<user>`	L’utilisateur Linux que tu as créé lors de l’installation d’Ubuntu	`anna`
`<server-ip>`	L’adresse du serveur dans ton réseau domestique. Sur le serveur, `ip -4 -br addr` l’affiche sur la ligne de l’adaptateur réseau, avant le `/`. Ton routeur l’indique aussi parmi ses appareils.	`192.168.1.200`
`example.com`	Ton propre domaine. `app.example.com` signifie `app.` suivi de ton domaine.	`app.example.com`

Ainsi, ssh <user>@<server-ip> devient par exemple ssh anna@192.168.1.200.