2e18724685
- 14 chapitres + annexe en Markdown (chapitres/), 99 étapes - Générateur WeasyPrint (build/build.py) : PDF générique ou personnalisé via --vars fichier.conf - PDF générique + PDF personnalisé srv1.skglobalinstitute.com - Commandes v-* vérifiées contre le code source HestiaCP 1.10.4 - 03-bis-hestiacp.md pointe vers le nouveau guide Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_018J2PsVQ28oW4xEkWJpcU9G
62 lines
2.5 KiB
Markdown
62 lines
2.5 KiB
Markdown
# Annexe : adresses et régénération du guide
|
|
|
|
## Récapitulatif des adresses
|
|
|
|
| Service | Adresse |
|
|
|---|---|
|
|
| Panel HestiaCP | `https://{{FQDN}}:{{PANEL_PORT}}` |
|
|
| SSH administrateur | `ssh -p {{SSH_PORT}} {{USER}}@{{IP}}` |
|
|
| SSH déploiement | `ssh -p {{SSH_PORT}} {{CLIENT}}@{{IP}}` |
|
|
| Webmail | `https://webmail.{{DOMAINE}}` |
|
|
| Mail (IMAP / SMTP) | `mail.{{DOMAINE}}` : 993 / 465 ou 587 |
|
|
| phpMyAdmin | `https://{{FQDN}}/<alias-du-chapitre-4>/` |
|
|
| Portainer | `https://portainer.{{DOMAINE}}` |
|
|
| Uptime Kuma | `https://status.{{DOMAINE}}` |
|
|
| Netdata | tunnel SSH puis `http://localhost:19999` |
|
|
| Serveurs DNS | `ns1.{{DOMAINE}}`, `ns2.{{DOMAINE}}` → {{IP}} |
|
|
|
|
## Générer ce guide pour un autre VPS
|
|
|
|
Ce PDF est produit à partir de fichiers Markdown, qui se trouvent dans le dépôt `vps-docs`, dossier `hestiacp/` :
|
|
|
|
| Élément | Rôle |
|
|
|---|---|
|
|
| `chapitres/*.md` | Le contenu, un fichier par chapitre ; `{{…}}` marque une variable |
|
|
| `vps.conf.exemple` | Modèle de fichier de variables |
|
|
| `build/build.py` | Le générateur (Markdown → HTML → PDF avec WeasyPrint) |
|
|
| `build/style.css`, `build/fonts/` | La mise en page et les polices |
|
|
| `build/meta.conf` | Version de HestiaCP et date de vérification affichées en couverture |
|
|
|
|
Installez une fois les outils (Ubuntu ou Debian) :
|
|
|
|
```bash
|
|
sudo apt install -y python3-venv libpango-1.0-0 libpangoft2-1.0-0
|
|
python3 -m venv ~/.venvs/guide
|
|
~/.venvs/guide/bin/pip install weasyprint markdown pygments
|
|
```
|
|
|
|
Puis, pour un nouveau VPS :
|
|
|
|
```bash
|
|
cd vps-docs/hestiacp
|
|
cp vps.conf.exemple nouveau-vps.conf
|
|
micro nouveau-vps.conf
|
|
~/.venvs/guide/bin/python build/build.py --vars nouveau-vps.conf
|
|
```
|
|
|
|
Le fichier `Guide-VPS-HestiaCP-<FQDN>.pdf` est créé, avec toutes les valeurs déjà remplies. Sans `--vars`, vous obtenez la version générique.
|
|
|
|
> [!WARNING] Avant chaque nouvelle installation
|
|
> HestiaCP évolue vite. Avant d'installer un nouveau serveur :
|
|
> - consultez les notes de version sur <https://github.com/hestiacp/hestiacp/releases> ;
|
|
> - vérifiez les options de l'installeur avec `bash hst-install.sh -h` ;
|
|
> - en cas de doute sur une commande `v-…`, lisez son en-tête : `head -12 /usr/local/hestia/bin/<commande>` ;
|
|
> - mettez à jour `build/meta.conf` après vérification.
|
|
|
|
## Sources officielles
|
|
|
|
- Documentation HestiaCP : <https://hestiacp.com/docs/>
|
|
- Code source et scripts `v-*` : <https://github.com/hestiacp/hestiacp>
|
|
- Forum : <https://forum.hestiacp.com>
|
|
- Installation de Docker : <https://docs.docker.com/engine/install/ubuntu/>
|