ProxMenux/web/messages/it/docs/settings/proxmenux-monitor.json

{
  "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://<your-proxmox-ip>:8008",
    "outro": "Il Monitor viene installato automaticamente nell'ambito dell'installazione standard ProxMenux e viene eseguito come servizio systemd (<code>proxmenux-monitor.service</code>) 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 <code>proxmenux-monitor.service</code> è 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 <em>e</em> disabilita l'avvio automatico; attivare abilita l'avvio automatico <em>e</em> 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 <em>\"ProxMenux Monitor Service Verification\"</em>, poi segnala:",
    "items": [
      "<strong>Stato di servizio:</strong> attivo, inattivo o not_installed.",
      "<strong>Web UI URL</strong> (solo quando attivo): <code>http://&lt;host_ip&gt;:8008</code> — derivato da <code>hostname -I | awk '''{print $1}'''</code>.",
      "<strong>Dettaglio systemd uscita:</strong> <code>systemctl status proxmenux-monitor.service --no-pager -l</code> — 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 <code>/root/.config/proxmenux-monitor/auth.json</code> esistente a <code>auth.json.bak-&lt;UTC timestamp&gt;</code> (mode <code>0600</code>) così lo stato precedente può essere ripristinato manualmente se il reset è stato un errore.",
      "Arresta il servizio <code>proxmenux-monitor</code> per evitare conflitti tra la modifica del file e un accesso in corso.",
      "Cancella i campi di identità in <code>auth.json</code>: <code>enabled=false</code>, <code>configured=false</code>, svuota <code>username</code>, <code>password_hash</code>, <code>totp_secret</code> e l'array dei codici di backup.",
      "<strong>Conserva</strong> <code>jwt_secret</code> e i dati registrati <code>api_tokens</code> / <code>revoked_tokens</code>, così i token di lunga durata usati da Home Assistant o altri script <em>continuano ad autenticarsi</em> dopo la reimpostazione.",
      "Riavvia il servizio. La prossima visita a <code>http://&lt;host&gt;:8008</code> 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": "<strong>Cancellati:</strong> nome utente, hash della password, segreto TOTP 2FA e codici di recupero. <strong>Conservati:</strong> <code>jwt_secret</code>, metadati <code>api_tokens</code> e lista <code>revoked_tokens</code>. Per invalidare anche tutti i token API e ripartire da zero, elimina <code>auth.json</code> 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 <code>menu</code> 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 <link>Monitor → Accesso e autenticazione → Recuperare una password persa</link> 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 <code>systemctl list-unit-files | grep proxmenux-monitor</code> — 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 (<code>pve-firewall</code> 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: <code>journalctl -u proxmenux-monitor.service -b</code>."
  },
  "related": {
    "heading": "Correlati",
    "items": [
      {
        "href": "/docs/security/fail2ban",
        "label": "Fail2Ban",
        "tailRich": "— la prigione <code>[proxmenux]</code> protegge il Monitor su TCP 8008."
      },
      {
        "href": "/docs/settings",
        "label": "Panoramica delle impostazioni",
        "tail": "."
      }
    ]
  }
}