mirror of
https://github.com/MacRimi/ProxMenux.git
synced 2026-11-02 10:52:22 +00:00
docs: review settings documentation in all seven translations
This commit is contained in:
Jonatan
@@ -0,0 +1,113 @@
|
||||
{
|
||||
"meta": {
|
||||
"title": "Cambia canale di rilascio | Documentazione ProxMenux",
|
||||
"description": "Passa tra i canali Stable (main) e Beta (develop) di ProxMenux in una sola finestra. Bidirezionale e idempotente; esegue il programma di installazione ufficiale del canale scelto e normalizza il servizio Monitor.",
|
||||
"ogTitle": "Cambia canale di rilascio | Documentazione ProxMenux",
|
||||
"ogDescription": "Una opzione delle Impostazioni per passare tra Stable e Beta senza eseguire manualmente i programmi di installazione."
|
||||
},
|
||||
"header": {
|
||||
"title": "Cambia canale di rilascio",
|
||||
"description": "Una opzione unica delle Impostazioni passa tra Stable (ramo main) e Beta (ramo develop). La precedente opzione unidirezionale «Disattiva programma beta» è sostituita da una finestra bidirezionale che offre entrambi i sensi ed esegue il programma di installazione ufficiale del canale scelto.",
|
||||
"section": "Impostazioni"
|
||||
},
|
||||
"intro": {
|
||||
"title": "Che cosa è cambiato",
|
||||
"body": "Prima esistevano due procedure: «Disattiva programma beta», visibile solo con beta attiva, e la riesecuzione manuale del programma beta per rientrare. Ora sono riunite in <strong>Cambia canale di rilascio</strong>, sempre disponibile, che mostra il canale corrente e permette il passaggio tra Stable e Beta in entrambi i sensi."
|
||||
},
|
||||
"why": {
|
||||
"heading": "Perché questa opzione esiste",
|
||||
"intro": "ProxMenux è distribuito da due rami Git:",
|
||||
"items": [
|
||||
"<strong>Stable</strong>: il ramo <code>main</code>, indicato nel README e adatto alla maggior parte degli amministratori. I rilasci sono meno frequenti e includono solo modifiche già passate dalla validazione beta.",
|
||||
"<strong>Beta</strong>: il ramo <code>develop</code>. Funzioni e build di Monitor più recenti, con il tag che erediterà la prossima versione stabile. Alcune funzioni potrebbero avere difetti: scegliendo questo canale partecipi ai test prima del rilascio."
|
||||
],
|
||||
"outro": "Prima occorreva ricordare l'URL corretto del programma di installazione, copiarlo dal README e modificare <code>config.json</code> manualmente in caso di problemi di sincronizzazione. L'opzione unica esegue tutta la procedura con un'azione guidata."
|
||||
},
|
||||
"dialog": {
|
||||
"heading": "La finestra di dialogo",
|
||||
"intro": "Dal menu principale: <strong>Impostazioni → Cambia canale di rilascio</strong>. Appare un menu con due voci:",
|
||||
"options": [
|
||||
"<code>stable</code> — Stable (ramo main)",
|
||||
"<code>beta</code> — Beta (ramo develop)"
|
||||
],
|
||||
"behaviour": "Il canale corrente è preselezionato e mostrato in alto. Scegliendo lo stesso appare «Questo canale di rilascio è già attivo»: la finestra è idempotente. Scegliendo un altro canale appare una conferma specifica:",
|
||||
"directions": [
|
||||
"<strong>Stable → Beta:</strong> avverte che le versioni beta possono contenere bug o funzioni incomplete.",
|
||||
"<strong>Beta → Stabile:</strong> avverte che i controlli di aggiornamento beta si fermeranno e l'installatore stabile reinstallerà i componenti del canale stabile."
|
||||
]
|
||||
},
|
||||
"confirm": {
|
||||
"heading": "Cosa succede quando confermi",
|
||||
"items": [
|
||||
"<strong>Scarica il programma di installazione ufficiale</strong> del canale scelto:<ul><li>Stable: <code>install_proxmenux.sh</code> da <code>main</code></li><li>Beta: <code>install_proxmenux_beta.sh</code> da <code>develop</code></li></ul>Prima di continuare verifica che il file sia presente e lo rende eseguibile.",
|
||||
"<strong>Esegue il programma di installazione completo</strong>, lo stesso indicato nel README. Rilevamento dei componenti, backup dei file, installazione delle dipendenze e conservazione della lingua seguono la procedura ufficiale del canale scelto.",
|
||||
"Passando a <strong>Stable</strong>, il menu elimina i metadati beta rimasti in <code>config.json</code>: <code>beta_program</code>, <code>beta_version</code>, <code>install_branch</code> e <code>update_available.beta*</code>. <code>proxmenux_monitor.status = beta_updated</code> diventa <code>updated</code>. Il file residuo <code>beta_version.txt</code> e i programmi di installazione beta scaricati vengono rimossi.",
|
||||
"Passando a Stable, l'unità systemd di Monitor viene riscritta dal modello Stable: «Beta» viene rimosso dalla descrizione e <code>ExecStart</code> torna a puntare alla directory di esecuzione. Una nuova esecuzione di <code>systemctl status</code> riflette quindi il canale attuale.",
|
||||
"Ricarica il menu di configurazione. <em>Mostra informazioni sulla versione</em> mostrerà il nuovo canale."
|
||||
]
|
||||
},
|
||||
"switching": {
|
||||
"heading": "Passare avanti e indietro",
|
||||
"intro": "Entrambe le direzioni passano attraverso lo stesso programma di installazione: <strong>non</strong> flussi di disinstallazione e reinstallazione speciali. Ciascuna direzione esegue semplicemente il programma di installazione del canale, progettato per essere idempotente e sicuro da eseguire nuovamente su un'installazione esistente. Conseguenze pratiche:",
|
||||
"items": [
|
||||
"La configurazione esistente, ProxMenux Monitor login (<code>auth.json</code>), canali di notifica, registro post-installazione, soglie personalizzate — nessuno di questi sono toccati. L'interruttore di canale scambia solo l'albero di script e il binario AppImage.",
|
||||
"Un Monitor attivo prima del cambio rimane attivo dopo; uno disattivato rimane disattivato.",
|
||||
"Il file <code>auth.json</code>, i token API e il segreto JWT di ProxMenux Monitor vengono conservati al cambio di canale. Le sessioni non vengono disconnesse.",
|
||||
"Puoi cambiare canale tutte le volte che vuoi: la finestra accetta ogni modifica ed esegue nuovamente il programma di installazione. Non è necessario riavviare Proxmox.",
|
||||
"Il cambio di canale sostituisce gli script di ProxMenux e non può essere eseguito nel terminale del browser di Monitor: il PTY verrebbe chiuso durante l'aggiornamento, bloccando la finestra. In quel terminale appare invece un messaggio con il comando ufficiale di una riga per il canale scelto. Eseguilo da SSH o dalla console dell'host Proxmox."
|
||||
]
|
||||
},
|
||||
"feedback": {
|
||||
"heading": "Segnalare problemi della beta",
|
||||
"intro": "Se qualcosa si comporta inaspettatamente mentre sei sul canale Beta, aprire un problema con un contesto sufficiente è quello che chiude il divario a un rilascio stabile. Il rapporto più utile comprende:",
|
||||
"items": [
|
||||
"Quello che hai fatto e quello che ti aspettavi.",
|
||||
"Eventuali messaggi di errore visualizzati sullo schermo.",
|
||||
"I relativi registri Monitor:"
|
||||
],
|
||||
"logsCommand": "journalctl -u proxmenux-monitor -n 50 --no-pager",
|
||||
"versionLine": "La versione attuale di ProxMenux (Impostazioni → <link>Mostra informazioni sulla versione</link>).",
|
||||
"issueLine": "Aprire un <ghlink>GitHub Issue</ghlink> con queste informazioni e arriviamo alla correzione più veloce."
|
||||
},
|
||||
"manual": {
|
||||
"heading": "Equivalente manuale",
|
||||
"intro": "Se preferisci la shell o automatizzi il cambio di canale, la finestra esegue questi comandi:"
|
||||
},
|
||||
"unifiedCallout": {
|
||||
"title": "Perché entrambe le direzioni sono ora un'opzione",
|
||||
"body": "La vecchia opzione «Disattiva programma beta» appariva solo dopo la adesione alla beta. Per <em>aderire</em> occorreva cercare altrove il programma di installazione; per <em>uscire</em> talvolta occorreva pulire manualmente i metadati <code>beta_*</code>. <strong>Cambia canale di rilascio</strong> appare sempre, mostra il canale corrente e tratta entrambe le direzioni come un'operazione eseguibile, ripetibile e idempotente."
|
||||
},
|
||||
"troubleshoot": {
|
||||
"heading": "Risoluzione dei problemi",
|
||||
"downloadTitle": "“Impossibile scaricare l’installatore”",
|
||||
"downloadBody": "HTTPS in uscita a <code>raw.githubusercontent.com</code> fallito. Controllare la connettività e DNS dall'host:",
|
||||
"downloadCmd": "curl -fsSL -o /tmp/test https://raw.githubusercontent.com/MacRimi/ProxMenux/main/install_proxmenux.sh && head -1 /tmp/test",
|
||||
"downloadOutro": "Se questo non funziona al di fuori di ProxMenux, è un problema di rete / proxy sull'host.",
|
||||
"errorsTitle": "“Installer finito con errori”",
|
||||
"errorsBody": "Il programma di installazione ha restituito un codice diverso da zero. Non è previsto un ripristino automatico: alcuni file o componenti potrebbero essere già cambiati. Controlla l'output e lo stato attuale prima di riprovare. Esegui il programma manualmente via SSH o dalla console dell'host per vedere l'output completo.",
|
||||
"configTitle": "“Impossibile aggiornare il file di configurazione” dopo il passaggio a stabile",
|
||||
"configBody": "La pulizia post-installazione dei metadati beta non è riuscita — di solito perché <code>config.json</code> ha un errore di sintassi da una modifica manuale. Convalidalo:",
|
||||
"configCmd": "jq . /usr/local/share/proxmenux/config.json",
|
||||
"configOutro": "Correggi o ripristina il file ed esegui nuovamente l'opzione."
|
||||
},
|
||||
"related": {
|
||||
"heading": "Correlati",
|
||||
"items": [
|
||||
{
|
||||
"href": "/docs/settings/show-version-information",
|
||||
"label": "Mostra informazioni sulla versione",
|
||||
"tail": "— confermare quale canale è attivo ora."
|
||||
},
|
||||
{
|
||||
"href": "/docs/settings/proxmenux-monitor",
|
||||
"label": "ProxMenux Monitor",
|
||||
"tail": " — il servizio Monitor ricreato durante il cambio di canale."
|
||||
},
|
||||
{
|
||||
"href": "/docs/settings",
|
||||
"label": "Panoramica delle impostazioni",
|
||||
"tail": "."
|
||||
}
|
||||
]
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,108 @@
|
||||
{
|
||||
"meta": {
|
||||
"title": "Cambia lingua | Documentazione ProxMenux",
|
||||
"description": "Scegli tra otto lingue per ProxMenux. Ogni installazione include cataloghi JSON di traduzioni pregenerati; l'host non richiede un servizio di traduzione né un ambiente Python. Il menu si ricarica automaticamente.",
|
||||
"ogTitle": "Cambia lingua | Documentazione ProxMenux",
|
||||
"ogDescription": "Scegli una delle otto lingue di ProxMenux dalle Impostazioni. Disponibile in ogni installazione."
|
||||
},
|
||||
"header": {
|
||||
"title": "Cambia lingua",
|
||||
"description": "Passa tra le otto lingue supportate da ProxMenux. La scelta viene salvata in config.json e il menu viene riavviato nella nuova lingua. Ogni installazione include i cataloghi di traduzioni.",
|
||||
"section": "Impostazioni"
|
||||
},
|
||||
"intro": {
|
||||
"title": "Che cosa è questo",
|
||||
"body": "Una finestra elenca le otto lingue supportate. ProxMenux salva la scelta in <code>config.json</code> come <code>.language</code>, poi riavvia <code>config_menu.sh</code> per applicarla subito."
|
||||
},
|
||||
"warn": {
|
||||
"title": "Disponibile in ogni installazione",
|
||||
"body": "Le Impostazioni mostrano sempre Cambia lingua. I cataloghi vengono installati in <code>/usr/local/share/proxmenux/lang/</code> <em>e</em> la lingua scelta viene salvata in <code>config.json</code>. Il precedente ambiente Python di traduzione non è necessario."
|
||||
},
|
||||
"supported": {
|
||||
"heading": "Lingue supportate",
|
||||
"headerCode": "Code",
|
||||
"headerLang": "Lingua",
|
||||
"headerNotes": "Note",
|
||||
"rows": [
|
||||
{
|
||||
"code": "en",
|
||||
"lang": "Inglese",
|
||||
"notes": "Lingua sorgente — più accurata"
|
||||
},
|
||||
{
|
||||
"code": "es",
|
||||
"lang": "Spagnolo",
|
||||
"notes": "Catalogo JSON pregenerato"
|
||||
},
|
||||
{
|
||||
"code": "fr",
|
||||
"lang": "Francese",
|
||||
"notes": "Catalogo JSON pregenerato"
|
||||
},
|
||||
{
|
||||
"code": "de",
|
||||
"lang": "Tedesco",
|
||||
"notes": "Catalogo JSON pregenerato"
|
||||
},
|
||||
{
|
||||
"code": "it",
|
||||
"lang": "Italiano",
|
||||
"notes": "Catalogo JSON pregenerato"
|
||||
},
|
||||
{
|
||||
"code": "pt",
|
||||
"lang": "Portoghese",
|
||||
"notes": "Catalogo JSON pregenerato"
|
||||
},
|
||||
{
|
||||
"code": "sk",
|
||||
"lang": "Slovacco",
|
||||
"notes": "Catalogo JSON pregenerato"
|
||||
},
|
||||
{
|
||||
"code": "sv",
|
||||
"lang": "Svedese",
|
||||
"notes": "Catalogo JSON pregenerato"
|
||||
}
|
||||
]
|
||||
},
|
||||
"englishTip": {
|
||||
"title": "L'inglese è il più accurato",
|
||||
"body": "I testi nelle altre lingue provengono dai cataloghi JSON pregenerati inclusi in ProxMenux. Le traduzioni mancanti usano il testo inglese; non vengono effettuate chiamate di traduzione sull'host. In caso di dubbi, l'inglese resta il riferimento."
|
||||
},
|
||||
"underHood": {
|
||||
"heading": "Come funziona sotto il cofano",
|
||||
"items": [
|
||||
"La finestra elenca otto codici lingua; scegline uno.",
|
||||
"Se esiste <code>config.json</code>: <code>jq --arg lang \"$new_language\" '.language = $lang''</code> aggiorna il campo in posizione.",
|
||||
"Se <code>config.json</code> non esiste, viene creato un nuovo file con il codice della lingua in un oggetto contenente un solo campo.",
|
||||
"Finestra di conferma: <em>\"Lingua cambiata in [code]\"</em>.",
|
||||
"<code>exec bash config_menu.sh</code> ricarica il menu Impostazioni con la nuova lingua attiva."
|
||||
]
|
||||
},
|
||||
"manual": {
|
||||
"heading": "Equivalente manuale"
|
||||
},
|
||||
"troubleshoot": {
|
||||
"heading": "Risoluzione dei problemi",
|
||||
"noOptionTitle": "L'opzione non appare in Impostazioni",
|
||||
"noOptionBody": "Cambia lingua è sempre disponibile nelle versioni attuali. Se manca, aggiorna ProxMenux con il programma di installazione ufficiale e riapri le Impostazioni.",
|
||||
"stillEnglishTitle": "La lingua è cambiata ma l'interfaccia utente mostra ancora inglese",
|
||||
"stillEnglishBody": "Il menu si riavvia dopo la modifica. Se hai aperto una nuova shell e avviato un altro punto di ingresso di ProxMenux, esegui di nuovo <code>menu</code> per applicare la nuova lingua. Verifica con <code>jq -r '.language' /usr/local/share/proxmenux/config.json</code>."
|
||||
},
|
||||
"related": {
|
||||
"heading": "Correlati",
|
||||
"items": [
|
||||
{
|
||||
"href": "/docs/settings/show-version-information",
|
||||
"label": "Mostra informazioni sulla versione",
|
||||
"tail": " — conferma il canale di rilascio, i file di traduzione e la lingua attuale."
|
||||
},
|
||||
{
|
||||
"href": "/docs/settings",
|
||||
"label": "Panoramica delle impostazioni",
|
||||
"tail": "."
|
||||
}
|
||||
]
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,81 @@
|
||||
{
|
||||
"meta": {
|
||||
"title": "Impostazioni ProxMenux — Attivazione di Monitor, canale di rilascio, lingue | ProxMenux",
|
||||
"description": "Impostazioni di ProxMenux: servizio Monitor e reimpostazione della password, canale Stable/Beta, otto lingue, diagnostica della versione e disinstallazione. Le opzioni Monitor appaiono quando il servizio è installato.",
|
||||
"ogTitle": "Impostazioni ProxMenux — Attivazione di Monitor, canale di rilascio, lingue",
|
||||
"ogDescription": "Configura ProxMenux: servizio Monitor, canale di rilascio, lingua, informazioni sulla versione e disinstallazione.",
|
||||
"twitterTitle": "Impostazioni ProxMenux",
|
||||
"twitterDescription": "Attivazione di Monitor, cambio del canale di rilascio, lingue, informazioni sulla versione e disinstallazione."
|
||||
},
|
||||
"header": {
|
||||
"title": "Impostazioni",
|
||||
"description": "Configura ProxMenux: attiva o disattiva Monitor, reimposta le credenziali, passa tra Stable e Beta in entrambe le direzioni, scegli una delle otto lingue, consulta la diagnostica della versione e disinstalla. Le azioni di Monitor richiedono il servizio installato; la scelta della lingua è sempre disponibile.",
|
||||
"section": "Impostazioni"
|
||||
},
|
||||
"intro": {
|
||||
"title": "A cosa serve questo menu",
|
||||
"body": "Amministrazione di ProxMenux stesso: servizio Monitor, uscita dal canale beta, lingua, diagnostica della versione e disinstallazione. Nessun'opzione di questo menu modifica VM, container o archiviazione."
|
||||
},
|
||||
"opening": {
|
||||
"heading": "Apertura del menu",
|
||||
"body": "Dal menu principale di ProxMenux premi <kbd>s</kbd>. Le azioni Monitor appaiono se il servizio è installato; le altre impostazioni sono sempre disponibili:",
|
||||
"imageAlt": "Menu Impostazioni di ProxMenux con azioni Monitor condizionali"
|
||||
},
|
||||
"installTypes": {
|
||||
"heading": "Una installazione, tutte le lingue",
|
||||
"intro": "Le versioni attuali includono cataloghi JSON statici in ogni installazione. Le vecchie versioni offrivano modalità separate con traduzione e normale:",
|
||||
"headerType": "Tipo di installazione",
|
||||
"headerBundles": "Componenti inclusi",
|
||||
"headerMenu": "Mostra menu",
|
||||
"rows": [
|
||||
{
|
||||
"type": "Installazione attuale",
|
||||
"bundles": "Cataloghi JSON statici per otto lingue; nessun ambiente Python di traduzione",
|
||||
"menuRich": "<strong>Cambia lingua</strong> + Mostra versione + Disinstalla"
|
||||
},
|
||||
{
|
||||
"type": "Vecchie modalità con traduzione / normale",
|
||||
"bundles": "Vecchia separazione tra ambiente di traduzione e installazione solo in inglese",
|
||||
"menu": "Aggiorna con il programma ufficiale per usare il menu unificato attuale"
|
||||
}
|
||||
],
|
||||
"detectionTitle": "La scelta della lingua è sempre disponibile",
|
||||
"detectionBody": "Il menu non verifica più un ambiente di traduzione. Ogni installazione include <code>/usr/local/share/proxmenux/lang/</code> e salva il valore <code>language</code> scelto in <code>config.json</code>."
|
||||
},
|
||||
"options": {
|
||||
"heading": "Opzioni menu",
|
||||
"intro": "Questi strumenti gestiscono ProxMenux stesso. <em>Condizionale</em> indica che le azioni Monitor appaiono solo se il servizio systemd è installato. Canale di rilascio, lingua, diagnostica della versione e disinstallazione sono sempre disponibili.",
|
||||
"list": [
|
||||
{
|
||||
"icon": "Activity",
|
||||
"href": "/docs/settings/proxmenux-monitor",
|
||||
"title": "ProxMenux Monitor",
|
||||
"description": "Attiva / disattiva l'unità proxmenux-monitor.service systemd, controlla lo stato attuale e ripristina la password di accesso del cruscotto se è stata persa. UI Web disponibile su TCP 8008.",
|
||||
"badge": "Condizionale"
|
||||
},
|
||||
{
|
||||
"icon": "TestTube",
|
||||
"href": "/docs/settings/beta-program",
|
||||
"title": "Cambia canale di rilascio",
|
||||
"description": "Passa tra Stable (main) e Beta (develop) in entrambe le direzioni da una sola finestra. Esegue il programma di installazione ufficiale del canale scelto; è idempotente e sempre visibile.",
|
||||
"badge": "Sempre disponibile"
|
||||
},
|
||||
{
|
||||
"icon": "Info",
|
||||
"href": "/docs/settings/show-version-information",
|
||||
"title": "Mostra informazioni sulla versione",
|
||||
"description": "Versione di ProxMenux, canale di rilascio, componenti installati, percorsi dei file, file di traduzione e lingua attuale."
|
||||
},
|
||||
{
|
||||
"icon": "Trash2",
|
||||
"href": "/docs/settings/uninstall-proxmenux",
|
||||
"title": "Disinstalla ProxMenux",
|
||||
"description": "Rimuovere ProxMenux e (opzionalmente) le sue dipendenze. Inoltre ripristina i backup /root/.bashrc e /etc/motd creati al momento dell'installazione."
|
||||
}
|
||||
]
|
||||
},
|
||||
"configTip": {
|
||||
"title": "Dove viene salvata la configurazione",
|
||||
"bodyRich": "La maggior parte dello stato gestito da questo menu è salvata in <code>/usr/local/share/proxmenux/config.json</code>: <code>language</code>, <code>beta_program.status</code> e indicatori di installazione per ciascun componente. Lo stato del servizio Monitor è gestito da systemd (<code>proxmenux-monitor.service</code>), non qui. La versione viene letta da <code>/usr/local/share/proxmenux/version.txt</code>."
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,119 @@
|
||||
{
|
||||
"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://<host_ip>: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-<UTC timestamp></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://<host>: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": "."
|
||||
}
|
||||
]
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,81 @@
|
||||
{
|
||||
"meta": {
|
||||
"title": "Mostra informazioni sulla versione | Documentazione ProxMenux",
|
||||
"description": "Diagnostica di ProxMenux in sola lettura: versione, canale di rilascio, componenti registrati in config.json, percorsi dei file, cataloghi di traduzioni e lingua attuale.",
|
||||
"ogTitle": "Mostra informazioni sulla versione | Documentazione ProxMenux",
|
||||
"ogDescription": "Dati diagnostici su versione di ProxMenux, canale di rilascio, componenti, file e lingua."
|
||||
},
|
||||
"header": {
|
||||
"title": "Mostra informazioni sulla versione",
|
||||
"description": "Diagnostica in sola lettura. Legge version.txt, config.json e percorsi di file noti, poi mostra una casella di testo scorrevole con versione, canale di rilascio, componenti installati, presenza dei file, file di traduzione e lingua attuale.",
|
||||
"section": "Impostazioni"
|
||||
},
|
||||
"intro": {
|
||||
"title": "Che cosa è questo",
|
||||
"body": "Un autodiagnostico. Utile quando si segnala un problema (incolla il contenuto di dialogo nel bug report) o per confermare un'installazione completata in modo pulito. Non modifica niente."
|
||||
},
|
||||
"reports": {
|
||||
"heading": "Che cosa riferisce",
|
||||
"headerSection": "Sezione",
|
||||
"headerSource": "Fonte",
|
||||
"headerContent": "Contenuto",
|
||||
"rows": [
|
||||
{
|
||||
"section": "Versione attuale",
|
||||
"source": "version.txt",
|
||||
"contentRich": "Numero di versione su una sola riga; <code>Unknown</code> se il file manca"
|
||||
},
|
||||
{
|
||||
"section": "Canale di rilascio",
|
||||
"source": "Stato del programma beta in config.json",
|
||||
"content": "Stable (main) o Beta (develop); versione beta se disponibile"
|
||||
},
|
||||
{
|
||||
"section": "Componenti installati",
|
||||
"source": "config.json",
|
||||
"content": "Stato di ciascun componente (✓ installato / creato / aggiornato, ✗ assente)"
|
||||
},
|
||||
{
|
||||
"section": "File ProxMenux",
|
||||
"source": "controllo filesystem",
|
||||
"contentRich": "<code>menu</code>, <code>utils.sh</code>, <code>config.json</code>, <code>version.txt</code> presenza + percorsi"
|
||||
},
|
||||
{
|
||||
"section": "File di traduzione",
|
||||
"source": "/usr/local/share/proxmenux/lang/",
|
||||
"content": "Presenza della directory lang/ inclusa in ogni installazione"
|
||||
},
|
||||
{
|
||||
"section": "Lingua attuale",
|
||||
"source": "config.json",
|
||||
"contentRich": "Codice lingua da <code>.language</code>; usa <code>en</code> se non impostato"
|
||||
}
|
||||
]
|
||||
},
|
||||
"sampleHeading": "Esempio di output",
|
||||
"manualHeading": "Equivalenti manuali",
|
||||
"troubleshoot": {
|
||||
"heading": "Risoluzione dei problemi",
|
||||
"unknownTitle": "La versione mostra \"Unknown\"",
|
||||
"unknownBody": "<code>/usr/local/share/proxmenux/version.txt</code> è mancante o illeggibile. Il più spesso causato da un'installazione parziale. Reinstallare dalla sorgente ufficiale ProxMenux.",
|
||||
"noConfigTitle": "Nessuna informazione di installazione disponibile",
|
||||
"noConfigBody": "<code>config.json</code> manca. Senza questo file lo script non può elencare i componenti. Reinstalla per ricrearlo.",
|
||||
"wrongStatusTitle": "Un componente mostra ✗ anche se sono sicuro di averlo installato",
|
||||
"wrongStatusBody": "Significa che <code>config.json</code> non registra quel componente come installato: potrebbe trattarsi di uno script che non si registra ancora, oppure di una installazione manuale eseguita senza ProxMenux. La finestra riflette il contenuto di <code>config.json</code>, non lo stato effettivo del disco."
|
||||
},
|
||||
"related": {
|
||||
"heading": "Correlati",
|
||||
"items": [
|
||||
{
|
||||
"href": "/docs/settings/uninstall-proxmenux",
|
||||
"label": "Disinstalla ProxMenux",
|
||||
"tail": "— rimuovere tutti questi file."
|
||||
},
|
||||
{
|
||||
"href": "/docs/settings",
|
||||
"label": "Panoramica delle impostazioni",
|
||||
"tail": "."
|
||||
}
|
||||
]
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,92 @@
|
||||
{
|
||||
"meta": {
|
||||
"title": "Disinstalla ProxMenux | Documentazione ProxMenux",
|
||||
"description": "Disinstallazione pulita di ProxMenux con rimozione facoltativa di jq e dialog, pulizia dei vecchi file di traduzione e del servizio Monitor e ripristino dei backup di sistema.",
|
||||
"ogTitle": "Disinstalla ProxMenux | Documentazione ProxMenux",
|
||||
"ogDescription": "Pulitamente rimuovere ProxMenux da un host Proxmox con pulizia di dipendenza opzionale."
|
||||
},
|
||||
"header": {
|
||||
"title": "Disinstalla ProxMenux",
|
||||
"description": "Rimuove ProxMenux dall'host Proxmox con un processo interattivo: conferma, rimozione facoltativa delle dipendenze, pulizia del servizio ProxMenux Monitor e ripristino dei backup di /root/.bashrc e /etc/motd. Mostra una barra di avanzamento per tutta la durata del processo.",
|
||||
"section": "Impostazioni"
|
||||
},
|
||||
"scopeWarn": {
|
||||
"title": "Riguarda solo l'installazione di ProxMenux, non VM / CT / archiviazione",
|
||||
"body": "La disinstallazione rimuove gli script ProxMenux, il lanciatore del menu, il servizio Monitor facoltativo e i backup dei file di sistema creati da ProxMenux durante l'installazione. <strong>Non modifica VM, container, archiviazione, configurazione di rete, Fail2Ban, driver NVIDIA o qualsiasi altro elemento installato tramite ProxMenux.</strong> Questi rimangono invariati."
|
||||
},
|
||||
"flow": {
|
||||
"heading": "Procedura di disinstallazione",
|
||||
"items": [
|
||||
"<strong>Finestra di conferma.</strong> Sì/no: «Vuoi davvero disinstallare ProxMenux?»",
|
||||
"<strong>Elenco delle dipendenze da rimuovere.</strong> Propone jq e dialog. Entrambe le caselle sono deselezionate; scegli solo le dipendenze che nessun'altra applicazione richiede.",
|
||||
"<strong>La rimozione mostra una barra di avanzamento.</strong> Rimuove ogni vecchio ambiente di traduzione rimasto, il lanciatore <code>menu</code>, la struttura <code>/usr/local/share/proxmenux/</code>, il servizio ProxMenux Monitor se presente insieme alla destinazione di notifica registrata in Proxmox VE (<code>proxmenux-webhook</code> e la relativa regola di corrispondenza), le dipendenze selezionate e infine ripristina i backup dei file di sistema (vedi sotto).",
|
||||
"<strong>Finestra di completamento.</strong> Elenca le dipendenze rimosse e termina."
|
||||
]
|
||||
},
|
||||
"deps": {
|
||||
"heading": "Rimozione della dipendenza: cosa è offerto",
|
||||
"intro": "La lista propone jq e dialog. <strong>Nessuna casella è selezionata per impostazione predefinita</strong>: altre applicazioni potrebbero usare questi pacchetti di sistema, quindi è più sicuro conservarli.",
|
||||
"headerType": "Installazione",
|
||||
"headerOffered": "Offerto per la rimozione",
|
||||
"rows": [
|
||||
{
|
||||
"type": "Versioni attuali",
|
||||
"offeredRich": "<code>dialog</code>, <code>jq</code>"
|
||||
},
|
||||
{
|
||||
"type": "Vecchie installazioni dopo l'aggiornamento",
|
||||
"offeredRich": "<code>dialog</code>, <code>jq</code>"
|
||||
}
|
||||
],
|
||||
"warnTitle": "Pacchetti a livello di sistema — pensare due volte",
|
||||
"warnBody": "La lista attuale propone <code>jq</code> e <code>dialog</code>, non <code>python3</code>. Altri strumenti potrebbero richiedere questi pacchetti di sistema. La rimozione può eliminare anche pacchetti dipendenti o dipendenze inutilizzate. Conserva i pacchetti necessari e controlla ogni proposta di rimozione prima di eseguire apt manualmente."
|
||||
},
|
||||
"removed": {
|
||||
"heading": "Cosa viene rimosso",
|
||||
"code": "/usr/local/bin/menu # the launcher\n/usr/local/share/proxmenux/ # everything: scripts, config, cache, version\n/opt/googletrans-env/ # leftover legacy translation environment\n/etc/systemd/system/proxmenux-monitor.service # Monitor service unit\n/root/.config/proxmenux-monitor/ # Monitor config dir\n # + dependencies you ticked in the checklist"
|
||||
},
|
||||
"restored": {
|
||||
"heading": "Che cosa viene ripristinato",
|
||||
"items": [
|
||||
"Se <code>/root/.bashrc.bak</code> esiste, viene rinominato in <code>/root/.bashrc</code> (ripristinando il file bashrc originale).",
|
||||
"Se <code>/etc/motd.bak</code> esiste, viene rinominato in <code>/etc/motd</code>. Altrimenti sed rimuove dal motd esistente la riga ProxMenux (<em>“This system is optimised by: ProxMenux”</em>)."
|
||||
]
|
||||
},
|
||||
"othersCallout": {
|
||||
"title": "Gli altri componenti installati da ProxMenux rimangono",
|
||||
"body": "Tutto ciò che ProxMenux è installato tramite altri menu — Fail2Ban, Lynis, NVIDIA driver, modifiche post-installazione — <strong>non</strong> viene toccato da questo programma di disinstallazione. Ognuno ha il proprio flusso di disinstallazione all'interno del rispettivo menu (oppure puoi rimuoverlo direttamente con apt). Guarda prima <em>Mostra informazioni sulla versione</em> per vedere cosa è registrato."
|
||||
},
|
||||
"manual": {
|
||||
"heading": "Disinstallazione manuale",
|
||||
"intro": "Se per qualche motivo il disinstallatore del menu non può essere eseguito (ad es. <code>dialog</code> già mancante), la sequenza manuale equivalente:",
|
||||
"code": "# 1. Stop and remove the Monitor service (if installed)\nsystemctl stop proxmenux-monitor.service 2>/dev/null\nsystemctl disable proxmenux-monitor.service 2>/dev/null\nrm -f /etc/systemd/system/proxmenux-monitor.service\nrm -rf /root/.config/proxmenux-monitor\nsystemctl daemon-reload\nsystemctl reset-failed 2>/dev/null\n\n# 2. Remove a leftover legacy translation environment\nrm -rf /opt/googletrans-env\n\n# 3. Remove ProxMenux files\nrm -f /usr/local/bin/menu\nrm -rf /usr/local/share/proxmenux\n\n# 4. Restore backups\n[ -f /root/.bashrc.bak ] && mv /root/.bashrc.bak /root/.bashrc\n[ -f /etc/motd.bak ] && mv /etc/motd.bak /etc/motd \\\n || sed -i '/This system is optimised by: ProxMenux/d' /etc/motd"
|
||||
},
|
||||
"reinstall": {
|
||||
"heading": "Reinstallare più tardi",
|
||||
"body": "Esegui di nuovo il programma di installazione ufficiale di ProxMenux. Le versioni attuali usano un'unica modalità di installazione che include tutte le otto lingue dell'interfaccia."
|
||||
},
|
||||
"troubleshoot": {
|
||||
"heading": "Risoluzione dei problemi",
|
||||
"hangTitle": "La disinstallazione si blocca durante la rimozione di un vecchio ambiente di traduzione",
|
||||
"hangBody": "Le versioni attuali rimuovono un ambiente residuo con <code>rm -rf /opt/googletrans-env</code>; non eseguono <code>pip uninstall</code>. Se questo passaggio si blocca, esaminalo da un'altra shell e verifica il filesystem dell'host prima di riprovare.",
|
||||
"aptTitle": "apt segnala pacchetti ancora in uso durante la rimozione delle dipendenze",
|
||||
"aptBody": "I pacchetti selezionati vengono contrassegnati come automatici e passati a <code>apt-get -y --purge autoremove</code>. Questo non garantisce la protezione dei servizi dipendenti. Lascia deselezionate le dipendenze necessarie ad altri strumenti e controlla le rimozioni proposte da apt prima di qualsiasi pulizia manuale.",
|
||||
"motdTitle": "MOTD mostra ancora la linea ProxMenux dopo la disinstallazione",
|
||||
"motdBody": "Può accadere se <code>/etc/motd.bak</code> non esisteva e sed non ha trovato la riga (per esempio perché era stata modificata). Modifica <code>/etc/motd</code> manualmente e rimuovi ogni riga ProxMenux rimasta."
|
||||
},
|
||||
"related": {
|
||||
"heading": "Correlati",
|
||||
"items": [
|
||||
{
|
||||
"href": "/docs/settings/show-version-information",
|
||||
"label": "Mostra informazioni sulla versione",
|
||||
"tail": " — verifica cosa verrebbe rimosso prima di disinstallare."
|
||||
},
|
||||
{
|
||||
"href": "/docs/settings",
|
||||
"label": "Panoramica delle impostazioni",
|
||||
"tail": "."
|
||||
}
|
||||
]
|
||||
}
|
||||
}
|
||||
Reference in New Issue
Block a user