{ "meta": { "title": "ProxMenux Monitor | Documentazione ProxMenux", "description": "Attiva o disattiva l'unità systemd proxmenux-monitor.service e verifica il suo stato. Monitor fornisce un'interfaccia web sulla porta TCP 8008 per il monitoraggio visivo dell'host.", "ogTitle": "ProxMenux Monitor | Documentazione ProxMenux", "ogDescription": "Attiva o disattiva il servizio systemd proxmenux-monitor e controllane lo stato dalle Impostazioni." }, "header": { "title": "ProxMenux Monitor", "description": "Due azioni correlate nelle Impostazioni: attivare o disattivare l'unità systemd proxmenux-monitor.service (avvio/arresto e abilitazione/disabilitazione insieme) e visualizzarne lo stato dettagliato. Monitor fornisce un'interfaccia web sulla porta TCP 8008 per il monitoraggio visivo dell'host.", "section": "Impostazioni" }, "intro": { "title": "Cos'è ProxMenux Monitor?", "body": "ProxMenux Monitor è un cruscotto web integrato che fornisce visibilità in tempo reale nell'infrastruttura Proxmox, accessibile da qualsiasi browser della rete, senza bisogno di un terminale." }, "offers": { "heading": "Cosa offre", "items": [ "Monitoraggio in tempo reale di CPU, RAM, utilizzo del disco e traffico di rete.", "Panoramica dell'esecuzione di VM e contenitori LXC con indicatori di stato.", "Autenticazione di accesso per proteggere l'interfaccia.", "Autenticazione a due fattori (2FA) con supporto TOTP.", "Supporto proxy inverso (Nginx / Traefik).", "Progettato per lavorare su dispositivi desktop e mobili." ] }, "access": { "heading": "Accesso", "intro": "Una volta installato, il cruscotto è disponibile a:", "url": "http://:8008", "outro": "Il Monitor viene installato automaticamente nell'ambito dell'installazione standard ProxMenux e viene eseguito come servizio systemd (proxmenux-monitor.service) che inizia automaticamente sul boot." }, "warnConditional": { "title": "Opzioni delle impostazioni visibili solo quando Monitor è installato", "body": "Le due voci del menu descritte di seguito appaiono solo in Impostazioni se proxmenux-monitor.service è registrato con systemd. Se non li vedi, il Monitor non è stato installato (è opzionale durante l'installazione ProxMenux). Per aggiungerlo in seguito, reinstallare ProxMenux con l'ultima versione e selezionare l'opzione Monitor." }, "toggle": { "heading": "Attivare / disattivare", "intro": "La prima voce del menu alterna tra due stati in base al fatto che il servizio sia in esecuzione:", "headerState": "Stato attuale", "headerLabel": "Etichetta del menu", "headerAction": "Azione sulla conferma", "rows": [ { "state": "attivo", "label": "Disattiva ProxMenux Monitor", "action": "systemctl stop + disable" }, { "state": "inattivo", "label": "Attiva ProxMenux Monitor", "action": "systemctl enable + start" } ], "outro": "Ogni modifica richiede una conferma sì/no. Disattivare arresta il servizio e disabilita l'avvio automatico; attivare abilita l'avvio automatico e avvia subito il servizio." }, "status": { "heading": "Mostra stato servizio Monitor", "intro": "La seconda voce del menu è di sola lettura. Sgombera lo schermo, mostra il logo ProxMenux e il titolo \"ProxMenux Monitor Service Verification\", poi segnala:", "items": [ "Stato di servizio: attivo, inattivo o not_installed.", "Web UI URL (solo quando attivo): http://<host_ip>:8008 — derivato da hostname -I | awk '''{print $1}'''.", "Dettaglio systemd uscita: systemctl status proxmenux-monitor.service --no-pager -l — mostra le linee di log recenti, ExecStart, MainPID, ecc." ] }, "manual": { "title": "Equivalenti manuali", "intro": "Da qualsiasi shell:", "code": "systemctl status proxmenux-monitor.service # detailed status\nsystemctl is-active proxmenux-monitor.service # one-word status\nsystemctl enable --now proxmenux-monitor.service # enable + start\nsystemctl disable --now proxmenux-monitor.service # stop + disable\njournalctl -u proxmenux-monitor.service -f # follow live logs" }, "reset": { "heading": "Reimposta password ProxMenux Monitor", "intro": "Percorso di recupero per l'operatore che ha perso la password del cruscotto (o dispositivo 2FA). L'opzione viene visualizzata solo quando il Monitor viene installato sull'host. Selezione:", "items": [ "Chiede la conferma con una finestra di dialogo sì/no — l'azione è distruttiva per le credenziali di accesso.", "Il backup del /root/.config/proxmenux-monitor/auth.json esistente a auth.json.bak-<UTC timestamp> (mode 0600) così lo stato precedente può essere ripristinato manualmente se il reset è stato un errore.", "Arresta il servizio proxmenux-monitor per evitare conflitti tra la modifica del file e un accesso in corso.", "Cancella i campi di identità in auth.json: enabled=false, configured=false, svuota username, password_hash, totp_secret e l'array dei codici di backup.", "Conserva jwt_secret e i dati registrati api_tokens / revoked_tokens, così i token di lunga durata usati da Home Assistant o altri script continuano ad autenticarsi dopo la reimpostazione.", "Riavvia il servizio. La prossima visita a http://<host>:8008 mostra la procedura guidata di configurazione del primo lancio in modo da poter creare un nuovo account di amministrazione." ], "preservedTitle": "Cosa viene conservato e cosa viene cancellato", "preservedBody": "Cancellati: nome utente, hash della password, segreto TOTP 2FA e codici di recupero. Conservati: jwt_secret, metadati api_tokens e lista revoked_tokens. Per invalidare anche tutti i token API e ripartire da zero, elimina auth.json manualmente invece di usare questa opzione. Al prossimo avvio il servizio rigenera il segreto JWT e tutti gli altri dati.", "trustTitle": "L'accesso fisico-host è l'ancora di fiducia", "trustBody": "Questo percorso di reset richiede shell radice sull'host. Chiunque può eseguire il comando menu come root controlla già la casella, quindi dare loro il recupero password non è un escalation privilegio — è coerente con come ogni altro strumento di amministrazione su Proxmox funziona. Il corollario: il login Monitor non proteggerà nulla da qualcuno che hai già lasciato nel guscio Proxmox.", "seeAlso": "Vedi anche Monitor → Accesso e autenticazione → Recuperare una password persa per la stessa procedura dal pannello e i dettagli sul calcolo degli hash delle password e sulla generazione del segreto JWT." }, "files": { "heading": "File coinvolti", "code": "/etc/systemd/system/proxmenux-monitor.service # systemd unit\n/root/.config/proxmenux-monitor/ # runtime config dir\n/var/log/proxmenux-auth.log # Flask app auth log\n # (read by Fail2Ban [proxmenux] jail)" }, "troubleshoot": { "heading": "Risoluzione dei problemi", "missingTitle": "Entrambe le opzioni di menu mancano", "missingBody": "Il Monitor non è registrato con systemd. Confermare con systemctl list-unit-files | grep proxmenux-monitor — se non c'è uscita, reinstallare ProxMenux dal programma di installazione ufficiale con l'ultima versione e selezionare l'opzione Monitor durante l'installazione.", "unreachableTitle": "Servizio attivato ma l'URL non è raggiungibile", "unreachableBody": "L'uscita di stato delle impostazioni ti dà l'IP. Conferma:", "unreachableCmd": "ss -tlnp | grep 8008 # is anything listening?\njournalctl -u proxmenux-monitor -n 100 --no-pager # recent errors\ncurl -sI http://localhost:8008 # local reachability", "unreachableOutro": "Se localhost funziona ma non è esterno, controlla il firewall host (pve-firewall o nftables) per TCP 8008 in entrata.", "stopsTitle": "Attivato il servizio ma si ferma pochi secondi dopo", "stopsBody": "Di solito si tratta di un conflitto sulla porta 8008 o di un controllo delle dipendenze non riuscito. Il registro di sistema indica la causa: journalctl -u proxmenux-monitor.service -b." }, "related": { "heading": "Correlati", "items": [ { "href": "/docs/security/fail2ban", "label": "Fail2Ban", "tailRich": "— la prigione [proxmenux] protegge il Monitor su TCP 8008." }, { "href": "/docs/settings", "label": "Panoramica delle impostazioni", "tail": "." } ] } }