mirror of
https://github.com/MacRimi/ProxMenux.git
synced 2026-11-02 10:52:22 +00:00
docs: review post-install documentation in all seven translations
This commit is contained in:
Jonatan
@@ -0,0 +1,172 @@
|
||||
{
|
||||
"meta": {
|
||||
"title": "Script post-installazione automatizzato | Documentazione ProxMenux",
|
||||
"description": "Lo script post-installazione automatizzato ProxMenux esegue 14 ottimizzazioni predefinite in base all’hardware su un nuovo host Proxmox VE. Non presenta una lista di funzioni da selezionare, ma può chiedere conferma per rimuovere l’avviso di abbonamento, alcune installazioni Log2RAM e il riavvio. Le modifiche reversibili vengono registrate.",
|
||||
"ogTitle": "Script post-installazione automatizzato | Documentazione ProxMenux",
|
||||
"ogDescription": "14 ottimizzazioni predefinite in base all’hardware per un nuovo host Proxmox VE, con conferme per alcune azioni e registrazione delle modifiche reversibili."
|
||||
},
|
||||
"header": {
|
||||
"title": "Script post-installazione automatizzato",
|
||||
"description": "ProxMenux esegue 14 ottimizzazioni di base predefinite senza lista di funzioni da selezionare. Alcune azioni chiedono conferma. Le modifiche reversibili vengono registrate per Disinstalla ottimizzazioni; gli aggiornamenti dei pacchetti non sono descritti come reversibili.",
|
||||
"section": "Post-Install · Automatizzato"
|
||||
},
|
||||
"intro": {
|
||||
"title": "Quando scegliere l’installazione automatizzata",
|
||||
"body": "Eseguilo su un host Proxmox appena installato per ottenere una configurazione di base senza scegliere ogni funzione. Lo script è idempotente: una seconda esecuzione riapplica le stesse impostazioni. Le funzioni opzionali (Fastfetch, IOMMU, repository Ceph, HA, correzioni AMD…) <strong>non</strong> fanno parte di questo percorso; sceglile da <link>Personalizzabile</link> se ti servono."
|
||||
},
|
||||
"applies": {
|
||||
"heading": "Cosa applica lo script",
|
||||
"intro": "Le ottimizzazioni vengono applicate in questo ordine preciso. La colonna <em>Categoria</em> rimanda alla documentazione dettagliata di ogni modifica nella guida personalizzabile.",
|
||||
"headerNum": "#",
|
||||
"headerTool": "Strumento",
|
||||
"headerWhat": "Che cosa fa",
|
||||
"headerCategory": "Categoria"
|
||||
},
|
||||
"optimizations": [
|
||||
{
|
||||
"tool": "Repository APT + aggiornamento completo",
|
||||
"what": "Disabilita le sorgenti Enterprise pve-enterprise.sources e ceph.sources, crea una sorgente no-subscription per il nome in codice Debian dell’host, quindi esegue apt update && apt full-upgrade -y (comando ufficiale di aggiornamento Proxmox).",
|
||||
"category": "Impostazioni di base",
|
||||
"categorySlug": "basic-settings"
|
||||
},
|
||||
{
|
||||
"tool": "Rimozione dell’avviso di abbonamento",
|
||||
"what": "Modifica l’interfaccia web per nascondere l’avviso «Nessun abbonamento valido». Chiede conferma prima di applicare; reversibile da Disinstalla ottimizzazioni.",
|
||||
"category": "Personalizzazione",
|
||||
"categorySlug": "customization"
|
||||
},
|
||||
{
|
||||
"tool": "Forza IPv4",
|
||||
"what": "Scrive /etc/apt/apt.conf.d/99-force-ipv4 affinché apt usi solo IPv4, evitando collegamenti IPv6 instabili ai mirror.",
|
||||
"category": "Rete",
|
||||
"categorySlug": "network"
|
||||
},
|
||||
{
|
||||
"tool": "Salta i pacchetti di lingua",
|
||||
"what": "Scrive /etc/apt/apt.conf.d/99-disable-translations per non scaricare più gli indici delle descrizioni tradotte dei pacchetti, riducendo i dati degli aggiornamenti apt.",
|
||||
"category": "Impostazioni di base",
|
||||
"categorySlug": "basic-settings"
|
||||
},
|
||||
{
|
||||
"tool": "Aumentare i limiti del sistema",
|
||||
"what": "Aumenta le risorse di monitoraggio inotify, i limiti nofile/nproc, quelli del portachiavi del kernel e fs.file-max tramite sysctl.d, limits.d, pam e systemd, per host con molti container.",
|
||||
"category": "Sistema",
|
||||
"categorySlug": "system"
|
||||
},
|
||||
{
|
||||
"tool": "Regolazione della memoria",
|
||||
"what": "Imposta vm.swappiness=10, rapporti bilanciati di pagine modificate non ancora scritte, vm.max_map_count=262144 e compattazione proattiva se supportata. La politica di overcommit della memoria del kernel resta quella predefinita di Proxmox.",
|
||||
"category": "Sistema",
|
||||
"categorySlug": "system"
|
||||
},
|
||||
{
|
||||
"tool": "Comportamento in caso di kernel panic",
|
||||
"what": "Configura l’host per riavviarsi 10 secondi dopo un panic / oops / hardlockup invece di restare bloccato indefinitamente.",
|
||||
"category": "Sistema",
|
||||
"categorySlug": "system"
|
||||
},
|
||||
{
|
||||
"tool": "Regolazione dello stack di rete",
|
||||
"what": "Dimensioni dei buffer TCP, rafforzamento IPv4 (redirect disattivati, rp_filter=2, registrazione martian disattivata), porte locali 1024-65535, rilevamento MTU TCP, RFC 1337 e script /usr/local/sbin/proxmenux-fwbr-tune collegato a un’unità systemd a esecuzione singola e una regola udev. Così rp_filter=0 / log_martians=0 vengono riapplicati alle interfacce fwbr*/fwln*/fwpr*/tap* ogni volta che Proxmox le ricrea all’avvio/arresto delle VM, al riavvio o alla migrazione live.",
|
||||
"category": "Rete",
|
||||
"categorySlug": "network"
|
||||
},
|
||||
{
|
||||
"tool": "Personalizzazione Bashrc (root)",
|
||||
"what": "PS1 colorato, alias comuni (l/la/ll/ls/grep), cronologia con data e ora e caricamento di bash-completion, dentro un blocco delimitato PMX_CORE_BASHRC facile da rimuovere.",
|
||||
"category": "Personalizzazione",
|
||||
"categorySlug": "customization"
|
||||
},
|
||||
{
|
||||
"tool": "Log2RAM (ottimizzato per SSD, automatico)",
|
||||
"what": "Riduce l’usura SSD/NVMe spostando /var/log in un ramdisk tmpfs sincronizzato periodicamente sul disco. Installazione dal progetto upstream quando il disco root è SSD o NVMe. Dimensione in base alla RAM dell’host (128M / 256M / 512M), sincronizzazione periodica e protezione automatica che elimina vecchi journal all’80% e tronca i log molto attivi al 92% prima della scrittura. Adatta i limiti journald al ramdisk. Dettagli su <link>Log2RAM</link>.",
|
||||
"category": "Archiviazione",
|
||||
"categorySlug": "storage"
|
||||
},
|
||||
{
|
||||
"tool": "Autotrim ZFS (solo SSD)",
|
||||
"what": "Attiva zpool autotrim=on su ogni pool ZFS i cui vdev siano tutti SSD o NVMe con supporto TRIM, controllando /sys/block/[dev]/queue/rotational e discard_granularity. I pool su HDD vengono saltati. Per la disinstallazione registra solo i pool realmente modificati da ProxMenux; quelli su cui hai attivato autotrim manualmente restano invariati.",
|
||||
"category": "Archiviazione",
|
||||
"categorySlug": "storage"
|
||||
},
|
||||
{
|
||||
"tool": "Limiti di dimensione di journald",
|
||||
"what": "Forza l’archiviazione persistente, limita SystemMaxUse=64M / RuntimeMaxUse=60M e abilita compressione e log di livello info richiesti da Monitor. Viene saltato se Log2RAM è attivo, perché esegue la propria regolazione.",
|
||||
"category": "Sistema",
|
||||
"categorySlug": "system"
|
||||
},
|
||||
{
|
||||
"tool": "Regolazione di logrotate",
|
||||
"what": "Imposta globalmente daily seguito da size 10M, conserva 7 rotazioni e abilita compressione e copytruncate. Il criterio di dimensione successivo prevale; le regole specifiche possono sovrascriverlo. Adatto a Log2RAM, ma la frequenza dipende da regole e timer.",
|
||||
"category": "Sistema",
|
||||
"categorySlug": "system"
|
||||
},
|
||||
{
|
||||
"tool": "Nomi di interfaccia persistenti",
|
||||
"what": "Scrive un file <code>/etc/systemd/network/10-proxmenux-<iface>.link</code> per scheda fisica, con intestazione «Managed by ProxMenux», che associa il MAC al nome attuale. I nomi <code>eth0</code> / <code>enp…</code> restano stabili dopo riavvii e aggiunte di schede.",
|
||||
"category": "Rete",
|
||||
"categorySlug": "network"
|
||||
}
|
||||
],
|
||||
"hardwareTitle": "Impostazioni predefinite in base all’hardware",
|
||||
"hardwareBody": "Lo script legge l'hardware dell'host prima di applicare le impostazioni. Log2RAM è installato solo su dischi SSD/root NVMe per impostazione predefinita (richiede se il rilevamento indica diversamente). La dimensione del disco ram Log2RAM viene scelta dal totale RAM (<code>≤ 8 GB → 128M</code>, <code>≤ 16 GB → 256M</code>, <code>'>' 16 GB → 512M</code>). I limiti del journald vengono adattati alla dimensione del ramdisk quando Log2RAM è attivo, per evitare di riempirlo.",
|
||||
"upgrade": {
|
||||
"heading": "Aggiorna gli elenchi dei pacchetti e il sistema",
|
||||
"intro": "Il primo passo del pacchetto automatizzato è l'aggiornamento Proxmox. La guida di aggiornamento di Proxmox per un host in esecuzione (nella stessa versione principale) è quella di eseguire:",
|
||||
"after": "Questa riga è il comando ufficiale delle versioni attuali di Proxmox. Lo script automatizzato esegue <strong>esattamente</strong> questo e aggiunge la pulizia dei repository e le operazioni successive consigliate dalla guida — come l’utilità separata <link>Aggiornamento del sistema Proxmox</link>:",
|
||||
"items": [
|
||||
"Disabilita le sorgenti Enterprise <code>pve-enterprise.sources</code> / <code>ceph.sources</code>, rimuove i vecchi file dei repository e crea una sorgente no-subscription per il nome in codice dell’host.",
|
||||
"Esegue l’aggiornamento senza interazione con <code>DEBIAN_FRONTEND=noninteractive</code> e <code>--force-confdef --force-confold</code>: conserva i file personalizzati anche quando sono cambiati nel progetto originale.",
|
||||
"Installa pacchetti Proxmox essenziali se mancanti (<code>zfsutils-linux</code>, <code>proxmox-backup-restore-image</code>, <code>chrony</code>).",
|
||||
"Controllo di coerenza dei metadati LVM, <code>apt-get autoremove -y</code> + <code>apt-get autoclean -y</code> e richiesta di riavvio solo se il kernel è cambiato."
|
||||
],
|
||||
"sameTitle": "Stesso aggiornamento, due punti di ingresso",
|
||||
"sameBody": "Il bundle automatizzato e l'utilità standalone <link>Proxmox System Update</link> condividono gli stessi script sottostanti (<code>update-pve8.sh</code> / <code>update-pve9_2.sh</code>). Utilizzare l'utilità da solo quando si desidera aggiornare l'host solo senza applicare il resto delle ottimizzazioni."
|
||||
},
|
||||
"endResult": {
|
||||
"heading": "Risultato finale previsto",
|
||||
"body": "Al termine vedrai un messaggio di successo con l’output di ogni passaggio e una richiesta di riavvio, necessario per alcune impostazioni del kernel. Puoi rimandarlo: le impostazioni si applicheranno al prossimo avvio.",
|
||||
"imageAlt": "Script post-installazione automatizzato — output finale del terminale con ogni ottimizzazione applicata correttamente"
|
||||
},
|
||||
"notDoes": {
|
||||
"heading": "Che cosa questo script NON fa",
|
||||
"items": [
|
||||
"Rilevamento automatico del fuso orario (commentato nel sorgente; usa Personalizzabile se ti serve).",
|
||||
"Disattivare portmapper / rpcbind (vedi <secLink>Sicurezza</secLink>).",
|
||||
"Abilitare IOMMU / VFIO (vedi <virtLink>Virtualizzazione</virtLink>).",
|
||||
"Installare Fastfetch / Figurine / repository Ceph / HA / correzioni CPU AMD (vedi <optLink>Opzionali</optLink>).",
|
||||
"Installare pigz o regolare ZFS ARC (vedi <perfLink>Prestazioni</perfLink> / <storLink>Archiviazione</storLink>)."
|
||||
]
|
||||
},
|
||||
"xshokTitle": "rilevamento xshok-proxmox",
|
||||
"xshokBody": "Se l'host ha precedentemente eseguito lo script <code>xshok-proxmox</code>, ProxMenux rileva il file marcatore e ti avvisa prima di continuare. Alcune modifiche possono sovrapporsi. Lo script compagno è deprecato — se si decide di continuare comunque, rivedere <link> la panoramica</link> per contesto.",
|
||||
"revert": {
|
||||
"heading": "Ripristino",
|
||||
"body": "Ogni strumento della tabella viene registrato in <code>/usr/local/share/proxmenux/installed_tools.json</code>. Apri <link>Disinstalla ottimizzazioni</link> per scegliere quali elementi ripristinare. Le copie dei file modificati sono accanto agli originali con suffisso <code>.bak</code>."
|
||||
},
|
||||
"related": {
|
||||
"heading": "Correlati",
|
||||
"items": [
|
||||
{
|
||||
"label": "Post-installazione personalizzabile",
|
||||
"href": "/docs/post-install/customizable",
|
||||
"tail": "— scegli esattamente quello che vuoi dallo stesso catalogo."
|
||||
},
|
||||
{
|
||||
"label": "Disinstalla ottimizzazioni",
|
||||
"href": "/docs/post-install/uninstall",
|
||||
"tail": "— ripristinare qualsiasi sottoinsieme di ciò che è stato applicato qui."
|
||||
},
|
||||
{
|
||||
"label": "Comandi di sistema utili",
|
||||
"href": "/docs/help-info/system-commands",
|
||||
"tail": " — verifica le modifiche (uptime, free, journalctl, ecc.)."
|
||||
},
|
||||
{
|
||||
"label": "Panoramica post-install",
|
||||
"href": "/docs/post-install",
|
||||
"tail": "."
|
||||
}
|
||||
]
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,240 @@
|
||||
{
|
||||
"meta": {
|
||||
"title": "Post-Install: Impostazioni di base | Documentazione ProxMenux",
|
||||
"description": "Opzioni di base post-installazione: passare ai repository Proxmox senza abbonamento e aggiornare il sistema, rilevare il fuso orario e attivare NTP, saltare le traduzioni APT e scegliere tra 25 utilità comuni da installare."
|
||||
},
|
||||
"header": {
|
||||
"title": "Post-Install: Impostazioni di base",
|
||||
"section": "Impostazioni post-installazione Proxmox"
|
||||
},
|
||||
"intro": {
|
||||
"title": "Che cosa copre questa categoria",
|
||||
"body": "Cinque opzioni di base per un host Proxmox nuovo: passare ai repository della community senza abbonamento, aggiornare tutto il sistema, configurare automaticamente fuso orario e NTP, disattivare le traduzioni APT per risparmiare banda e spazio e scegliere tra 25 utilità comuni."
|
||||
},
|
||||
"upgrade": {
|
||||
"heading": "Aggiorna gli elenchi dei pacchetti e il sistema",
|
||||
"intro": "Riconfigura APT per utilizzare il repository gratuito <em>pve-no-subscription</em> (invece del repo aziendale che richiede un abbonamento) e gestisce un aggiornamento completo del sistema. I passaggi esatti dipendono dalla versione principale di Proxmox VE: ProxMenux lo rileva e invia allo script giusto.",
|
||||
"headerVersion": "Versione PVE",
|
||||
"headerScript": "Script di selezione per versione",
|
||||
"headerCodename": "Nome in codice Debian",
|
||||
"rows": [
|
||||
{
|
||||
"version": "9.x",
|
||||
"script": "update-pve9_2.sh",
|
||||
"codename": "trixie"
|
||||
},
|
||||
{
|
||||
"version": "8.x",
|
||||
"script": "update-pve8.sh",
|
||||
"codename": "bookworm"
|
||||
}
|
||||
],
|
||||
"officialTitle": "Raccomandazione ufficiale Proxmox",
|
||||
"officialBody": "La guida ufficiale Proxmox consiglia questi comandi in quest’ordine:",
|
||||
"officialOutro": "È il comando usuale per aggiornare all’interno della stessa versione principale di Proxmox VE. Controlla i repository e le modifiche proposte ai pacchetti <em>prima</em> di procedere. Il passaggio a un’altra versione principale richiede la procedura ufficiale di migrazione.",
|
||||
"doesTitle": "Ciò che l'opzione ProxMenux fa — verificata contro lo script",
|
||||
"doesIntro": "L’aggiornamento ProxMenux esegue i comandi apt indicati e aggiunge passaggi preliminari e finali che altrimenti dovresti gestire manualmente. L’elenco seguente corrisponde allo script di selezione; vedi <link>Aggiornamento del sistema Proxmox</link> per tutti i dettagli.",
|
||||
"doesItems": [
|
||||
"<strong>Prima di tutto, sistemare i repository.</strong> Disabilita i repository enterprise <code>pve-enterprise.sources</code> / <code>ceph.sources</code>, elimina i vecchi file dei repository rimasti dalle precedenti versioni di PVE e scrive un file <code>proxmox.sources</code> pulito che punta al canale gratuito <em>pve-no-subscription</em>, corrispondente al nome in codice Debian dell'host: trixie per PVE 9, bookworm per PVE 8.",
|
||||
"<strong>Riscrive i repository Debian</strong> con main / updates / security e <code>non-free-firmware</code>, eliminando l’avviso del firmware durante l’aggiornamento.",
|
||||
"<strong>Esegue l’aggiornamento ufficiale.</strong> <code>apt-get update</code> seguito da <code>apt full-upgrade -y</code> (PVE 9) oppure <code>apt dist-upgrade -y</code> (PVE 8), senza interazione con <code>--force-confdef --force-confold</code> per mantenere i file di configurazione personalizzati.",
|
||||
"<strong>Installa i pacchetti essenziali</strong> se mancanti: <code>zfsutils-linux</code>, <code>proxmox-backup-restore-image</code>, <code>chrony</code>.",
|
||||
"<strong>Controlla i metadati LVM.</strong> Cerca VM con passthrough dei dischi che potrebbero aver lasciato vecchie intestazioni di volumi fisici sui dischi grezzi. Segnala anomalie senza correzioni automatiche.",
|
||||
"<strong>Pulisce al termine:</strong> <code>apt-get autoremove -y</code> + <code>apt-get autoclean -y</code>, poi chiede il riavvio se il kernel è stato aggiornato o esiste <code>/var/run/reboot-required</code>."
|
||||
],
|
||||
"shortTitle": "In breve",
|
||||
"shortBody": "L’opzione esegue il comando consigliato <code>apt update && apt full-upgrade -y</code>, aggiunge la sistemazione dei repository e la pulizia finale indicate nella guida ufficiale e chiede il riavvio al termine. Vedi <link>Aggiornamento del sistema Proxmox</link> per il diagramma completo: lo stesso strumento è disponibile separatamente nel menu principale.",
|
||||
"subTitle": "Non applicare a un host con abbonamento",
|
||||
"subBody": "Se hai un abbonamento Proxmox e vuoi mantenere i repository Enterprise, salta l’opzione. Disabilita Enterprise e passa al canale della community. L’aggiornamento dei pacchetti e la riscrittura dei repository non sono reversibili da Disinstalla ottimizzazioni; riconfigura esplicitamente i repository per cambiare canale in seguito.",
|
||||
"safetyTitle": "Controllo di sicurezza post-update",
|
||||
"safetyBody": "Dopo l’aggiornamento, lo script cerca vecchi metadati di volumi fisici (PV) sui dischi. Può accadere quando una VM con passthrough scrive intestazioni LVM su un disco grezzo. Se rileva qualcosa di sospetto, avvisa e suggerisce <code>pvs</code> per l’ispezione. Nessuna azione automatica."
|
||||
},
|
||||
"time": {
|
||||
"heading": "Sincronizza l’ora automaticamente",
|
||||
"intro": "Rileva l'IP pubblico del server tramite <code>dig myip.opendns.com @resolver1.opendns.com</code>, quindi chiede a <code>ipapi.co/'{'ip'}'/timezone</code> di cercare il fuso orario IANA corrispondente e applicarlo con <code>timedatectl set-timezone</code>. Infine consente NTP con <code>timedatectl set-ntp true</code>.",
|
||||
"depTitle": "Dipende da due servizi esterni",
|
||||
"depBody": "La ricerca si basa su OpenDNS e <code>ipapi.co</code> raggiungibile, e sulle loro risposte sono corrette. Se si esegue Proxmox dietro una VPN o su un VLAN che evade da una regione diversa, il fuso orario auto-detected potrebbe essere sbagliato. In questo caso saltare questa opzione e impostare il fuso orario a mano:",
|
||||
"revertTitle": "Reversibile dal menu Disinstalla",
|
||||
"revertBody": "<link>Disinstalla ottimizzazioni</link> reimposta il fuso orario su UTC, un valore sicuro. NTP resta attivo: l’orologio continua a sincronizzarsi e mostra UTC finché non imposti un altro fuso."
|
||||
},
|
||||
"languages": {
|
||||
"heading": "Salta il download di lingue aggiuntive",
|
||||
"intro": "Durante <code>apt update</code>, APT può scaricare descrizioni tradotte dei pacchetti oltre ai metadati principali. L’opzione le disattiva per risparmiare banda e spazio. Prima, ProxMenux <strong>verifica che la locale dell’host sia generata</strong>: legge <code>/etc/default/locale</code> o <code>/etc/environment</code>, aggiunge a <code>/etc/locale.gen</code> se manca ed esegue <code>locale-gen</code>. Le impostazioni locali della shell restano quindi intatte.",
|
||||
"writtenTitle": "Cosa si scrive",
|
||||
"revertTitle": "Reversibile dal menu Disinstalla",
|
||||
"revertBody": "Cancellare <code>/etc/apt/apt.conf.d/99-disable-translations</code> (sia manualmente che dal menu Disinstalla) ripristina il comportamento predefinito e APT scarica nuovamente i file di lingua."
|
||||
},
|
||||
"utilities": {
|
||||
"heading": "Installa utilità di sistema comuni",
|
||||
"intro": "Apre una lista di <strong>25 utilità selezionate</strong> in gruppi. Scegli e conferma: ProxMenux le installa con <code>apt</code>, verifica il risultato e mostra un riepilogo finale.",
|
||||
"imageAlt": "Selettore delle utilità ProxMenux: Spazio per selezionare, Invio per confermare",
|
||||
"reuseTitle": "La stessa lista viene riutilizzata altrove",
|
||||
"reuseBody": "Il catalogo di 25 utilità è definito in un solo punto: <code>PROXMENUX_UTILS</code> in <code>scripts/global/utils-install-functions.sh</code>. Il menu <em>Utilità e strumenti → Utilità di sistema</em> mostra la stessa lista per aggiungerne altre in seguito senza ripetere la post-installazione.",
|
||||
"listTitle": "Cosa c'è nella lista",
|
||||
"groups": [
|
||||
{
|
||||
"group": "Monitor di sistema",
|
||||
"items": [
|
||||
{
|
||||
"pkg": "htop",
|
||||
"desc": "Visualizzatore interattivo dei processi"
|
||||
},
|
||||
{
|
||||
"pkg": "btop",
|
||||
"desc": "Monitor di risorse moderne (CPU, RAM, dischi, rete, processi)"
|
||||
},
|
||||
{
|
||||
"pkg": "s-tui",
|
||||
"desc": "Interfaccia terminale per stress test e monitoraggio CPU"
|
||||
},
|
||||
{
|
||||
"pkg": "iftop",
|
||||
"desc": "Uso della larghezza di banda per connessione in tempo reale"
|
||||
},
|
||||
{
|
||||
"pkg": "iotop",
|
||||
"desc": "I/O disco per processo"
|
||||
},
|
||||
{
|
||||
"pkg": "iptraf-ng",
|
||||
"desc": "Monitor LAN IP interattivo"
|
||||
}
|
||||
]
|
||||
},
|
||||
{
|
||||
"group": "Rete",
|
||||
"items": [
|
||||
{
|
||||
"pkg": "iperf3",
|
||||
"desc": "Misura la larghezza di banda massima raggiungibile tra gli host"
|
||||
},
|
||||
{
|
||||
"pkg": "net-tools",
|
||||
"desc": "Strumenti legacy (ifconfig, netstat, route). Ancora utile per i controlli rapidi."
|
||||
},
|
||||
{
|
||||
"pkg": "ipset",
|
||||
"desc": "Gestire grandi set IP nel kernel — utile con le regole iptables/nftables."
|
||||
}
|
||||
]
|
||||
},
|
||||
{
|
||||
"group": "Download e archivi",
|
||||
"items": [
|
||||
{
|
||||
"pkg": "axel",
|
||||
"desc": "Acceleratore di download parallelo leggero"
|
||||
},
|
||||
{
|
||||
"pkg": "aria2",
|
||||
"desc": "Downloader multi-source / multi-protocollo (HTTP, FTP, BitTorrent, Metalink)"
|
||||
},
|
||||
{
|
||||
"pkg": "unzip",
|
||||
"desc": "Estrarre archivi ZIP"
|
||||
},
|
||||
{
|
||||
"pkg": "zip",
|
||||
"desc": "Crea archivi ZIP"
|
||||
},
|
||||
{
|
||||
"pkg": "cabextract",
|
||||
"desc": "Estrarre archivi Microsoft CAB (utile con le ISO di Windows)"
|
||||
},
|
||||
{
|
||||
"pkg": "wimtools",
|
||||
"desc": "Gestire immagini WIM di Windows (estrarre, dividere, montare, applicare)"
|
||||
},
|
||||
{
|
||||
"pkg": "genisoimage",
|
||||
"desc": "Costruisci immagini ISO 9660 da un albero di directory"
|
||||
}
|
||||
]
|
||||
},
|
||||
{
|
||||
"group": "Testo e file",
|
||||
"items": [
|
||||
{
|
||||
"pkg": "dos2unix",
|
||||
"desc": "Convertire i terminatori di riga CRLF (Windows) in LF (Unix)"
|
||||
},
|
||||
{
|
||||
"pkg": "grc",
|
||||
"desc": "Colorazione generica: applica l’evidenziazione della sintassi all’output di ping, traceroute, dig, tail e altri comandi"
|
||||
},
|
||||
{
|
||||
"pkg": "plocate",
|
||||
"desc": "Ricerca file veloce (indicizzata). Eseguire `updatedb` dopo l'installazione per costruire l'indice."
|
||||
}
|
||||
]
|
||||
},
|
||||
{
|
||||
"group": "Accesso remoto e sessioni",
|
||||
"items": [
|
||||
{
|
||||
"pkg": "sshpass",
|
||||
"desc": "Autenticazione SSH con password senza interazione (utile negli script, non nell’uso quotidiano)"
|
||||
},
|
||||
{
|
||||
"pkg": "tmux",
|
||||
"desc": "Multiplexer di terminale: scollegare sessioni, dividere pannelli e mantenere le sessioni dopo una disconnessione"
|
||||
}
|
||||
]
|
||||
},
|
||||
{
|
||||
"group": "Hardware e basso livello",
|
||||
"items": [
|
||||
{
|
||||
"pkg": "msr-tools",
|
||||
"desc": "Lettura/scrittura dei registri specifici del modello CPU (rdmsr, wrmsr)"
|
||||
},
|
||||
{
|
||||
"pkg": "intel-gpu-tools",
|
||||
"desc": "Utilità diagnostiche Intel GPU tra cui `intel_gpu_top`"
|
||||
}
|
||||
]
|
||||
},
|
||||
{
|
||||
"group": "Virtualizzazione",
|
||||
"items": [
|
||||
{
|
||||
"pkg": "libguestfs-tools",
|
||||
"desc": "Ispezionare e modificare immagini disco VM (virt-ls, virt-cat, guestmount...)"
|
||||
},
|
||||
{
|
||||
"pkg": "chntpw",
|
||||
"desc": "Modifica SAM di Windows — utile per il recupero di password su VM Windows che eredite"
|
||||
}
|
||||
]
|
||||
}
|
||||
],
|
||||
"actionTitle": "Alcuni di loro in azione",
|
||||
"noBulkTitle": "Vengono rimosse solo le utilità installate da ProxMenux",
|
||||
"noBulkBody": "ProxMenux registra solo i pacchetti selezionati che non erano già installati. Disinstalla ottimizzazioni li rimuove completamente e conserva quelli già presenti. Gli aggiornamenti APT non hanno un ripristino atomico sicuro: disinstallare le utilità non annulla l’aggiornamento del sistema."
|
||||
},
|
||||
"related": {
|
||||
"heading": "Correlati",
|
||||
"items": [
|
||||
{
|
||||
"label": "Aggiornamento sistema Proxmox",
|
||||
"href": "/docs/utils/system-update",
|
||||
"tail": " — Riesegue il ciclo apt update + dist-upgrade su richiesta."
|
||||
},
|
||||
{
|
||||
"label": "Installatore delle utilità di sistema",
|
||||
"href": "/docs/utils/system-utils",
|
||||
"tail": "— installare (o reinstallare) le utilità singolarmente dopo l'installazione."
|
||||
},
|
||||
{
|
||||
"label": "Comandi aggiornamenti e pacchetti",
|
||||
"href": "/docs/help-info/update-commands",
|
||||
"tail": " — Riferimento apt per la shell."
|
||||
},
|
||||
{
|
||||
"label": "Post-installazione personalizzabile",
|
||||
"href": "/docs/post-install/customizable",
|
||||
"tail": " — torna al menu superiore."
|
||||
}
|
||||
]
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,106 @@
|
||||
{
|
||||
"meta": {
|
||||
"title": "Script post-installazione personalizzabile | Documentazione ProxMenux",
|
||||
"description": "Scegli esattamente quali ottimizzazioni applicare a un host Proxmox VE con ProxMenux. 10 categorie, circa 35 strumenti e un’interfaccia con caselle di selezione. Include tutto lo script Automatizzato, più opzioni esplicite (IOMMU, Fastfetch, Figurine, Ceph, HA, correzioni AMD…).",
|
||||
"ogTitle": "Script post-installazione personalizzabile | Documentazione ProxMenux",
|
||||
"ogDescription": "10 categorie, circa 35 ottimizzazioni individuali. Scegli esattamente cosa vuoi su un host Proxmox VE. Le modifiche reversibili sono registrate."
|
||||
},
|
||||
"header": {
|
||||
"title": "Script post-installazione personalizzabile",
|
||||
"description": "Scegli esattamente quali ottimizzazioni applicare a un host Proxmox VE. ProxMenux raggruppa circa 35 strumenti in 10 categorie in un’unica finestra con caselle di selezione. Lo stesso motore di Automatizzato, con controllo completo sulle modifiche.",
|
||||
"section": "Post-installazione · Personalizzabile"
|
||||
},
|
||||
"intro": {
|
||||
"title": "Quando scegliere Personalizzabile",
|
||||
"body": "Scegli questa opzione se sai già quali regolazioni vuoi o non vuoi sull’host. Una lista con caselle raggruppate per categoria permette di selezionare, deselezionare e combinare le ottimizzazioni. Puoi riapplicarle in seguito; le modifiche reversibili sono registrate per <link>Disinstalla ottimizzazioni</link>. Gli aggiornamenti dei pacchetti non sono presentati come reversibili."
|
||||
},
|
||||
"compare": {
|
||||
"heading": "Confronto con Automatizzato",
|
||||
"body": "Personalizzabile include tutto lo <link>script Automatizzato</link>: le stesse 14 ottimizzazioni di base e molte opzioni che Automatizzato omette intenzionalmente, utili per hardware specifico (correzioni AMD), hosting specifico (OVH RTM) o carichi particolari (IOMMU/VFIO, repository Ceph, alta disponibilità, Fastfetch, Figurine, regolazione dell’ARC ZFS, pigz, istantanee ZFS automatiche, limiti di velocità vzdump, Open vSwitch, TCP BBR…)."
|
||||
},
|
||||
"categoriesSection": {
|
||||
"heading": "Le 10 categorie",
|
||||
"body": "Lo script Personalizzabile raggruppa le ottimizzazioni in 10 categorie in un’unica finestra con caselle di selezione. Ogni categoria ha una pagina di documentazione: apri una scheda per motivazioni, valori predefiniti e verifiche di ogni opzione."
|
||||
},
|
||||
"categories": [
|
||||
{
|
||||
"name": "Impostazioni di base",
|
||||
"description": "Pulisce le sorgenti APT, esegue l’aggiornamento ufficiale Proxmox e imposta fuso orario, impostazioni locali e utilità comuni. La base di tutte le altre categorie."
|
||||
},
|
||||
{
|
||||
"name": "Sistema",
|
||||
"description": "Regola i log e i limiti del kernel per un host che ospita molte VM e container. Include journald, logrotate, sysctl (memoria, limiti dei file), comportamento in caso di kernel panic e riavvii rapidi."
|
||||
},
|
||||
{
|
||||
"name": "Virtualizzazione",
|
||||
"description": "Prepara l’host per la virtualizzazione avanzata. Installa l’agente guest adatto quando Proxmox stesso gira in una VM supportata e abilita IOMMU/VFIO per il passthrough PCI di GPU, controller e TPU."
|
||||
},
|
||||
{
|
||||
"name": "Rete",
|
||||
"description": "Rafforza e regola lo stack di rete dell’host. Forza APT su IPv4, applica impostazioni di sicurezza sysctl e buffer TCP, offre Open vSwitch, TCP BBR e TCP Fast Open e associa nomi persistenti delle interfacce agli indirizzi MAC."
|
||||
},
|
||||
{
|
||||
"name": "Archiviazione",
|
||||
"description": "Configura i comuni sottosistemi di archiviazione Proxmox: dimensione dell’ARC ZFS, istantanee ZFS automatiche, autotrim ZFS per pool SSD/NVMe e limiti di velocità vzdump per evitare di saturare i dischi durante i backup."
|
||||
},
|
||||
{
|
||||
"name": "Sicurezza",
|
||||
"description": "Riduce la superficie di attacco esposta per impostazione predefinita. Disattiva i servizi RPC portmapper/rpcbind che Proxmox non richiede ma lascia in ascolto."
|
||||
},
|
||||
{
|
||||
"name": "Personalizzazione",
|
||||
"description": "Modificare l'esperienza visiva e shell dell'ospite: colori e alias in bashrc, banner MOTD e rimozione dell'avviso di abbonamento nell'interfaccia utente web."
|
||||
},
|
||||
{
|
||||
"name": "Monitoraggio",
|
||||
"description": "Integra l’host con OVH Real-Time Monitoring. Installa RTM solo se ProxMenux rileva un server OVH; sugli altri host non apporta modifiche."
|
||||
},
|
||||
{
|
||||
"name": "Prestazioni",
|
||||
"description": "Accelerare le operazioni di compressione (backup, trasferimenti) sostituendo gzip con la sua controparte parallela pigz."
|
||||
},
|
||||
{
|
||||
"name": "Opzionale",
|
||||
"description": "Opzioni specializzate non necessarie a tutti gli host: correzioni CPU AMD, banner Fastfetch, nome host 3D con Figurine, aggiornamento dell’indice PVE Appliance Manager, repository Ceph, servizi di alta disponibilità, Log2RAM per ridurre l’usura degli SSD e profilo swap ZRAM."
|
||||
}
|
||||
],
|
||||
"mixTip": {
|
||||
"title": "Combina Automatizzato e Personalizzabile",
|
||||
"body": "Un uso comune: esegui prima <strong>Automatizzato</strong> per la configurazione di base, poi apri <strong>Personalizzabile</strong> e scegli solo gli strumenti opzionali utili, come IOMMU per il passthrough GPU. Le modifiche sono registrate separatamente; Disinstalla mostra tutto ciò che hai applicato, indipendentemente dalla modalità usata."
|
||||
},
|
||||
"related": {
|
||||
"heading": "Correlati",
|
||||
"items": [
|
||||
{
|
||||
"label": "Post-installazione automatizzata",
|
||||
"href": "/docs/post-install/automated",
|
||||
"tail": " — impostazioni predefinite ragionevoli applicate senza domande."
|
||||
},
|
||||
{
|
||||
"label": "Disinstalla ottimizzazioni",
|
||||
"href": "/docs/post-install/uninstall",
|
||||
"tail": " — annulla in modo pulito le opzioni selezionate."
|
||||
},
|
||||
{
|
||||
"label": "Impostazioni di base",
|
||||
"href": "/docs/post-install/basic-settings",
|
||||
"tail": "— repos, tempo, lingua, utilità."
|
||||
},
|
||||
{
|
||||
"label": "Virtualizzazione",
|
||||
"href": "/docs/post-install/virtualization",
|
||||
"tail": "— IOMMU + VFIO per il passaggio."
|
||||
},
|
||||
{
|
||||
"label": "Sicurezza",
|
||||
"href": "/docs/post-install/security",
|
||||
"tailRich": " · <storageLink>Archiviazione</storageLink> · <networkLink>Rete</networkLink> · <customLink>Personalizzazione</customLink> — altre categorie."
|
||||
},
|
||||
{
|
||||
"label": "Panoramica post-installazione",
|
||||
"href": "/docs/post-install",
|
||||
"tail": "."
|
||||
}
|
||||
]
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,74 @@
|
||||
{
|
||||
"meta": {
|
||||
"title": "Post-Install: Personalizzazione | Documentazione ProxMenux",
|
||||
"description": "Opzioni di personalizzazione nello script post-installazione personalizzabile di ProxMenux: prompt bash colorato con alias utili, banner ProxMenux nel MOTD e rimozione dell’avviso di abbonamento dall’interfaccia web Proxmox."
|
||||
},
|
||||
"header": {
|
||||
"title": "Dopo l'installazione: personalizzazione",
|
||||
"description": "Regolazioni estetiche e pratiche per l’host Proxmox. Rendono la shell più piacevole e nascondono l’avviso di abbonamento nell’interfaccia web. Bashrc, MOTD e banner sono registrati e reversibili dal menu Disinstalla.",
|
||||
"section": "Impostazioni post-installazione Proxmox"
|
||||
},
|
||||
"intro": {
|
||||
"title": "Che cosa copre questa categoria",
|
||||
"body": "Tre piccole opzioni indipendenti: un <strong>prompt bash colorato con alias</strong> per la shell root, un <strong>banner MOTD</strong> di una riga visibile all’accesso SSH e la rimozione della <strong>finestra «Nessun abbonamento valido»</strong> mostrata a ogni accesso all’interfaccia web Proxmox."
|
||||
},
|
||||
"bashrc": {
|
||||
"heading": "Personalizza bashrc",
|
||||
"intro": "Inserisce in <code>/root/.bashrc</code> un blocco con prompt colorato, cronologia con data e ora, alias standard di <code>ls</code> / <code>grep</code> e un <code>source</code> per il completamento bash. Migliora il lavoro via SSH e rende chiaro su quale host ti trovi quando hai molte schede aperte.",
|
||||
"writesTitle": "Ciò che ProxMenux aggiunge a .bashrc",
|
||||
"writesOutro": "Il blocco è delimitato dai marcatori <code>PMX_CORE_BASHRC</code>. Eseguire di nuovo lo script sostituisce il blocco precedente senza duplicarlo. L’originale <code>.bashrc</code> viene salvato una volta in <code>/root/.bashrc.bak</code> e una riga <code>source /root/.bashrc</code> viene aggiunta a <code>/root/.bash_profile</code> per applicare il prompt anche alle shell di login, ad esempio dopo <code>su -</code>.",
|
||||
"rootTitle": "Si applica solo a root",
|
||||
"rootBody": "La personalizzazione si applica alla shell dell’account root. Gli altri utenti creati sull’host mantengono le proprie impostazioni predefinite. Se amministri Proxmox esclusivamente dall’interfaccia web e non usi mai la shell, questa opzione ha solo un effetto estetico e puoi saltarla."
|
||||
},
|
||||
"motd": {
|
||||
"heading": "Imposta un banner MOTD personalizzato",
|
||||
"intro": "Antepone <em>\"This system is optimised by: ProxMenux\"</em> a <code>/etc/motd</code>, il messaggio dopo un accesso SSH riuscito, sopra il prompt e prima degli script <code>update-motd</code>. Innocuo e puramente informativo: conferma a colpo d’occhio che ProxMenux è stato applicato sull’host.",
|
||||
"writesTitle": "Cosa scrive ProxMenux",
|
||||
"writesOutro": "Alla prima applicazione, ProxMenux registra se <code>/etc/motd</code> esisteva e ne salva il contenuto originale in <code>/usr/local/share/proxmenux</code>. L’operazione è idempotente: se la riga identificativa è già presente, non viene aggiunta. Le installazioni precedenti con <code>/etc/motd.bak</code> vengono migrate allo stesso stato reversibile."
|
||||
},
|
||||
"banner": {
|
||||
"heading": "Rimuovi il banner di abbonamento",
|
||||
"intro": "Rimuove la finestra <em>«Non hai un abbonamento valido per questo server»</em> che appare a ogni accesso web Proxmox senza abbonamento Enterprise. ProxMenux tiene conto della versione e avvia lo script adatto ai diversi pacchetti dell’interfaccia delle versioni principali.",
|
||||
"versionTitle": "Scelta dello script in base alla versione",
|
||||
"versionItems": [
|
||||
"<strong>PVE 9.x</strong> → esegue <code>remove-banner-pve-v3.sh</code>, che modifica <code>proxmoxlib.js</code> per desktop e la nuova interfaccia mobile basata su Yew.",
|
||||
"<strong>PVE 8.x</strong> → esegue <code>remove-banner-pve8.sh</code>, solo per l’interfaccia desktop."
|
||||
],
|
||||
"versionOutro": "Prima della modifica, ProxMenux salva i file JS/template originali in <code>/usr/local/share/proxmenux/backups/</code> con data e ora. Disinstalla usa queste copie per ripristinarli; se il backup manca o è danneggiato, reinstalla i pacchetti dell’interfaccia Proxmox.",
|
||||
"breakTitle": "Può rompersi dopo gli aggiornamenti di Proxmox",
|
||||
"breakBody": "Gli aggiornamenti dell’interfaccia Proxmox sovrascrivono spesso <code>proxmoxlib.js</code> e possono far tornare l’avviso. Puoi riapplicare l’opzione per modificare il file oppure accettare l’avviso fino ad allora. ProxMenux installa anche un hook APT che riapplica la modifica dopo gli aggiornamenti dei pacchetti: vedi <link>Disinstalla ottimizzazioni</link> per rimuoverlo.",
|
||||
"legalTitle": "Nota legale (sempre vale la pena ripetere)",
|
||||
"legalBody": "Questa opzione nasconde solo l’avviso dell’interfaccia. <strong>Non</strong> concede supporto Enterprise o accesso al repository Enterprise e non cambia la licenza del software. Proxmox VE è distribuito sotto GNU AGPLv3. Un abbonamento sostiene il progetto e dà accesso al canale di aggiornamento Enterprise: scegli il supporto adatto al tuo ambiente."
|
||||
},
|
||||
"verify": {
|
||||
"heading": "Verifica",
|
||||
"intro": "Dopo aver applicato tutti e tre:",
|
||||
"reversibleTitle": "Tutti e tre i cambiamenti di personalizzazione sono tracciati",
|
||||
"reversibleBody": "<link>Disinstalla ottimizzazioni</link> ripristina <code>/root/.bashrc</code>, riporta MOTD al contenuto esatto precedente a ProxMenux o elimina il file se prima non esisteva e ripristina i file dell’interfaccia modificati dal backup oppure reinstalla i pacchetti necessari."
|
||||
},
|
||||
"related": {
|
||||
"heading": "Correlati",
|
||||
"items": [
|
||||
{
|
||||
"label": "Opzionale",
|
||||
"href": "/docs/post-install/optional",
|
||||
"tail": " — Fastfetch e Figurine, altre personalizzazioni visive."
|
||||
},
|
||||
{
|
||||
"label": "Mostra informazioni sulla versione",
|
||||
"href": "/docs/settings/show-version-information",
|
||||
"tail": " — conferma che le personalizzazioni sono registrate come installate."
|
||||
},
|
||||
{
|
||||
"label": "Disinstalla ottimizzazioni",
|
||||
"href": "/docs/post-install/uninstall",
|
||||
"tail": " — ripristina bashrc, motd e l’avviso di abbonamento."
|
||||
},
|
||||
{
|
||||
"label": "Post-installazione personalizzabile",
|
||||
"href": "/docs/post-install/customizable",
|
||||
"tail": " — torna al menu superiore."
|
||||
}
|
||||
]
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,106 @@
|
||||
{
|
||||
"meta": {
|
||||
"title": "Script post-installazione di Proxmox VE — Automatizzato e personalizzabile | ProxMenux",
|
||||
"description": "Panoramica degli script post-installazione di ProxMenux per Proxmox VE. Automatizzato applica impostazioni predefinite ragionevoli senza domande; Personalizzabile permette di scegliere esattamente cosa applicare in 10 categorie; Disinstalla ottimizzazioni ripristina le modifiche reversibili supportate.",
|
||||
"ogTitle": "Script post-installazione di Proxmox VE — Automatizzato e personalizzabile",
|
||||
"ogDescription": "Applica le comuni ottimizzazioni post-installazione di Proxmox VE in 10 categorie, automaticamente o a scelta, con opzioni reversibili.",
|
||||
"twitterTitle": "Script dopo l'installazione di Proxmox VE | ProxMenux",
|
||||
"twitterDescription": "Ottimizzazione post-installazione automatizzata e personalizzabile per Proxmox VE — con opzioni reversibili."
|
||||
},
|
||||
"header": {
|
||||
"title": "Script dopo l'installazione",
|
||||
"description": "Configura un host Proxmox VE appena installato con le ottimizzazioni post-installazione di ProxMenux. Applica automaticamente la configurazione di base, scegli le singole opzioni, aggiorna le funzioni installate o ripristina le modifiche reversibili supportate. Gli aggiornamenti dei pacchetti non sono presentati come reversibili.",
|
||||
"section": "Impostazioni post-installazione Proxmox"
|
||||
},
|
||||
"intro": {
|
||||
"title": "A cosa serve questo menu",
|
||||
"body": "Dopo l’installazione di Proxmox VE, decine di piccole modifiche rendono l’host più veloce e più facile da mantenere: repository senza abbonamento, limiti ragionevoli per journald, buffer TCP adeguati, salvataggio dei log che preserva gli SSD, miglioramenti di bashrc e altro. ProxMenux le automatizza e registra le modifiche di configurazione reversibili supportate."
|
||||
},
|
||||
"openingMenu": {
|
||||
"heading": "Apertura del menu",
|
||||
"body": "Dal menu principale di ProxMenux, selezionare <strong>Impostazioni post-installazione Proxmox</strong>. Vedrai questo:",
|
||||
"imageAlt": "Menu degli script post-installazione: Automatizzato, Personalizzabile, la voce condizionale Applica aggiornamenti disponibili (solo se ci sono aggiornamenti in attesa) e Disinstalla, seguiti dalla sezione Script della community"
|
||||
},
|
||||
"threeWays": {
|
||||
"heading": "Quattro modi per applicare le ottimizzazioni",
|
||||
"body": "Le quattro voci ProxMenux condividono lo stesso codice e registro degli strumenti installati, offrendo diversi livelli di controllo. <em>Applica aggiornamenti disponibili</em> compare solo se almeno un’ottimizzazione installata ha una versione su disco più recente di quella registrata; resta nascosta su un host appena configurato."
|
||||
},
|
||||
"routes": [
|
||||
{
|
||||
"title": "Automatizzato",
|
||||
"description": "Una serie curata di 14 ottimizzazioni sicure e sempre utili applicate in sequenza con zero prompt. Buon default per la maggior parte degli utenti.",
|
||||
"bullets": [
|
||||
"Repository senza abbonamento + aggiornamento del sistema",
|
||||
"Memoria, kernel, rete tuning",
|
||||
"Log2RAM (rilevamento automatico su SSD/NVMe)",
|
||||
"Limiti di dimensione Journald + logrotate",
|
||||
"Nomi di interfaccia persistenti"
|
||||
]
|
||||
},
|
||||
{
|
||||
"title": "Personalizzabile",
|
||||
"description": "Circa 35 ottimizzazioni individuali in 10 categorie. Scegli esattamente quali applicare. Lo stesso motore di Automatizzato, con controllo completo.",
|
||||
"bullets": [
|
||||
"Interfaccia con caselle di selezione per categoria",
|
||||
"Include tutto ciò che fa Automatizzato, più opzioni da attivare esplicitamente (IOMMU, Fastfetch, Figurine, Ceph, HA, correzioni AMD…)",
|
||||
"Eseguilo quante volte vuoi: le modifiche sono idempotenti"
|
||||
]
|
||||
},
|
||||
{
|
||||
"title": "Applica aggiornamenti disponibili",
|
||||
"description": "Quando un’ottimizzazione post-installazione (Log2Ram, impostazioni della memoria, Logrotate…) ha una versione su disco più recente di quella registrata sull’host, questa voce mostra solo quelle cambiate. Esegue di nuovo la funzione corrispondente e aggiorna il registro, senza toccare altro.",
|
||||
"bullets": [
|
||||
"Scelta esplicita per ogni ottimizzazione, solo quelle cambiate",
|
||||
"Lo stesso selettore è disponibile nella dashboard di Monitor",
|
||||
"Un’unica notifica raggruppata quando arrivano nuovi aggiornamenti"
|
||||
]
|
||||
},
|
||||
{
|
||||
"title": "Disinstalla ottimizzazioni",
|
||||
"description": "Le modifiche reversibili supportate sono registrate in un registro JSON e associate a una funzione di ripristino. Le azioni senza un ripristino sicuro, come un aggiornamento completo dei pacchetti, sono escluse intenzionalmente.",
|
||||
"bullets": [
|
||||
"Rileva automaticamente le ottimizzazioni precedentemente applicate",
|
||||
"Sceglie il ripristino adatto a ogni voce: ripristina il backup .bak, se creato, elimina il frammento di configurazione sysctl.d se non serviva alcun backup oppure reinstalla il pacchetto originale con --force-confnew (ad esempio per il banner dell’abbonamento)",
|
||||
"Richiesta di riavvio se necessario (VFIO, nomi persistenti, ecc.)"
|
||||
]
|
||||
}
|
||||
],
|
||||
"whichTitle": "Quale dovrebbe scegliere?",
|
||||
"whichBody": "Per una nuova installazione Proxmox con una configurazione di base ragionevole senza decisioni: <autoLink><strong>Automatizzato</strong></autoLink>. Se sai già quali regolazioni vuoi o non vuoi: <customLink><strong>Personalizzabile</strong></customLink>. Per aggiornare solo un’ottimizzazione già applicata di cui esiste una versione più recente su disco: <updatesLink><strong>Applica aggiornamenti disponibili</strong></updatesLink>. Per annullare in modo pulito modifiche precedenti: <uninstallLink><strong>Disinstalla ottimizzazioni</strong></uninstallLink>. Puoi combinarli: prima Automatizzato, poi aggiungi opzioni come Fastfetch o IOMMU con Personalizzabile e annulla singole voci in seguito.",
|
||||
"mixing": {
|
||||
"heading": "Combinare con altri script post-installazione",
|
||||
"stackTitle": "Non impilare più script post-installazione",
|
||||
"stackBody": "Eseguire più script post-installazione sullo stesso host può creare file di configurazione duplicati, voci sysctl in conflitto o persino interrompere la rete dopo il riavvio. Se hai già applicato <strong>Helper-Scripts Post Install</strong>, alcune ottimizzazioni ProxMenux possono sovrapporsi alla sua configurazione. Usa un solo strumento post-installazione per host.",
|
||||
"xshokTitle": "xshok-proxmox: deprecato",
|
||||
"xshokBody": "Le versioni precedenti di ProxMenux indicavano <a>xshok-proxmox</a> come strumento post-installazione complementare. Il progetto è ora deprecato e non è più offerto da ProxMenux. Se una vecchia esecuzione ha lasciato marcatori sull’host, ProxMenux li rileva ancora e avvisa. Oggi non è però uno strumento da installare accanto a ProxMenux."
|
||||
},
|
||||
"community": {
|
||||
"heading": "Script della community",
|
||||
"body": "Il menu offre anche due script di terze parti del progetto <a>community-scripts</a>: <em>Proxmox VE Post Install</em> e <em>Proxmox VE Microcode</em>. Sono wrapper che scaricano ed eseguono gli script originali tramite <code>wget | bash</code>. ProxMenux non li mantiene. Vedi <link>Repository esterni</link> per dettagli e valutazioni sull’affidabilità prima di eseguirli."
|
||||
},
|
||||
"related": {
|
||||
"heading": "Correlati",
|
||||
"items": [
|
||||
{
|
||||
"label": "Aggiornamento sistema Proxmox",
|
||||
"href": "/docs/utils/system-update",
|
||||
"tail": "— mantiene l'host aggiornato una volta che è stato post-installato."
|
||||
},
|
||||
{
|
||||
"label": "Sicurezza",
|
||||
"href": "/docs/security",
|
||||
"tail": " — Fail2Ban + Lynis oltre alle misure di sicurezza post-installazione."
|
||||
},
|
||||
{
|
||||
"label": "Mostra informazioni sulla versione",
|
||||
"href": "/docs/settings/show-version-information",
|
||||
"tail": "— vedere quali componenti post-installazione vengono tracciati come installati."
|
||||
},
|
||||
{
|
||||
"label": "Comandi aggiornamenti e pacchetti",
|
||||
"href": "/docs/help-info/update-commands",
|
||||
"tail": "— riferimento per apt / pveupgrade."
|
||||
}
|
||||
]
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,56 @@
|
||||
{
|
||||
"meta": {
|
||||
"title": "Post-Install: Monitoraggio | Documentazione ProxMenux",
|
||||
"description": "Opzioni di monitoraggio nello script ProxMenux Personalizzabile post-installazione. Attualmente un'unica opzione: installare OVH Real-Time Monitoring (RTM), che si attiva solo se l'host viene rilevato come server OVH."
|
||||
},
|
||||
"header": {
|
||||
"title": "Dopo l'installazione: monitoraggio",
|
||||
"description": "Opzioni di monitoraggio all'interno dello script di installazione post personalizzabile. Questa categoria è piccola e specifica del fornitore — installa l'agente di monitoraggio OVH in tempo reale su server OVH dedicati e non fa nulla altrove.",
|
||||
"section": "Impostazioni post-installazione Proxmox"
|
||||
},
|
||||
"intro": {
|
||||
"title": "Ambito volutamente limitato",
|
||||
"body": "Il monitoraggio post-installazione si limita a <strong>un agente specifico di un fornitore</strong>. Gli strumenti generici (Prometheus, Grafana, node_exporter) sono esclusi perché richiedono scelte architetturali — host separato, conservazione dei dati, destinazioni degli avvisi — che non si adattano a un passaggio con un clic. ProxMenux Monitor, incluso in ProxMenux, svolge gran parte di quel ruolo senza agenti esterni."
|
||||
},
|
||||
"ovh": {
|
||||
"heading": "Installare il monitoraggio in tempo reale OVH (RTM)",
|
||||
"intro": "Se il vostro host Proxmox è un server dedicato affittato da <a>OVHcloud</a>, è possibile attivare RTM per esporre la telemetria hardware (CPU temperatura, stato PSU, disco SMART, stato del controller RAID, ecc.) al pannello di controllo OVH. Questo è lo stesso agente OVH utilizza per la propria funzione \"Server Monitoring\".",
|
||||
"decisionsTitle": "Come decide ProxMenux",
|
||||
"decisionsItems": [
|
||||
"Ottiene l'IP pubblico dell'host tramite <code>curl ipinfo.io/ip</code>.",
|
||||
"Cerca il provider proprietario tramite una query <code>whois</code> a <code>v4.whois.cymru.com</code>.",
|
||||
"Se il risultato menziona OVH, scarica <code>last-public-ovh-infra-yak.snap.mirrors.ovh.net/yak/archives/apply.sh</code> e lo passa a <code>bash</code> con il manifest Puppet di RTM v2.",
|
||||
"Se il risultato <em>non</em> menziona OVH, non è installato nulla. L'opzione è una no-op."
|
||||
],
|
||||
"remoteTitle": "Script remoto passato a bash tramite pipe",
|
||||
"remoteBody": "L’installazione esegue <code>wget -qO - https://…apply.sh | bash</code>. Se il mirror OVH viene compromesso, lo script viene eseguito come root sull’host. Prima di attivare l’opzione, valuta la fiducia nella catena dei mirror OVH rispetto al beneficio del monitoraggio. Per la maggior parte degli utenti domestici o non OVH, l’opzione dovrebbe restare disattivata.",
|
||||
"noOpTitle": "Attiva solo se l'host è effettivamente in OVH",
|
||||
"noOpBody": "L’opzione non modifica i server non OVH, quindi selezionarla su un Proxmox domestico non rompe nulla. Su un host non OVH lo script mostra <em>«Non è un server OVH, installazione RTM saltata»</em> e termina senza installare pacchetti.",
|
||||
"runsTitle": "Cosa esegue ProxMenux",
|
||||
"verifyTitle": "Verifica",
|
||||
"verifyBody": "Su un vero host OVH, dopo il riavvio dovresti vedere la <a>dashboard RTM</a> in OVH Manager con dati dell’host in tempo reale. Sul lato Proxmox, il raccoglitore RTM è un servizio systemd: controllalo direttamente:",
|
||||
"troubleTitle": "Risoluzione dei problemi",
|
||||
"revertTitle": "Rimuovi RTM dal menu Disinstalla",
|
||||
"revertBody": "Se RTM è registrato come installato, Disinstalla ottimizzazioni offre una voce OVH Real-Time Monitoring. Esegue <code>apt-get purge -y ''ovh-rtm*'' ''rtm'' ''rtm-*''</code>, elimina /etc/rtm e registra RTM come disinstallato. I residui Puppet possono richiedere pulizia manuale: controlla i manifest specifici di RTM in <code>/etc/puppet/</code>. Su un host non OVH non sono stati installati pacchetti RTM, quindi non c’è nulla da rimuovere."
|
||||
},
|
||||
"related": {
|
||||
"heading": "Correlati",
|
||||
"items": [
|
||||
{
|
||||
"label": "ProxMenux Monitor",
|
||||
"href": "/docs/settings/proxmenux-monitor",
|
||||
"tail": "— dashboard web locale per l'host (lavora su qualsiasi fornitore, non solo OVH)."
|
||||
},
|
||||
{
|
||||
"label": "Comandi di sistema utili",
|
||||
"href": "/docs/help-info/system-commands",
|
||||
"tail": " — riferimento per il monitoraggio dell’host locale."
|
||||
},
|
||||
{
|
||||
"label": "Post-installazione personalizzabile",
|
||||
"href": "/docs/post-install/customizable",
|
||||
"tail": " — torna al menu superiore."
|
||||
}
|
||||
]
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,128 @@
|
||||
{
|
||||
"meta": {
|
||||
"title": "Post-installazione: Rete | Documentazione ProxMenux",
|
||||
"description": "Opzioni di rete dello script post-installazione personalizzabile ProxMenux: forzare APT su IPv4, applicare un profilo sysctl selezionato, installare Open vSwitch, abilitare TCP BBR + Fast Open e associare i nomi delle interfacce ai loro indirizzi MAC."
|
||||
},
|
||||
"header": {
|
||||
"title": "Post-Install: Rete",
|
||||
"section": "Impostazioni post-installazione Proxmox"
|
||||
},
|
||||
"intro": {
|
||||
"title": "Che cosa copre questa categoria",
|
||||
"body": "Cinque opzioni di rete indipendenti. Due sono semplici (<strong>APT su IPv4</strong>, <strong>installazione di Open vSwitch</strong>), due regolano il comportamento TCP (<strong>profilo sysctl di rete</strong>, <strong>BBR + Fast Open</strong>) e una risolve un problema comune: <strong>fissare i nomi delle interfacce</strong>, affinché una nuova scheda di rete o un aggiornamento BIOS non rinomini <code>enp3s0</code> in <code>enp4s0</code> e non interrompa i bridge."
|
||||
},
|
||||
"ipv4": {
|
||||
"heading": "Forza APT a usare IPv4",
|
||||
"intro": "Scrive <code>Acquire::ForceIPv4 \"true\";</code> a <code>/etc/apt/apt.conf.d/99-force-ipv4</code>. APT si rifiuta quindi di utilizzare IPv6 per i download dei pacchetti, anche se l'host ha connettività IPv6.",
|
||||
"tipTitle": "Chi beneficia",
|
||||
"tipBody": "Utile se la connessione IPv6 è instabile, più lenta di IPv4 o se il mirror Debian/Proxmox a volte non funziona su IPv6. Non crea problemi sugli host senza IPv6. Su una rete dual stack funzionante rende il comportamento prevedibile: apt non ti sorprenderà con un timeout IPv6."
|
||||
},
|
||||
"sysctl": {
|
||||
"heading": "Applica ottimizzazioni di rete",
|
||||
"intro": "Scrive un profilo sysctl selezionato in <code>/etc/sysctl.d/99-network.conf</code>: buffer dei socket del kernel, rafforzamento di ICMP, protezione di base dallo spoofing e dimensioni dei buffer TCP adatte a un hypervisor con molti flussi simultanei.",
|
||||
"tunedTitle": "Cosa viene regolato",
|
||||
"headerArea": "Settore",
|
||||
"headerSettings": "Impostazioni chiave",
|
||||
"rows": [
|
||||
{
|
||||
"area": "Buffer dei socket del kernel",
|
||||
"settings": "<code>netdev_max_backlog=8192</code>, <code>rmem_max=16M</code>, <code>wmem_max=16M</code>, <code>somaxconn=8192</code>"
|
||||
},
|
||||
{
|
||||
"area": "Rafforzamento di ICMP",
|
||||
"settings": "<code>icmp_echo_ignore_broadcasts=1</code>, <code>icmp_ignore_bogus_error_responses=1</code>"
|
||||
},
|
||||
{
|
||||
"area": "Sicurezza del routing",
|
||||
"settings": "<code>accept_redirects=0</code>, <code>accept_source_route=0</code>, <code>secure_redirects=0</code>, <code>send_redirects=0</code>, <code>log_martians=0</code>"
|
||||
},
|
||||
{
|
||||
"area": "Filtro percorso inverso",
|
||||
"settings": "<code>rp_filter=2</code> (modalità permissiva, vedi nota sotto)"
|
||||
},
|
||||
{
|
||||
"area": "TCP",
|
||||
"settings": "<code>tcp_mtu_probing=1</code>, <code>tcp_rfc1337=1</code>, <code>tcp_sack=1</code>, <code>tcp_rmem=8K/87K/16M</code>, <code>tcp_wmem=8K/64K/16M</code>"
|
||||
},
|
||||
{
|
||||
"area": "Porte",
|
||||
"settings": "<code>ip_local_port_range=1024 65535</code> (insieme delle porte effimere)"
|
||||
},
|
||||
{
|
||||
"area": "Socket Unix",
|
||||
"settings": "<code>net.unix.max_dgram_qlen=4096</code>"
|
||||
}
|
||||
],
|
||||
"sourceOutro": "Aggiunge anche <code>source /etc/network/interfaces.d/*</code> a <code>/etc/network/interfaces</code> se non già presente — pratica standard in modo da poter rilasciare frammenti di interfaccia modulare senza modificare il file principale.",
|
||||
"fwbrTitle": "Regolazione automatica dei bridge del firewall virtuale",
|
||||
"fwbrBody": "Insieme al profilo sysctl, ProxMenux installa lo script ausiliario <code>/usr/local/sbin/proxmenux-fwbr-tune</code>, che applica <code>rp_filter=0</code> e <code>log_martians=0</code> alle interfacce <code>fwbr*</code> / <code>fwln*</code> / <code>fwpr*</code> / <code>tap*</code> create da Proxmox per VM e container. L’unità a esecuzione singola <code>proxmenux-fwbr-tune.service</code> lo avvia al boot; la regola <code>/etc/udev/rules.d/99-zz-proxmenux-fwbr-tune.rules</code> a ogni evento <code>net add</code> corrispondente a questi prefissi. Copre quindi le interfacce ricreate all’avvio o all’arresto delle VM, al riavvio e durante la migrazione live. Lo script elabora anche le interfacce già presenti subito dopo l’installazione.",
|
||||
"rpFilterTitle": "Perché rp_filter=2 (permissivo) invece di 1 (rigoroso)",
|
||||
"rpFilterBody": "Il filtro del percorso inverso rigoroso scarta i pacchetti la cui sorgente sarebbe raggiungibile tramite un’interfaccia <em>diversa</em>. È un’impostazione predefinita adatta ai client, ma problematica su un host Proxmox dove il traffico VM spesso arriva su un bridge ed esce da un uplink con percorsi asimmetrici. <code>rp_filter=2</code> (permissivo) scarta solo pacchetti con sorgenti realmente non raggiungibili tramite routing. Il compromesso riduce leggermente il rilevamento dello spoofing IP locale per non interrompere la rete delle VM."
|
||||
},
|
||||
"ovs": {
|
||||
"heading": "Installa Open vSwitch",
|
||||
"intro": "Installa <code>openvswitch-switch</code> + <code>openvswitch-common</code>. I pacchetti aggiungono OVS come alternativa ai bridge Linux predefiniti di Proxmox. La sola installazione non cambia la rete: i bridge <code>vmbrX</code> esistenti continuano a funzionare. Quando <em>crei</em> un nuovo bridge nell’interfaccia Proxmox, puoi scegliere OVS dall’elenco dei tipi.",
|
||||
"tipTitle": "Quando OVS ha senso",
|
||||
"tipBody": "Valuta OVS se ti servono <strong>trunk VLAN con ID non contigui</strong>, <strong>LACP con LLDP in modalità specifiche</strong>, <strong>programmazione dettagliata dei flussi</strong> (OpenFlow) o interoperabilità con controller SDN. Per un laboratorio domestico con poche VLAN e un solo uplink LACP, i bridge Linux + <code>vmbrX.VID</code> sono più semplici e adeguati.",
|
||||
"revertTitle": "Reversibile dal menu Disinstalla",
|
||||
"revertBody": "OVS viene registrato. <link>Disinstalla ottimizzazioni</link> esegue <code>apt purge</code> su <code>openvswitch-switch</code> e <code>openvswitch-common</code>. Migra i bridge OVS a bridge Linux <em>prima</em> della disinstallazione, altrimenti le VM su quei bridge perderanno la rete al prossimo avvio. Equivalente manuale:"
|
||||
},
|
||||
"bbr": {
|
||||
"heading": "Abilita TCP BBR + TCP Fast Open",
|
||||
"intro": "Scrive due file sysctl e li ricarica. BBR sostituisce CUBIC con l’algoritmo di congestione di Google basato sulla banda, che gestisce meglio collegamenti ad alta capacità e latenza o con perdite. TCP Fast Open (TFO) elimina un’andata e ritorno sulle connessioni TCP ripetute inviando dati nel SYN.",
|
||||
"verifyTitle": "Verifica",
|
||||
"impactTitle": "L'impatto è dipendente dal carico di lavoro",
|
||||
"impactBody": "BBR è efficace su collegamenti ad alta latenza o con perdite (replica intercontinentale, tunnel VPN, client mobili). In una LAN tra due macchine sullo stesso switch, la differenza spesso rientra nelle oscillazioni di misura. TFO aiuta soprattutto le connessioni HTTP brevi e ripetute.",
|
||||
"revertTitle": "Reversibile dal menu Disinstalla",
|
||||
"revertBody": "BBR/TFO vengono registrati. <link>Disinstalla ottimizzazioni</link> elimina i due file sysctl (<code>/etc/sysctl.d/99-kernel-bbr.conf</code> e <code>99-tcp-fastopen.conf</code>) e ricarica la configurazione restante. Eliminare un file non reimposta i valori attivi del kernel. Valori predefiniti come <code>cubic</code> e <code>tcp_fastopen=1</code> tornano dopo un riavvio, salvo altre configurazioni che li sovrascrivano. Equivalente manuale:"
|
||||
},
|
||||
"names": {
|
||||
"heading": "Nomi interfacce (persistenti)",
|
||||
"intro": "Esamina ogni scheda di rete fisica dell’host, saltando loopback, veth Docker, bridge, dispositivi TAP, bond, Cilium, ZeroTier e WireGuard. Scrive un file systemd <code>.link</code> che associa il nome attuale all’indirizzo MAC attuale. L’associazione MAC prevale quindi sulla logica di denominazione del kernel.",
|
||||
"whyTitle": "Perché questo è importante",
|
||||
"whyItems": [
|
||||
"Aggiungere o rimuovere dispositivi PCIe può cambiare la numerazione del bus, trasformando <code>enp3s0</code> in <code>enp4s0</code>. Se <code>/etc/network/interfaces</code> fa riferimento al vecchio nome, il bridge scompare al riavvio.",
|
||||
"Gli aggiornamenti BIOS o firmware a volte cambiano l’enumerazione dei dispositivi, con lo stesso effetto.",
|
||||
"Lo script fissa i nomi delle schede fisiche, incluse le porte fisiche usate dai bond. Salta le interfacce virtuali, come veth LXC e i dispositivi bond stessi; non risolve le condizioni di gara nei nomi delle schede virtuali <code>hotplug</code>."
|
||||
],
|
||||
"writtenTitle": "Cosa si scrive",
|
||||
"writtenIntro": "Un file per NIC fisico, a <code>/etc/systemd/network/10-proxmenux-<iface>.link</code>. Ogni file inizia con l'intestazione <code># Managed by ProxMenux — do not edit</code> così ProxMenux può distinguere i propri file da file <code>.link</code> forniti dall'utente o dal pacchetto.",
|
||||
"writtenOutro": "I file <code>.link</code> di altri pacchetti o scritti dall’utente vengono conservati; sono gestiti solo quelli con l’intestazione ProxMenux. A ogni esecuzione successiva la funzione verifica i propri file: rilegge <code>MACAddress=</code> da ogni <code>10-proxmenux-*.link</code> ed elimina quelli la cui MAC non compare più in <code>/sys/class/net/</code>. I file delle versioni precedenti nel formato <code>10-<iface>.link</code> vengono migrati automaticamente la prima volta.",
|
||||
"pveTitle": "PVE 9 vs PVE 8",
|
||||
"pveBody": "Lo script usa file systemd <code>.link</code> per i nomi persistenti. Su Proxmox VE 9 ricarica anche le regole udev dopo la scrittura, affinché le nuove schede possano usarle senza riavvio. Controlla le interfacce esistenti dopo un riavvio sia su PVE 8 sia su PVE 9. Questo non sostituisce <code>ifupdown2</code> sull’host. In entrambi i casi lo script segnala la necessità di riavvio alla post-installazione personalizzabile.",
|
||||
"reviewTitle": "Controlla prima il file /etc/network/interfaces esistente",
|
||||
"reviewBody": "Se la configurazione precedente in <code>/etc/network/interfaces</code> usa nomi delle schede generati dal kernel, fissare quelli <em>attuali</em> è il risultato voluto. Se hai già adattato manualmente la configurazione a nomi specifici, verifica prima del riavvio che i nomi fissati corrispondano al file interfaces.",
|
||||
"revertTitle": "Reversibile dal menu Disinstalla",
|
||||
"revertBody": "<link>Disinstalla ottimizzazioni</link> elimina solo i file <code>10-proxmenux-*.link</code> con intestazione ProxMenux da <code>/etc/systemd/network/</code>. Conserva ogni file <code>.link</code> aggiunto dall’utente o da altri pacchetti. Al prossimo riavvio torna la denominazione predefinita di systemd."
|
||||
},
|
||||
"related": {
|
||||
"heading": "Correlati",
|
||||
"items": [
|
||||
{
|
||||
"label": "Gestione rete",
|
||||
"href": "/docs/network",
|
||||
"tail": "— diagnostica, analisi del ponte, riparazioni guidate."
|
||||
},
|
||||
{
|
||||
"label": "Nomi di interfaccia persistenti",
|
||||
"href": "/docs/network/persistent-names",
|
||||
"tail": " — la stessa funzione disponibile in un menu dedicato per un secondo momento; usa una delle due opzioni, non entrambe."
|
||||
},
|
||||
{
|
||||
"label": "Riferimento dei comandi di rete",
|
||||
"href": "/docs/help-info/network-commands",
|
||||
"tail": " — ip, ss, ethtool, sysctl."
|
||||
},
|
||||
{
|
||||
"label": "Disinstalla ottimizzazioni",
|
||||
"href": "/docs/post-install/uninstall",
|
||||
"tail": " — annulla queste modifiche di rete."
|
||||
},
|
||||
{
|
||||
"label": "Post-installazione personalizzabile",
|
||||
"href": "/docs/post-install/customizable",
|
||||
"tail": " — torna al menu superiore."
|
||||
}
|
||||
]
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,177 @@
|
||||
{
|
||||
"meta": {
|
||||
"title": "ProxMenux Post-Install: Impostazioni opzionali",
|
||||
"description": "Guida a Impostazioni opzionali nello script post-install ProxMenux per ulteriori funzioni e ottimizzazioni Proxmox VE.",
|
||||
"ogTitle": "ProxMenux Post-Install: Impostazioni opzionali",
|
||||
"ogDescription": "Guida a Impostazioni opzionali nello script post-install ProxMenux per ulteriori funzioni e ottimizzazioni Proxmox VE.",
|
||||
"ogImageAlt": "Impostazioni opzionali ProxMenux Post-Install"
|
||||
},
|
||||
"title": "Impostazioni opzionali",
|
||||
"intro": "La categoria <strong>Impostazioni opzionali</strong> offre funzioni e ottimizzazioni aggiuntive per Proxmox VE. Non sono essenziali, ma possono migliorare le capacità del sistema in situazioni specifiche.",
|
||||
"available": "Funzioni opzionali disponibili",
|
||||
"stepLabel": "Passaggio",
|
||||
"ceph": {
|
||||
"title": "Aggiungi l'ultimo supporto Ceph",
|
||||
"intro": "Questa opzione installa l'ultimo supporto del sistema di archiviazione Ceph per Proxmox VE. Ceph è un sistema di archiviazione distribuito che offre elevate prestazioni, affidabilità e scalabilità.",
|
||||
"doesIntro": "Cosa fa:",
|
||||
"doesItems": [
|
||||
"Aggiunge il repository Ceph al sistema",
|
||||
"Aggiorna gli elenchi dei pacchetti",
|
||||
"Installa i pacchetti Ceph utilizzando il comando 'pveceph install'",
|
||||
"Verifica l'installazione"
|
||||
],
|
||||
"howUse": "Come utilizzare: Dopo l'installazione, è possibile configurare e gestire lo storage Ceph utilizzando l'interfaccia web Proxmox VE o gli strumenti di riga di comando.",
|
||||
"automates": "Questa regolazione automatizza i seguenti comandi:"
|
||||
},
|
||||
"amd": {
|
||||
"title": "Applicare correzioni per CPU AMD",
|
||||
"intro": "Questa opzione applica correzioni specifiche per le CPU AMD EPYC e Ryzen per migliorare la stabilità e la compatibilità.",
|
||||
"doesIntro": "Cosa fa:",
|
||||
"doesItems": [
|
||||
"Rileva se è presente un EPYC AMD o Ryzen CPU",
|
||||
"Applica il parametro kernel 'idle=nomwait' per prevenire crash casuali (tramite /etc/kernel/cmdline su host systemd-boot, o /etc/default/grub su host GRUB — con un .bak dell'originale)",
|
||||
"Configura KVM per ignorare alcuni MSR (Model Specific Registers) per una migliore compatibilità degli ospiti di Windows"
|
||||
],
|
||||
"howUse": "Come usare: Queste correzioni vengono applicate automaticamente e richiedono un riavvio del sistema per avere effetto.",
|
||||
"automates": "Questa regolazione automatizza i seguenti comandi:"
|
||||
},
|
||||
"ha": {
|
||||
"title": "Abilita servizi di alta disponibilità",
|
||||
"intro": "Questa opzione consente servizi High Availability (HA) in Proxmox VE, consentendo il failover automatico di VM e container in caso di guasto del nodo.",
|
||||
"doesIntro": "Cosa fa:",
|
||||
"doesItems": [
|
||||
"Attiva e avvia il servizio pve-ha-lrm (Local Resource Manager)",
|
||||
"Attiva e avvia il servizio pve-ha-crm (Cluster Resource Manager)",
|
||||
"Attiva e avvia il servizio corosync per la comunicazione cluster"
|
||||
],
|
||||
"howUse": "Come utilizzare: Dopo aver abilitato questi servizi, è possibile configurare gruppi HA e risorse nell'interfaccia web Proxmox VE.",
|
||||
"automates": "Questa regolazione automatizza i seguenti comandi:"
|
||||
},
|
||||
"pveam": {
|
||||
"title": "Aggiorna Proxmox VE Appliance Manager",
|
||||
"intro": "Aggiorna l’indice locale dei modelli di container esposto da <code>pveam</code> in Proxmox, così l’elenco delle appliance software è aggiornato alla prossima creazione di un LXC.",
|
||||
"doesIntro": "Cosa fa:",
|
||||
"doesItems": [
|
||||
"Esegue <code>pveam update</code> sui mirror Proxmox per recuperare il catalogo attuale delle appliance software",
|
||||
"Popola l’elenco delle appliance software mostrato quando si crea un container"
|
||||
],
|
||||
"howUse": "Uso: eseguilo se l’elenco delle appliance software sembra datato o dopo un cambio di mirror. Scarica solo l’indice del catalogo, non i modelli stessi.",
|
||||
"automates": "Questa regolazione automatizza il seguente comando:"
|
||||
},
|
||||
"fastfetch": {
|
||||
"title": "Installare e configurare Fastfetch",
|
||||
"intro": "Questa opzione installa silenziosamente e configura Fastfetch, uno strumento di informazioni di sistema che visualizza specifiche di sistema e un logo personalizzato al login.",
|
||||
"doesLabel": "Cosa fa:",
|
||||
"doesItems": [
|
||||
"Scarica e installa silenziosamente l’ultima versione di Fastfetch",
|
||||
"Consente di scegliere un logo personalizzato (<strong>ProxMenux, Proxmox, Helper-Scripts, Home-Labs-Club, Proxmology</strong>, o uno personalizzato)",
|
||||
"Configura Fastfetch per visualizzare <em>\"Sistema ottimizzato da ProxMenux\"</em>",
|
||||
"Configura Fastfetch per avviarsi automaticamente all’accesso in console"
|
||||
],
|
||||
"importantLabel": "Importante:",
|
||||
"importantBody": "Se ti connetti a Proxmox tramite SSH, scegli il logo <strong>Proxmox</strong> o creane uno con <code>jp2a</code> o <code>img2txt</code>. Gli altri loghi vengono generati con <code>chafa</code> e potrebbero non essere visualizzati correttamente in una normale sessione SSH.",
|
||||
"customLabel": "Loghi personalizzati:",
|
||||
"customBody1": "Per utilizzare un logo personalizzato, posizionare il file di testo ASCII in: <code>/usr/local/share/fastfetch/logos/</code>",
|
||||
"customBody2": "È possibile creare loghi personalizzati utilizzando strumenti come <code>chafa</code>, <code>jp2a</code>, o <code>img2txt</code>.",
|
||||
"customBody3": "Per i migliori risultati:",
|
||||
"customItems": [
|
||||
"Mantieni l’altezza del logo entro 35 righe per conservare le proporzioni e rientrare nel terminale",
|
||||
"Utilizzare <code>chafa</code> per loghi a colori (può non visualizzare correttamente in sessioni SSH)",
|
||||
"Utilizzare <code>jp2a</code> o <code>img2txt</code> per loghi compatibili con SSH"
|
||||
],
|
||||
"examplesLabel": "Loghi di esempio:",
|
||||
"logos": [
|
||||
{
|
||||
"name": "ProxMenux",
|
||||
"alt": "Logo ProxMenux",
|
||||
"src": "https://macrimi.github.io/ProxMenux/fastfetch/proxmenux.png"
|
||||
},
|
||||
{
|
||||
"name": "Proxmox",
|
||||
"alt": "Logo Proxmox",
|
||||
"src": "https://macrimi.github.io/ProxMenux/fastfetch/proxmox.png"
|
||||
},
|
||||
{
|
||||
"name": "JC Channel",
|
||||
"alt": "Logo di JC Channel",
|
||||
"src": "/fastfetch/jc-channel.png"
|
||||
},
|
||||
{
|
||||
"name": "Helper-Scripts",
|
||||
"alt": "Logo di Helper-Scripts",
|
||||
"src": "https://macrimi.github.io/ProxMenux/fastfetch/helper-scripts.png"
|
||||
},
|
||||
{
|
||||
"name": "Home-Labs-Club",
|
||||
"alt": "Logo di Home-Labs-Club",
|
||||
"src": "https://macrimi.github.io/ProxMenux/fastfetch/home-labs-club.png"
|
||||
},
|
||||
{
|
||||
"name": "Proxmology",
|
||||
"alt": "Logo Proxmology",
|
||||
"src": "https://macrimi.github.io/ProxMenux/fastfetch/proxmology.png"
|
||||
}
|
||||
],
|
||||
"automates": "Questa regolazione automatizza i seguenti comandi:"
|
||||
},
|
||||
"figurine": {
|
||||
"title": "Installare e configurare Figurine",
|
||||
"intro": "Questa opzione installa e configura Figurine, uno strumento che crea eleganti banner di testo ASCII per il tuo terminale, visualizzando il tuo nome host in un formato 3D visivamente accattivante.",
|
||||
"doesLabel": "Cosa fa:",
|
||||
"doesItems": [
|
||||
"Scarica e installa Figurine v2.1.1 da GitHub per l’architettura dell’host (AMD64, ARM64 o ARMv7)",
|
||||
"Crea un messaggio di benvenuto che visualizza il tuo hostname in 3D ASCII art quando accedi",
|
||||
"Aggiorna il binario Figurine esistente solo dopo aver completato correttamente il download e l’estrazione",
|
||||
"Imposta il messaggio di benvenuto da eseguire automaticamente al login"
|
||||
],
|
||||
"practicalLabel": "Uso pratico:",
|
||||
"practicalBody": "Quando gestisci più nodi Proxmox in un cluster, Figurine mostra subito a quale nodo sei connesso. Aiuta a evitare comandi accidentali sul nodo sbagliato e migliora il flusso di lavoro con più server.",
|
||||
"exampleLabel": "Esempio di output:",
|
||||
"imageAlt": "Output di esempio di Figurine",
|
||||
"automates": "Questa regolazione automatizza il seguente processo:",
|
||||
"outro": "Dopo l'installazione, vedrai il tuo nome host visualizzato nell'arte 3D ASCII ogni volta che accedi, rendendo immediatamente chiaro su quale nodo Proxmox stai lavorando."
|
||||
},
|
||||
"log2ram": {
|
||||
"title": "Installare Log2RAM (SSD/NVMe riduzione dell'usura)",
|
||||
"intro": "Log2RAM monta <code>/var/log</code> su un ramdisk tmpfs e lo sincronizza periodicamente sul disco. Accumulare in RAM le frequenti scritture journald può ridurre usura SSD e I/O. Sincronizzazione e arresto regolare salvano i log, ma una perdita improvvisa di alimentazione può perdere le voci dall’ultima sincronizzazione.",
|
||||
"upstreamLabel": "Progetto a monte:",
|
||||
"upstreamUrl": "https://github.com/azlux/log2ram",
|
||||
"upstreamLinkLabel": "azlux/log2ram su GitHub",
|
||||
"doesLabel": "Cosa fa ProxMenux:",
|
||||
"doesItems": [
|
||||
"Rileva se il disco root è SSD/NVMe leggendo <code>/sys/block/<dev>/queue/rotational</code>. Su un disco rotazionale il flusso automatizzato chiede prima di installare.",
|
||||
"Clona il repository originale (<code>azlux/log2ram</code>) in <code>/tmp/log2ram</code> e modifica <code>install.sh</code>, sostituendo <code>rsync -aAXv</code> con <code>rsync -aXv --no-acls</code>. Evita l’errore <em>set_acl: Operation not supported</em> con codice di uscita 23, che lo script originale genera spostando /var/log su filesystem senza ACL. L’unità systemd <code>log2ram</code> viene abilitata dopo l’installazione.",
|
||||
"Dimensiona il ramdisk in base alla RAM dell’host: <code>≤ 8 GB → 128M</code>, <code>≤ 16 GB → 256M</code>, <code>> 16 GB → 512M</code>. Scrive il valore in <code>SIZE=</code> di <code>/etc/log2ram.conf</code>.",
|
||||
"Pianifica una sincronizzazione periodica del disco tramite <code>/etc/cron.d/log2ram</code>: ogni 1h / 3h / 6h secondo lo stesso livello RAM.",
|
||||
"Installa <code>/usr/local/bin/log2ram-check.sh</code>, eseguito ogni 10 minuti da <code>/etc/cron.d/log2ram-auto-sync</code>. Quando <code>/var/log</code> raggiunge l’80% del ramdisk, pulisce i vecchi journal. Al 92% esegue prima <code>logrotate -f /etc/logrotate.d/proxmox-backup-api</code> se il file esiste: i log API PBS sono spesso i maggiori consumatori di spazio su un host PBS. Poi tronca <code>pveproxy access/error</code> e <code>pveam.log</code> prima della sincronizzazione. <code>log2ram write</code> da solo copia tmpfs sul disco senza ridurlo. La protezione aiuta a evitare arresti di PVE con <em>No space left on device</em> per crescita incontrollata dei log.",
|
||||
"Rileva il servizio <code>proxmox-backup-server</code> sull’host. Se presente, crea <code>/etc/logrotate.d/proxmox-backup-api</code> (20 MB × 3 rotazioni) e <code>/etc/cron.hourly/proxmox-backup-logrotate</code> per limitare i log API PBS, abituale fonte di crescita, anche tra le sincronizzazioni Log2RAM. Senza PBS non modifica nulla.",
|
||||
"Regola i limiti systemd-journald (<code>SystemMaxUse</code>, <code>RuntimeMaxUse</code>) per adattarsi all'interno del ramdisk in modo che un singolo scoppio non possa riempirlo.",
|
||||
"Si registra in <code>installed_tools.json</code> per consentire il ripristino da Disinstalla ottimizzazioni."
|
||||
],
|
||||
"howUseLabel": "Come usare:",
|
||||
"howUseBody": "Il percorso automatizzato installa Log2RAM senza intervento se rileva un disco root SSD/NVMe. Quello personalizzabile chiede dimensione, intervallo e attivazione della protezione. Il messaggio indica 90%, ma lo script generato usa le soglie di pulizia all’80% e intensiva al 92% descritte sopra.",
|
||||
"verifyLabel": "Verificare e gestire dalla shell:",
|
||||
"verifyCode": "# Service state and configured timers\nsystemctl status log2ram\nsystemctl list-timers log2ram*\n\n# Current ramdisk usage — /var/log IS the tmpfs itself\ndf -h /var/log\n\n# Force a sync now (tmpfs → disk); does NOT shrink the tmpfs\nlog2ram write\n\n# Trigger the auto-sync guard on demand (vacuum + sync when usage is high)\n/usr/local/bin/log2ram-check.sh\n\n# Current config: SIZE, mail settings, path\ncat /etc/log2ram.conf\n\n# ProxMenux-specific cron jobs\ncat /etc/cron.d/log2ram /etc/cron.d/log2ram-auto-sync\n\n# Recent Log2RAM activity\njournalctl -u log2ram -n 50 --no-pager"
|
||||
},
|
||||
"zram": {
|
||||
"title": "Abilita il profilo di scambio ZRAM",
|
||||
"intro": "Crea un dispositivo swap compresso in RAM, <code>/dev/zram0</code>, con <code>systemd-zram-generator</code>. Le pagine spostate dal kernel nello swap vengono compresse con zstd e tenute in memoria prima di usare lo swap su disco.",
|
||||
"doesLabel": "Cosa fa:",
|
||||
"doesItems": [
|
||||
"Installa <code>systemd-zram-generator</code> se manca e registra se è stato installato da ProxMenux.",
|
||||
"Scrive <code>/etc/systemd/zram-generator.conf.d/90-proxmenux.conf</code>: un dispositivo <code>zram0</code> dimensionato ad un decimo dell'host RAM, compressione zstd (<code>zstd(level=9)</code> con systemd-zram-generator 1.2.0 o versioni successive) e priorità swap 32767.",
|
||||
"Con questa priorità il kernel riempie prima ZRAM. Uno swap esistente su disco mantiene la propria priorità e prende le pagine che non si adattano più a ZRAM.",
|
||||
"Prima di cambiare qualcosa, cerca un'altra configurazione ZRAM: uno swap zram attivo, una linea zram in <code>/etc/fstab</code>, un'unità systemd o un altro file generatore. Se ne trova una, l'opzione si ferma e lascia quella configurazione così com'è.",
|
||||
"Avvia <code>dev-zram0.swap</code> e controlla che il dispositivo attivo corrisponda al profilo. Se non lo fa, lo stato precedente viene ripristinato.",
|
||||
"Si registra in <code>installed_tools.json</code> per consentire il ripristino da Disinstalla ottimizzazioni."
|
||||
],
|
||||
"howUseLabel": "Come usare:",
|
||||
"howUseBody": "L’opzione è disponibile solo nel percorso personalizzabile, non in quello automatizzato. Il dispositivo viene ricreato a ogni avvio. Quando è attivo, il riquadro Memoria di ProxMenux Monitor mostra capacità, swap usato, algoritmo, rapporto di compressione e memoria fisica occupata.",
|
||||
"verifyLabel": "Verificare dalla shell:",
|
||||
"verifyCode": "# Active swap devices and their priority\nswapon --show\n\n# ZRAM device: algorithm, size and compressed data\nzramctl\n\n# Profile written by ProxMenux\ncat /etc/systemd/zram-generator.conf.d/90-proxmenux.conf\n\n# State of the swap unit\nsystemctl status dev-zram0.swap"
|
||||
},
|
||||
"autoApplication": {
|
||||
"title": "Applicazione automatica",
|
||||
"body": "Nel percorso personalizzabile seleziona ogni funzione in base alle necessità. Log2RAM fa parte anche di quello automatizzato con rilevamento hardware; ZRAM resta esclusivo di Personalizzabile. Consulta le sezioni per conferme e prerequisiti."
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,61 @@
|
||||
{
|
||||
"meta": {
|
||||
"title": "Post-installazione: Prestazioni | Documentazione ProxMenux",
|
||||
"description": "Opzioni di prestazioni nello script post-installazione personalizzabile di ProxMenux. Sostituisce gzip a thread singolo con pigz (gzip parallelo) per accelerare backup e compressione sugli host multicore."
|
||||
},
|
||||
"header": {
|
||||
"title": "Dopo l'installazione: prestazioni",
|
||||
"description": "Opzioni di prestazioni dello script post-installazione Personalizzabile. La categoria contiene una sola ottimizzazione: sostituire gzip con pigz affinché backup e compressione usino tutti i core della CPU invece di uno solo.",
|
||||
"section": "Impostazioni post-installazione Proxmox"
|
||||
},
|
||||
"intro": {
|
||||
"title": "Che cosa copre questa categoria",
|
||||
"body": "L’unica opzione di prestazioni qui reindirizza gzip a un’implementazione parallela. Le altre regolazioni (memoria, scheduling I/O, dimensione dell’ARC ZFS, limiti del kernel) sono nelle rispettive categorie (<em>Sistema</em>, <em>Archiviazione</em>), perché riguardano sottosistemi diversi."
|
||||
},
|
||||
"pigz": {
|
||||
"heading": "Usa pigz per una compressione gzip più rapida",
|
||||
"intro": "<code>gzip</code> standard comprime usando <strong>un solo core della CPU</strong>. Sugli host Proxmox moderni con 8, 16 o 32 core, ciò limita molto i backup VM/CT con <code>vzdump</code>, la rotazione dei log e ogni operazione che passa per <code>gzip</code>. <a>pigz</a> è un sostituto parallelo immediatamente compatibile: stesso output compatibile gzip, ma lavoro distribuito su tutti i core.",
|
||||
"doesTitle": "Cosa fa ProxMenux",
|
||||
"doesIntro": "Cinque passaggi, tutti idempotenti:",
|
||||
"doesItems": [
|
||||
"Imposta <code>pigz: 1</code> in <code>/etc/vzdump.conf</code> quindi lo strumento di backup di Proxmox utilizza pigz in modo nativo.",
|
||||
"Installa il pacchetto <code>pigz</code> apt se non già presente.",
|
||||
"Scrive uno script wrapper a <code>/bin/pigzwrapper</code> che inoltra ogni argomento a <code>/usr/bin/pigz</code>.",
|
||||
"Registra una diversione dpkg per il binario di sistema <code>gzip</code> (<code>/usr/bin/gzip</code> su Proxmox VE 9, <code>/bin/gzip</code> su Proxmox VE 8). Il binario originale resta accanto come <code>gzip.distrib</code> e il wrapper lo sostituisce. Da quel momento <em>qualsiasi programma</em> che chiama <code>gzip</code>, come logrotate, <code>tar czf</code>, script e vzdump, usa pigz in modo trasparente.",
|
||||
"Controlla che il file mantenuto come <code>gzip.distrib</code> sia un gzip funzionante prima che l'involucro sia messo in atto e reinstalla il pacchetto <code>gzip</code> prima quando non lo è. Un host che ha ancora il precedente swap <code>/bin/gzip.original</code> viene spostato alla diversione quando l'opzione viene applicata di nuovo."
|
||||
],
|
||||
"replacesTitle": "Sostituisce un binario di sistema",
|
||||
"replacesBody": "Mettere un wrapper al posto di <code>gzip</code> è insolito. È sicuro perché produce output compatibile gzip, ma gli script con percorsi fissi, eseguiti in chroot restrittivi o che verificano gli hash dei binari possono comportarsi diversamente. Il binario originale resta come <code>gzip.distrib</code>. Grazie alla diversione dpkg, un aggiornamento del pacchetto <code>gzip</code> o il passaggio da Proxmox VE 8 a 9 aggiorna quel file e mantiene il wrapper.",
|
||||
"revertTitle": "Reversibile dal menu Disinstalla",
|
||||
"revertBody": "Questa ottimizzazione è registrata. <link>Disinstalla ottimizzazioni</link> copia il binario originale da <code>gzip.distrib</code> al posto del wrapper, rimuove la diversione e <code>pigzwrapper</code>, commenta la riga <code>pigz</code> in <code>/etc/vzdump.conf</code> ed esegue <code>apt purge pigz</code> dopo aver verificato che gzip funziona. Equivalente manuale su Proxmox VE 9:",
|
||||
"verifyTitle": "Verifica",
|
||||
"verifyBody": "Dopo l'applicazione, <code>gzip --version</code> dovrebbe menzionare pigz. Un rapido benchmark mostra anche la differenza di velocità su un host multi-core:",
|
||||
"whenTitle": "Quando questo è più importante",
|
||||
"whenBody": "Il vantaggio cresce con il <strong>numero di core dell’host</strong> e la <strong>frequenza dei backup</strong>. Su un server domestico a 2 core con un vzdump al giorno è marginale. Su un host di produzione a 16 core che salva una dozzina di VM ogni notte, pigz può ridurre la finestra di backup a una frazione del tempo richiesto da gzip a thread singolo."
|
||||
},
|
||||
"related": {
|
||||
"heading": "Correlati",
|
||||
"items": [
|
||||
{
|
||||
"label": "Comandi di backup e ripristino",
|
||||
"href": "/docs/help-info/backup-commands",
|
||||
"tailRich": " — riferimento CLI di vzdump, inclusa l’opzione <code>--pigz</code> per i thread."
|
||||
},
|
||||
{
|
||||
"label": "Archiviazione",
|
||||
"href": "/docs/post-install/storage",
|
||||
"tail": "— limiti di velocità di vzdump e sintonizzazione ZFS ARC."
|
||||
},
|
||||
{
|
||||
"label": "Sistema",
|
||||
"href": "/docs/post-install/system",
|
||||
"tail": " — regolazione dei descrittori di file e della memoria."
|
||||
},
|
||||
{
|
||||
"label": "Post-installazione personalizzabile",
|
||||
"href": "/docs/post-install/customizable",
|
||||
"tail": " — torna al menu superiore."
|
||||
}
|
||||
]
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,57 @@
|
||||
{
|
||||
"meta": {
|
||||
"title": "Post-Install: Sicurezza | Documentazione ProxMenux",
|
||||
"description": "Opzioni di sicurezza disponibili nello script ProxMenux Personalizzabile post-installazione. Attualmente un'unica opzione: disabilitare il servizio portmapper/rpcbind per ridurre la superficie di attacco dell'host."
|
||||
},
|
||||
"header": {
|
||||
"title": "Post-Install: Sicurezza",
|
||||
"section": "Impostazioni post-installazione Proxmox"
|
||||
},
|
||||
"intro": {
|
||||
"title": "Che cosa copre questa categoria",
|
||||
"body": "La sicurezza post-installazione si limita al <strong>rafforzamento dell’host applicabile in sicurezza senza supervisione</strong>: disattivare servizi che quasi nessuno usa, con possibilità di annullamento dal menu Disinstalla. Gli strumenti attivi (Fail2Ban per prevenire intrusioni, Lynis per gli audit) si trovano nella voce <em>Sicurezza</em> del menu principale di ProxMenux, fuori dalla post-installazione."
|
||||
},
|
||||
"rpcbind": {
|
||||
"heading": "Disattivare il portmapper / rpcbind",
|
||||
"intro": "<code>rpcbind</code> (in precedenza <code>portmap</code>) associa i numeri dei programmi RPC alle porte di rete. È una dipendenza di NFS e di alcuni vecchi strumenti RPC. Su un tipico host Proxmox che non funge da server NFS, <strong>nulla lo usa</strong>; lasciarlo attivo mantiene la porta <code>111/tcp</code> in ascolto su ogni interfaccia.",
|
||||
"whyTitle": "Perché conviene disattivarlo",
|
||||
"whyItems": [
|
||||
"Riduce la superficie di attacco ospite — un servizio di ascolto in meno di preoccuparsi.",
|
||||
"Storicamente abusato come vettore di riflessione/amplificazione in attacchi DDoS. Disabilitare <code>rpcbind</code> rimuove quel fattore di amplificazione per il vostro host.",
|
||||
"Rimuove il rumore generato nei log e nell’output di <code>netstat</code> / <code>ss</code>, rendendo più facile individuare l’attività reale."
|
||||
],
|
||||
"nfsTitle": "Non disabilitarlo se si utilizza NFS",
|
||||
"nfsBody": "Sia il server NFS <strong>sia</strong> il client NFS dipendono da <code>rpcbind</code> per negoziare le porte usate da <code>mountd</code>, <code>statd</code>, <code>lockd</code> e altri servizi. Se il tuo host Proxmox <em>esporta</em> condivisioni NFS verso altri dispositivi oppure <em>monta</em> condivisioni NFS da un NAS, non applicare questa opzione. I montaggi fallirebbero con <code>mount.nfs: rpc.statd is not running</code> o errori simili.",
|
||||
"runsTitle": "Cosa esegue ProxMenux",
|
||||
"runsOutro": "Il pacchetto resta installato. ProxMenux registra lo stato originale di abilitazione e attività di rpcbind.service e rpcbind.socket, poi disabilita e arresta entrambe le unità per impedire che l’attivazione tramite socket riavvii il servizio.",
|
||||
"verifyTitle": "Verifica",
|
||||
"verifyBody": "Dopo l'applicazione, confermare <code>rpcbind</code> è spento e nulla sta ascoltando sulla porta 111:",
|
||||
"reversibleTitle": "Ripristinare lo stato di servizio originale",
|
||||
"reversibleBody": "La modifica è registrata in <code>installed_tools.json</code>. <link>Disinstalla ottimizzazioni</link> riporta ogni unità rpcbind agli stati abilitato/disabilitato e attivo/inattivo rilevati prima della modifica di ProxMenux; non presume che rpcbind fosse abilitato su tutti gli host."
|
||||
},
|
||||
"related": {
|
||||
"heading": "Correlati",
|
||||
"items": [
|
||||
{
|
||||
"label": "Menu di sicurezza",
|
||||
"href": "/docs/security",
|
||||
"tail": " — strumenti più avanzati: Fail2Ban (prevenzione delle intrusioni) e Lynis (audit)."
|
||||
},
|
||||
{
|
||||
"label": "Lynis",
|
||||
"href": "/docs/security/lynis",
|
||||
"tail": " — per controllare l’host e trovare altri modi di rafforzarne la sicurezza."
|
||||
},
|
||||
{
|
||||
"label": "Comandi di sistema utili",
|
||||
"href": "/docs/help-info/system-commands",
|
||||
"tail": "— stato di servizio, journalctl, riferimento di audit lynis."
|
||||
},
|
||||
{
|
||||
"label": "Post-installazione personalizzabile",
|
||||
"href": "/docs/post-install/customizable",
|
||||
"tail": " — torna al menu superiore."
|
||||
}
|
||||
]
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,167 @@
|
||||
{
|
||||
"meta": {
|
||||
"title": "Post-installazione: Archiviazione | Documentazione ProxMenux",
|
||||
"description": "Ottimizzazioni di archiviazione dello script post-installazione personalizzabile ProxMenux: dimensione ZFS ARC in base alla RAM, snapshot periodici con zfs-auto-snapshot e rimozione dei limiti di velocità dei backup vzdump."
|
||||
},
|
||||
"header": {
|
||||
"title": "Post-installazione: Archiviazione",
|
||||
"section": "Impostazioni post-installazione Proxmox"
|
||||
},
|
||||
"intro": {
|
||||
"title": "Che cosa copre questa categoria",
|
||||
"body": "Quattro ottimizzazioni di archiviazione: regolare <strong>ZFS ARC</strong> su una parte ragionevole della RAM, installare e pianificare <strong>snapshot automatici ZFS</strong>, abilitare <strong>ZFS autotrim</strong> su pool SSD/NVMe e rimuovere i limiti di <strong>vzdump</strong> per velocizzare i backup. Le opzioni sono indipendenti: scegli quelle adatte al sistema. Una quinta, <link>Log2RAM</link>, riduce l’usura SSD/NVMe spostando <code>/var/log</code> su ramdisk. È nella pagina Opzionali perché il menu personalizzabile la raggruppa lì."
|
||||
},
|
||||
"trackedTitle": "Tutti e quattro sono tracciati nel menu Disinstalla",
|
||||
"trackedBody": "Ogni opzione si registra in <code>installed_tools.json</code> per <link>Disinstalla ottimizzazioni</link>. <code>zfs_arc</code> rimuove <code>/etc/modprobe.d/99-zfsarc.conf</code> e ricrea initramfs; <code>zfs_auto_snapshot</code> annulla la pianificazione cron e offre la rimozione completa del pacchetto; <code>zfs_autotrim</code> imposta <code>autotrim=off</code> sui pool che ha abilitato; <code>vzdump_speed</code> ripristina <code>/etc/vzdump.conf</code> dal <code>.bak</code> creato all’installazione.",
|
||||
"arc": {
|
||||
"heading": "Ottimizza dimensione ZFS ARC",
|
||||
"intro": "La <strong>Adaptive Replacement Cache (ARC)</strong> è la cache di lettura ZFS in RAM. Le installazioni Proxmox VE dalla 8.1 impostano il 10% di RAM, massimo 16 GiB; host precedenti o aggiornati possono differire. Questa opzione scrive un proprio limite in base alla RAM. Controlla impostazioni e carico: una cache più piccola non è sempre più veloce.",
|
||||
"sizingTitle": "Regole di dimensionamento",
|
||||
"headerRam": "RAM dell'host",
|
||||
"headerMax": "Limite ARC",
|
||||
"rows": [
|
||||
{
|
||||
"ram": "Formula",
|
||||
"max": "RAM / 10, massimo 16 GiB e minimo 64 MiB"
|
||||
},
|
||||
{
|
||||
"ram": "host 8 GB",
|
||||
"max": "≈ 819 MiB (RAM/10)"
|
||||
},
|
||||
{
|
||||
"ram": "host 16 GB",
|
||||
"max": "≈ 1.6 GiB (RAM/10)"
|
||||
},
|
||||
{
|
||||
"ram": "host 64 GB",
|
||||
"max": "≈ 6.4 GiB (RAM/10)"
|
||||
},
|
||||
{
|
||||
"ram": "≥ host 160 GB",
|
||||
"max": "16 GiB (limite)"
|
||||
}
|
||||
],
|
||||
"after": "Il file <code>/etc/modprobe.d/99-zfsarc.conf</code> contiene solo <code>options zfs zfs_arc_max=…</code>. Gli altri parametri ZFS (<code>zfs_arc_min</code>, prelettura/limite scritture L2ARC, timeout TXG) non vengono regolati. Prima, una verifica cerca altri <code>*.conf</code> in <code>/etc/modprobe.d/</code> che impostano <code>zfs_arc_min</code> / <code>zfs_arc_max</code>, li salva con manifesto in <code>/usr/local/share/proxmenux/backups/zfs_arc/</code> ed elimina le righe in conflitto, lasciando attivo solo il file ARC ProxMenux. Poi <code>update-initramfs -u -k all</code> e, se necessario, <code>proxmox-boot-tool refresh</code> portano il limite nell’initramfs dei sistemi con root ZFS.",
|
||||
"rebootTitle": "Richiede un riavvio per prendere effetto",
|
||||
"rebootBody": "Le impostazioni ARC vengono lette caricando il modulo <code>zfs</code>. Per gli host con root ZFS, ProxMenux rigenera initramfs con <code>update-initramfs -u -k all</code> e aggiorna se necessario il bootloader con <code>proxmox-boot-tool refresh</code>. Il nuovo parametro richiede comunque un riavvio, segnalato automaticamente.",
|
||||
"safeTitle": "Sicuro su host non-ZFS",
|
||||
"safeBody": "La funzione scrive la configurazione solo se <code>zpool list</code> segnala almeno un pool ZFS importato. Su host Proxmox con solo ext4/LVM o con strumenti ZFS ma nessun pool importato, selezionare questa opzione non modifica nulla.",
|
||||
"verifyTitle": "Verifica e rollback manuale"
|
||||
},
|
||||
"autoSnap": {
|
||||
"heading": "Installa ZFS auto-snapshot",
|
||||
"intro": "Installa il pacchetto <a>zfs-auto-snapshot</a> e riscrive i suoi programmi di cron in modo che le snapshot vengano prese automaticamente a diversi intervalli. Una grande rete di sicurezza senza sforzo sopra i vostri backup vzdump regolari.",
|
||||
"cadenceTitle": "Frequenza degli snapshot configurata da ProxMenux",
|
||||
"headerLabel": "Etichetta",
|
||||
"headerRuns": "Esecuzione",
|
||||
"headerKept": "Istantanee tenute",
|
||||
"rows": [
|
||||
{
|
||||
"label": "frequente",
|
||||
"runs": "ogni 15 min",
|
||||
"kept": "4"
|
||||
},
|
||||
{
|
||||
"label": "oraria",
|
||||
"runs": "ogni ora",
|
||||
"kept": "1"
|
||||
},
|
||||
{
|
||||
"label": "ogni giorno",
|
||||
"runs": "una volta al giorno",
|
||||
"kept": "1"
|
||||
},
|
||||
{
|
||||
"label": "settimanale",
|
||||
"runs": "una volta alla settimana",
|
||||
"kept": "1"
|
||||
},
|
||||
{
|
||||
"label": "mensile",
|
||||
"runs": "una volta al mese",
|
||||
"kept": "1"
|
||||
}
|
||||
],
|
||||
"conservativeTitle": "Conservazione limitata",
|
||||
"conservativeBody": "ProxMenux mantiene una conservazione limitata: 4 snapshot frequenti e 1 per ciascun intervallo più lungo, per contenere lo spazio ZFS. Per conservarne di più modifica i numeri in <code>/etc/cron.d/zfs-auto-snapshot</code>, <code>/etc/cron.hourly/zfs-auto-snapshot</code> ecc. dopo lo script.",
|
||||
"onlyZfsTitle": "Utile solo sui pool ZFS",
|
||||
"onlyZfsBody": "Installare il pacchetto su un host ext4-solo è innocuo ma inutile — non ci sono set di dati ZFS per esso di snapshot. Salta questa opzione se non si utilizza ZFS.",
|
||||
"verifyTitle": "Verifica e rollback manuale"
|
||||
},
|
||||
"autotrim": {
|
||||
"heading": "Abilita ZFS autotrim (pool SSD/NVMe)",
|
||||
"intro": "Abilita <code>autotrim</code> sui pool ZFS composti solo da SSD o NVMe con supporto TRIM. Per prudenza salta i pool con dispositivi rotanti. Quelli già impostati su <code>autotrim=on</code> restano invariati.",
|
||||
"trimTitle": "Cosa fa TRIM e perché conta su ZFS",
|
||||
"trimBody1": "SSD e NVMe gestiscono blocchi interni di cancellazione più grandi dei settori logici del filesystem. Quando si elimina un file, l’unità non sa ancora che i settori sono liberi e la pulizia interna può continuare a spostare dati obsoleti per liberare blocchi. <strong>TRIM</strong> indica all’unità i settori liberi per consentirne la cancellazione anticipata.",
|
||||
"trimBody2": "Senza TRIM, esaurire i blocchi già cancellati può degradare le prestazioni SSD e aumentare le scritture interne, riducendo la vita utile. Con TRIM, l’unità può mantenere blocchi vuoti pronti alla scrittura.",
|
||||
"trimBody3": "Con <code>autotrim=on</code>, ZFS esegue TRIM in background sullo spazio liberato di recente, raggruppando gli intervalli. Un <code>zpool trim <pool></code> periodico è un’alternativa. Autotrim evita una pianificazione separata, ma l’impatto dipende dai dispositivi; il TRIM manuale periodico può essere migliore su alcune unità economiche.",
|
||||
"practicalTitle": "Perché questo è pratico da abilitare?",
|
||||
"practicalItems": [
|
||||
"<strong>Prestazioni di scrittura sostenute.</strong> TRIM può aiutare a recuperare blocchi inutilizzati. Benefici e impatto sulla latenza dipendono da dispositivo e carico.",
|
||||
"<strong>Durata dell’unità.</strong> Evitare copie interne inutili può ridurre amplificazione di scrittura e usura NAND, senza garantire una durata aggiuntiva specifica.",
|
||||
"<strong>Nessun processo cron da pianificare.</strong> A differenza di un <code>zpool trim</code> periodico, autotrim viene gestito automaticamente dal pool."
|
||||
],
|
||||
"whenTitle": "Quando è necessario?",
|
||||
"whenIntro1": "<strong>Valuta l’attivazione</strong> sui pool ZFS solo con SSD/NVMe compatibili TRIM. Controlla comportamento e latenza; su alcuni dispositivi è preferibile TRIM manuale pianificato.",
|
||||
"whenIntro2": "<strong>Lo script lo ignora automaticamente</strong> su:",
|
||||
"whenSkipItems": [
|
||||
"Pool con vdev HDD rotanti: filtro hardware prudente di questo script.",
|
||||
"Drive senza <code>discard_granularity</code> esposti in sysfs — solitamente vecchi SSD senza TRIM, o percorsi passanti dove il sistema operativo non può vedere il dispositivo sottostante.",
|
||||
"Pools dove ZFS riporta la proprietà non supportato (raro; molto vecchio pools).",
|
||||
"Pools già predisposto per <code>autotrim=on</code> (no-op)."
|
||||
],
|
||||
"whenIntro3": "<strong>Non pertinente su host ext4-solo</strong> — non c'è nulla per ZFS da tagliare. La funzione esce con un messaggio amichevole in quel caso.",
|
||||
"recordedTitle": "Perché vengono registrati solo i pool modificati da ProxMenux",
|
||||
"recordedBody": "La funzione registra un pool nel file di stato interno (<code>/usr/local/share/proxmenux/zfs_autotrim_pools</code>) solo se lo ha cambiato da <code>off</code> a <code>on</code>. I pool già con autotrim prima dello script restano fuori elenco: una futura disinstallazione annulla solo le modifiche di ProxMenux, non quelle impostate da te.",
|
||||
"manualTitle": "Equivalente manuale (in esecuzione sul server)",
|
||||
"manualIntro": "La sequenza completa che lo script corre contro ogni pool è replicabile a mano. Questo è quello che si digiterebbe se si desidera fare la stessa cosa su un singolo pool senza ProxMenux:",
|
||||
"verifyTitle": "Verifica e rollback manuale",
|
||||
"oneShotTitle": "Preferisci un TRIM singolo invece di quello continuo?",
|
||||
"oneShotBody": "Alcuni amministratori preferiscono TRIM manuale nelle ore di minor carico. Disabilita autotrim e pianifica un processo cron con <code>zpool trim <pool></code>: stesso obiettivo, frequenza diversa."
|
||||
},
|
||||
"vzdump": {
|
||||
"heading": "Aumenta la velocità di backup di vzdump",
|
||||
"intro": "Scrive bwlimit: 0 e ionice: 5 nella configurazione globale vzdump. Proxmox non ha già limiti di banda predefiniti: rimuove un limite solo se configurato. Rispetto a ionice: 7, il valore 5 aumenta la priorità I/O best-effort se lo scheduler la rispetta. Può influire sugli ospiti e non garantisce backup più rapidi.",
|
||||
"changedTitle": "Cosa cambia in /etc/vzdump.conf",
|
||||
"backupTitle": "Prima esecuzione crea un .bak di vzdump.conf",
|
||||
"backupBody": "Alla prima esecuzione ProxMenux copia <code>/etc/vzdump.conf</code> in <code>/etc/vzdump.conf.bak</code> prima di modificarlo. Le esecuzioni successive non sovrascrivono la copia, lasciando recuperabile la configurazione precedente. <code>bwlimit</code> e <code>ionice</code> vengono modificati con <code>sed</code>; altre opzioni come compress, pigz, tmpdir ed exclude-path sono conservate.",
|
||||
"skipTitle": "Quando saltare questo",
|
||||
"skipBody": "Su un host con storage locale lento e VM sensibili alla latenza, togliere il limite di banda può causare rallentamenti durante i backup. Se hai impostato un <code>bwlimit</code> per questo motivo, conservalo e salta questa opzione.",
|
||||
"verifyTitle": "Verifica e rollback manuale"
|
||||
},
|
||||
"related": {
|
||||
"heading": "Correlati",
|
||||
"items": [
|
||||
{
|
||||
"label": "Comandi di gestione ZFS",
|
||||
"href": "/docs/help-info/zfs-commands",
|
||||
"tail": "— zpool / zfs riferimento per ARC, snapshot, scrub."
|
||||
},
|
||||
{
|
||||
"label": "Comandi di archiviazione e dischi",
|
||||
"href": "/docs/help-info/storage-commands",
|
||||
"tail": "— riferimento generico di blocco-dispositivo e di stoccaggio Proxmox."
|
||||
},
|
||||
{
|
||||
"label": "Comandi di backup e ripristino",
|
||||
"href": "/docs/help-info/backup-commands",
|
||||
"tail": " — riferimento CLI vzdump per banda e priorità I/O."
|
||||
},
|
||||
{
|
||||
"label": "Disinstalla ottimizzazioni",
|
||||
"href": "/docs/post-install/uninstall",
|
||||
"tail": " — annulla le modifiche ARC / vzdump."
|
||||
},
|
||||
{
|
||||
"label": "Log2RAM",
|
||||
"href": "/docs/post-install/optional#log2ram",
|
||||
"tail": " — riduce l’usura SSD/NVMe tenendo /var/log su ramdisk; documentato in Opzionali."
|
||||
},
|
||||
{
|
||||
"label": "Post-installazione personalizzabile",
|
||||
"href": "/docs/post-install/customizable",
|
||||
"tail": " — torna al menu superiore."
|
||||
}
|
||||
]
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,133 @@
|
||||
{
|
||||
"meta": {
|
||||
"title": "Post-Install: Sistema | Documentazione ProxMenux",
|
||||
"description": "Ottimizzazioni a livello di sistema nello script post-installazione personalizzabile ProxMenux: journald e limiti di dimensione logrotate, limiti più elevati del kernel e dei descrittori di file, ottimizzazione della memoria bilanciata, kexec per riavvii rapidi e ripristino dal kernel panico."
|
||||
},
|
||||
"header": {
|
||||
"title": "Dopo l'installazione: sistema",
|
||||
"section": "Impostazioni post-installazione Proxmox"
|
||||
},
|
||||
"intro": {
|
||||
"title": "Che cosa copre questa categoria",
|
||||
"body": "Sei ottimizzazioni di sistema indipendenti. Regolano <strong>journald</strong> e <strong>logrotate</strong> per evitare che i log riempiano il disco, aumentano <strong>i limiti del kernel e dei descrittori di file</strong> per le applicazioni con molti file aperti, <strong>bilanciano la memoria</strong> su un host di virtualizzazione, aggiungono <strong>kexec</strong> per riavviare senza BIOS e configurano <strong>il ripristino automatico</strong> in caso di kernel panic. Tutte e sei sono registrate e reversibili dal menu Disinstalla."
|
||||
},
|
||||
"journald": {
|
||||
"heading": "Ottimizza journald",
|
||||
"intro": "Riscrive <code>/etc/systemd/journald.conf</code> con valori ragionevoli affinché il journal di systemd non riempia gradualmente la partizione root, poi riavvia <code>systemd-journald</code> e ripulisce i log esistenti.",
|
||||
"keyTitle": "Valori chiave",
|
||||
"keyItems": [
|
||||
"<code>Storage=persistent</code> — tenere i registri sul disco attraverso i reboots.",
|
||||
"<code>SystemMaxUse=64M</code> / <code>RuntimeMaxUse=60M</code> — limiti all’uso di disco e memoria del journal.",
|
||||
"<code>Compress=yes</code>, <code>Seal=no</code> — comprime i log, disabilita la sigillatura con sicurezza in avanti (risparmia CPU).",
|
||||
"<code>MaxLevelStore=info</code> — salva il livello info e quelli superiori, necessari al visualizzatore log ProxMenux Monitor e a Fail2Ban per rilevare gli accessi SSH/Proxmox falliti dal journal.",
|
||||
"Limite di frequenza: <code>1000 events / 30 s</code> per evitare un flusso eccessivo di log.",
|
||||
"<code>ForwardToSyslog=no</code>, <code>ForwardToWall=no</code> — non duplicare messaggi a syslog o trasmettere a console."
|
||||
],
|
||||
"tipTitle": "Perché MaxLevelStore=info conta",
|
||||
"tipBody": "Una soglia più rigorosa come <code>warning</code> fa mostrare a ProxMenux Monitor voci quasi identiche in tutti gli intervalli, perché gran parte dell’attività è di livello info, e impedisce a Fail2Ban di vedere gli accessi falliti. Per ridurre i log usa <code>SystemMaxUse</code> e <code>RateLimitBurst</code> senza restringere i livelli salvati."
|
||||
},
|
||||
"logrotate": {
|
||||
"heading": "Ottimizza logrotate",
|
||||
"intro": "Riscrive <code>/etc/logrotate.conf</code> con impostazioni globali giornaliere e di dimensione, 7 rotazioni conservate, compressione e <code>copytruncate</code> per consentire ai servizi di scrivere senza riaprire i log. La dimensione, indicata dopo la frequenza giornaliera, prevale salvo regole specifiche del log. Il <code>logrotate.conf</code> originale viene copiato in <code>.bak</code> alla prima applicazione.",
|
||||
"tipTitle": "Compatibile con Log2RAM",
|
||||
"tipBody": "La direttiva <code>size 10M</code> prevale sull’impostazione giornaliera precedente; <em>non</em> significa il primo dei due criteri. Logrotate controlla la soglia quando viene eseguito, e le regole specifiche possono sovrascrivere quelle globali. Con <code>/var/log</code> nella RAM di Log2RAM, verifica regole e frequenza del timer per controllare lo spazio."
|
||||
},
|
||||
"limits": {
|
||||
"heading": "Aumenta i vari limiti del sistema",
|
||||
"intro": "Aumenta i limiti di kernel, systemd e PAM che possono essere troppo bassi per un host con molte VM, container e servizi di rete.",
|
||||
"headerFile": "File",
|
||||
"headerSets": "Che cosa imposta",
|
||||
"rows": [
|
||||
{
|
||||
"file": "/etc/sysctl.d/99-maxwatches.conf",
|
||||
"sets": "<code>fs.inotify.max_user_watches / max_user_instances / max_queued_events = 1048576</code>"
|
||||
},
|
||||
{
|
||||
"file": "/etc/sysctl.d/99-maxkeys.conf",
|
||||
"sets": "<code>kernel.keys.maxkeys / root_maxkeys = 1000000</code>"
|
||||
},
|
||||
{
|
||||
"file": "/etc/sysctl.d/99-swap.conf",
|
||||
"sets": "<code>vm.swappiness = 10</code>, <code>vm.vfs_cache_pressure = 100</code>"
|
||||
},
|
||||
{
|
||||
"file": "/etc/sysctl.d/99-fs.conf",
|
||||
"sets": "<code>fs.nr_open / file-max = 2097152</code>, <code>fs.aio-max-nr = 1048576</code>"
|
||||
},
|
||||
{
|
||||
"file": "/etc/security/limits.d/99-limits.conf",
|
||||
"sets": "<code>nofile</code> e <code>nproc</code> a 1.048.576 (illimitati per root)"
|
||||
},
|
||||
{
|
||||
"file": "/etc/systemd/system.conf + user.conf",
|
||||
"sets": "<code>DefaultLimitNOFILE=1048576</code> per servizi systemd"
|
||||
},
|
||||
{
|
||||
"file": "/etc/pam.d/common-session + runuser-l",
|
||||
"sets": "<code>session required pam_limits.so</code> così il suddetto si applica alle shell di login"
|
||||
},
|
||||
{
|
||||
"file": "/root/.profile",
|
||||
"sets": "<code>ulimit -n 1048576</code> per la shell root"
|
||||
}
|
||||
],
|
||||
"tipTitle": "Perché inotify è importante",
|
||||
"tipBody": "Docker, Syncthing, gli osservatori di file Node.js e le scansioni Plex possono esaurire <code>max_user_watches</code>. Il valore predefinito dipende dal kernel e dalla RAM; non è sempre 8192. Il limite di 1M consente più osservatori senza preallocarli. Quelli attivi consumano memoria del kernel: controlla l’uso sugli host con poca RAM."
|
||||
},
|
||||
"memory": {
|
||||
"heading": "Ottimizzare le impostazioni di memoria",
|
||||
"intro": "Scrive un profilo sysctl bilanciato in <code>/etc/sysctl.d/99-memory.conf</code>. È pensato per un host hypervisor: preferisce tenere in RAM la memoria attivamente usata dalle VM e libera pagine in anticipo per evitare blocchi durante picchi di allocazione.",
|
||||
"warnTitle": "swappiness=10 sugli host con poca memoria",
|
||||
"warnBody": "Su un host con 16 GB di RAM e molte VM, abbassare swappiness può portare il kernel a terminare processi per memoria esaurita invece di usare lo swap. Se gli eventi OOM sono frequenti, riporta swappiness a 30–60 in <code>/etc/sysctl.d/99-memory.conf</code> dopo lo script."
|
||||
},
|
||||
"kexec": {
|
||||
"heading": "Attiva reboot veloci (kexec)",
|
||||
"intro": "Installa <code>kexec-tools</code> e lo collega in modo da poter riavviare l'host direttamente in un nuovo kernel <em> senza passare attraverso il firmware BIOS/UEFI</em>. Su grandi server dove POST prende 45 – 90 secondi, questo trasforma un riavvio da una pausa caffè in pochi secondi di downtime.",
|
||||
"installsTitle": "Cosa installa ProxMenux",
|
||||
"installsItems": [
|
||||
"Pacchetto <code>kexec-tools</code> (debconf preimpostato con <code>kexec-tools/load_kexec boolean false</code> per evitare domande di apt e lasciare disattivato il caricamento automatico allo spegnimento).",
|
||||
"Unità systemd <code>/etc/systemd/system/kexec-pve.service</code> — carica kernel Proxmox e initrd in memoria all’avvio, riutilizzando la riga di comando attuale del kernel.",
|
||||
"Un alias in <code>/root/.bash_profile</code>: <code>reboot-quick</code> → <code>systemctl kexec</code>."
|
||||
],
|
||||
"usageIntro": "Utilizzo dopo il riavvio successivo (o manuale <code>systemctl start kexec-pve</code>):",
|
||||
"warnTitle": "Quando non usare kexec",
|
||||
"warnBody": "kexec salta l’inizializzazione del firmware. Se BIOS/UEFI deve ripristinare lo stato hardware, per esempio una GPU in passthrough che si reimposta solo con POST completo o un firmware HBA problematico, i riavvii kexec possono lasciare i dispositivi parzialmente inizializzati. Usa un <code>reboot</code> normale dopo aggiornamenti del kernel o per applicare modifiche BIOS/UEFI. <code>reboot-quick</code> serve ai riavvii quotidiani."
|
||||
},
|
||||
"panic": {
|
||||
"heading": "Abilita riavvio in caso di kernel panic",
|
||||
"intro": "Fa <strong>riavviare automaticamente</strong> il kernel invece di lasciarlo bloccato sulla schermata di panic. Essenziale per host Proxmox remoti o senza console locale: un kernel bloccato ferma tutte le VM finché non puoi spegnere e riaccendere l’host.",
|
||||
"tipTitle": "Abbina questo con accesso remoto alla console",
|
||||
"tipBody": "Il riavvio automatico serve al recupero, non al debug. Per <em>indagare</em> su un panic invece di ripartire soltanto, usa <link>l’opzione kexec</link> con il supporto kdump del kernel, non configurato da ProxMenux, oppure registra una console seriale su un altro host prima di abilitare il riavvio automatico."
|
||||
},
|
||||
"verify": {
|
||||
"heading": "Verifica",
|
||||
"intro": "Dopo aver applicato le ottimizzazioni del sistema:",
|
||||
"tipTitle": "Ripristino e limiti",
|
||||
"tipBody": "Le sei opzioni sono registrate in <code>installed_tools.json</code> e disponibili in <link>Disinstalla ottimizzazioni</link>. Il ripristino rimuove configurazioni, unità e alias kexec e ripristina journald/logrotate. Alcuni limiti attivi richiedono una nuova sessione o riavvio. Da /root/.profile viene rimosso solo il vecchio ulimit -n 256000; l’attuale ulimit -n 1048576 può restare e richiedere rimozione manuale."
|
||||
},
|
||||
"related": {
|
||||
"heading": "Correlati",
|
||||
"items": [
|
||||
{
|
||||
"label": "Comandi di sistema utili",
|
||||
"href": "/docs/help-info/system-commands",
|
||||
"tail": "— verificare le modifiche (free -h, journalctl, ulimit -a)."
|
||||
},
|
||||
{
|
||||
"label": "Prestazioni",
|
||||
"href": "/docs/post-install/performance",
|
||||
"tail": "— regolazione supplementare del livello di sistema (pigz)."
|
||||
},
|
||||
{
|
||||
"label": "Disinstalla ottimizzazioni",
|
||||
"href": "/docs/post-install/uninstall",
|
||||
"tail": "— annullare qualsiasi modifica."
|
||||
},
|
||||
{
|
||||
"label": "Post-installazione personalizzabile",
|
||||
"href": "/docs/post-install/customizable",
|
||||
"tail": " — torna al menu superiore."
|
||||
}
|
||||
]
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,271 @@
|
||||
{
|
||||
"meta": {
|
||||
"title": "Disinstalla ottimizzazioni | Documentazione ProxMenux",
|
||||
"description": "Ripristina le modifiche di configurazione post-installazione reversibili applicate da ProxMenux. Gli strumenti registrati utilizzano disinstallatori dedicati che conservano lo stato host preesistente, laddove possibile."
|
||||
},
|
||||
"header": {
|
||||
"title": "Disinstalla ottimizzazioni",
|
||||
"description": "Ripristina le modifiche reversibili apportate dagli script post-installazione automatizzati o personalizzabili. ProxMenux registra ogni ottimizzazione supportata con la sua funzione di restauro dedicata; gli aggiornamenti dei pacchetti sono intenzionalmente esclusi.",
|
||||
"section": "Impostazioni post-installazione Proxmox"
|
||||
},
|
||||
"intro": {
|
||||
"title": "Perché questo esiste",
|
||||
"body": "Ogni modifica reversibile supportata viene <strong>registrata</strong> in <code>/usr/local/share/proxmenux/installed_tools.json</code>. Il registro elenca le ottimizzazioni attive e richiama la funzione di ripristino corrispondente. Le azioni senza ripristino sicuro, come l’aggiornamento completo dei pacchetti, non vengono aggiunte."
|
||||
},
|
||||
"openMenu": {
|
||||
"heading": "Come aprirlo",
|
||||
"body": "Dal menu principale apri <strong>Impostazioni post-installazione Proxmox → Disinstalla ottimizzazioni</strong>. La lista mostra le ottimizzazioni <em>attualmente applicate</em>; quelle non applicate non compaiono.",
|
||||
"imageAlt": "Lista Disinstalla ottimizzazioni con modifiche attive sull’host e caselle per scegliere quali annullare"
|
||||
},
|
||||
"howWorks": {
|
||||
"heading": "Come funziona il ripristino",
|
||||
"steps": [
|
||||
{
|
||||
"title": "Registro e rilevamento automatico",
|
||||
"body1": "Alla prima esecuzione ProxMenux cerca indicatori sull’host: <code>/etc/sysctl.d/99-memory.conf</code>, <code>/etc/apt/apt.conf.d/99-force-ipv4</code>, pacchetto <code>haveged</code> installato, servizio Log2RAM attivo e simili. Gli elementi riconosciuti vengono registrati come reversibili anche se applicati da una versione precedente al registro.",
|
||||
"body2": "Questa migrazione funziona solo una volta. Dopo di che, ogni applicazione/ritorno aggiorna il registro direttamente."
|
||||
},
|
||||
{
|
||||
"title": "Scegli cosa ripristinare",
|
||||
"body1": "La lista mostra un nome comprensibile per ogni elemento, come <em>Ottimizzazione della memoria</em>, <em>Passthrough PCI IOMMU/VFIO</em> o <em>Log2RAM (protezione SSD)</em>. Seleziona quelli da annullare; gli altri non vengono modificati."
|
||||
},
|
||||
{
|
||||
"title": "Esecuzione del ripristino",
|
||||
"body1": "Per ogni elemento selezionato, ProxMenux chiama la sua funzione disinstallazione corrispondente. La maggior parte delle inversioni seguono uno dei tre modelli:",
|
||||
"items": [
|
||||
"<strong>Da backup</strong> — ripristina un <code>.bak</code> creato all’applicazione (bashrc, logrotate.conf, journald.conf, riga di comando GRUB/kernel).",
|
||||
"<strong>Rimozione della configurazione</strong> — elimina i file ProxMenux <code>/etc/sysctl.d/99-*.conf</code>, <code>/etc/apt/apt.conf.d/99-*</code> o l’unità systemd, poi ricarica.",
|
||||
"<strong>Reinstallazione dei pacchetti</strong> — per modifiche all’interfaccia come l’avviso di abbonamento, reinstalla i pacchetti originali con <code>--force-confnew</code> per ripristinare le impostazioni distribuite."
|
||||
],
|
||||
"body2": "Ogni inversione registra i suoi progressi. Gli elementi che richiedono un riavvio (VFIO, nomi di interfaccia persistenti) impostano una bandiera che attiva il prompt di riavvio alla fine."
|
||||
},
|
||||
{
|
||||
"title": "Richiesta di riavvio finale",
|
||||
"body1": "Dopo l'inversione il menu mostra un prompt di riavvio. Gli elementi che hanno cambiato i parametri del kernel, i moduli del kernel o la denominazione di rete (VFIO, i nomi di interfaccia persistenti) hanno bisogno del riavvio per prendere effetto; altri elementi non lo fanno, e il prompt è un default di sicurezza piuttosto che un controllo per-item."
|
||||
}
|
||||
]
|
||||
},
|
||||
"reversible": {
|
||||
"heading": "Che cosa è reversibile",
|
||||
"intro": "Le ottimizzazioni reversibili registrate e i loro disinstallatori corrispondenti sono raggruppati qui per area:",
|
||||
"groups": [
|
||||
{
|
||||
"title": "Repositori & APT",
|
||||
"items": [
|
||||
{
|
||||
"tool": "Rimozione dell’avviso di abbonamento",
|
||||
"restores": "Prima cerca di ripristinare i file UI da backup propri di ProxMenux (/usr/local/share/proxmenux/backups/proxmoxlib.js.backup.* e, quando l'interfaccia utente mobile viene patchata, index.html.tpl.backup.*). Solo se un backup è mancante o danneggiato, torna a reinstallare pve-manager, proxmox-widget-toolkit, libjs-extjs e libpve-http-server-perl con force-confnew. Inoltre cancella le copie cache .js / .gz."
|
||||
},
|
||||
{
|
||||
"tool": "Salta le lingue APT",
|
||||
"restores": "Rimuove /etc/apt/apt.conf.d/99-disable-translations, consentendo gli indici delle descrizioni tradotte secondo le altre impostazioni linguistiche APT."
|
||||
},
|
||||
{
|
||||
"tool": "Forza IPv4 per APT",
|
||||
"restores": "Rimuove /etc/apt/apt.conf.d/99-force-ipv4."
|
||||
},
|
||||
{
|
||||
"tool": "Utilità del sistema",
|
||||
"restores": "Rimuove completamente solo i pacchetti di utilità selezionati che ProxMenux ha registrato come appena installati. I pacchetti già presenti non entrano nell’elenco e restano intatti."
|
||||
}
|
||||
]
|
||||
},
|
||||
{
|
||||
"title": "Limiti di Kernel, memoria e sistema",
|
||||
"items": [
|
||||
{
|
||||
"tool": "Impostazioni della memoria",
|
||||
"restores": "Rimuove /etc/sysctl.d/99-memory.conf e ricarica sysctl."
|
||||
},
|
||||
{
|
||||
"tool": "Configurazione del kernel panic",
|
||||
"restores": "Rimuove /etc/sysctl.d/99-kernelpanic.conf."
|
||||
},
|
||||
{
|
||||
"tool": "Aumento dei limiti di sistema",
|
||||
"restores": "Rimuove /etc/sysctl.d/99-maxwatches.conf, 99-maxkeys.conf, 99-swap.conf, 99-fs.conf e /etc/security/limits.d/99-limits.conf. Ripristina limiti PAM e DefaultLimitNOFILE systemd. In /root/.profile rimuove solo il vecchio ulimit -n 256000; ulimit -n 1048576 dell’installatore attuale può restare e richiedere rimozione manuale."
|
||||
},
|
||||
{
|
||||
"tool": "Profilo swap ZRAM",
|
||||
"restores": "Disattiva lo swap /dev/zram0, ferma dev-zram0.swap e rimuove /etc/systemd/zram-generator.conf.d/90-proxmenux.conf. Rimuove completamente systemd-zram-generator solo se installato da ProxMenux e senza altre configurazioni ZRAM. Se non può spostare le pagine fuori da ZRAM, il profilo rimane attivo e non elimina nulla."
|
||||
}
|
||||
]
|
||||
},
|
||||
{
|
||||
"title": "Rete",
|
||||
"items": [
|
||||
{
|
||||
"tool": "Ottimizzazione della rete",
|
||||
"restores": "Rimuove /etc/sysctl.d/99-network.conf, 97-proxmenux-fwbr.conf e 98-proxmenux-rpf.conf, l’unità proxmenux-fwbr-tune.service, lo script /usr/local/sbin/proxmenux-fwbr-tune e la regola udev /etc/udev/rules.d/99-zz-proxmenux-fwbr-tune.rules. Elimina anche source /etc/network/interfaces.d/* da /etc/network/interfaces. Ricarica sysctl, systemd e le regole udev."
|
||||
},
|
||||
{
|
||||
"tool": "Open vSwitch",
|
||||
"restores": "Esegue apt purge su openvswitch-switch e openvswitch-common. Migrare eventuali ponti OVS indietro ai ponti Linux prima di eseguire questa disinstallazione — altrimenti le VM su quei ponti perdono la rete sul prossimo avvio."
|
||||
},
|
||||
{
|
||||
"tool": "TCP BBR + TCP Fast Open",
|
||||
"restores": "Rimuove /etc/sysctl.d/99-kernel-bbr.conf e 99-tcp-fastopen.conf e ricarica le altre impostazioni sysctl. Eliminare i file non ripristina i valori attivi; valori come cubic e tcp_fastopen=1 tornano al riavvio salvo altre configurazioni."
|
||||
},
|
||||
{
|
||||
"tool": "Nomi di interfaccia persistenti",
|
||||
"restores": "Rimuove solo i file 10-proxmenux-*.link che trasportano l'intestazione ProxMenux da /etc/systemd/network/. Qualsiasi file .link fornito da un altro pacchetto o scritto dall'utente viene lasciato in posizione. I nomi delle interfacce ritornano al comportamento predefinito di systemd nel prossimo riavvio."
|
||||
}
|
||||
]
|
||||
},
|
||||
{
|
||||
"title": "Registrazione",
|
||||
"items": [
|
||||
{
|
||||
"tool": "Ottimizzazione di journald",
|
||||
"restores": "Riscrive /etc/systemd/journald.conf con i valori predefiniti originali e riavvia systemd-journald."
|
||||
},
|
||||
{
|
||||
"tool": "Ottimizzazione Logrotate",
|
||||
"restores": "Ripristina /etc/logrotate.conf dal file .bak catturato prima della modifica."
|
||||
},
|
||||
{
|
||||
"tool": "Log2RAM",
|
||||
"restores": "Ferma e disabilita servizio e timer. Elimina processi cron, unità systemd, binari, configurazione e /var/log.hdd. Rimuove anche il pacchetto apt se installato in quel modo."
|
||||
},
|
||||
{
|
||||
"tool": "TRIM automatico ZFS",
|
||||
"restores": "Legge /usr/local/share/proxmenux/zfs_autotrim_pools, l’elenco dei pool realmente modificati, ed esegue zpool set autotrim=off su ciascuno. Non tocca autotrim abilitato manualmente prima di ProxMenux."
|
||||
}
|
||||
]
|
||||
},
|
||||
{
|
||||
"title": "Shell & apparenza",
|
||||
"items": [
|
||||
{
|
||||
"tool": "Personalizzazione di Bashrc",
|
||||
"restores": "Ripristina /root/.bashrc dal backup .bak. Se non esiste alcun backup, rimuove il blocco PMX_CORE_BASHRC da marcatori."
|
||||
},
|
||||
{
|
||||
"tool": "Banner MOTD personalizzato",
|
||||
"restores": "Ripristina l'esatto contenuto originale /etc/motd mantenuto sotto /usr/local/share/proxmenux, rimuove il file quando non esisteva prima, o rimuove in modo sicuro il marcatore legacy durante la migrazione di un'installazione precedente."
|
||||
},
|
||||
{
|
||||
"tool": "Fastfetch",
|
||||
"restores": "Rimuove binario, directory di configurazione, hook update-motd e blocco delimitato BEGIN FASTFETCH / END FASTFETCH da /root/.bashrc, ~/.profile, /etc/profile e /etc/profile.d/fastfetch.sh. Rimuove completamente il pacchetto apt se installato."
|
||||
},
|
||||
{
|
||||
"tool": "Figurine",
|
||||
"restores": "Rimuove il binario, la voce profile.d e il blocco alias in bashrc/profile."
|
||||
}
|
||||
]
|
||||
},
|
||||
{
|
||||
"title": "Hardware e virtualizzazione",
|
||||
"items": [
|
||||
{
|
||||
"tool": "IOMMU / VFIO",
|
||||
"restores": "Rimuove i moduli vfio da /etc/modules, il nouveau / radeon / nvidia blacklist, e intel_iommu=on / amd_iommu=on / iommu=pt / pcie_acs_override parametri da /etc/kernel/cmdline (ZFS) o GRUB. Ricostruisce initramfs."
|
||||
},
|
||||
{
|
||||
"tool": "AMD CPU correzioni (Ryzen/EPYC)",
|
||||
"restores": "Rimuove idle=nomwait dal kernel cmdline (ZFS) o GRUB, e le opzioni ignore_msrs / report_ignored_msrs da /etc/modprobe.d/kvm.conf."
|
||||
},
|
||||
{
|
||||
"tool": "Agente guest per un host Proxmox virtualizzato",
|
||||
"restores": "Legge /usr/local/share/proxmenux/guest_agent.pkg e rimuove il pacchetto host registrato. L’installatore sceglie qemu-guest-agent, open-vm-tools o virtualbox-guest-utils secondo l’hypervisor. Senza registrazione prova quei tre pacchetti. Agisce sull’host Proxmox annidato, non sui modelli guest."
|
||||
}
|
||||
]
|
||||
},
|
||||
{
|
||||
"title": "Archiviazione",
|
||||
"items": [
|
||||
{
|
||||
"tool": "Dimensionamento dell'ARC ZFS",
|
||||
"restores": "Rimuove /etc/modprobe.d/99-zfsarc.conf, ripristina i file *.conf esterni in conflitto salvati in /usr/local/share/proxmenux/backups/zfs_arc/, ricrea initramfs ed esegue proxmox-boot-tool refresh sugli host systemd-boot."
|
||||
},
|
||||
{
|
||||
"tool": "Snapshot automatici ZFS",
|
||||
"restores": "Rimuove le voci cron scritte dallo script e propone apt purge zfs-auto-snapshot. Gli snapshot esistenti sui pool restano intatti; eliminali separatamente se necessario."
|
||||
},
|
||||
{
|
||||
"tool": "Limiti di velocità di vzdump",
|
||||
"restores": "Ripristina /etc/vzdump.conf dal .bak l'installazione creata, riportando bwlimit e ionice ai valori pre-ProxMenux."
|
||||
}
|
||||
]
|
||||
},
|
||||
{
|
||||
"title": "Servizi e extra",
|
||||
"items": [
|
||||
{
|
||||
"tool": "Sincronizzazione del tempo",
|
||||
"restores": "Imposta il fuso orario di ritorno a UTC (impostazione predefinita sicura) tramite timedatectl."
|
||||
},
|
||||
{
|
||||
"tool": "Generazione di entropia (haveged)",
|
||||
"restores": "Ferma, disabilita e rimuove completamente il pacchetto haveged."
|
||||
},
|
||||
{
|
||||
"tool": "kexec (riavvii rapidi)",
|
||||
"restores": "Disabilita kexec-pve.service, rimuove il file dell'unità e gli alias reboot-quick da /root/.bash_profile, purges kexec-tools."
|
||||
},
|
||||
{
|
||||
"tool": "RPC / rpcbind Disabilitazione",
|
||||
"restores": "Ripristina separatamente rpcbind.service e rpcbind.socket negli stati abilitato/disabilitato e attivo/inattivo registrati prima di ProxMenux."
|
||||
},
|
||||
{
|
||||
"tool": "pigz (gzip parallelo)",
|
||||
"restores": "Ripristina il vero gzip da gzip.distrib, rimuove la deviazione dpkg e /bin/pigzwrapper, commenta la riga pigz in /etc/vzdump.conf ed esegue apt purge pigz dopo aver verificato gzip."
|
||||
},
|
||||
{
|
||||
"tool": "Servizi di alta disponibilità",
|
||||
"restores": "Ferma e disabilita pve-ha-lrm, pve-ha-crm e corosync. I gruppi HA esistenti e le definizioni delle risorse non vengono eliminati — rimuoverli dall'interfaccia utente web se non ne hai più bisogno."
|
||||
},
|
||||
{
|
||||
"tool": "repository Ceph",
|
||||
"restores": "Rimuove completamente i pacchetti Ceph installati dall’opzione, elimina il file deb822 /etc/apt/sources.list.d/ceph.sources su PVE 9 o la vecchia lista Ceph su PVE 8 e aggiorna la cache APT."
|
||||
},
|
||||
{
|
||||
"tool": "OVH RTM (monitoraggio)",
|
||||
"restores": "Rimuove i pacchetti corrispondenti a ovh-rtm*, rtm e rtm-*, elimina /etc/rtm e la voce RTM dal registro. I residui Puppet in /etc/puppet/ possono richiedere verifica e pulizia manuale; la directory non viene eliminata. Su host non OVH l’installatore normalmente non modifica nulla."
|
||||
}
|
||||
]
|
||||
}
|
||||
]
|
||||
},
|
||||
"edge": {
|
||||
"heading": "Casi particolari e limiti",
|
||||
"packageTitle": "La reinstallazione interessa pacchetti Proxmox in uso",
|
||||
"packageBody": "Se le copie ProxMenux non possono annullare <strong>Rimozione dell’avviso di abbonamento</strong>, il ripiego reinstalla <code>pve-manager</code>, <code>proxmox-widget-toolkit</code>, <code>libjs-extjs</code> e <code>libpve-http-server-perl</code> con <code>--force-confnew</code>. Interessa l’interfaccia web in uso: ricarica il browser e attendi qualche secondo per riconnetterti. Evitalo durante migrazioni o clonazioni.",
|
||||
"rebootTitle": "I nomi persistenti e VFIO hanno bisogno di un riavvio",
|
||||
"rebootBody": "Eliminare i file <code>10-proxmenux-*.link</code> (<em>Nomi persistenti delle interfacce</em>) e annullare <em>IOMMU/VFIO</em> non cambia il sistema già avviato: le modifiche si applicano dopo il riavvio. ProxMenux segnala automaticamente la necessità di riavviare.",
|
||||
"perItemTitle": "Puoi annullare una modifica e conservare le altre",
|
||||
"perItemBody": "Il disinstallatore opera per-item. Se si desidera solo rimuovere Log2RAM ma mantenere il tuning di rete e le modifiche bashrc, selezionare solo <em>Log2RAM</em>. Nient'altro è toccato, e il registro è aggiornato di conseguenza."
|
||||
},
|
||||
"inspect": {
|
||||
"heading": "Ispezione manuale del registro",
|
||||
"intro": "Se volete vedere cosa è tracciato senza aprire il menu:",
|
||||
"outro": "Ogni voce <code>\"tool\": true</code> corrisponde a qualcosa che ProxMenux applicato e può invertire. Rimuovere una voce manualmente non è raccomandato — utilizzare sempre il menu, che esegue anche la funzione inversione invece di semplicemente dimenticando il cambiamento.",
|
||||
"reinstallTitle": "Reinstallare dopo aver disinstallato",
|
||||
"reinstallBody": "Puoi riapplicare in seguito un’ottimizzazione annullata. Apri di nuovo <link>il menu post-installazione</link> ed esegui Automatizzato o Personalizzabile: il registro memorizzerà il nuovo stato."
|
||||
},
|
||||
"related": {
|
||||
"heading": "Correlati",
|
||||
"items": [
|
||||
{
|
||||
"label": "Post-Install automatizzato",
|
||||
"href": "/docs/post-install/automated",
|
||||
"tail": " — riapplica la configurazione di base consigliata."
|
||||
},
|
||||
{
|
||||
"label": "Post-installazione personalizzabile",
|
||||
"href": "/docs/post-install/customizable",
|
||||
"tail": "— scegliere un sottoinsieme diverso."
|
||||
},
|
||||
{
|
||||
"label": "Disinstalla ProxMenux",
|
||||
"href": "/docs/settings/uninstall-proxmenux",
|
||||
"tail": "— operazione diversa: rimuove ProxMenux se stessa, non le sue ottimizzazioni applicate."
|
||||
},
|
||||
{
|
||||
"label": "Panoramica post-install",
|
||||
"href": "/docs/post-install",
|
||||
"tail": "."
|
||||
}
|
||||
]
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,112 @@
|
||||
{
|
||||
"meta": {
|
||||
"title": "Applica aggiornamenti disponibili — Ottimizzazioni post-installazione | Documentazione ProxMenux",
|
||||
"description": "Come ProxMenux rileva quando un'ottimizzazione post-install (Log2Ram, Impostazioni di memoria, Limiti di sistema, Logrotate, tuning di rete...) è stata aggiornata a monte e come applicare la nuova versione — dal menu Post-Install o dal cruscotto Monitor."
|
||||
},
|
||||
"header": {
|
||||
"title": "Applica aggiornamenti disponibili",
|
||||
"description": "Quando sul disco è presente una versione di un’ottimizzazione post-installazione (Log2Ram, impostazioni della memoria, limiti di sistema, Logrotate …) più recente di quella registrata sull’host, ProxMenux la segnala come aggiornamento disponibile. Puoi applicarla dal menu di post-installazione nell’interfaccia degli script oppure dalla dashboard del Monitor. Entrambi i percorsi rieseguono la stessa funzione di post-installazione e ne aggiornano la versione registrata.",
|
||||
"section": "Impostazioni post-installazione Proxmox"
|
||||
},
|
||||
"intro": {
|
||||
"title": "Che cosa è questo",
|
||||
"body": "Le ottimizzazioni post-installazione ProxMenux hanno versioni, ad esempio <code>Log2ram SSD Protection v1.2</code>. L’host registra quelle attive e le relative versioni in <code>/usr/local/share/proxmenux/installed_tools.json</code>. Quando una nuova versione ProxMenux aggiorna un’ottimizzazione, viene rilevata la differenza ed è possibile riapplicare solo quella, senza ripetere tutta la post-installazione."
|
||||
},
|
||||
"why": {
|
||||
"heading": "Perché questo esiste",
|
||||
"body": "Le ottimizzazioni post-installazione ricevono miglioramenti: regolazioni sysctl, limiti Logrotate più severi, nuovi criteri di dimensionamento Log2RAM o correzioni di casi limite. Senza questa modalità occorreva ripetere lo script, che riapplica <em>tutte</em> le ottimizzazioni, oppure rinunciare al miglioramento. Applica aggiornamenti disponibili permette di scegliere solo quelle la cui versione è cambiata."
|
||||
},
|
||||
"detection": {
|
||||
"heading": "Come vengono rilevati gli aggiornamenti",
|
||||
"steps": [
|
||||
{
|
||||
"title": "Script con versione su disco",
|
||||
"body": "Ogni funzione post-installazione dichiara la sua versione all'interno dello script (<code>scripts/post_install/auto_post_install.sh</code> e <code>scripts/post_install/customizable_post_install.sh</code>). Uno scanner estrae queste versioni dalla fonte sul disco."
|
||||
},
|
||||
{
|
||||
"title": "Registro delle versioni sull’host",
|
||||
"body": "Quando l'operatore ha applicato ogni ottimizzazione, la corrispondente chiamata <code>register_tool</code> ha scritto la versione attiva in <code>/usr/local/share/proxmenux/installed_tools.json</code>. Questo file è la fonte della verità per \"che cosa è attivo su questo host in questo momento\"."
|
||||
},
|
||||
{
|
||||
"title": "Monitor confronta entrambi i lati",
|
||||
"body": "All’avvio e ogni 24 ore, Monitor confronta le versioni su disco con quelle registrate. Ogni differenza genera una voce in <code>/usr/local/share/proxmenux/updates_available.json</code>. Il file alimenta la voce del menu post-installazione e la scheda della dashboard Monitor."
|
||||
},
|
||||
{
|
||||
"title": "Una notifica per nuova versione",
|
||||
"body": "Quando almeno un’ottimizzazione ha un aggiornamento in attesa, Monitor invia un’unica notifica raggruppata, ad esempio <em>«4 aggiornamenti delle ottimizzazioni ProxMenux disponibili»</em>, con una riga per strumento nel formato <code>name (vX → vY)</code>, come per i pacchetti Proxmox. Non si ripete ogni giorno per lo stesso insieme: si riattiva solo con una nuova versione o un nuovo strumento nell’elenco."
|
||||
}
|
||||
]
|
||||
},
|
||||
"pathA": {
|
||||
"heading": "Percorso A — Dal menu post-installazione",
|
||||
"intro": "Dal menu principale ProxMenux, apri <strong>Impostazioni post-installazione Proxmox</strong>. Con aggiornamenti in attesa compare <strong>Applica aggiornamenti disponibili (N)</strong> sopra <em>Disinstalla ottimizzazioni</em>. Il numero indica quante ottimizzazioni hanno una versione su disco più recente di quella registrata. Se tutto è aggiornato, la voce è nascosta.",
|
||||
"menuAlt": "Menu degli script post-installazione con Applica aggiornamenti disponibili (N) sopra Disinstalla ottimizzazioni; il contatore indica quante ottimizzazioni hanno una versione più recente su disco",
|
||||
"menuCaption": "<em>Applica aggiornamenti disponibili (N)</em> compare solo se almeno un’ottimizzazione ha un aggiornamento in attesa; si nasconde quando l’host è aggiornato.",
|
||||
"checklistBody": "Apre una lista con tutti gli aggiornamenti in attesa, nel formato <code>name (vX → vY)</code>. Sono tutti selezionati per impostazione predefinita: deseleziona quelli che non vuoi applicare ora.",
|
||||
"checklistAlt": "Finestra Applica aggiornamenti disponibili con una riga per ottimizzazione in attesa, nome e passaggio di versione (attuale → disponibile). Tutte le righe sono selezionate.",
|
||||
"checklistCaption": "Seleziona le singole ottimizzazioni da aggiornare. Lo stesso motore usato per la post-installazione automatica e personalizzabile riesegue in background ogni funzione selezionata e ne aggiorna la versione registrata."
|
||||
},
|
||||
"pathB": {
|
||||
"heading": "Percorso B — Dalla dashboard Monitor",
|
||||
"intro": "Gli stessi aggiornamenti compaiono in Monitor sotto <link>Impostazioni → Ottimizzazioni ProxMenux</link>. La scheda mostra un <strong>contatore degli aggiornamenti</strong> in attesa che apre il selettore per ottimizzazione. Ogni strumento ha anche la propria azione di aggiornamento.",
|
||||
"imageAlt": "Scheda Ottimizzazioni ProxMenux nelle impostazioni Monitor con contatore degli aggiornamenti che apre il selettore e azioni di aggiornamento per ogni strumento",
|
||||
"imageCaption": "La scheda Ottimizzazioni di Monitor rende accessibili gli aggiornamenti dal contatore quando esiste una versione più recente su disco, senza accedere alla shell."
|
||||
},
|
||||
"applying": {
|
||||
"heading": "Cosa succede quando si applica",
|
||||
"steps": [
|
||||
{
|
||||
"title": "Riesegue la funzione post-installazione",
|
||||
"body": "La funzione scelta viene rieseguita sull’host. Essendo <strong>idempotente</strong>, non duplica la configurazione: sostituisce la versione precedente con la nuova, inclusi file sysctl, configurazioni aggiuntive e unità dei servizi."
|
||||
},
|
||||
{
|
||||
"title": "Aggiorna il registro",
|
||||
"body": "La chiamata <code>register_tool</code> nella funzione scrive la nuova versione in <code>installed_tools.json</code>. La scansione successiva non rileva più differenze e l’aggiornamento scompare dal menu e dalla scheda Monitor."
|
||||
},
|
||||
{
|
||||
"title": "Nessun riavvio a meno che la funzione non lo dica",
|
||||
"body": "La maggior parte degli aggiornamenti hanno effetto immediatamente. Gli aggiornamenti che toccano i moduli del kernel, i nomi di interfaccia persistenti, o VFIO mostrano lo stesso prompt di riavvio di una nuova installazione."
|
||||
},
|
||||
{
|
||||
"title": "Aggiornamento del Registro inviato al Monitor",
|
||||
"body": "Al termine del gruppo, il menu invia una richiesta POST a <code>http://127.0.0.1:8008/api/updates/post-install/scan</code> per ricostruire <code>/usr/local/share/proxmenux/updates_available.json</code>. Dopo tutti gli aggiornamenti scompaiono il contatore nella scheda Ottimizzazioni e la voce condizionale della shell, senza attendere la scansione successiva. La scheda resta disponibile."
|
||||
}
|
||||
],
|
||||
"jqTitle": "jq è necessario",
|
||||
"jqBody": "La lista del percorso A usa <code>jq</code> per leggere il JSON degli aggiornamenti. Se <code>jq</code> manca, termina senza messaggi: vedresti il menu con il conteggio ma nulla accadrebbe dopo la selezione. Su un’installazione Proxmox moderna <code>jq</code> è presente; in caso di dubbio esegui <code>apt install -y jq</code>."
|
||||
},
|
||||
"differs": {
|
||||
"heading": "Come differisce dagli altri percorsi",
|
||||
"headerPath": "Path",
|
||||
"headerScope": "Ambito",
|
||||
"headerWhen": "Quando ha senso",
|
||||
"rows": [
|
||||
{
|
||||
"pathLabel": "Automatizzato",
|
||||
"pathHref": "/docs/post-install/automated",
|
||||
"scope": "Riapplica <em>tutte</em> le ottimizzazioni del pacchetto.",
|
||||
"when": "Host nuovo o riapplicazione completa della configurazione di base di un nodo interamente gestito."
|
||||
},
|
||||
{
|
||||
"pathLabel": "Personalizzabile",
|
||||
"pathHref": "/docs/post-install/customizable",
|
||||
"scope": "Scegli dal catalogo completo.",
|
||||
"when": "Scegliere esattamente quali ottimizzazioni sono attive sull’host."
|
||||
},
|
||||
{
|
||||
"pathLabel": "Applica aggiornamenti disponibili",
|
||||
"pathHref": null,
|
||||
"scope": "Solo le ottimizzazioni con una versione più recente su disco.",
|
||||
"when": "Mantenere aggiornate le ottimizzazioni installate senza toccare il resto."
|
||||
},
|
||||
{
|
||||
"pathLabel": "Disinstalla ottimizzazioni",
|
||||
"pathHref": "/docs/post-install/uninstall",
|
||||
"scope": "Invertire l'ottimizzazione e rimuovere la sua voce di registro.",
|
||||
"when": "Annullare una modifica specifica."
|
||||
}
|
||||
]
|
||||
},
|
||||
"notifTitle": "Controllo della notifica",
|
||||
"notifBody": "L’evento <em>Aggiornamenti delle ottimizzazioni ProxMenux disponibili</em> annuncia gli aggiornamenti in attesa. È attivo per impostazione predefinita su ogni canale e può essere silenziato per canale in <link>Impostazioni → Notifiche</link>. Si attiva una sola volta per insieme distinto di aggiornamenti, non a ogni scansione di 24 ore."
|
||||
}
|
||||
@@ -0,0 +1,116 @@
|
||||
{
|
||||
"meta": {
|
||||
"title": "Post-installazione: Virtualizzazione | Documentazione ProxMenux",
|
||||
"description": "Opzioni di virtualizzazione nel ProxMenux Personalizzabile script post-installazione: installare automaticamente l'agente ospite giusto se Proxmox viene eseguito all'interno di un VM e abilitare IOMMU / VFIO in modo da poter passare i dispositivi PCI (GPU, NIC, HBA) attraverso le proprie VM."
|
||||
},
|
||||
"header": {
|
||||
"title": "Post-Install: Virtualizzazione",
|
||||
"section": "Impostazioni post-installazione Proxmox"
|
||||
},
|
||||
"intro": {
|
||||
"title": "Che cosa copre questa categoria",
|
||||
"body": "Due opzioni indipendenti. <strong>Installa il guest agent appropriato</strong> serve quando Proxmox stesso gira dentro un altro hypervisor. <strong>Abilita supporto VFIO IOMMU</strong> interessa la maggior parte degli utenti: attiva le funzioni del kernel per assegnare direttamente GPU, HBA o schede di rete a una VM con prestazioni quasi native."
|
||||
},
|
||||
"guestAgent": {
|
||||
"heading": "Installa il guest agent appropriato",
|
||||
"intro": "Rileva l’ambiente di virtualizzazione dell’host Proxmox tramite <code>systemd-detect-virt</code> e <code>dmidecode</code> e installa gli strumenti guest adatti per comunicare correttamente con l’hypervisor esterno: arresto ordinato, sincronizzazione dell’orologio, informazioni IP, ecc.",
|
||||
"headerDetected": "Host rilevato",
|
||||
"headerPackage": "Pacchetto installato",
|
||||
"rows": [
|
||||
{
|
||||
"detected": "QEMU / KVM",
|
||||
"package": "qemu-guest-agent"
|
||||
},
|
||||
{
|
||||
"detected": "VMware (ESXi, Workstation)",
|
||||
"package": "open-vm-tools"
|
||||
},
|
||||
{
|
||||
"detected": "VirtualBox",
|
||||
"package": "virtualbox-guest-utils"
|
||||
},
|
||||
{
|
||||
"detected": "Bare metal (nessuno)",
|
||||
"package": "— no-op, niente installato"
|
||||
}
|
||||
],
|
||||
"skipTitle": "Salta questo su bare-metal Proxmox",
|
||||
"skipBody": "Se Proxmox gira direttamente sull’hardware, il caso comune, selezionare l’opzione non cambia nulla: il rilevatore restituisce <code>none</code> e lo script termina senza modifiche. Serve solo alle configurazioni che eseguono Proxmox <em>come guest</em> per test o laboratori."
|
||||
},
|
||||
"vfio": {
|
||||
"heading": "Abilita supporto VFIO IOMMU",
|
||||
"intro": "Attiva IOMMU sull’host e carica i moduli per il passthrough PCI (<code>vfio</code>, <code>vfio_iommu_type1</code>, <code>vfio_pci</code>). Puoi così assegnare un dispositivo fisico a una VM, che vi accede direttamente con prestazioni quasi native.",
|
||||
"whoTitle": "Chi ha bisogno di questo",
|
||||
"whoItems": [
|
||||
"Vuoi assegnare una GPU a una VM Windows per il gaming o a una VM macOS.",
|
||||
"Hai un NIC 10G dedicato per un firewall/router VM (OPNsense, pfSense).",
|
||||
"Si desidera passare un HBA direttamente a un TrueNAS/Unraid VM per ZFS su dischi nudi.",
|
||||
"Prevedi di usare una <em>Coral TPU</em>, una scheda di acquisizione o un dongle SDR in una VM."
|
||||
],
|
||||
"whoOutro": "Se non ti serve nulla di questo, puoi saltare l’opzione. Per l’accesso ai dispositivi da un <strong>LXC</strong>, invece di una VM, IOMMU <em>non</em> è necessario.",
|
||||
"doesTitle": "Cosa fa ProxMenux",
|
||||
"doesIntro": "La funzione tiene conto del boot loader: rileva ZFS (systemd-boot) o LVM/ext4 (GRUB) e scrive nel file corretto. È idempotente: se i parametri esistono già, non li aggiunge di nuovo.",
|
||||
"headerBoot": "Tipo di avvio",
|
||||
"headerFile": "File modificato",
|
||||
"headerPost": "Passo dopo aggiornamento",
|
||||
"bootRows": [
|
||||
{
|
||||
"boot": "systemd-boot (ZFS)",
|
||||
"file": "/etc/kernel/cmdline",
|
||||
"post": "proxmox-boot-tool refresh"
|
||||
},
|
||||
{
|
||||
"boot": "GRUB (LVM/ext4)",
|
||||
"file": "/etc/default/grub",
|
||||
"post": "update-grub"
|
||||
}
|
||||
],
|
||||
"kernelIntro": "Parametri del kernel aggiunti:",
|
||||
"modulesIntro": "Moduli Kernel aggiunti a <code>/etc/modules</code>:",
|
||||
"blacklistIntro": "Driver in conflitto inseriti nella blacklist in <code>/etc/modprobe.d/blacklist.conf</code>:",
|
||||
"blacklistTitle": "La blacklist dei driver GPU impedisce l’uso della GPU sull’host",
|
||||
"blacklistBody": "La blacklist impedisce al kernel host di associare <em>qualsiasi</em> driver GPU, permettendo a VFIO di acquisire la GPU. È ciò che serve per il passthrough a una VM, ma è l’<strong>opposto</strong> di quanto necessario per <link>installare i driver NVIDIA sull’host</link>, ad esempio per la transcodifica LXC. Scegli un percorso per ogni GPU:",
|
||||
"pathItems": [
|
||||
"<strong>GPU → VM:</strong> abilita VFIO/IOMMU qui e lascia i driver GPU nella blacklist.",
|
||||
"<strong>GPU → LXC (o host):</strong> salta questa opzione, usa l’installazione NVIDIA sull’host e non inserire nvidia/nouveau nella blacklist.",
|
||||
"<strong>Due GPU:</strong> una può andare a una VM e l’altra a un LXC, ma serve una configurazione più precisa: associare solo una scheda a <code>vfio-pci</code> tramite ID PCI. La blacklist predefinita è troppo ampia: modifica poi <code>blacklist.conf</code>."
|
||||
],
|
||||
"acsTitle": "Informazioni su pcie_acs_override — sapere cosa stai abilitando",
|
||||
"acsBody": "<code>pcie_acs_override=downstream,multifunction</code> allenta il controllo PCIe Access Control Services. Il kernel può separare gruppi IOMMU che il firmware indica come indivisibili, talvolta l’unico modo per assegnare un dispositivo senza l’intero gruppo. Il compromesso è <strong>un isolamento ridotto tra dispositivi</strong>: una VM malevola o compromessa con passthrough ha una superficie di attacco DMA maggiore. Accettabile in un laboratorio domestico, da valutare bene su host con carichi non attendibili. Se non serve, rimuovi il parametro da <code>/etc/kernel/cmdline</code> o <code>/etc/default/grub</code> dopo lo script e ripeti l’aggiornamento del boot loader.",
|
||||
"rebootTitle": "Riavvio necessario",
|
||||
"rebootBody": "IOMMU, moduli VFIO e blacklist hanno effetto dopo la rigenerazione di initramfs e il riavvio. Lo script esegue <code>update-initramfs -u -k all</code>, aggiorna il boot loader e imposta «riavvio necessario», così Personalizzabile lo propone alla fine.",
|
||||
"verifyTitle": "Verifica dopo il riavvio",
|
||||
"revertTitle": "Reversibile dal menu Disinstalla",
|
||||
"revertBody": "<link>Rimuovi le ottimizzazioni</link> annulla tutte le modifiche: elimina i parametri IOMMU da <code>/etc/kernel/cmdline</code> o da GRUB, rimuove i moduli VFIO da <code>/etc/modules</code>, elimina le voci della blacklist dei driver e ricostruisce initramfs. Per applicare effettivamente il ripristino è necessario riavviare."
|
||||
},
|
||||
"related": {
|
||||
"heading": "Correlati",
|
||||
"items": [
|
||||
{
|
||||
"label": "Aggiungi GPU a VM (Passthrough)",
|
||||
"href": "/docs/hardware/gpu-vm-passthrough",
|
||||
"tail": "— passo successivo naturale una volta abilitato IOMMU + VFIO."
|
||||
},
|
||||
{
|
||||
"label": "Aggiungi controller o NVMe a VM",
|
||||
"href": "/docs/disk-manager/add-controller-nvme-vm",
|
||||
"tail": " — la stessa infrastruttura di passthrough per i controller di archiviazione."
|
||||
},
|
||||
{
|
||||
"label": "Comandi di passaggio GPU",
|
||||
"href": "/docs/help-info/gpu-commands",
|
||||
"tail": "— Riferimento di verifica IOMMU."
|
||||
},
|
||||
{
|
||||
"label": "Disinstalla ottimizzazioni",
|
||||
"href": "/docs/post-install/uninstall",
|
||||
"tail": " — annulla IOMMU / VFIO in modo pulito."
|
||||
},
|
||||
{
|
||||
"label": "Post-installazione personalizzabile",
|
||||
"href": "/docs/post-install/customizable",
|
||||
"tail": " — torna al menu superiore."
|
||||
}
|
||||
]
|
||||
}
|
||||
}
|
||||
Reference in New Issue
Block a user