glances_install_pipx.md переименован в glances_install_docker_or_pipx.md
Файл переименован без изменений
install_glances_docker.md(файл создан)
| @@ -0,0 +1,171 @@ | |||
| 1 | + | # Installation complète de Glances Web avec Docker (Debian 12 / Proxmox) | |
| 2 | + | ||
| 3 | + | Ce guide décrit une installation **PRODUCTION READY** de **Glances Web** via **Docker**. | |
| 4 | + | Aucune dépendance Python, aucune limitation PEP 668. | |
| 5 | + | Recommandé pour **Proxmox / Debian 12 / serveurs headless**. | |
| 6 | + | ||
| 7 | + | --- | |
| 8 | + | ||
| 9 | + | ## 1. Prérequis Docker | |
| 10 | + | ||
| 11 | + | ```bash | |
| 12 | + | apt update | |
| 13 | + | apt install -y ca-certificates curl gnupg | |
| 14 | + | curl -fsSL https://get.docker.com | sh | |
| 15 | + | systemctl enable --now docker | |
| 16 | + | ``` | |
| 17 | + | ||
| 18 | + | Test : | |
| 19 | + | ```bash | |
| 20 | + | docker run hello-world | |
| 21 | + | ``` | |
| 22 | + | ||
| 23 | + | --- | |
| 24 | + | ||
| 25 | + | ## 2. Arborescence recommandée | |
| 26 | + | ||
| 27 | + | ```bash | |
| 28 | + | mkdir -p /opt/glances | |
| 29 | + | cd /opt/glances | |
| 30 | + | ``` | |
| 31 | + | ||
| 32 | + | --- | |
| 33 | + | ||
| 34 | + | ## 3. Fichier de configuration Glances (custom) | |
| 35 | + | ||
| 36 | + | ```bash | |
| 37 | + | mkdir -p /opt/glances/config | |
| 38 | + | nano /opt/glances/config/glances.conf | |
| 39 | + | ``` | |
| 40 | + | ||
| 41 | + | Exemple : | |
| 42 | + | ```ini | |
| 43 | + | [global] | |
| 44 | + | refresh=2 | |
| 45 | + | check_update=false | |
| 46 | + | ||
| 47 | + | [cpu] | |
| 48 | + | hide=false | |
| 49 | + | ||
| 50 | + | [mem] | |
| 51 | + | hide=false | |
| 52 | + | ||
| 53 | + | [disk] | |
| 54 | + | hide=false | |
| 55 | + | ||
| 56 | + | [diskio] | |
| 57 | + | hide=false | |
| 58 | + | ||
| 59 | + | [network] | |
| 60 | + | hide=false | |
| 61 | + | ||
| 62 | + | [docker] | |
| 63 | + | hide=false | |
| 64 | + | ``` | |
| 65 | + | ||
| 66 | + | --- | |
| 67 | + | ||
| 68 | + | ## 4. Lancer Glances Web (FULL FEATURES) | |
| 69 | + | ||
| 70 | + | ```bash | |
| 71 | + | docker run -d \ | |
| 72 | + | --name glances \ | |
| 73 | + | --pid host \ | |
| 74 | + | --privileged \ | |
| 75 | + | -p 61208:61208 \ | |
| 76 | + | -v /var/run/docker.sock:/var/run/docker.sock \ | |
| 77 | + | -v /opt/glances/config:/glances/conf \ | |
| 78 | + | --restart unless-stopped \ | |
| 79 | + | nicolargo/glances | |
| 80 | + | ``` | |
| 81 | + | ||
| 82 | + | Accès : | |
| 83 | + | ``` | |
| 84 | + | http://IP_DU_SERVEUR:61208 | |
| 85 | + | ``` | |
| 86 | + | ||
| 87 | + | --- | |
| 88 | + | ||
| 89 | + | ## 5. Variables utiles | |
| 90 | + | ||
| 91 | + | | Variable | Description | | |
| 92 | + | |-------|------------| | |
| 93 | + | | GLANCES_OPT | Options glances | | |
| 94 | + | | -w | Mode Web | | |
| 95 | + | | -p | Port custom | | |
| 96 | + | | -B | Bind IP | | |
| 97 | + | ||
| 98 | + | Exemple : | |
| 99 | + | ```bash | |
| 100 | + | -e GLANCES_OPT="-w -p 61209 -B 0.0.0.0" | |
| 101 | + | ``` | |
| 102 | + | ||
| 103 | + | --- | |
| 104 | + | ||
| 105 | + | ## 6. Docker Compose (optionnel) | |
| 106 | + | ||
| 107 | + | ```bash | |
| 108 | + | nano /opt/glances/docker-compose.yml | |
| 109 | + | ``` | |
| 110 | + | ||
| 111 | + | ```yaml | |
| 112 | + | version: "3.9" | |
| 113 | + | ||
| 114 | + | services: | |
| 115 | + | glances: | |
| 116 | + | image: nicolargo/glances | |
| 117 | + | container_name: glances | |
| 118 | + | pid: host | |
| 119 | + | privileged: true | |
| 120 | + | ports: | |
| 121 | + | - "61208:61208" | |
| 122 | + | volumes: | |
| 123 | + | - /var/run/docker.sock:/var/run/docker.sock | |
| 124 | + | - /opt/glances/config:/glances/conf | |
| 125 | + | environment: | |
| 126 | + | - GLANCES_OPT=-w | |
| 127 | + | restart: unless-stopped | |
| 128 | + | ``` | |
| 129 | + | ||
| 130 | + | Lancer : | |
| 131 | + | ```bash | |
| 132 | + | docker compose up -d | |
| 133 | + | ``` | |
| 134 | + | ||
| 135 | + | --- | |
| 136 | + | ||
| 137 | + | ## 7. Logs & debug | |
| 138 | + | ||
| 139 | + | ```bash | |
| 140 | + | docker logs glances | |
| 141 | + | docker inspect glances | |
| 142 | + | ``` | |
| 143 | + | ||
| 144 | + | --- | |
| 145 | + | ||
| 146 | + | ## 8. Sécurité (recommandé) | |
| 147 | + | ||
| 148 | + | - Restreindre le port via firewall | |
| 149 | + | - Mettre Glances derrière Nginx | |
| 150 | + | - Ajouter authentification HTTP | |
| 151 | + | ||
| 152 | + | --- | |
| 153 | + | ||
| 154 | + | ## 9. Bonnes pratiques | |
| 155 | + | ||
| 156 | + | - ✅ Docker = méthode la plus stable | |
| 157 | + | - ❌ Pas de Python système | |
| 158 | + | - ❌ Pas de pip | |
| 159 | + | - ⭐ Recommandé sur Proxmox | |
| 160 | + | ||
| 161 | + | --- | |
| 162 | + | ||
| 163 | + | ## 10. Accès final | |
| 164 | + | ||
| 165 | + | ``` | |
| 166 | + | http://IP_DU_SERVEUR:61208 | |
| 167 | + | ``` | |
| 168 | + | ||
| 169 | + | --- | |
| 170 | + | ||
| 171 | + | FIN. | |
glances_install_pipx.md(файл создан)
| @@ -0,0 +1,181 @@ | |||
| 1 | + | # Installation complète de Glances Web avec pipx (Debian 12 / Proxmox) | |
| 2 | + | ||
| 3 | + | Ce guide installe **Glances 4.x (FastAPI Web UI)** proprement avec **pipx**, sans casser Python système (PEP 668). | |
| 4 | + | Compatible **Debian 12 / Proxmox**, CLI only. | |
| 5 | + | ||
| 6 | + | --- | |
| 7 | + | ||
| 8 | + | ## 1. Prérequis système | |
| 9 | + | ||
| 10 | + | ```bash | |
| 11 | + | apt update | |
| 12 | + | apt install -y python3 python3-venv python3-full pipx | |
| 13 | + | ``` | |
| 14 | + | ||
| 15 | + | Activer pipx dans le PATH : | |
| 16 | + | ```bash | |
| 17 | + | pipx ensurepath | |
| 18 | + | export PATH=$PATH:/root/.local/bin | |
| 19 | + | ``` | |
| 20 | + | ||
| 21 | + | --- | |
| 22 | + | ||
| 23 | + | ## 2. Installation de Glances via pipx | |
| 24 | + | ||
| 25 | + | ```bash | |
| 26 | + | pipx install glances | |
| 27 | + | ``` | |
| 28 | + | ||
| 29 | + | Vérification : | |
| 30 | + | ```bash | |
| 31 | + | which glances | |
| 32 | + | glances --version | |
| 33 | + | ``` | |
| 34 | + | ||
| 35 | + | Résultat attendu : | |
| 36 | + | ``` | |
| 37 | + | /root/.local/bin/glances | |
| 38 | + | Glances 4.x.x | |
| 39 | + | ``` | |
| 40 | + | ||
| 41 | + | --- | |
| 42 | + | ||
| 43 | + | ## 3. Installer les dépendances Web (OBLIGATOIRE) | |
| 44 | + | ||
| 45 | + | Glances 4.x utilise **FastAPI** pour le mode Web. | |
| 46 | + | ||
| 47 | + | ```bash | |
| 48 | + | pipx inject glances fastapi uvicorn | |
| 49 | + | ``` | |
| 50 | + | ||
| 51 | + | Vérifier : | |
| 52 | + | ```bash | |
| 53 | + | pipx list | |
| 54 | + | ``` | |
| 55 | + | ||
| 56 | + | --- | |
| 57 | + | ||
| 58 | + | ## 4. Test manuel du Web | |
| 59 | + | ||
| 60 | + | ```bash | |
| 61 | + | glances -w -B 0.0.0.0 | |
| 62 | + | ``` | |
| 63 | + | ||
| 64 | + | Accès : | |
| 65 | + | ``` | |
| 66 | + | http://IP_DU_SERVEUR:61208 | |
| 67 | + | ``` | |
| 68 | + | ||
| 69 | + | --- | |
| 70 | + | ||
| 71 | + | ## 5. Configuration Glances (custom) | |
| 72 | + | ||
| 73 | + | Créer le dossier : | |
| 74 | + | ```bash | |
| 75 | + | mkdir -p /root/.config/glances | |
| 76 | + | nano /root/.config/glances/glances.conf | |
| 77 | + | ``` | |
| 78 | + | ||
| 79 | + | Exemple de configuration : | |
| 80 | + | ```ini | |
| 81 | + | [global] | |
| 82 | + | refresh=2 | |
| 83 | + | check_update=false | |
| 84 | + | ||
| 85 | + | [cpu] | |
| 86 | + | hide=false | |
| 87 | + | ||
| 88 | + | [mem] | |
| 89 | + | hide=false | |
| 90 | + | ||
| 91 | + | [disk] | |
| 92 | + | hide=false | |
| 93 | + | ||
| 94 | + | [diskio] | |
| 95 | + | hide=false | |
| 96 | + | ||
| 97 | + | [network] | |
| 98 | + | hide=false | |
| 99 | + | ||
| 100 | + | [docker] | |
| 101 | + | hide=false | |
| 102 | + | ``` | |
| 103 | + | ||
| 104 | + | --- | |
| 105 | + | ||
| 106 | + | ## 6. Service systemd (démarrage automatique) | |
| 107 | + | ||
| 108 | + | Créer le service : | |
| 109 | + | ```bash | |
| 110 | + | nano /etc/systemd/system/glances-web.service | |
| 111 | + | ``` | |
| 112 | + | ||
| 113 | + | Contenu : | |
| 114 | + | ```ini | |
| 115 | + | [Unit] | |
| 116 | + | Description=Glances Web (pipx) | |
| 117 | + | After=network.target | |
| 118 | + | ||
| 119 | + | [Service] | |
| 120 | + | Type=simple | |
| 121 | + | User=root | |
| 122 | + | Environment=HOME=/root | |
| 123 | + | Environment=PATH=/root/.local/bin:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin | |
| 124 | + | ExecStart=/root/.local/bin/glances -w -B 0.0.0.0 | |
| 125 | + | Restart=on-failure | |
| 126 | + | RestartSec=3 | |
| 127 | + | ||
| 128 | + | [Install] | |
| 129 | + | WantedBy=multi-user.target | |
| 130 | + | ``` | |
| 131 | + | ||
| 132 | + | Activer : | |
| 133 | + | ```bash | |
| 134 | + | systemctl daemon-reload | |
| 135 | + | systemctl enable --now glances-web | |
| 136 | + | ``` | |
| 137 | + | ||
| 138 | + | Vérifier : | |
| 139 | + | ```bash | |
| 140 | + | systemctl status glances-web | |
| 141 | + | ``` | |
| 142 | + | ||
| 143 | + | --- | |
| 144 | + | ||
| 145 | + | ## 7. Dépannage rapide | |
| 146 | + | ||
| 147 | + | ### Erreur FastAPI | |
| 148 | + | ```bash | |
| 149 | + | pipx inject glances fastapi uvicorn | |
| 150 | + | ``` | |
| 151 | + | ||
| 152 | + | ### Port déjà utilisé | |
| 153 | + | ```bash | |
| 154 | + | ss -lntp | grep 61208 | |
| 155 | + | ``` | |
| 156 | + | ||
| 157 | + | Changer le port si besoin : | |
| 158 | + | ```ini | |
| 159 | + | ExecStart=/root/.local/bin/glances -w -B 0.0.0.0 -p 61209 | |
| 160 | + | ``` | |
| 161 | + | ||
| 162 | + | --- | |
| 163 | + | ||
| 164 | + | ## 8. Bonnes pratiques | |
| 165 | + | ||
| 166 | + | - ❌ Ne jamais utiliser `pip install glances` | |
| 167 | + | - ❌ Ne jamais utiliser `--break-system-packages` | |
| 168 | + | - ✅ pipx ou Docker uniquement | |
| 169 | + | - ⭐ Docker recommandé en PROD | |
| 170 | + | ||
| 171 | + | --- | |
| 172 | + | ||
| 173 | + | ## 9. Accès final | |
| 174 | + | ||
| 175 | + | ``` | |
| 176 | + | http://IP_DU_SERVEUR:61208 | |
| 177 | + | ``` | |
| 178 | + | ||
| 179 | + | --- | |
| 180 | + | ||
| 181 | + | FIN. | |