mirror of
https://github.com/MacRimi/ProxMenux.git
synced 2026-11-01 10:22:08 +00:00
Merge pull request #487 from jcastro/docs/review-post-install
docs: review post-install documentation in all seven translations
This commit is contained in:
MacRimi
@@ -282,8 +282,8 @@ done < /usr/local/share/proxmenux/zfs_autotrim_pools`}
|
||||
|
||||
<h3 className="text-lg font-semibold mt-6 mb-2 text-gray-900">{t("vzdump.changedTitle")}</h3>
|
||||
<CopyableCode
|
||||
code={`bwlimit: 0 # No bandwidth limit (was capped by default)
|
||||
ionice: 5 # Lower I/O priority (5 = best-effort class, lowest priority in that class)`}
|
||||
code={`bwlimit: 0 # No bandwidth limit; replaces any configured global cap
|
||||
ionice: 5 # Best-effort level 5; higher priority than the default 7 where supported`}
|
||||
className="my-4"
|
||||
/>
|
||||
|
||||
|
||||
@@ -0,0 +1,172 @@
|
||||
{
|
||||
"meta": {
|
||||
"title": "Automatisiertes Nachinstallationsskript | ProxMenux Dokumentation",
|
||||
"description": "Das automatisierte Nachinstallationsskript von ProxMenux führt 14 festgelegte, hardwareabhängige Optimierungen auf einem neuen Proxmox-VE-Host aus. Es gibt keine Funktionsauswahlliste; Systemaktualisierung, Bannerentfernung, manche Log2RAM-Installationen und Neustart können jedoch eine Bestätigung verlangen. Rückgängig zu machende Konfigurationsänderungen werden erfasst.",
|
||||
"ogTitle": "Automatisiertes Nachinstallationsskript | ProxMenux Dokumentation",
|
||||
"ogDescription": "14 festgelegte, hardwareabhängige Optimierungen für einen neuen Proxmox-VE-Host, mit Bestätigungen für einige Aktionen und Erfassung rückgängig zu machender Änderungen."
|
||||
},
|
||||
"header": {
|
||||
"title": "Automatisiertes Post-Install-Skript",
|
||||
"description": "ProxMenux führt 14 festgelegte Basisoptimierungen ohne Funktionsauswahlliste aus. Einige Aktionen verlangen eine Bestätigung. Rückgängig zu machende Konfigurationsänderungen werden für Optimierungen deinstallieren erfasst; Paket-Upgrades werden nicht als reversibel beschrieben.",
|
||||
"section": "Post-Installation · Automatisiert"
|
||||
},
|
||||
"intro": {
|
||||
"title": "Wann automatisiert ausgewählt werden soll",
|
||||
"body": "Führen Sie dies auf einem frisch installierten Proxmox-Host aus, wenn Sie eine sinnvolle Basislinie wünschen, ohne Entscheidungen treffen zu müssen. Das Skript ist idempotent – es ist sicher, es zweimal auszuführen, es wendet lediglich dieselben Konfigurationen erneut an. Opt-in-Funktionen (Fastfetch, IOMMU, Ceph Repo, HA, AMD-Fixes…) sind absichtlich <strong>nicht</strong> Teil dieses Pfades; Wählen Sie sie bei Bedarf unter <link>Anpassbar</link> aus."
|
||||
},
|
||||
"applies": {
|
||||
"heading": "Was das Skript anwendet",
|
||||
"intro": "Die Optimierungen werden genau in dieser Reihenfolge angewendet. Die Spalte <em>Kategorie</em> verlinkt auf die ausführliche Dokumentation jeder Änderung in der anpassbaren Nachinstallation.",
|
||||
"headerNum": "#",
|
||||
"headerTool": "Werkzeug",
|
||||
"headerWhat": "Was es tut",
|
||||
"headerCategory": "Kategorie"
|
||||
},
|
||||
"optimizations": [
|
||||
{
|
||||
"tool": "APT-Repositorys + vollständiges Upgrade",
|
||||
"what": "Deaktiviert die Enterprise-Quellen pve-enterprise.sources und ceph.sources, erstellt eine passende No-Subscription-Quelle für den Debian-Codenamen des Hosts und führt apt update && apt full-upgrade -y aus (offizieller Proxmox-Upgrade-Befehl).",
|
||||
"category": "Grundeinstellungen",
|
||||
"categorySlug": "basic-settings"
|
||||
},
|
||||
{
|
||||
"tool": "Subskriptionsbanner entfernen",
|
||||
"what": "Passt die Weboberfläche an, um den Hinweis „Kein gültiges Abonnement“ auszublenden. Fragt vorher nach Bestätigung; über Optimierungen deinstallieren rückgängig zu machen.",
|
||||
"category": "Anpassung",
|
||||
"categorySlug": "customization"
|
||||
},
|
||||
{
|
||||
"tool": "IPv4 erzwingen",
|
||||
"what": "Schreibt /etc/apt/apt.conf.d/99-force-ipv4, damit apt nur IPv4 nutzt und instabile IPv6-Verbindungen zu Spiegelservern umgeht.",
|
||||
"category": "Netzwerk",
|
||||
"categorySlug": "network"
|
||||
},
|
||||
{
|
||||
"tool": "Sprachpakete überspringen",
|
||||
"what": "Schreibt /etc/apt/apt.conf.d/99-disable-translations, um übersetzte Paketbeschreibungsindizes nicht mehr herunterzuladen und die Datenmenge bei apt-Updates zu verringern.",
|
||||
"category": "Grundeinstellungen",
|
||||
"categorySlug": "basic-settings"
|
||||
},
|
||||
{
|
||||
"tool": "Erhöhung der Systemgrenzen",
|
||||
"what": "Erhöht inotify-Überwachungen, nofile/nproc-Grenzen, Kernel-Schlüsselbundgrenzen und fs.file-max über sysctl.d, limits.d, pam und systemd — ausreichend für Hosts mit vielen Containern.",
|
||||
"category": "System",
|
||||
"categorySlug": "system"
|
||||
},
|
||||
{
|
||||
"tool": "Speicherabstimmung",
|
||||
"what": "Setzt vm.swappiness=10, ausgewogene Anteile noch nicht geschriebener Speicherseiten, vm.max_map_count=262144 und bei Unterstützung proaktive Speicherkompaktierung. Die Overcommit-Richtlinie des Kernels bleibt auf dem Proxmox-Standard.",
|
||||
"category": "System",
|
||||
"categorySlug": "system"
|
||||
},
|
||||
{
|
||||
"tool": "Verhalten bei Kernel-Panik",
|
||||
"what": "Konfiguriert den Host so, dass er 10 Sekunden nach einer Panik / oops / Hardlockup neu startet, anstatt auf unbestimmte Zeit einzufrieren.",
|
||||
"category": "System",
|
||||
"categorySlug": "system"
|
||||
},
|
||||
{
|
||||
"tool": "Netzwerk-Stack abstimmen",
|
||||
"what": "TCP Buffer Sizing, IPv4-Härtung (redirects off, rp_filter=2, martian log off), lokaler Portbereich 1024-65535, TCP MTU-Probing, RFC 1337, plus ein Helfer bei /usr/local/sbin/proxmenux-fwbr-tune, der mit einer oneshot systemd-Einheit und einer udev-Regel verdrahtet ist, so dass rp_filter=0 / log_martians=0 jedes Mal wieder auf fwbr*/fwln*/fwpr*/tap*-Schnittstellen angewendet werden, wenn Proxmox sie bei VM Start / Stop, Neustart oder Live-Migration neu erstellt.",
|
||||
"category": "Netzwerk",
|
||||
"categorySlug": "network"
|
||||
},
|
||||
{
|
||||
"tool": "Bashrc-Anpassung (root)",
|
||||
"what": "Farbige PS1, gebräuchliche Aliase (l/la/ll/ls/grep), Zeitstempel-Historie und Bash-Completion-Sourcing, alles in einem PMX_CORE_BASHRC eingezäunten Block, so dass es leicht zu entfernen ist.",
|
||||
"category": "Anpassung",
|
||||
"categorySlug": "customization"
|
||||
},
|
||||
{
|
||||
"tool": "Log2RAM (SSD-bewusst, auto)",
|
||||
"what": "Reduziert SSD-/NVMe-Verschleiß durch Verschieben von /var/log in eine tmpfs-RAM-Disk mit regelmäßiger Synchronisierung auf Datenträger. Installation aus dem Upstream-Projekt bei SSD oder NVMe als Systemplatte. Die Größe richtet sich nach dem Host-RAM (128M / 256M / 512M). Ein Schutz leert alte Journale ab 80% Belegung und kürzt stark wachsende Logs ab 92% vor dem Schreiben. Regelmäßige Synchronisierung wird geplant und journald an den verfügbaren Platz angepasst. Details unter <link>Log2RAM</link>.",
|
||||
"category": "Speicher",
|
||||
"categorySlug": "storage"
|
||||
},
|
||||
{
|
||||
"tool": "ZFS Autotrim (nur SSD)",
|
||||
"what": "Aktiviert zpool autotrim=on in jedem ZFS-Pool, dessen vdevs alle SSD/NVMe mit TRIM-Unterstützung sind (überprüft /sys/block/[dev]/queue/rotational und discard_granularity). Pools, die von HDDs unterstützt werden, werden automatisch übersprungen. Nur Pools, die tatsächlich von ProxMenux geändert wurden, werden zur Deinstallation aufgezeichnet - Pools, die Sie manuell autotrimieren, werden in Ruhe gelassen.",
|
||||
"category": "Speicher",
|
||||
"categorySlug": "storage"
|
||||
},
|
||||
{
|
||||
"tool": "Journald Größenbeschränkungen",
|
||||
"what": "Erzwingt dauerhaften Speicher, begrenzt SystemMaxUse=64M / RuntimeMaxUse=60M und aktiviert Komprimierung sowie Info-Protokollierung für Monitor. Wird bei aktivem Log2RAM automatisch übersprungen, da dieses die Anpassung selbst übernimmt.",
|
||||
"category": "System",
|
||||
"categorySlug": "system"
|
||||
},
|
||||
{
|
||||
"tool": "Logrotate abstimmen",
|
||||
"what": "Setzt global daily und danach size 10M, behält 7 Rotationen und aktiviert Komprimierung sowie copytruncate. Das spätere Größenkriterium hat Vorrang; einzelne Logregeln können es überschreiben. Für Log2RAM geeignet, die Häufigkeit hängt aber von Regeln und Timer ab.",
|
||||
"category": "System",
|
||||
"categorySlug": "system"
|
||||
},
|
||||
{
|
||||
"tool": "Persistente Schnittstellennamen",
|
||||
"what": "Schreibt einen <code>/etc/systemd/network/10-proxmenux-<iface>.link</code> pro physischem NIC (jeder beginnt mit einem 'Managed by ProxMenux'-Header), der den MAC an den aktuellen Namen anheftet, so dass <code>eth0</code> / <code>enp…</code> Namen über Neustarts und neue NIC-Ergänzungen stabil bleiben.",
|
||||
"category": "Netzwerk",
|
||||
"categorySlug": "network"
|
||||
}
|
||||
],
|
||||
"hardwareTitle": "Hardwareabhängige Standardwerte",
|
||||
"hardwareBody": "Das Skript liest die Host-Hardware vor dem Anwenden von Einstellungen. Log2RAM ist standardmäßig nur auf SSD / NVMe Root-Festplatten installiert (es wird aufgefordert, wenn die Erkennung etwas anderes sagt). Die Ramdisk-Größe von Log2RAM wird aus der Gesamt-RAM (<code>≤ 8 GB → 128M</code>, <code>≤ 16 GB → 256M</code>, <code>'>' 16 GB → 512M</code>) ausgewählt. Die Journald-Limits werden an die Ramdisk-Größe angepasst, wenn Log2RAM aktiv ist, um ein Ausfüllen zu vermeiden.",
|
||||
"upgrade": {
|
||||
"heading": "Paketlisten und System aktualisieren",
|
||||
"intro": "Der erste Schritt der automatisierten Nachinstallation ist das Proxmox-Upgrade. Für einen laufenden Host innerhalb derselben Hauptversion empfiehlt Proxmox selbst:",
|
||||
"after": "Diese Zeile ist der offizielle Befehl für aktuelle Proxmox-Versionen. Das automatisierte Skript führt <strong>genau</strong> das aus und ergänzt Repository-Bereinigung und Nacharbeiten gemäß Upgrade-Anleitung — dieselben Schritte wie das separate Werkzeug <link>Proxmox-Systemaktualisierung</link>:",
|
||||
"items": [
|
||||
"Deaktiviert die Enterprise-Quellen <code>pve-enterprise.sources</code> / <code>ceph.sources</code>, entfernt alte Repository-Dateien und erstellt eine saubere No-Subscription-Quelle für den Codenamen des Hosts.",
|
||||
"Führt das Upgrade nicht interaktiv mit <code>DEBIAN_FRONTEND=noninteractive</code> und <code>--force-confdef --force-confold</code> aus. Angepasste Konfigurationsdateien bleiben erhalten, auch wenn sie sich im Upstream geändert haben.",
|
||||
"Installiert wichtige Proxmox-Pakete, wenn sie fehlen (<code>zfsutils-linux</code>, <code>proxmox-backup-restore-image</code>, <code>chrony</code>).",
|
||||
"LVM Metadaten-Sanitätsprüfung, <code>apt-get autoremove -y</code> + <code>apt-get autoclean -y</code> und eine Neustartaufforderung nur, wenn der Kernel tatsächlich geändert wurde."
|
||||
],
|
||||
"sameTitle": "Gleicher Updater, zwei Einstiegspunkte",
|
||||
"sameBody": "Das automatisierte Paket und das eigenständige <link>Proxmox System Update</link>-Dienstprogramm teilen sich die gleichen zugrunde liegenden Skripte (<code>update-pve8.sh</code> / <code>update-pve9_2.sh</code>). Verwenden Sie das Dienstprogramm selbst, wenn Sie nur den Host aktualisieren möchten, ohne den Rest der Optimierungen anzuwenden."
|
||||
},
|
||||
"endResult": {
|
||||
"heading": "Erwartetes Endergebnis",
|
||||
"body": "Am Ende sehen Sie eine Erfolgsmeldung mit Ausgaben der einzelnen Schritte und eine Neustartfrage, da einige Kerneleinstellungen einen Neustart benötigen. Sie können den Neustart verschieben; die Einstellungen gelten beim nächsten Start.",
|
||||
"imageAlt": "Automatisiertes Nachinstallationsskript — abschließende Terminalausgabe mit erfolgreich angewendeten Optimierungen"
|
||||
},
|
||||
"notDoes": {
|
||||
"heading": "Was dieses Skript nicht tut",
|
||||
"items": [
|
||||
"Automatische Zeitzonenerkennung (im Quellskript auskommentiert; bei Bedarf die anpassbare Nachinstallation verwenden).",
|
||||
"Portmapper / rpcbind deaktivieren (siehe <secLink>Sicherheit</secLink>).",
|
||||
"IOMMU / VFIO aktivieren (siehe <virtLink>Virtualisierung</virtLink>).",
|
||||
"Fastfetch / Figurine / Ceph-Repository / HA / AMD-CPU-Korrekturen installieren (siehe <optLink>Optional</optLink>).",
|
||||
"pigz installieren oder ZFS ARC abstimmen (siehe <perfLink>Leistung</perfLink> / <storLink>Speicher</storLink>)."
|
||||
]
|
||||
},
|
||||
"xshokTitle": "xshok-proxmox-Erkennung",
|
||||
"xshokBody": "Wenn der Host zuvor das <code>xshok-proxmox</code>-Skript ausgeführt hat, erkennt ProxMenux die Markierungsdatei und warnt Sie, bevor Sie fortfahren. Einige Tweaks können sich überschneiden. Das Begleitskript ist veraltet - wenn Sie sich entscheiden, trotzdem fortzufahren, überprüfen Sie <link>die Übersicht</link> für den Kontext.",
|
||||
"revert": {
|
||||
"heading": "Rückgängig machen",
|
||||
"body": "Jedes Werkzeug der Tabelle wird in <code>/usr/local/share/proxmenux/installed_tools.json</code> erfasst. Unter <link>Optimierungen deinstallieren</link> können Sie einzelne Änderungen zurücksetzen. Sicherungen geänderter Konfigurationsdateien liegen mit der Endung <code>.bak</code> neben den Originalen."
|
||||
},
|
||||
"related": {
|
||||
"heading": "Verwandte Themen",
|
||||
"items": [
|
||||
{
|
||||
"label": "Anpassbare Nachinstallation",
|
||||
"href": "/docs/post-install/customizable",
|
||||
"tail": " — wählen Sie im selben Katalog genau die gewünschten Funktionen."
|
||||
},
|
||||
{
|
||||
"label": "Optimierungen deinstallieren",
|
||||
"href": "/docs/post-install/uninstall",
|
||||
"tail": " — einzelne hier angewendete Änderungen rückgängig machen."
|
||||
},
|
||||
{
|
||||
"label": "Nützliche Systembefehle",
|
||||
"href": "/docs/help-info/system-commands",
|
||||
"tail": " — Änderungen überprüfen (uptime, free, journalctl usw.)."
|
||||
},
|
||||
{
|
||||
"label": "Übersicht Post-Install",
|
||||
"href": "/docs/post-install",
|
||||
"tail": "."
|
||||
}
|
||||
]
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,240 @@
|
||||
{
|
||||
"meta": {
|
||||
"title": "Post-Install: Grundeinstellungen | ProxMenux Dokumentation",
|
||||
"description": "Grundlegende Optionen nach der Installation: Wechseln Sie zu kostenlosen Proxmox-Repositories und Upgraden, erkennen Sie automatisch die Zeitzone und aktivieren Sie NTP, überspringen Sie APT-Sprachdownloads und wählen Sie aus 25 gängigen System-Dienstprogrammen zur Installation."
|
||||
},
|
||||
"header": {
|
||||
"title": "Post-Install: Grundeinstellungen",
|
||||
"section": "Einstellungen nach der Installation von Proxmox"
|
||||
},
|
||||
"intro": {
|
||||
"title": "Was diese Kategorie abdeckt",
|
||||
"body": "Fünf Grundlagen für einen neuen Proxmox-Host: auf Community-Repositories ohne Abonnement umstellen, das System vollständig aktualisieren, Zeitzone und NTP automatisch konfigurieren, APT-Sprachdownloads zur Einsparung von Bandbreite und Speicherplatz abschalten und aus 25 gängigen Systemwerkzeugen wählen."
|
||||
},
|
||||
"upgrade": {
|
||||
"heading": "Paketlisten und System aktualisieren",
|
||||
"intro": "Stellt APT auf das kostenlose Repository <em>pve-no-subscription</em> statt des abonnementpflichtigen Enterprise-Repositorys um und aktualisiert das gesamte System. Die Schritte hängen von der Proxmox-VE-Hauptversion ab; ProxMenux erkennt sie und startet das passende Skript.",
|
||||
"headerVersion": "PVE-Version",
|
||||
"headerScript": "Versionsabhängiges Startskript",
|
||||
"headerCodename": "Debian-Codename",
|
||||
"rows": [
|
||||
{
|
||||
"version": "9.x",
|
||||
"script": "update-pve9_2.sh",
|
||||
"codename": "trixie"
|
||||
},
|
||||
{
|
||||
"version": "8.x",
|
||||
"script": "update-pve8.sh",
|
||||
"codename": "bookworm"
|
||||
}
|
||||
],
|
||||
"officialTitle": "Die offizielle Proxmox Empfehlung",
|
||||
"officialBody": "Die offizielle Proxmox-Anleitung empfiehlt diese genaue Reihenfolge:",
|
||||
"officialOutro": "Das ist der übliche Befehl für Updates innerhalb der installierten Proxmox-VE-Hauptversion. Prüfen Sie die Repositories und vorgeschlagenen Paketänderungen, <em>bevor</em> Sie fortfahren. Ein Hauptversionswechsel erfordert das offizielle Migrationsverfahren.",
|
||||
"doesTitle": "Was die ProxMenux-Option tut - verifiziert gegen das Skript",
|
||||
"doesIntro": "Das ProxMenux-Update wickelt die oben genannten exakten apt-Befehle ab und fügt eine Reihe von Pre-/Post-Schritten hinzu, die Sie sich sonst von Hand merken müssten. Jedes Element unten ist, was das Dispatcher-Skript tatsächlich tut (siehe <link>Proxmox System Update</link> für die vollständige Aufschlüsselung):",
|
||||
"doesItems": [
|
||||
"<strong>Zuerst die Repositories bereinigen.</strong> Deaktiviert die Enterprise-Quellen <code>pve-enterprise.sources</code> / <code>ceph.sources</code>, entfernt alte Repository-Dateien früherer PVE-Versionen und erstellt eine saubere <code>proxmox.sources</code> für den kostenlosen Kanal <em>pve-no-subscription</em>, passend zum Debian-Codenamen: trixie für PVE 9, bookworm für PVE 8.",
|
||||
"<strong>Debian-Repositories neu schreiben</strong> mit main / updates / security und <code>non-free-firmware</code>, damit die Firmwarewarnung beim Upgrade entfällt.",
|
||||
"<strong>Führt das offizielle Upgrade aus.</strong> <code>apt-get update</code> gefolgt von <code>apt full-upgrade -y</code> (PVE 9) oder <code>apt dist-upgrade -y</code> (PVE 8), jeweils nicht interaktiv mit <code>--force-confdef --force-confold</code>, um angepasste Konfigurationsdateien zu erhalten.",
|
||||
"<strong>Installiert fehlende wichtige Pakete:</strong> <code>zfsutils-linux</code>, <code>proxmox-backup-restore-image</code>, <code>chrony</code>.",
|
||||
"<strong>LVM-Metadaten prüfen.</strong> Sucht nach VMs mit Festplatten-Passthrough, die veraltete Physical-Volume-Header auf Rohdatenträger geschrieben haben könnten. Warnt bei Auffälligkeiten, ohne sie automatisch zu beheben.",
|
||||
"<strong>Bereinigt danach:</strong> <code>apt-get autoremove -y</code> + <code>apt-get autoclean -y</code>, dann Neustartabfrage bei Kernel-Update oder vorhandener Datei <code>/var/run/reboot-required</code>."
|
||||
],
|
||||
"shortTitle": "Kurz gesagt",
|
||||
"shortBody": "Die Option führt das empfohlene <code>apt update && apt full-upgrade -y</code> aus, ergänzt die im offiziellen Leitfaden genannte Repository- und Nachbereitung und fragt am Ende nach dem Neustart. Siehe <link>Proxmox-Systemupdate</link> mit vollständigem Ablaufdiagramm — derselbe Updater ist als eigenständiges Werkzeug im Hauptmenü verfügbar.",
|
||||
"subTitle": "Nicht auf einen abonnierten Host anwenden",
|
||||
"subBody": "Wenn Sie ein Proxmox-Abonnement haben und Enterprise-Repositories behalten möchten, überspringen Sie diese Option. Sie deaktiviert Enterprise und stellt auf den Community-Kanal um. Paketupgrade und Repository-Umschreibung lassen sich unter Optimierungen deinstallieren nicht zurücksetzen. Einen späteren Kanalwechsel müssen Sie gezielt über die Repository-Konfiguration vornehmen.",
|
||||
"safetyTitle": "Sicherheitsüberprüfung nach der Aktualisierung",
|
||||
"safetyBody": "Nach dem Upgrade prüft das Skript auf Festplatten mit veralteten PV-Metadaten (Physical Volume) - ein Edge Case, der auftreten kann, wenn ein VM mit Festplattendurchgang LVM-Header auf eine Rohplatte kritzelt. Wenn etwas Verdächtiges gefunden wird, sehen Sie eine Warnung, die <code>pvs</code> zur Inspektion vorschlägt. Es wird nicht automatisch gehandelt."
|
||||
},
|
||||
"time": {
|
||||
"heading": "Zeit automatisch synchronisieren",
|
||||
"intro": "Erkennt die öffentliche IP des Servers über <code>dig myip.opendns.com @resolver1.opendns.com</code>, fragt dann <code>ipapi.co/'{'ip'}'/timezone</code>, um die passende IANA-Zeitzone nachzuschlagen, und wendet sie mit <code>timedatectl set-timezone</code> an. Endlich ermöglicht NTP mit <code>timedatectl set-ntp true</code>.",
|
||||
"depTitle": "Abhängig von zwei externen Diensten",
|
||||
"depBody": "Der Lookup basiert darauf, dass OpenDNS und <code>ipapi.co</code> erreichbar sind und ihre Antworten korrekt sind. Wenn Sie Proxmox hinter einem VPN oder einem VLAN ausführen, das aus einer anderen Region austritt, ist die automatisch erkannte Zeitzone möglicherweise falsch. In diesem Fall überspringen Sie diese Option und legen Sie die Zeitzone von Hand fest:",
|
||||
"revertTitle": "Reversibel aus dem Menü Deinstallieren",
|
||||
"revertBody": "<link>Optimierungen deinstallieren</link> setzt die Zeitzone auf UTC zurück, eine sichere Vorgabe. NTP bleibt aktiv; die Uhr synchronisiert sich weiter und zeigt UTC, bis Sie eine andere Zeitzone einstellen."
|
||||
},
|
||||
"languages": {
|
||||
"heading": "Das Herunterladen zusätzlicher Sprachen überspringen",
|
||||
"intro": "Bei <code>apt update</code> kann APT übersetzte Paketbeschreibungen zusätzlich zu den Hauptmetadaten herunterladen. Die Option deaktiviert diese Downloads zur Einsparung von Bandbreite und Speicherplatz. Zuvor <strong>stellt ProxMenux sicher, dass die Locale des Hosts generiert ist</strong>: Es liest <code>/etc/default/locale</code> oder <code>/etc/environment</code>, ergänzt <code>/etc/locale.gen</code> bei Bedarf und führt <code>locale-gen</code> aus. Die Shell-Locale bleibt erhalten.",
|
||||
"writtenTitle": "Was geschrieben wird",
|
||||
"revertTitle": "Reversibel aus dem Menü Deinstallieren",
|
||||
"revertBody": "Das Löschen von <code>/etc/apt/apt.conf.d/99-disable-translations</code> (manuell oder aus dem Menü Deinstallieren) stellt das Standardverhalten wieder her und APT lädt Sprachdateien erneut herunter."
|
||||
},
|
||||
"utilities": {
|
||||
"heading": "Allgemeine Systemdienstprogramme installieren",
|
||||
"intro": "Öffnet eine gruppierte Auswahlliste mit <strong>25 ausgewählten Werkzeugen</strong>. Wählen und bestätigen Sie; ProxMenux installiert sie über <code>apt</code>, überprüft das Ergebnis und zeigt eine Zusammenfassung.",
|
||||
"imageAlt": "Auswahldialog für ProxMenux-Systemwerkzeuge: Leertaste zum Auswählen, Eingabetaste zum Bestätigen",
|
||||
"reuseTitle": "Die gleiche Liste wird an anderer Stelle wiederverwendet",
|
||||
"reuseBody": "Der Katalog mit 25 Werkzeugen ist zentral definiert: <code>PROXMENUX_UTILS</code> in <code>scripts/global/utils-install-functions.sh</code>. Unter <em>Dienstprogramme und Werkzeuge → Systemwerkzeuge</em> finden Sie dieselbe Liste für spätere Installationen ohne erneuten Nachinstallationslauf.",
|
||||
"listTitle": "Was ist in der Liste",
|
||||
"groups": [
|
||||
{
|
||||
"group": "Systemüberwachung",
|
||||
"items": [
|
||||
{
|
||||
"pkg": "htop",
|
||||
"desc": "Interaktiver Prozess-Viewer"
|
||||
},
|
||||
{
|
||||
"pkg": "btop",
|
||||
"desc": "Moderner Ressourcenmonitor (CPU, RAM, Festplatten, Netz, Prozesse)"
|
||||
},
|
||||
{
|
||||
"pkg": "s-tui",
|
||||
"desc": "Terminaloberfläche für CPU-Belastungstests und Überwachung"
|
||||
},
|
||||
{
|
||||
"pkg": "iftop",
|
||||
"desc": "Live-Bandbreitennutzung pro Verbindung"
|
||||
},
|
||||
{
|
||||
"pkg": "iotop",
|
||||
"desc": "Datenträger-I/O pro Prozess"
|
||||
},
|
||||
{
|
||||
"pkg": "iptraf-ng",
|
||||
"desc": "Interaktiver IP-LAN-Monitor"
|
||||
}
|
||||
]
|
||||
},
|
||||
{
|
||||
"group": "Netzwerk",
|
||||
"items": [
|
||||
{
|
||||
"pkg": "iperf3",
|
||||
"desc": "Messen Sie die maximal erreichbare Bandbreite zwischen Hosts"
|
||||
},
|
||||
{
|
||||
"pkg": "net-tools",
|
||||
"desc": "Legacy-Tools (ifconfig, netstat, route). Immer noch praktisch für schnelle Überprüfungen."
|
||||
},
|
||||
{
|
||||
"pkg": "ipset",
|
||||
"desc": "Verwalten Sie große IP-Sets im Kernel – nützlich mit iptables/nftables-Regeln."
|
||||
}
|
||||
]
|
||||
},
|
||||
{
|
||||
"group": "Download und Archiv",
|
||||
"items": [
|
||||
{
|
||||
"pkg": "axel",
|
||||
"desc": "Leichter paralleler Download-Beschleuniger"
|
||||
},
|
||||
{
|
||||
"pkg": "aria2",
|
||||
"desc": "Multi-Source-/Multi-Protokoll-Downloader (HTTP, FTP, BitTorrent, Metalink)"
|
||||
},
|
||||
{
|
||||
"pkg": "unzip",
|
||||
"desc": "ZIP-Archive extrahieren"
|
||||
},
|
||||
{
|
||||
"pkg": "zip",
|
||||
"desc": "ZIP-Archive erstellen"
|
||||
},
|
||||
{
|
||||
"pkg": "cabextract",
|
||||
"desc": "Extrahieren von Microsoft CAB-Archiven (bei der Arbeit mit Windows ISOs praktisch)"
|
||||
},
|
||||
{
|
||||
"pkg": "wimtools",
|
||||
"desc": "Windows-WIM-Abbilder bearbeiten (extrahieren, aufteilen, einbinden, anwenden)"
|
||||
},
|
||||
{
|
||||
"pkg": "genisoimage",
|
||||
"desc": "ISO-9660-Abbilder aus einem Verzeichnis erstellen"
|
||||
}
|
||||
]
|
||||
},
|
||||
{
|
||||
"group": "Text und Dateien",
|
||||
"items": [
|
||||
{
|
||||
"pkg": "dos2unix",
|
||||
"desc": "CRLF-Zeilenenden (Windows) in LF-Zeilenenden (Unix) umwandeln"
|
||||
},
|
||||
{
|
||||
"pkg": "grc",
|
||||
"desc": "Färbt Ausgaben von ping, traceroute, dig, tail usw. mit Syntaxhervorhebung ein"
|
||||
},
|
||||
{
|
||||
"pkg": "plocate",
|
||||
"desc": "Schnelle Dateisuche (indexiert). Führen Sie `updatedb` nach der Installation aus, um den Index zu erstellen."
|
||||
}
|
||||
]
|
||||
},
|
||||
{
|
||||
"group": "Remote und Sessions",
|
||||
"items": [
|
||||
{
|
||||
"pkg": "sshpass",
|
||||
"desc": "Nicht interaktive SSH-Passwortauthentifizierung (für Skripte, nicht für den täglichen Gebrauch)"
|
||||
},
|
||||
{
|
||||
"pkg": "tmux",
|
||||
"desc": "Terminal-Multiplexer: Sitzungen abkoppeln, Fenster teilen und Sitzungen bei Verbindungsabbrüchen erhalten"
|
||||
}
|
||||
]
|
||||
},
|
||||
{
|
||||
"group": "Hardware und Low-Level",
|
||||
"items": [
|
||||
{
|
||||
"pkg": "msr-tools",
|
||||
"desc": "CPU modellspezifische Register lesen/schreiben (rdmsr, wrmsr)"
|
||||
},
|
||||
{
|
||||
"pkg": "intel-gpu-tools",
|
||||
"desc": "Intel GPU Diagnoseprogramme einschließlich `intel_gpu_top`"
|
||||
}
|
||||
]
|
||||
},
|
||||
{
|
||||
"group": "Virtualisierung",
|
||||
"items": [
|
||||
{
|
||||
"pkg": "libguestfs-tools",
|
||||
"desc": "VM-Festplattenabbilder untersuchen und ändern (virt-ls, virt-cat, guestmount…)"
|
||||
},
|
||||
{
|
||||
"pkg": "chntpw",
|
||||
"desc": "Bearbeiten von Windows SAM - nützlich für die Passwortwiederherstellung auf Windows VMs, die Sie erben"
|
||||
}
|
||||
]
|
||||
}
|
||||
],
|
||||
"actionTitle": "Einige davon in Aktion",
|
||||
"noBulkTitle": "Nur von ProxMenux installierte Werkzeuge werden entfernt",
|
||||
"noBulkBody": "ProxMenux erfasst nur ausgewählte Pakete, die noch nicht installiert waren. Optimierungen deinstallieren entfernt diese Pakete vollständig und lässt zuvor vorhandene Pakete bestehen. Für APT-Upgrades gibt es kein sicheres atomares Zurückrollen: Das Entfernen der Werkzeuge macht das System-Upgrade nicht rückgängig."
|
||||
},
|
||||
"related": {
|
||||
"heading": "Verwandte Themen",
|
||||
"items": [
|
||||
{
|
||||
"label": "Proxmox-Systemupdate",
|
||||
"href": "/docs/utils/system-update",
|
||||
"tail": " — Führt den Zyklus apt update + dist-upgrade bei Bedarf erneut aus."
|
||||
},
|
||||
{
|
||||
"label": "Installationsprogramm für Systemdienstprogramme",
|
||||
"href": "/docs/utils/system-utils",
|
||||
"tail": "— Installation (oder Neuinstallation) von Dienstprogrammen einzeln nach der Nachinstallation."
|
||||
},
|
||||
{
|
||||
"label": "Befehle für Updates und Pakete",
|
||||
"href": "/docs/help-info/update-commands",
|
||||
"tail": " — APT-Referenz für die Shell."
|
||||
},
|
||||
{
|
||||
"label": "Anpassbare Nachinstallation",
|
||||
"href": "/docs/post-install/customizable",
|
||||
"tail": " — zurück zum übergeordneten Menü."
|
||||
}
|
||||
]
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,106 @@
|
||||
{
|
||||
"meta": {
|
||||
"title": "Anpassbares Post-Install-Script | ProxMenux Dokumentation",
|
||||
"description": "Wählen Sie genau die Optimierungen aus, die ProxMenux auf Ihrem Proxmox-VE-Host anwenden soll. 10 Kategorien, etwa 35 einzelne Werkzeuge und eine Auswahl mit Kontrollkästchen. Enthält alle Funktionen des automatischen Skripts plus ausdrücklich wählbare Optionen wie IOMMU, Fastfetch, Figurine, Ceph, HA und AMD-Korrekturen.",
|
||||
"ogTitle": "Anpassbares Post-Install-Script | ProxMenux Dokumentation",
|
||||
"ogDescription": "10 Kategorien, ~35 individuelle Optimierungen. Wählen Sie genau das aus, was Sie auf einem Proxmox VE-Host wünschen. Reversible Veränderungen werden verfolgt."
|
||||
},
|
||||
"header": {
|
||||
"title": "Anpassbares Post-Install-Script",
|
||||
"description": "Wählen Sie genau die Optimierungen für Ihren Proxmox-VE-Host. ProxMenux gruppiert etwa 35 Werkzeuge in 10 Kategorien in einem gemeinsamen Auswahldialog. Dieselbe Grundlage wie Automatisch, aber mit voller Kontrolle über die angewendeten Änderungen.",
|
||||
"section": "Post-Installation · Anpassbar"
|
||||
},
|
||||
"intro": {
|
||||
"title": "Wann Sie Anpassbar wählen sollten",
|
||||
"body": "Wählen Sie diesen Weg, wenn Sie die gewünschten oder unerwünschten Anpassungen bereits kennen. Eine nach Kategorien gruppierte Auswahlliste erlaubt das Vorwählen, Abwählen und Kombinieren von Optimierungen. Einträge können später erneut angewendet werden. Reversible Konfigurationsänderungen werden für <link>Optimierungen deinstallieren</link> erfasst; Paket-Upgrades gelten nicht als reversibel."
|
||||
},
|
||||
"compare": {
|
||||
"heading": "Vergleich mit Automatisch",
|
||||
"body": "Anpassbar umfasst das gesamte <link>automatische Skript</link>: dieselben 14 Basisoptimierungen plus zahlreiche ausdrücklich wählbare Optionen, die Automatisch absichtlich auslässt. Diese sind nur für bestimmte Hardware (AMD-Korrekturen), Hostinganbieter (OVH RTM) oder Arbeitslasten nützlich (IOMMU/VFIO, Ceph-Repository, Hochverfügbarkeit, Fastfetch, Figurine, ZFS-ARC-Anpassung, pigz, automatische ZFS-Snapshots, vzdump-Geschwindigkeitsgrenzen, Open vSwitch, TCP BBR …)."
|
||||
},
|
||||
"categoriesSection": {
|
||||
"heading": "Die 10 Kategorien",
|
||||
"body": "Das anpassbare Skript gruppiert die Optimierungen in 10 Kategorien in einem gemeinsamen Auswahldialog. Jede Kategorie hat eine eigene Dokumentationsseite. Öffnen Sie eine Karte für die Begründung, Vorgaben und Prüfschritte jeder Option."
|
||||
},
|
||||
"categories": [
|
||||
{
|
||||
"name": "Grundeinstellungen",
|
||||
"description": "APT-Quellen bereinigen, das offizielle Proxmox-Upgrade ausführen und Zeitzone, Gebietsschema sowie häufig benötigte Werkzeuge einrichten. Die Grundlage aller anderen Gruppen."
|
||||
},
|
||||
{
|
||||
"name": "System",
|
||||
"description": "Optimieren Sie das Protokollsubsystem und die Kernel-Grenzwerte für einen Host, der viele VMs und Container enthält. Behandelt journald, Logrotate, Sysctl (Speicher, Dateibeschränkungen), Kernel-Panic-Verhalten und schnelle Neustarts."
|
||||
},
|
||||
{
|
||||
"name": "Virtualisierung",
|
||||
"description": "Bereitet den Host auf erweiterte Virtualisierung vor. Installiert den passenden Gastagenten, wenn Proxmox selbst in einer unterstützten VM läuft, und aktiviert IOMMU/VFIO für die PCI-Durchreichung von GPUs, Controllern und TPUs."
|
||||
},
|
||||
{
|
||||
"name": "Netzwerk",
|
||||
"description": "Härtet und optimiert den Netzwerkstack des Hosts. Erzwingt IPv4 für APT, wendet sysctl-Härtung und TCP-Pufferanpassungen an, bietet Open vSwitch, TCP BBR und TCP Fast Open und bindet persistente Schnittstellennamen an MAC-Adressen."
|
||||
},
|
||||
{
|
||||
"name": "Speicher",
|
||||
"description": "Richten Sie die gängigen Speicher-Subsysteme von Proxmox ein: ZFS ARC Sizing, ZFS auto-snapshot, ZFS autotrim für SSD/NVMe Pools und vzdump Geschwindigkeitsbegrenzungen, um eine Sättigung der Festplatte bei Backups zu vermeiden."
|
||||
},
|
||||
{
|
||||
"name": "Sicherheit",
|
||||
"description": "Verringert die standardmäßig offene Angriffsfläche. Deaktiviert die RPC-Dienste portmapper/rpcbind, die Proxmox nicht benötigt, aber lauschen lässt."
|
||||
},
|
||||
{
|
||||
"name": "Anpassung",
|
||||
"description": "Ändern Sie das visuelle und Shell-Erlebnis des Hosts: Farben und Aliase in bashrc, MOTD-Banner und Entfernen des Abonnementbescheids in der Web-Benutzeroberfläche."
|
||||
},
|
||||
{
|
||||
"name": "Überwachung",
|
||||
"description": "Integriert den Host in OVH Real-Time Monitoring. Installiert RTM nur, wenn ProxMenux einen OVH-Server erkennt; auf anderen Hosts ändert die Option nichts."
|
||||
},
|
||||
{
|
||||
"name": "Leistung",
|
||||
"description": "Beschleunigen Sie Kompressionsvorgänge (Backups, Transfers), indem Sie gzip durch sein paralleles Gegenstück pigz ersetzen."
|
||||
},
|
||||
{
|
||||
"name": "Fakultativ",
|
||||
"description": "Nischenstücke, die nicht jeder Host braucht: AMD CPU Fixes, Fastfetch-Banner, Figurine 3D-Hostname, Indexaktualisierung des PVE Appliance Managers, Ceph Repository, High Availability Services, Log2RAM zur Reduzierung des SSD-Verschleisses und ein ZRAM-Swap-Profil."
|
||||
}
|
||||
],
|
||||
"mixTip": {
|
||||
"title": "Automatisch und Anpassbar kombinieren",
|
||||
"body": "Ein übliches Vorgehen: zuerst <strong>Automatisch</strong> für sinnvolle Grundeinstellungen, dann <strong>Anpassbar</strong> öffnen und nur benötigte Zusatzwerkzeuge wählen, etwa IOMMU für GPU-Passthrough. Änderungen werden unabhängig erfasst; Deinstallieren zeigt alle angewendeten Einträge unabhängig vom verwendeten Weg."
|
||||
},
|
||||
"related": {
|
||||
"heading": "Verwandte Themen",
|
||||
"items": [
|
||||
{
|
||||
"label": "Automatische Nachinstallation",
|
||||
"href": "/docs/post-install/automated",
|
||||
"tail": " — sinnvolle Vorgaben ohne Rückfragen anwenden."
|
||||
},
|
||||
{
|
||||
"label": "Optimierungen deinstallieren",
|
||||
"href": "/docs/post-install/uninstall",
|
||||
"tail": " — jede Auswahl sauber rückgängig machen."
|
||||
},
|
||||
{
|
||||
"label": "Grundeinstellungen",
|
||||
"href": "/docs/post-install/basic-settings",
|
||||
"tail": "— Repos, Zeit, Sprache, Dienstprogramme."
|
||||
},
|
||||
{
|
||||
"label": "Virtualisierung",
|
||||
"href": "/docs/post-install/virtualization",
|
||||
"tail": "— IOMMU + VFIO für Passthrough."
|
||||
},
|
||||
{
|
||||
"label": "Sicherheit",
|
||||
"href": "/docs/post-install/security",
|
||||
"tailRich": " · <storageLink>Speicher</storageLink> · <networkLink>Netzwerk</networkLink> · <customLink>Anpassung</customLink> — weitere Kategorien."
|
||||
},
|
||||
{
|
||||
"label": "Übersicht nach der Installation",
|
||||
"href": "/docs/post-install",
|
||||
"tail": "."
|
||||
}
|
||||
]
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,74 @@
|
||||
{
|
||||
"meta": {
|
||||
"title": "Nach der Installation: Anpassung | ProxMenux-Dokumentation",
|
||||
"description": "Anpassungen im anpassbaren ProxMenux-Skript nach der Installation: farbige Bash-Eingabeaufforderung mit nützlichen Aliasen, ProxMenux-Banner in der MOTD und Entfernung des Abonnementhinweises aus der Proxmox-Weboberfläche."
|
||||
},
|
||||
"header": {
|
||||
"title": "Nach der Installation: Anpassung",
|
||||
"description": "Optische und praktische Anpassungen für den Proxmox-Host. Sie machen die Shell angenehmer und blenden den Abonnementhinweis in der Weboberfläche aus. Bashrc, MOTD und Abonnementbanner werden erfasst und lassen sich über Deinstallieren zurücksetzen.",
|
||||
"section": "Einstellungen nach der Installation von Proxmox"
|
||||
},
|
||||
"intro": {
|
||||
"title": "Was diese Kategorie abdeckt",
|
||||
"body": "Drei kleine, unabhängige Optionen: eine <strong>farbige Bash-Eingabeaufforderung mit Aliasen</strong> für die root-Shell, ein einzeiliges <strong>MOTD-Banner</strong> bei SSH-Anmeldung und Entfernung des <strong>Popups „Kein gültiges Abonnement“</strong>, das Proxmox bei jeder Web-Anmeldung zeigt."
|
||||
},
|
||||
"bashrc": {
|
||||
"heading": "bashrc anpassen",
|
||||
"intro": "Injiziert einen kuratierten Block in <code>/root/.bashrc</code> mit einer farbigen Eingabeaufforderung, Zeitstempel-Historie, Standard-<code>ls</code>/<code>grep</code>-Aliasen und einem <code>source</code> für die Bash-Vervollständigung. Macht das Arbeiten über SSH spürbar angenehmer und macht deutlich, auf welchem Host Sie sich befinden, wenn Sie viele Tabs geöffnet haben.",
|
||||
"writesTitle": "Was ProxMenux zu .bashrc hinzufügt",
|
||||
"writesOutro": "Der Block wird durch die <code>PMX_CORE_BASHRC</code>-Marker begrenzt. Das Ausführen des Skripts ersetzt den vorherigen Block, anstatt ihn zu duplizieren. Die ursprüngliche <code>.bashrc</code> wird einmal auf <code>/root/.bashrc.bak</code> gesichert, und eine <code>source /root/.bashrc</code>-Zeile wird an <code>/root/.bash_profile</code> angehängt, so dass die Aufforderung auch für Login-Shells gilt (z. B. nach <code>su -</code>).",
|
||||
"rootTitle": "Gilt nur für root",
|
||||
"rootBody": "Die Anpassung zielt auf die Shell des Root-Kontos ab. Andere Benutzer, die Sie auf dem Host erstellen, behalten ihre eigenen Standardeinstellungen. Wenn Sie Proxmox ausschließlich über die Web-Benutzeroberfläche verwalten und niemals die Shell verwenden, ist diese Option reine Ästhetik und Sie können sie überspringen."
|
||||
},
|
||||
"motd": {
|
||||
"heading": "Richten Sie ein benutzerdefiniertes MOTD-Banner ein",
|
||||
"intro": "Stellt <em>\"This system is optimised by: ProxMenux\"</em> an den Anfang von <code>/etc/motd</code>, der Nachricht nach erfolgreicher SSH-Anmeldung oberhalb der Shell-Eingabeaufforderung und vor den <code>update-motd</code>-Skripten. Harmlos und rein informativ — als schnelle sichtbare Bestätigung, dass ProxMenux auf diesem Host angewendet wurde.",
|
||||
"writesTitle": "Was ProxMenux schreibt",
|
||||
"writesOutro": "Bei der ersten Anwendung erfasst ProxMenux, ob <code>/etc/motd</code> existierte und speichert seinen ursprünglichen Inhalt unter <code>/usr/local/share/proxmenux</code>. Die Operation ist idempotent: Wenn die Markierungslinie bereits vorhanden ist, wird nichts hinzugefügt. Ältere Anlagen mit einem vorhandenen <code>/etc/motd.bak</code> werden in den gleichen reversiblen Zustand migriert."
|
||||
},
|
||||
"banner": {
|
||||
"heading": "Abonnementbanner entfernen",
|
||||
"intro": "Entfernt den Dialog <em>„Sie haben kein gültiges Abonnement für diesen Server“</em>, der bei jeder Anmeldung ohne Enterprise-Abonnement in der Proxmox-Weboberfläche erscheint. ProxMenux berücksichtigt die Version und startet das passende Skript für die unterschiedlichen UI-Pakete der Hauptversionen.",
|
||||
"versionTitle": "Skriptauswahl nach Version",
|
||||
"versionItems": [
|
||||
"<strong>PVE 9.x</strong> führt <code>remove-banner-pve-v3.sh</code> aus (patcht sowohl die Desktop-<code>proxmoxlib.js</code> als auch die neue Yew-basierte mobile Benutzeroberfläche).",
|
||||
"<strong>PVE 8.x</strong> führt <code>remove-banner-pve8.sh</code> aus (nur auf dem Desktop)."
|
||||
],
|
||||
"versionOutro": "Vor dem Patchen sichert ProxMenux die ursprünglichen JS/Template-Dateien mit einem Zeitstempel auf <code>/usr/local/share/proxmenux/backups/</code>. Der Deinstallationsfluss verwendet diese Backups, um die Originaldateien wiederherzustellen, und greift auf die Neuinstallation der Proxmox-Benutzeroberflächenpakete zurück, wenn das Backup fehlt oder beschädigt ist.",
|
||||
"breakTitle": "Kann nach Proxmox Updates brechen",
|
||||
"breakBody": "Proxmox-UI-Updates überschreiben regelmäßig <code>proxmoxlib.js</code>, wodurch der Hinweis zurückkehren kann. Sie können die Option danach erneut anwenden oder den Hinweis bis dahin hinnehmen. ProxMenux installiert außerdem einen APT-Hook zum automatischen erneuten Patchen bei Paket-Upgrades. Unter <link>Optimierungen deinstallieren</link> erfahren Sie, wie dieser Hook entfernt wird.",
|
||||
"legalTitle": "Rechtliche Anmerkung (immer wiederholenswert)",
|
||||
"legalBody": "Diese Option blendet nur den UI-Hinweis aus. Sie gewährt <strong>keinen</strong> Enterprise-Support oder Zugriff auf das Enterprise-Repository und ändert die Softwarelizenz nicht. Proxmox VE wird unter GNU AGPLv3 veröffentlicht. Ein Abonnement unterstützt das Projekt und ermöglicht den Enterprise-Updatekanal. Wählen Sie eine passende Supportstufe für Ihre Umgebung."
|
||||
},
|
||||
"verify": {
|
||||
"heading": "Verifizierung",
|
||||
"intro": "Nach Anwendung aller drei:",
|
||||
"reversibleTitle": "Alle drei Anpassungsänderungen werden verfolgt",
|
||||
"reversibleBody": "<link>Optimierungen deinstallieren</link> stellt <code>/root/.bashrc</code> wieder her, gibt MOTD zu seinem genauen Pre-ProxMenux-Inhalt zurück (oder entfernt die Datei, wenn sie vorher nicht existierte) und stellt die gepatchten UI-Dateien aus dem Backup wieder her oder installiert die betroffenen Proxmox-Pakete bei Bedarf neu."
|
||||
},
|
||||
"related": {
|
||||
"heading": "Verwandte Themen",
|
||||
"items": [
|
||||
{
|
||||
"label": "Fakultativ",
|
||||
"href": "/docs/post-install/optional",
|
||||
"tail": " — Fastfetch und Figurine, weitere visuelle Anpassungen."
|
||||
},
|
||||
{
|
||||
"label": "Versionsinformationen anzeigen",
|
||||
"href": "/docs/settings/show-version-information",
|
||||
"tail": " — bestätigt, dass die Anpassungen als installiert erfasst sind."
|
||||
},
|
||||
{
|
||||
"label": "Optimierungen deinstallieren",
|
||||
"href": "/docs/post-install/uninstall",
|
||||
"tail": " — bashrc, motd und Abonnementhinweis zurücksetzen."
|
||||
},
|
||||
{
|
||||
"label": "Anpassbare Nachinstallation",
|
||||
"href": "/docs/post-install/customizable",
|
||||
"tail": " — zurück zum übergeordneten Menü."
|
||||
}
|
||||
]
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,106 @@
|
||||
{
|
||||
"meta": {
|
||||
"title": "Proxmox VE Post-Install-Script — Automatisiert und anpassbar | ProxMenux",
|
||||
"description": "Überblick über die ProxMenux-Skripte nach der Installation von Proxmox VE. Das automatische Skript wendet sinnvolle Vorgaben ohne Rückfragen an. Mit dem anpassbaren Skript wählen Sie gezielt aus 10 Kategorien. Unter Optimierungen deinstallieren können unterstützte reversible Änderungen zurückgesetzt werden.",
|
||||
"ogTitle": "Proxmox VE Post-Install-Script — Automatisiert und anpassbar",
|
||||
"ogDescription": "Übliche Proxmox VE-Postinstallationsoptimierungen in 10-Kategorien anwenden - automatisiert oder à la carte mit reversiblen Optionen.",
|
||||
"twitterTitle": "Proxmox VE Post-Install-Script | ProxMenux",
|
||||
"twitterDescription": "Automatisierte und anpassbare Nachinstallationsoptimierungen für Proxmox VE – mit reversiblen Optionen."
|
||||
},
|
||||
"header": {
|
||||
"title": "Post-Install Skripte",
|
||||
"description": "Konfigurieren Sie einen neuen Proxmox VE-Host mit den ProxMenux-Optimierungen nach der Installation. Wenden Sie die Baseline automatisch an, wählen Sie einzelne Optionen aus, aktualisieren Sie installierte Funktionen oder stellen Sie unterstützte reversible Änderungen wieder her. Paket-Upgrades werden nicht als reversibel dargestellt.",
|
||||
"section": "Einstellungen nach der Installation von Proxmox"
|
||||
},
|
||||
"intro": {
|
||||
"title": "Wozu dieses Menü dient",
|
||||
"body": "Direkt nach der Installation von Proxmox VE machen Dutzende kleine Änderungen den Host schneller und leichter wartbar: Repositories ohne Abonnement, sinnvolle journald-Limits und TCP-Puffer, SSD-schonende Protokollspeicherung, bashrc-Verbesserungen und mehr. ProxMenux automatisiert sie und erfasst die unterstützten reversiblen Konfigurationsänderungen."
|
||||
},
|
||||
"openingMenu": {
|
||||
"heading": "Öffnen des Menüs",
|
||||
"body": "Wählen Sie im Hauptmenü von ProxMenux <strong>Einstellungen nach der Installation von Proxmox</strong>. Folgendes wird angezeigt:",
|
||||
"imageAlt": "Menü für Skripte nach der Installation: Automatisch, Anpassbar, der bedingte Eintrag Verfügbare Updates anwenden (nur bei ausstehenden Updates) und Deinstallieren, gefolgt von Community-Skripten"
|
||||
},
|
||||
"threeWays": {
|
||||
"heading": "Vier Möglichkeiten, Optimierungen anzuwenden",
|
||||
"body": "Die vier ProxMenux-Einträge nutzen denselben Code und dasselbe Register installierter Werkzeuge, bieten aber unterschiedliche Kontrolle. <em>Verfügbare Updates anwenden</em> erscheint nur, wenn für mindestens eine installierte Optimierung eine neuere Version auf dem Datenträger liegt als die registrierte. Direkt nach der Einrichtung bleibt der Eintrag verborgen."
|
||||
},
|
||||
"routes": [
|
||||
{
|
||||
"title": "Automatisch",
|
||||
"description": "Eine sorgfältig ausgewählte Gruppe von 14 sicheren, stets nützlichen Optimierungen, die nacheinander ohne Rückfragen angewendet werden. Eine gute Vorgabe für die meisten Benutzer.",
|
||||
"bullets": [
|
||||
"Repositories ohne Abonnement + Systemupgrade",
|
||||
"Speicher, Kernel, Netzwerk-Tuning",
|
||||
"Log2RAM (automatisch auf SSD/NVMe erkannt)",
|
||||
"Journald + Logrotate-Größenbeschränkungen",
|
||||
"Persistente Schnittstellennamen"
|
||||
]
|
||||
},
|
||||
{
|
||||
"title": "Anpassbar",
|
||||
"description": "Etwa 35 einzelne Optimierungen in 10 Kategorien. Sie wählen genau aus, welche angewendet werden. Dieselbe Grundlage wie Automatisch, aber mit voller Kontrolle.",
|
||||
"bullets": [
|
||||
"Auswahllisten pro Kategorie",
|
||||
"Enthält alle Funktionen von Automatisch plus ausdrücklich auswählbare Optionen (IOMMU, Fastfetch, Figurine, Ceph, HA, AMD-Korrekturen …)",
|
||||
"Beliebig oft ausführbar — die Änderungen sind idempotent"
|
||||
]
|
||||
},
|
||||
{
|
||||
"title": "Verfügbare Updates anwenden",
|
||||
"description": "Liegt eine Nachinstallationsoptimierung (Log2Ram, Speichereinstellungen, Logrotate …) auf dem Datenträger in einer neueren Version vor als der auf dem Host erfassten, zeigt dieser Menüpunkt nur die betroffenen Optimierungen an. Er führt die jeweilige Funktion erneut aus und aktualisiert den gespeicherten Versionsstand. Alles andere bleibt unverändert.",
|
||||
"bullets": [
|
||||
"Jede Optimierung einzeln auswählen (nur geänderte)",
|
||||
"Dieselbe Auswahl ist im Monitor-Dashboard verfügbar",
|
||||
"Eine gemeinsame Benachrichtigung, wenn neue Updates verfügbar werden"
|
||||
]
|
||||
},
|
||||
{
|
||||
"title": "Optimierungen deinstallieren",
|
||||
"description": "Unterstützte rückgängig machbare Änderungen werden in einer JSON-Datei erfasst und mit einer Wiederherstellungsfunktion verknüpft. Aktionen ohne sichere Rückkehrmöglichkeit, etwa ein vollständiges Paketupgrade, sind bewusst ausgeschlossen.",
|
||||
"bullets": [
|
||||
"Erkennt zuvor angewendete Optimierungen automatisch",
|
||||
"Wählt für jeden Eintrag den passenden Rückweg: aus einem vorhandenen .bak-Backup wiederherstellen, den sysctl.d-Konfigurationsausschnitt löschen, wenn keine Sicherung nötig war, oder das unveränderte Originalpaket mit --force-confnew neu installieren (z. B. beim Abonnementbanner)",
|
||||
"Neustartabfrage bei Bedarf (VFIO, persistente Namen usw.)"
|
||||
]
|
||||
}
|
||||
],
|
||||
"whichTitle": "Welches sollten Sie wählen?",
|
||||
"whichBody": "Bei einer neuen Proxmox-Installation mit sinnvollen Grundeinstellungen ohne Entscheidungen: <autoLink><strong>Automatisch</strong></autoLink>. Wenn Sie die gewünschten oder unerwünschten Anpassungen schon kennen: <customLink><strong>Anpassbar</strong></customLink>. Für eine bereits angewendete Optimierung, deren neuere Version auf dem Datenträger liegt: <updatesLink><strong>Verfügbare Updates anwenden</strong></updatesLink>. Zum sauberen Zurücksetzen früherer Änderungen: <uninstallLink><strong>Optimierungen deinstallieren</strong></uninstallLink>. Sie können kombinieren: zuerst Automatisch, dann unter Anpassbar Optionen wie Fastfetch oder IOMMU hinzufügen und später einzelne Einträge zurücksetzen.",
|
||||
"mixing": {
|
||||
"heading": "Mischen mit anderen Post-Installation-Scripts",
|
||||
"stackTitle": "Stapeln Sie nicht mehrere Post-Installationsskripte",
|
||||
"stackBody": "Das Ausführen mehrerer Post-Installationsskripte auf demselben Host kann doppelte Konfigurationsdateien, widersprüchliche sysctl-Einträge oder, schlimmer noch, defekte Netzwerke nach dem Neustart verursachen. Wenn Sie das <strong>Helper-Scripts Post Install</strong> bereits angewendet haben, können sich einige ProxMenux-Optimierungen mit dem bereits konfigurierten überschneiden. Bleiben Sie bei einem Post-Installations-Tool pro Host.",
|
||||
"xshokTitle": "xshok-proxmox: veraltet",
|
||||
"xshokBody": "Frühere Versionen von ProxMenux verwies auf <a>xshok-proxmox</a> als Begleitwerkzeug nach der Installation. Dieses Projekt ist jetzt veraltet und wird nicht mehr von ProxMenux angeboten. Wenn ein früherer Lauf von xshok-proxmox Markierungen auf dem Host hinterlassen hat, erkennt ProxMenux sie immer noch und wird Sie warnen - aber es ist nicht etwas, das Sie heute neben ProxMenux installieren sollten."
|
||||
},
|
||||
"community": {
|
||||
"heading": "Gemeinschaftsskripte",
|
||||
"body": "Das Menü bietet zwei Drittanbieterskripte aus dem Projekt <a>community-scripts</a>: <em>Proxmox VE Post Install</em> und <em>Proxmox VE Microcode</em>. Die Wrapper laden die Originalskripte mit <code>wget | bash</code> herunter und führen sie aus. ProxMenux pflegt sie nicht. Lesen Sie vor der Ausführung <link>Externe Repositories</link> für Details und Hinweise zur Vertrauenswürdigkeit."
|
||||
},
|
||||
"related": {
|
||||
"heading": "Verwandte Themen",
|
||||
"items": [
|
||||
{
|
||||
"label": "Proxmox-Systemupdate",
|
||||
"href": "/docs/utils/system-update",
|
||||
"tail": " — hält den Host nach der Ersteinrichtung aktuell."
|
||||
},
|
||||
{
|
||||
"label": "Sicherheit",
|
||||
"href": "/docs/security",
|
||||
"tail": "- Fail2Ban + Lynis oben auf der Nachinstallationshärtung."
|
||||
},
|
||||
{
|
||||
"label": "Versionsinformationen anzeigen",
|
||||
"href": "/docs/settings/show-version-information",
|
||||
"tail": " — zeigt, welche Komponenten nach der Installation als installiert erfasst sind."
|
||||
},
|
||||
{
|
||||
"label": "Befehle für Updates und Pakete",
|
||||
"href": "/docs/help-info/update-commands",
|
||||
"tail": " — Referenz für apt / pveupgrade."
|
||||
}
|
||||
]
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,56 @@
|
||||
{
|
||||
"meta": {
|
||||
"title": "Nach der Installation: Überwachung | ProxMenux-Dokumentation",
|
||||
"description": "Überwachungsoptionen im ProxMenux anpassbaren Post-Installationsskript. Derzeit eine einzige Option: OVH Real-Time Monitoring (RTM) installieren, das nur aktiviert wird, wenn der Host als OVH-Server erkannt wird."
|
||||
},
|
||||
"header": {
|
||||
"title": "Nach der Installation: Überwachung",
|
||||
"description": "Überwachungsoptionen im anpassbaren Skript nach der Installation. Diese kleine, anbieterspezifische Kategorie installiert den OVH-Real-Time-Monitoring-Agenten auf dedizierten OVH-Servern und tut auf anderen Hosts nichts.",
|
||||
"section": "Einstellungen nach der Installation von Proxmox"
|
||||
},
|
||||
"intro": {
|
||||
"title": "Zweckgebundener enger Anwendungsbereich",
|
||||
"body": "Die Überwachung nach der Installation beschränkt sich auf <strong>einen anbieterspezifischen Agenten</strong>. Allgemeine Überwachung mit Prometheus, Grafana oder node_exporter gehört nicht dazu, da Entscheidungen über einen separaten Host, Datenaufbewahrung und Alarmziele nicht in einen Ein-Klick-Schritt passen. Der mitgelieferte ProxMenux Monitor erfüllt den Großteil dieser Aufgabe ohne externen Agenten."
|
||||
},
|
||||
"ovh": {
|
||||
"heading": "Installation von OVH Real-Time Monitoring (RTM)",
|
||||
"intro": "Wenn Ihr Proxmox-Host ein dedizierter Server ist, der von <a>OVHcloud</a> gemietet wird, können Sie RTM aktivieren, um Hardware-Telemetrie (CPU-Temperatur, PSU-Status, Festplatte SMART, RAID-Controller-Zustand usw.) dem OVH-Bedienfeld auszusetzen. Dies ist der gleiche Agent, den OVH für seine eigene \"Server Monitoring\" -Funktion verwendet.",
|
||||
"decisionsTitle": "Wie ProxMenux entscheidet",
|
||||
"decisionsItems": [
|
||||
"Ermittelt die öffentliche IP-Adresse des Hosts mit <code>curl ipinfo.io/ip</code>.",
|
||||
"Sucht den besitzenden ISP mit einer <code>whois</code>-Abfrage zu <code>v4.whois.cymru.com</code> nach.",
|
||||
"Wenn das Ergebnis OVH nennt, lädt es <code>last-public-ovh-infra-yak.snap.mirrors.ovh.net/yak/archives/apply.sh</code> herunter und leitet es mit dem Puppet-Manifest für RTM v2 an <code>bash</code> weiter.",
|
||||
"Wenn im Ergebnis OVH <em>nicht</em> erwähnt wird, ist nichts installiert. Die Option ist eine No-Op."
|
||||
],
|
||||
"remoteTitle": "Remote-Skript per Pipe an bash übergeben",
|
||||
"remoteBody": "Die Installation läuft <code>wget -qO - https://…apply.sh | bash</code>. Wenn der OVH-Spiegel jemals kompromittiert wird, wird das Skript als root auf Ihrem Host ausgeführt. Bevor Sie diese Option aktivieren, entscheiden Sie, ob Sie der Spiegelkette von OVH mehr vertrauen als der Überwachung, die Sie erhalten. Für die meisten Heimlabor- oder Nicht-OVH-Benutzer sollte diese Option einfach ausgeschaltet bleiben.",
|
||||
"noOpTitle": "Nur aktivieren, wenn der Host tatsächlich bei OVH ist",
|
||||
"noOpBody": "Die Option ist ein No-Op auf Nicht-OVH-Servern, so dass das Ankreuzen auf einem Heimlabor Proxmox nichts kaputt macht. Auf einem Nicht-OVH-Host druckt das Skript <em>\"Kein OVH-Server, überspringt die RTM-Installation\"</em> und verlässt es sauber; es werden keine Pakete installiert.",
|
||||
"runsTitle": "Was ProxMenux ausführt",
|
||||
"verifyTitle": "Verifizierung",
|
||||
"verifyBody": "Auf einem echten OVH-Host sollten Sie nach einem Neustart das <a>RTM-Dashboard</a> in Ihrem OVH-Manager sehen, das mit Live-Daten für den Host gefüllt ist. Auf der Proxmox-Seite ist der RTM-Sammler ein systemd-Service - überprüfen Sie es direkt:",
|
||||
"troubleTitle": "Fehlerbehebung",
|
||||
"revertTitle": "RTM über das Menü Deinstallieren entfernen",
|
||||
"revertBody": "Ist RTM als installiert registriert, bietet Optimierungen deinstallieren einen Eintrag für OVH Real-Time Monitoring. Er führt <code>apt-get purge -y ''ovh-rtm*'' ''rtm'' ''rtm-*''</code> aus, löscht /etc/rtm und markiert RTM als deinstalliert. Puppet-Reste müssen eventuell manuell bereinigt werden; prüfen Sie RTM-spezifische Manifeste unter <code>/etc/puppet/</code>. Auf einem Nicht-OVH-Host wurden keine RTM-Pakete installiert, daher ist nichts zu entfernen."
|
||||
},
|
||||
"related": {
|
||||
"heading": "Verwandte Themen",
|
||||
"items": [
|
||||
{
|
||||
"label": "ProxMenux Monitor",
|
||||
"href": "/docs/settings/proxmenux-monitor",
|
||||
"tail": "- lokales Web-Dashboard für den Host (funktioniert bei jedem Anbieter, nicht nur OVH)."
|
||||
},
|
||||
{
|
||||
"label": "Nützliche Systembefehle",
|
||||
"href": "/docs/help-info/system-commands",
|
||||
"tail": "– Referenz zur Überwachung des lokalen Hosts."
|
||||
},
|
||||
{
|
||||
"label": "Anpassbare Nachinstallation",
|
||||
"href": "/docs/post-install/customizable",
|
||||
"tail": " — zurück zum übergeordneten Menü."
|
||||
}
|
||||
]
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,128 @@
|
||||
{
|
||||
"meta": {
|
||||
"title": "Post-Install: Netzwerk | ProxMenux Dokumentation",
|
||||
"description": "Netzwerkoptionen im anpassbaren Nachinstallationsskript von ProxMenux: APT über IPv4 erzwingen, ein abgestimmtes sysctl-Profil anwenden, Open vSwitch installieren, TCP BBR + Fast Open aktivieren und Schnittstellennamen an MAC-Adressen binden."
|
||||
},
|
||||
"header": {
|
||||
"title": "Post-Install: Netzwerk",
|
||||
"section": "Einstellungen nach der Installation von Proxmox"
|
||||
},
|
||||
"intro": {
|
||||
"title": "Was diese Kategorie abdeckt",
|
||||
"body": "Fünf unabhängige Netzwerkoptionen: Zwei sind einfach (<strong>APT über IPv4</strong>, <strong>Open vSwitch installieren</strong>), zwei passen das TCP-Verhalten an (<strong>Netzwerk-sysctl-Profil</strong>, <strong>BBR + Fast Open</strong>). Eine behebt ein häufiges Betriebsproblem: <strong>Schnittstellennamen fest zuweisen</strong>, damit eine neue Netzwerkkarte oder ein BIOS-Update <code>enp3s0</code> nicht in <code>enp4s0</code> umbenennt und Ihre Bridges unterbricht."
|
||||
},
|
||||
"ipv4": {
|
||||
"heading": "Erzwingen Sie, dass APT IPv4 verwendet",
|
||||
"intro": "Schreibt <code>Acquire::ForceIPv4 \"true\";</code> in <code>/etc/apt/apt.conf.d/99-force-ipv4</code>. APT weigert sich dann, IPv6 für Paketdownloads zu verwenden, auch wenn der Host über IPv6-Konnektivität verfügt.",
|
||||
"tipTitle": "Wer profitiert",
|
||||
"tipBody": "Hilfreich bei instabilen oder gegenüber IPv4 langsameren IPv6-Verbindungen oder wenn der Debian-/Proxmox-Spiegel gelegentlich über IPv6 ausfällt. Auf Hosts ohne IPv6 unproblematisch. In einem funktionierenden Dual-Stack-Netz sorgt es für vorhersehbares Verhalten: apt überrascht Sie nicht mit einer IPv6-Zeitüberschreitung."
|
||||
},
|
||||
"sysctl": {
|
||||
"heading": "Netzwerkoptimierungen anwenden",
|
||||
"intro": "Schreibt ein abgestimmtes sysctl-Profil nach <code>/etc/sysctl.d/99-network.conf</code>. Es umfasst Socket-Puffer des Kernels, ICMP-Härtung, grundlegenden Schutz vor Adressfälschung und TCP-Puffergrößen für einen Hypervisor mit vielen gleichzeitigen Datenströmen.",
|
||||
"tunedTitle": "Was angepasst wird",
|
||||
"headerArea": "Thema",
|
||||
"headerSettings": "Schlüsseleinstellungen",
|
||||
"rows": [
|
||||
{
|
||||
"area": "Socket-Puffer des Kernels",
|
||||
"settings": "<code>netdev_max_backlog=8192</code>, <code>rmem_max=16M</code>, <code>wmem_max=16M</code>, <code>somaxconn=8192</code>"
|
||||
},
|
||||
{
|
||||
"area": "ICMP-Härtung",
|
||||
"settings": "<code>icmp_echo_ignore_broadcasts=1</code>, <code>icmp_ignore_bogus_error_responses=1</code>"
|
||||
},
|
||||
{
|
||||
"area": "Routing-Sicherheit",
|
||||
"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": "Rückwärtspfadfilter",
|
||||
"settings": "<code>rp_filter=2</code> (lockerer Modus, siehe Hinweis unten)"
|
||||
},
|
||||
{
|
||||
"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": "Ports",
|
||||
"settings": "<code>ip_local_port_range=1024 65535</code> (Bereich kurzlebiger Ports)"
|
||||
},
|
||||
{
|
||||
"area": "Unix-Sockets",
|
||||
"settings": "<code>net.unix.max_dgram_qlen=4096</code>"
|
||||
}
|
||||
],
|
||||
"sourceOutro": "Es fügt auch <code>source /etc/network/interfaces.d/*</code> zu <code>/etc/network/interfaces</code> hinzu, wenn nicht bereits vorhanden - Standardpraxis, so dass Sie modulare Schnittstellensnippets ablegen können, ohne die Hauptdatei zu bearbeiten.",
|
||||
"fwbrTitle": "Automatisches Tuning von virtuellen Firewall Bridges",
|
||||
"fwbrBody": "Zusätzlich zum sysctl-Profil installiert ProxMenux das Hilfsskript <code>/usr/local/sbin/proxmenux-fwbr-tune</code>. Es setzt <code>rp_filter=0</code> und <code>log_martians=0</code> für die Schnittstellen <code>fwbr*</code> / <code>fwln*</code> / <code>fwpr*</code> / <code>tap*</code>, die Proxmox für VMs und Container erstellt. Die einmalig ausgeführte Unit <code>proxmenux-fwbr-tune.service</code> ruft es beim Booten auf, die Regel <code>/etc/udev/rules.d/99-zz-proxmenux-fwbr-tune.rules</code> bei jedem <code>net add</code>-Ereignis mit diesen Präfixen. So werden auch bei VM-Start/-Stopp, Neustart und Live-Migration neu erstellte Schnittstellen erfasst. Direkt nach der Installation verarbeitet das Skript zudem alle bereits vorhandenen Schnittstellen.",
|
||||
"rpFilterTitle": "Warum rp_filter=2 (lose) statt 1 (streng)",
|
||||
"rpFilterBody": "Strenge Rückwärtspfadfilterung verwirft Pakete, deren Quelladresse über eine <em>andere</em> Schnittstelle erreichbar wäre. Das ist ein sinnvoller Standard für Clients, kann aber auf einem Proxmox-Host Probleme verursachen: VM-Verkehr kommt häufig über eine Bridge an und geht bei asymmetrischem Routing über einen Uplink hinaus. <code>rp_filter=2</code> (locker) verwirft nur Pakete mit tatsächlich nicht erreichbaren Quelladressen. Der Kompromiss: etwas geringere Erkennung lokaler IP-Adressfälschung, dafür ein funktionierendes VM-Netz."
|
||||
},
|
||||
"ovs": {
|
||||
"heading": "Open vSwitch installieren",
|
||||
"intro": "Installiert <code>openvswitch-switch</code> + <code>openvswitch-common</code>. Damit steht OVS als Alternative zu den standardmäßigen Linux-Bridges von Proxmox bereit. Die Installation allein ändert keine Netzwerkkonfiguration; vorhandene <code>vmbrX</code>-Bridges funktionieren weiter. Wenn Sie eine neue Bridge <em>erstellen</em>, können Sie OVS im Typ-Auswahlmenü der Proxmox-Oberfläche wählen.",
|
||||
"tipTitle": "Wenn OVS Sinn macht",
|
||||
"tipBody": "Ziehen Sie OVS in Betracht, wenn Sie <strong>VLAN-Trunking mit nicht zusammenhängenden VLAN-IDs</strong>, <strong>LACP mit LLDP in bestimmten Modi</strong>, <strong>feingranulare Programmierung von Datenflüssen</strong> (OpenFlow) oder die Zusammenarbeit mit SDN-Controllern benötigen. Für ein Heimlabor mit wenigen VLANs und einem LACP-Uplink sind Linux-Bridges + <code>vmbrX.VID</code> einfacher und gut geeignet.",
|
||||
"revertTitle": "Reversibel aus dem Menü Deinstallieren",
|
||||
"revertBody": "OVS wird erfasst. <link>Optimierungen deinstallieren</link> führt <code>apt purge</code> für <code>openvswitch-switch</code> und <code>openvswitch-common</code> aus. Migrieren Sie OVS-Bridges <em>vor</em> der Deinstallation zu Linux-Bridges, sonst verlieren die VMs darauf beim nächsten Start die Netzwerkanbindung. Manuelles Äquivalent:"
|
||||
},
|
||||
"bbr": {
|
||||
"heading": "TCP BBR + TCP Fast Open aktivieren",
|
||||
"intro": "Schreibt zwei sysctl-Dateien und lädt sie neu. BBR ersetzt CUBIC durch Googles bandbreitenbasierten Überlastungsalgorithmus, der Verbindungen mit hoher Kapazität und Latenz sowie verlustbehaftete Verbindungen besser verarbeitet. TCP Fast Open (TFO) spart bei wiederholten TCP-Verbindungen einen Umlauf, indem bereits der SYN Daten mitführt.",
|
||||
"verifyTitle": "Verifizierung",
|
||||
"impactTitle": "Die Wirkung hängt von der Arbeitslast ab",
|
||||
"impactBody": "BBR ist bei hoher Latenz oder Paketverlust besonders hilfreich (kontinentübergreifende Replikation, VPN-Tunnel, mobile Clients). Im LAN zwischen zwei Rechnern am selben Switch liegt der Unterschied oft innerhalb der Messschwankungen. TFO hilft besonders bei kurzen, wiederholten HTTP-Verbindungen.",
|
||||
"revertTitle": "Reversibel aus dem Menü Deinstallieren",
|
||||
"revertBody": "BBR/TFO werden erfasst. <link>Optimierungen deinstallieren</link> entfernt die zwei sysctl-Dateien (<code>/etc/sysctl.d/99-kernel-bbr.conf</code> und <code>99-tcp-fastopen.conf</code>) und lädt die übrige Konfiguration neu. Das Löschen setzt aktive Kernelwerte nicht automatisch zurück. Standards wie <code>cubic</code> und <code>tcp_fastopen=1</code> gelten nach einem Neustart, sofern keine andere Konfiguration sie überschreibt. Manuelles Äquivalent:"
|
||||
},
|
||||
"names": {
|
||||
"heading": "Schnittstellennamen (persistent)",
|
||||
"intro": "Durchläuft alle physischen Netzwerkkarten des Hosts (überspringt Loopback, Docker-veths, Bridges, TAP-Geräte, Bonds, Cilium, ZeroTier und WireGuard). Für jede schreibt es eine systemd-<code>.link</code>-Datei, die den aktuellen Namen an die aktuelle MAC-Adresse bindet. Damit hat die MAC-Zuordnung Vorrang vor der Namenslogik des Kernels.",
|
||||
"whyTitle": "Warum das wichtig ist",
|
||||
"whyItems": [
|
||||
"Das Hinzufügen oder Entfernen von PCIe-Geräten kann die Busnummerierung verschieben und <code>enp3s0</code> in <code>enp4s0</code> verwandeln. Wenn Ihr <code>/etc/network/interfaces</code> auf den alten Namen verweist, verschwindet die Brücke beim Neustart.",
|
||||
"BIOS / Firmware-Updates ändern manchmal, wie Geräte aufgezählt werden, mit dem gleichen Effekt.",
|
||||
"Das Hilfsskript schreibt <code>.link</code>-Dateien für physische Netzwerkkarten, auch für Bond-Ports, mit der MAC, die sysfs gerade meldet; bei Bond-Ports kann das die gemeinsame MAC des Bonds sein, prüfen Sie ihre Namen daher nach einem Neustart. Virtuelle Schnittstellen wie LXC-veth-Geräte und die Bond-Geräte selbst werden übersprungen. Namenskonflikte virtueller <code>hotplug</code>-NICs behebt es nicht."
|
||||
],
|
||||
"writtenTitle": "Was geschrieben wird",
|
||||
"writtenIntro": "Eine Datei pro physischem NIC, bei <code>/etc/systemd/network/10-proxmenux-<iface>.link</code>. Jede Datei beginnt mit dem Header <code># Managed by ProxMenux — do not edit</code>, so dass ProxMenux seine eigenen Dateien von benutzer- oder paketgebundenen <code>.link</code>-Dateien unterscheiden kann.",
|
||||
"writtenOutro": "<code>.link</code>-Dateien anderer Pakete oder des Benutzers bleiben erhalten; nur Dateien mit ProxMenux-Header werden verwaltet. Bei erneutem Ausführen gleicht die Funktion ihren Bestand ab: Sie liest <code>MACAddress=</code> aus jeder <code>10-proxmenux-*.link</code> und entfernt Dateien, deren MAC unter <code>/sys/class/net/</code> nicht mehr vorkommt. Dateien älterer ProxMenux-Versionen im Format <code>10-<iface>.link</code> werden beim ersten Lauf automatisch migriert.",
|
||||
"pveTitle": "PVE 9 vs PVE 8",
|
||||
"pveBody": "Das Skript nutzt systemd-<code>.link</code>-Dateien für feste Namen. Auf Proxmox VE 9 lädt es danach zusätzlich udev-Regeln neu, damit eine bereits festgelegte NIC, die erneut angeschlossen oder erkannt wird, ihre Regel ohne Neustart übernimmt. Prüfen Sie vorhandene Schnittstellen nach einem Neustart auf PVE 8 und PVE 9. Der Host bleibt bei <code>ifupdown2</code>. In beiden Fällen setzt das Skript das Neustart-Flag, damit die anpassbare Nachinstallation danach fragt.",
|
||||
"reviewTitle": "Überprüfen Sie zuerst bestehende /etc/network/interfaces",
|
||||
"reviewBody": "Verweist die ältere Konfiguration in <code>/etc/network/interfaces</code> auf automatisch vom Kernel erzeugte NIC-Namen, ist das Festschreiben der <em>aktuellen</em> Namen sinnvoll. Haben Sie die Konfiguration bereits manuell an bestimmte Namen angepasst, prüfen Sie vor dem Neustart sorgfältig, ob die festen Namen mit der interfaces-Datei übereinstimmen.",
|
||||
"revertTitle": "Reversibel aus dem Menü Deinstallieren",
|
||||
"revertBody": "<link>Optimierungen deinstallieren</link> löscht nur <code>10-proxmenux-*.link</code>-Dateien mit ProxMenux-Header aus <code>/etc/systemd/network/</code>. Jede vom Benutzer oder anderen Paketen hinzugefügte <code>.link</code>-Datei bleibt erhalten. Beim nächsten Neustart gilt wieder das Standard-Namensverhalten von systemd."
|
||||
},
|
||||
"related": {
|
||||
"heading": "Verwandte Themen",
|
||||
"items": [
|
||||
{
|
||||
"label": "Netzwerkmanagement",
|
||||
"href": "/docs/network",
|
||||
"tail": " — Diagnose, Bridge-Analyse und geführte Reparaturen."
|
||||
},
|
||||
{
|
||||
"label": "Persistente Schnittstellennamen",
|
||||
"href": "/docs/network/persistent-names",
|
||||
"tail": " — dieselbe Funktion später als eigener Menüpunkt; verwenden Sie eine der beiden Möglichkeiten."
|
||||
},
|
||||
{
|
||||
"label": "Referenz der Netzwerkbefehle",
|
||||
"href": "/docs/help-info/network-commands",
|
||||
"tail": " — ip, ss, ethtool, sysctl."
|
||||
},
|
||||
{
|
||||
"label": "Optimierungen deinstallieren",
|
||||
"href": "/docs/post-install/uninstall",
|
||||
"tail": " — diese Netzwerkänderungen rückgängig machen."
|
||||
},
|
||||
{
|
||||
"label": "Anpassbare Nachinstallation",
|
||||
"href": "/docs/post-install/customizable",
|
||||
"tail": " — zurück zum übergeordneten Menü."
|
||||
}
|
||||
]
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,177 @@
|
||||
{
|
||||
"meta": {
|
||||
"title": "ProxMenux Post-Install: Optionale Einstellungen",
|
||||
"description": "Anleitung zu optionalen Einstellungen im ProxMenux-Skript nach der Installation für zusätzliche Proxmox VE-Funktionen und -Optimierungen.",
|
||||
"ogTitle": "ProxMenux Post-Install: Optionale Einstellungen",
|
||||
"ogDescription": "Anleitung zu optionalen Einstellungen im ProxMenux-Skript nach der Installation für zusätzliche Proxmox VE-Funktionen und -Optimierungen.",
|
||||
"ogImageAlt": "ProxMenux Optionale Einstellungen nach der Installation"
|
||||
},
|
||||
"title": "Optionale Einstellungen",
|
||||
"intro": "Die Kategorie <strong>Optionale Einstellungen</strong> bietet zusätzliche Funktionen und Optimierungen für Ihre Proxmox-VE-Installation. Sie sind nicht unbedingt erforderlich, können aber in bestimmten Situationen die Fähigkeiten des Systems erweitern.",
|
||||
"available": "Verfügbare optionale Funktionen",
|
||||
"stepLabel": "Schritt",
|
||||
"ceph": {
|
||||
"title": "Aktuelle Ceph Unterstützung hinzufügen",
|
||||
"intro": "Diese Option installiert die neueste Ceph-Speichersystemunterstützung für Proxmox VE. Ceph ist ein verteiltes Speichersystem, das hohe Leistung, Zuverlässigkeit und Skalierbarkeit bietet.",
|
||||
"doesIntro": "Was sie tut:",
|
||||
"doesItems": [
|
||||
"Fügt das Ceph-Repository zu Ihrem System hinzu",
|
||||
"Paketlisten aktualisieren",
|
||||
"Installiert Ceph-Pakete mit dem Befehl 'pveceph install'",
|
||||
"Überprüft die Installation"
|
||||
],
|
||||
"howUse": "Verwendung: Nach der Installation können Sie den Ceph-Speicher mit der Proxmox VE-Weboberfläche oder den Befehlszeilentools konfigurieren und verwalten.",
|
||||
"automates": "Diese Anpassung automatisiert die folgenden Befehle:"
|
||||
},
|
||||
"amd": {
|
||||
"title": "AMD-CPU-Korrekturen anwenden",
|
||||
"intro": "Diese Option wendet spezifische Korrekturen für AMD EPYC und Ryzen CPUs an, um die Stabilität und Kompatibilität zu verbessern.",
|
||||
"doesIntro": "Was sie tut:",
|
||||
"doesItems": [
|
||||
"Erkennen, ob ein AMD EPYC oder Ryzen CPU vorhanden ist",
|
||||
"Wendet den Kernelparameter 'idle=nomwait' an, um zufällige Abstürze zu verhindern (über /etc/kernel/cmdline auf systemd-Boot-Hosts oder /etc/default/grub auf GRUB-Hosts — mit einem .bak des Originals)",
|
||||
"Konfiguriert KVM, um bestimmte MSRs (Model Specific Registers) für eine bessere Windows-Gastkompatibilität zu ignorieren"
|
||||
],
|
||||
"howUse": "Verwendung: Diese Fixes werden automatisch angewendet und erfordern einen Systemneustart.",
|
||||
"automates": "Diese Anpassung automatisiert die folgenden Befehle:"
|
||||
},
|
||||
"ha": {
|
||||
"title": "Hochverfügbarkeitsdienste ermöglichen",
|
||||
"intro": "Diese Option ermöglicht High Availability (HA)-Dienste in Proxmox VE und ermöglicht ein automatisches Failover von VMs und Containern im Falle eines Knotenausfalls.",
|
||||
"doesIntro": "Was sie tut:",
|
||||
"doesItems": [
|
||||
"Aktiviert und startet den Dienst pve-ha-lrm (Local Resource Manager)",
|
||||
"Aktiviert und startet den pve-ha-crm (Cluster Resource Manager) Service",
|
||||
"Aktiviert und startet den corosync-Dienst für die Clusterkommunikation"
|
||||
],
|
||||
"howUse": "Verwendung: Nach Aktivierung dieser Dienste können Sie HA-Gruppen und -Ressourcen in der Proxmox VE-Weboberfläche konfigurieren.",
|
||||
"automates": "Diese Anpassung automatisiert die folgenden Befehle:"
|
||||
},
|
||||
"pveam": {
|
||||
"title": "Proxmox VE Appliance Manager aktualisieren",
|
||||
"intro": "Aktualisiert den lokalen Index der Containervorlagen, den <code>pveam</code> in der Proxmox-Oberfläche bereitstellt. So ist die Liste der verfügbaren Softwarevorlagen beim nächsten Erstellen eines LXC aktuell.",
|
||||
"doesIntro": "Was sie tut:",
|
||||
"doesItems": [
|
||||
"Führt <code>pveam update</code> gegen die Proxmox-Spiegelserver aus, um den aktuellen Katalog der Softwarevorlagen abzurufen",
|
||||
"Füllt die Liste der Softwarevorlagen in der Weboberfläche beim Erstellen eines Containers"
|
||||
],
|
||||
"howUse": "Verwendung: Einmal ausführen, wenn die Vorlagenliste in der Oberfläche veraltet wirkt oder Sie den Spiegelserver gewechselt haben. Es lädt nur den Katalogindex herunter, nicht die Vorlagen selbst.",
|
||||
"automates": "Diese Anpassung automatisiert den folgenden Befehl:"
|
||||
},
|
||||
"fastfetch": {
|
||||
"title": "Installieren und Konfigurieren von Fastfetch",
|
||||
"intro": "Diese Option installiert und konfiguriert leise Fastfetch, ein Systeminformationstool, das Systemspezifikationen und ein benutzerdefiniertes Logo beim Login anzeigt.",
|
||||
"doesLabel": "Was sie tut:",
|
||||
"doesItems": [
|
||||
"Lädt und installiert die neueste Fastfetch-Version ohne zusätzliche Rückfragen",
|
||||
"Ermöglicht Ihnen die Auswahl eines benutzerdefinierten Logos (<strong>ProxMenux, Proxmox, Helper-Scripts, Home-Labs-Club, Proxmology</strong> oder ein benutzerdefiniertes).",
|
||||
"Konfiguriert Fastfetch zur Anzeige von <em>\"System optimiert durch ProxMenux\"</em>",
|
||||
"Richtet Fastfetch so ein, dass es automatisch bei der Konsolenanmeldung ausgeführt wird"
|
||||
],
|
||||
"importantLabel": "Wichtig:",
|
||||
"importantBody": "Wenn Sie sich über SSH mit Proxmox verbinden, sollten Sie das <strong>Proxmox</strong>-Logo auswählen oder ein benutzerdefiniertes mit <code>jp2a</code> oder <code>img2txt</code> erstellen. Die anderen Logos werden mit <code>chafa</code> generiert und werden in einer Standard-SSH-Sitzung möglicherweise nicht korrekt angezeigt.",
|
||||
"customLabel": "Eigene Logos:",
|
||||
"customBody1": "Um ein benutzerdefiniertes Logo zu verwenden, legen Sie Ihre ASCII-Kunsttextdatei in: <code>/usr/local/share/fastfetch/logos/</code>",
|
||||
"customBody2": "Sie können benutzerdefinierte Logos mit Tools wie <code>chafa</code>, <code>jp2a</code> oder <code>img2txt</code> erstellen.",
|
||||
"customBody3": "Für beste Ergebnisse:",
|
||||
"customItems": [
|
||||
"Halten Sie die Logohöhe auf 35-Linien oder weniger, um Proportionen beizubehalten und in das Terminal zu passen",
|
||||
"Verwenden Sie <code>chafa</code> für Farblogos (in SSH-Sitzungen möglicherweise nicht korrekt angezeigt)",
|
||||
"Verwenden Sie <code>jp2a</code> oder <code>img2txt</code> für SSH-kompatible Logos"
|
||||
],
|
||||
"examplesLabel": "Beispiel Logos:",
|
||||
"logos": [
|
||||
{
|
||||
"name": "ProxMenux",
|
||||
"alt": "ProxMenux-Logo",
|
||||
"src": "https://macrimi.github.io/ProxMenux/fastfetch/proxmenux.png"
|
||||
},
|
||||
{
|
||||
"name": "Proxmox",
|
||||
"alt": "Proxmox-Logo",
|
||||
"src": "https://macrimi.github.io/ProxMenux/fastfetch/proxmox.png"
|
||||
},
|
||||
{
|
||||
"name": "JC Channel",
|
||||
"alt": "JC-Channel-Logo",
|
||||
"src": "/fastfetch/jc-channel.png"
|
||||
},
|
||||
{
|
||||
"name": "Helper-Scripts",
|
||||
"alt": "Helper-Scripts-Logo",
|
||||
"src": "https://macrimi.github.io/ProxMenux/fastfetch/helper-scripts.png"
|
||||
},
|
||||
{
|
||||
"name": "Home-Labs-Club",
|
||||
"alt": "Home-Labs-Club-Logo",
|
||||
"src": "https://macrimi.github.io/ProxMenux/fastfetch/home-labs-club.png"
|
||||
},
|
||||
{
|
||||
"name": "Proxmology",
|
||||
"alt": "Proxmology-Logo",
|
||||
"src": "https://macrimi.github.io/ProxMenux/fastfetch/proxmology.png"
|
||||
}
|
||||
],
|
||||
"automates": "Diese Anpassung automatisiert die folgenden Befehle:"
|
||||
},
|
||||
"figurine": {
|
||||
"title": "Installieren und Konfigurieren von Figurine",
|
||||
"intro": "Diese Option installiert und konfiguriert Figurine, ein Tool, das stilvolle ASCII-Textbanner für Ihr Terminal erstellt und Ihren Hostnamen in einem optisch ansprechenden 3D-Format anzeigt.",
|
||||
"doesLabel": "Was sie tut:",
|
||||
"doesItems": [
|
||||
"Lädt Figurine v2.1.1 von GitHub herunter und installiert die passende Version für die Host-Architektur (AMD64, ARM64 oder ARMv7)",
|
||||
"Erstellen Sie eine Begrüßungsnachricht, die Ihren Hostnamen in 3D ASCII-Kunst anzeigt, wenn Sie sich anmelden",
|
||||
"Aktualisiert eine vorhandene Figurine-Programmdatei erst nach erfolgreichem Download und Entpacken",
|
||||
"Richtet die Willkommensnachricht so ein, dass sie automatisch beim Login ausgeführt wird"
|
||||
],
|
||||
"practicalLabel": "Praktische Verwendung:",
|
||||
"practicalBody": "Beim Verwalten mehrerer Proxmox-Knoten in einem Cluster bietet Figurine eine sofortige visuelle Anzeige, an welchem Knoten Sie gerade angemeldet sind. Dies verhindert versehentliche Befehle auf dem falschen Knoten und verbessert Ihren Workflow bei der Verwaltung mehrerer Server.",
|
||||
"exampleLabel": "Beispielausgabe:",
|
||||
"imageAlt": "Figurine Beispielausgabe",
|
||||
"automates": "Diese Anpassung automatisiert den folgenden Prozess:",
|
||||
"outro": "Nach der Installation wird Ihr Hostname bei jeder Anmeldung in 3D ASCII-Kunst angezeigt, wodurch sofort klar wird, an welchem Proxmox-Knoten Sie arbeiten."
|
||||
},
|
||||
"log2ram": {
|
||||
"title": "Log2RAM installieren (SSD/NVMe Verschleißreduzierung)",
|
||||
"intro": "Log2RAM bindet <code>/var/log</code> als tmpfs-RAM-Disk ein und synchronisiert regelmäßig auf den Datenträger. Das Puffern häufiger journald-Schreibvorgänge im RAM kann SSD-Verschleiß und Datenträger-I/O verringern. Synchronisierung und sauberes Herunterfahren sichern die Logs; bei abruptem Stromausfall können Einträge seit der letzten Synchronisierung verloren gehen.",
|
||||
"upstreamLabel": "Vorgelagertes Projekt:",
|
||||
"upstreamUrl": "https://github.com/azlux/log2ram",
|
||||
"upstreamLinkLabel": "azlux/log2ram auf GitHub",
|
||||
"doesLabel": "Was ProxMenux tut:",
|
||||
"doesItems": [
|
||||
"Erkennt anhand von <code>/sys/block/<dev>/queue/rotational</code>, ob die Systemplatte SSD/NVMe ist. Bei einer rotierenden Festplatte fragt die automatisierte Variante vor der Installation nach.",
|
||||
"Klont das Originalprojekt (<code>azlux/log2ram</code>) nach <code>/tmp/log2ram</code> und passt <code>install.sh</code> an: <code>rsync -aAXv</code> wird durch <code>rsync -aXv --no-acls</code> ersetzt. Dadurch wird der Fehler <em>set_acl: Operation not supported</em> mit Exitcode 23 vermieden, der beim Verschieben von /var/log auf Dateisystemen ohne ACL-Unterstützung auftreten kann. Die systemd-Unit <code>log2ram</code> wird nach Installation aktiviert.",
|
||||
"Größe der Ramdisk auf Basis des Hosts RAM: <code>≤ 8 GB → 128M</code>, <code>≤ 16 GB → 256M</code>, <code>> 16 GB → 512M</code>. Schreibt den Wert in <code>SIZE=</code> in <code>/etc/log2ram.conf</code>.",
|
||||
"Plant eine regelmäßige Datenträgersynchronisierung über <code>/etc/cron.d/log2ram</code>: alle 1 / 3 / 6 Stunden entsprechend derselben RAM-Stufe.",
|
||||
"Installiert den Schutz <code>/usr/local/bin/log2ram-check.sh</code>, der über <code>/etc/cron.d/log2ram-auto-sync</code> alle 10 Minuten läuft. Bei 80% Belegung von <code>/var/log</code> bereinigt er journald. Bei 92% führt er zunächst <code>logrotate -f /etc/logrotate.d/proxmox-backup-api</code> aus, falls die Datei existiert: Die PBS-API-Logs sind oft der größte Platzverbraucher auf einem PBS-Host. Danach kürzt er <code>pveproxy access/error</code> und <code>pveam.log</code> vor der Synchronisierung. <code>log2ram write</code> allein kopiert tmpfs auf Disk, verkleinert es aber nicht. Der Schutz hilft gegen PVE-Ausfälle mit <em>No space left on device</em> durch unkontrolliertes Logwachstum.",
|
||||
"Erkennt den Dienst <code>proxmox-backup-server</code> auf dem Host. Falls vorhanden, erstellt es <code>/etc/logrotate.d/proxmox-backup-api</code> (20 MB × 3 Rotationen) und <code>/etc/cron.hourly/proxmox-backup-logrotate</code>, damit die häufig stark wachsenden PBS-API-Logs auch zwischen Log2RAM-Synchronisierungen begrenzt werden. Ohne PBS erfolgt keine Änderung.",
|
||||
"Stellt systemd-journald-Grenzwerte (<code>SystemMaxUse</code>, <code>RuntimeMaxUse</code>) so ein, dass sie in die Ramdisk passen, so dass ein einzelner Burst sie nicht füllen kann.",
|
||||
"Wird in <code>installed_tools.json</code> erfasst und kann über Optimierungen deinstallieren rückgängig gemacht werden."
|
||||
],
|
||||
"howUseLabel": "Wie zu verwenden:",
|
||||
"howUseBody": "Die automatisierte Variante installiert Log2RAM unbeaufsichtigt bei erkanntem SSD-/NVMe-Systemlaufwerk. Die anpassbare Variante fragt nach Größe, Intervall und Auto-Sync-Schutz. Die Abfrage nennt derzeit 90%, das erzeugte Skript nutzt jedoch 80% für Bereinigung und 92% für die oben beschriebene intensive Bereinigung.",
|
||||
"verifyLabel": "Überprüfen und Verwalten aus der 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": "ZRAM-Swap-Profil aktivieren",
|
||||
"intro": "Erstellt das komprimierte Swap-Gerät <code>/dev/zram0</code> im RAM mit <code>systemd-zram-generator</code>. Ausgelagerte Speicherseiten werden mit zstd komprimiert und im RAM gehalten, bevor Swap auf dem Datenträger genutzt wird.",
|
||||
"doesLabel": "Was sie tut:",
|
||||
"doesItems": [
|
||||
"Installiert <code>systemd-zram-generator</code>, wenn es fehlt, und zeichnet auf, ob ProxMenux es installiert hat.",
|
||||
"Schreibt <code>/etc/systemd/zram-generator.conf.d/90-proxmenux.conf</code>: ein <code>zram0</code>-Gerät mit einem Zehntel des Host-RAMs, zstd-Komprimierung (<code>zstd(level=9)</code> mit systemd-zram-generator ab 1.2.0) und Swap-Priorität 32767.",
|
||||
"Mit dieser Priorität füllt der Kernel zuerst ZRAM. Ein vorhandener Swap auf der Festplatte behält seine eigene Priorität und nimmt die Seiten, die nicht mehr in ZRAM passen.",
|
||||
"Sucht vor Änderungen nach einer anderen ZRAM-Konfiguration: aktivem zram-Swap, zram-Eintrag in <code>/etc/fstab</code>, systemd-Unit oder anderer Generatordatei. Wird eine gefunden, bricht die Option ab und lässt sie unverändert.",
|
||||
"Startet <code>dev-zram0.swap</code> und überprüft, ob das aktive Gerät mit dem Profil übereinstimmt. Wenn nicht, wird der vorherige Zustand wiederhergestellt.",
|
||||
"Wird in <code>installed_tools.json</code> erfasst und kann über Optimierungen deinstallieren rückgängig gemacht werden."
|
||||
],
|
||||
"howUseLabel": "Wie zu verwenden:",
|
||||
"howUseBody": "Diese Option gibt es nur in der anpassbaren Variante; die automatisierte wendet sie nicht an. Das Gerät wird bei jedem Start neu erstellt. Solange es aktiv ist, zeigt die Karte „Arbeitsspeicher“ in ProxMenux Monitor Kapazität, belegten Swap, Algorithmus, Kompressionsverhältnis und tatsächlichen RAM-Verbrauch.",
|
||||
"verifyLabel": "Überprüfen Sie von der 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": "Automatische Anwendung",
|
||||
"body": "Wählen Sie in der anpassbaren Variante die optionalen Funktionen nach Bedarf. Log2RAM gehört mit Hardwareerkennung auch zur automatisierten Variante; ZRAM bleibt ausschließlich anpassbar. Die Abschnitte erläutern Abfragen und Voraussetzungen."
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,61 @@
|
||||
{
|
||||
"meta": {
|
||||
"title": "Nach der Installation: Leistung | ProxMenux-Dokumentation",
|
||||
"description": "Leistungsoptionen im anpassbaren ProxMenux-Skript nach der Installation. Ersetzt das einsträngige gzip durch pigz (paralleles gzip) für schnellere Backups und Komprimierung auf Hosts mit mehreren Kernen."
|
||||
},
|
||||
"header": {
|
||||
"title": "Nach der Installation: Leistung",
|
||||
"description": "Leistungsoptionen innerhalb des anpassbaren Post-Installationsskripts. Derzeit enthält diese Kategorie eine einzige Optimierung: Ersetzen von gzip durch pigz, so dass Backups und Kompression jeden CPU-Kern anstelle von einem verwenden.",
|
||||
"section": "Einstellungen nach der Installation von Proxmox"
|
||||
},
|
||||
"intro": {
|
||||
"title": "Was diese Kategorie abdeckt",
|
||||
"body": "Die einzige Leistungsoption hier leitet das gzip des Systems auf eine parallele Implementierung um. Andere Leistungsanpassungen wie Speicheroptimierung, E/A-Scheduling, ZFS-ARC-Größe und Kernel-Limits finden Sie in ihren Kategorien (<em>System</em>, <em>Speicher</em>), da sie andere Subsysteme betreffen."
|
||||
},
|
||||
"pigz": {
|
||||
"heading": "Verwenden Sie pigz für eine schnellere GZIP-Komprimierung",
|
||||
"intro": "Standard-<code>gzip</code> komprimiert Daten mit <strong>einem einzigen CPU-Kern</strong>. Auf modernen Proxmox-Hosts mit 8, 16 oder 32 Kernen ist das ein großer Engpass bei VM-/CT-Backups mit <code>vzdump</code>, Logrotation und allen Vorgängen über <code>gzip</code>. <a>pigz</a> ist ein direkt einsetzbarer paralleler Ersatz: dieselbe gzip-kompatible Ausgabe, aber auf alle Kerne verteilte Arbeit.",
|
||||
"doesTitle": "Was ProxMenux tut",
|
||||
"doesIntro": "Fünf Schritte, alle idempotent:",
|
||||
"doesItems": [
|
||||
"Setzt <code>pigz: 1</code> in <code>/etc/vzdump.conf</code>, so dass das Backup-Tool von Proxmox pigz nativ verwendet.",
|
||||
"Installiert das Paket <code>pigz</code> apt, falls nicht bereits vorhanden.",
|
||||
"Schreibt ein Wrapper-Script bei <code>/bin/pigzwrapper</code>, das jedes Argument an <code>/usr/bin/pigz</code> weiterleitet.",
|
||||
"Registriert eine dpkg-Umleitung für das Systemprogramm <code>gzip</code> (<code>/usr/bin/gzip</code> bei Proxmox VE 9, <code>/bin/gzip</code> bei Proxmox VE 8). Die Originaldatei bleibt daneben als <code>gzip.distrib</code> erhalten und wird durch den Wrapper ersetzt. Danach verwendet <em>alles</em>, was <code>gzip</code> aufruft — logrotate, <code>tar czf</code>, Skripte und vzdump — transparent pigz.",
|
||||
"Prüft, ob die als <code>gzip.distrib</code> gespeicherte Datei ein funktionierender Gzip ist, bevor der Wrapper installiert wird, und installiert das <code>gzip</code>-Paket zuerst neu, wenn dies nicht der Fall ist. Ein Host, der noch den früheren <code>/bin/gzip.original</code>-Swap hat, wird in die Umleitung verschoben, wenn die Option erneut angewendet wird."
|
||||
],
|
||||
"replacesTitle": "Ersetzt ein Systemprogramm",
|
||||
"replacesBody": "Ein Wrapper anstelle von <code>gzip</code> ist ungewöhnlich. Das ist sicher, da der Wrapper gzip-kompatible Ausgabe erzeugt. Skripte mit fest kodierten Pfaden, in restriktiven chroot-Umgebungen oder mit Prüfung von Binärdatei-Hashes können sich jedoch anders verhalten. Das Original bleibt als <code>gzip.distrib</code> erhalten. Durch die dpkg-Umleitung aktualisieren Updates des Pakets <code>gzip</code> und das Upgrade von Proxmox VE 8 auf 9 diese Datei, während der Wrapper erhalten bleibt.",
|
||||
"revertTitle": "Reversibel aus dem Menü Deinstallieren",
|
||||
"revertBody": "Diese Optimierung wird erfasst. <link>Optimierungen deinstallieren</link> kopiert das Original aus <code>gzip.distrib</code> über den Wrapper, entfernt die Umleitung und <code>pigzwrapper</code>, kommentiert die Zeile <code>pigz</code> in <code>/etc/vzdump.conf</code> aus und führt nach erfolgreicher gzip-Prüfung <code>apt purge pigz</code> aus. Manuelles Äquivalent für Proxmox VE 9:",
|
||||
"verifyTitle": "Verifizierung",
|
||||
"verifyBody": "Nach der Anwendung sollte <code>gzip --version</code> pigz erwähnen. Ein schneller Benchmark zeigt auch den Geschwindigkeitsunterschied auf einem Multi-Core-Host:",
|
||||
"whenTitle": "Wenn das am wichtigsten ist",
|
||||
"whenBody": "Der Nutzen wächst mit der <strong>Anzahl der CPU-Kerne</strong> und der <strong>Häufigkeit der Backups</strong>. Auf einem Heimlaborrechner mit 2 Kernen und einem täglichen vzdump ist der Vorteil gering. Auf einem Produktionshost mit 16 Kernen, der jede Nacht ein Dutzend VMs sichert, kann pigz das Backup-Zeitfenster auf einen Bruchteil der Zeit von einsträngigem gzip verkürzen."
|
||||
},
|
||||
"related": {
|
||||
"heading": "Verwandte Themen",
|
||||
"items": [
|
||||
{
|
||||
"label": "Backup- und Wiederherstellungsbefehle",
|
||||
"href": "/docs/help-info/backup-commands",
|
||||
"tailRich": " — vzdump-CLI-Referenz einschließlich der Thread-Option <code>--pigz</code>."
|
||||
},
|
||||
{
|
||||
"label": "Speicher",
|
||||
"href": "/docs/post-install/storage",
|
||||
"tail": " — Geschwindigkeitsgrenzen für vzdump und ZFS-ARC-Anpassungen."
|
||||
},
|
||||
{
|
||||
"label": "System",
|
||||
"href": "/docs/post-install/system",
|
||||
"tail": " — Anpassung von Dateideskriptoren und Speicher."
|
||||
},
|
||||
{
|
||||
"label": "Anpassbare Nachinstallation",
|
||||
"href": "/docs/post-install/customizable",
|
||||
"tail": " — zurück zum übergeordneten Menü."
|
||||
}
|
||||
]
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,57 @@
|
||||
{
|
||||
"meta": {
|
||||
"title": "Post-Install: Sicherheit | ProxMenux Dokumentation",
|
||||
"description": "Sicherheitsoptionen im anpassbaren ProxMenux-Skript nach der Installation. Derzeit eine Option: den Dienst portmapper/rpcbind deaktivieren, um die Angriffsfläche des Hosts zu reduzieren."
|
||||
},
|
||||
"header": {
|
||||
"title": "Post-Install: Sicherheit",
|
||||
"section": "Einstellungen nach der Installation von Proxmox"
|
||||
},
|
||||
"intro": {
|
||||
"title": "Was diese Kategorie abdeckt",
|
||||
"body": "Die Sicherheit nach der Installation beschränkt sich auf <strong>Host-Härtung, die sicher unbeaufsichtigt angewendet werden kann</strong>: selten benötigte Dienste deaktivieren und dies über Deinstallieren wieder rückgängig machen. Aktive Sicherheitswerkzeuge wie Fail2Ban zur Einbruchsverhinderung und Lynis für Audits finden Sie unter <em>Sicherheit</em> im ProxMenux-Hauptmenü, außerhalb der Nachinstallation."
|
||||
},
|
||||
"rpcbind": {
|
||||
"heading": "Portmapper/rpcbind deaktivieren",
|
||||
"intro": "<code>rpcbind</code> (früher <code>portmap</code>) ordnet RPC-Programmnummern Netzwerkports zu. NFS und einige ältere RPC-Werkzeuge sind davon abhängig. Auf einem typischen Proxmox-Host ohne NFS-Server <strong>nutzt es nichts</strong>; aktiviert bleibt Port <code>111/tcp</code> auf allen Schnittstellen offen.",
|
||||
"whyTitle": "Warum es sich lohnt zu deaktivieren",
|
||||
"whyItems": [
|
||||
"Reduziert die Angriffsfläche des Hosts – ein Hördienst weniger, um den man sich Sorgen machen muss.",
|
||||
"Historisch missbraucht als Reflexions- / Verstärkungsvektor in DDoS-Angriffen. Durch das Deaktivieren von <code>rpcbind</code> wird dieser Verstärkungsfaktor für Ihren Host entfernt.",
|
||||
"Entfernt das Rauschen, das es in Protokollen und <code>netstat</code> / <code>ss</code> erzeugt, wodurch echte Aktivitäten leichter zu erkennen sind."
|
||||
],
|
||||
"nfsTitle": "Deaktivieren Sie dies nicht, wenn Sie NFS verwenden",
|
||||
"nfsBody": "NFS-Server <strong>und</strong> NFS-Client benötigen <code>rpcbind</code> zur Aushandlung der Ports für <code>mountd</code>, <code>statd</code>, <code>lockd</code> usw. Wenden Sie diese Option nicht an, wenn Ihr Proxmox-Host NFS-Freigaben <em>exportiert</em> oder NFS-Freigaben eines NAS <em>einbindet</em>. Das Einbinden schlägt sonst mit <code>mount.nfs: rpc.statd is not running</code> oder ähnlichen Fehlern fehl.",
|
||||
"runsTitle": "Was ProxMenux ausführt",
|
||||
"runsOutro": "Das Paket bleibt installiert. ProxMenux zeichnet den ursprünglichen aktivierten/aktiven Zustand von rpcbind.service und rpcbind.socket auf und deaktiviert und stoppt dann beide Einheiten, so dass die Socket-Aktivierung den Dienst nicht zurückbringen kann.",
|
||||
"verifyTitle": "Verifizierung",
|
||||
"verifyBody": "Bestätigen Sie nach der Anwendung, dass <code>rpcbind</code> deaktiviert ist und nichts auf Port 111 zuhört:",
|
||||
"reversibleTitle": "Wiederherstellen des ursprünglichen Service-Status",
|
||||
"reversibleBody": "Die Änderung wird in <code>installed_tools.json</code> erfasst. <link>Optimierungen deinstallieren</link> setzt jede rpcbind-Einheit auf den zuvor aufgezeichneten aktivierten/deaktivierten und aktiven/inaktiven Zustand zurück. Dabei wird nicht vorausgesetzt, dass rpcbind auf jedem Host aktiviert war."
|
||||
},
|
||||
"related": {
|
||||
"heading": "Verwandte Themen",
|
||||
"items": [
|
||||
{
|
||||
"label": "Sicherheitsmenü",
|
||||
"href": "/docs/security",
|
||||
"tail": " — leistungsfähigere Werkzeuge: Fail2Ban (Einbruchsverhinderung) und Lynis (Audit)."
|
||||
},
|
||||
{
|
||||
"label": "Lynis",
|
||||
"href": "/docs/security/lynis",
|
||||
"tail": "– Überprüfen Sie den Host, um weitere Möglichkeiten zur Härtung zu finden."
|
||||
},
|
||||
{
|
||||
"label": "Nützliche Systembefehle",
|
||||
"href": "/docs/help-info/system-commands",
|
||||
"tail": " — Referenz für Dienststatus, journalctl und lynis audit."
|
||||
},
|
||||
{
|
||||
"label": "Anpassbare Nachinstallation",
|
||||
"href": "/docs/post-install/customizable",
|
||||
"tail": " — zurück zum übergeordneten Menü."
|
||||
}
|
||||
]
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,167 @@
|
||||
{
|
||||
"meta": {
|
||||
"title": "Nachinstallation: Speicher | ProxMenux Dokumentation",
|
||||
"description": "Speicheroptimierungen im anpassbaren Nachinstallationsskript von ProxMenux: ZFS-ARC-Größe nach Host-RAM, regelmäßige Snapshots mit zfs-auto-snapshot und Entfernen der vzdump-Backup-Drosselung."
|
||||
},
|
||||
"header": {
|
||||
"title": "Post-Installation: Speicher",
|
||||
"section": "Einstellungen nach der Installation von Proxmox"
|
||||
},
|
||||
"intro": {
|
||||
"title": "Was diese Kategorie abdeckt",
|
||||
"body": "Vier Speicheroptimierungen: <strong>ZFS ARC</strong> auf einen sinnvollen Anteil des Host-RAMs abstimmen, <strong>automatische ZFS-Snapshots</strong> installieren und planen, <strong>ZFS autotrim</strong> auf SSD-/NVMe-Pools aktivieren und <strong>vzdump</strong> von Drosselungen befreien. Wählen Sie die unabhängigen Optionen passend zu Ihrem System. Als fünfte speichernahe Option reduziert <link>Log2RAM</link> SSD-/NVMe-Schreibvorgänge, indem es <code>/var/log</code> in eine RAM-Disk verschiebt. Es steht unter Optional, weil das anpassbare Menü es dort einordnet."
|
||||
},
|
||||
"trackedTitle": "Alle vier werden im Deinstallationsmenü erfasst",
|
||||
"trackedBody": "Jede Option registriert ein Werkzeug in <code>installed_tools.json</code> für <link>Optimierungen deinstallieren</link>. <code>zfs_arc</code> entfernt <code>/etc/modprobe.d/99-zfsarc.conf</code> und erstellt initramfs neu; <code>zfs_auto_snapshot</code> entfernt den Cron-Zeitplan und bietet die vollständige Paketentfernung an; <code>zfs_autotrim</code> setzt <code>autotrim=off</code> auf den zuvor aktivierten Pools; <code>vzdump_speed</code> stellt <code>/etc/vzdump.conf</code> aus der bei Installation erstellten <code>.bak</code> wieder her.",
|
||||
"arc": {
|
||||
"heading": "ZFS ARC-Größe optimieren",
|
||||
"intro": "Der <strong>Adaptive Replacement Cache (ARC)</strong> ist der ZFS-Lesecache im RAM. Proxmox-VE-Installationen ab 8.1 setzen 10% RAM mit maximal 16 GiB; ältere oder aktualisierte Hosts können abweichen. Diese Option schreibt genau diese Regel ausdrücklich (RAM/10, höchstens 16 GiB, mindestens 64 MiB) in eine eigene Datei und deckt so auch ältere oder aktualisierte Hosts ab. Prüfen Sie vorhandene Einstellungen und Arbeitslast; ein kleinerer Cache ist nicht immer schneller.",
|
||||
"sizingTitle": "Größenregeln",
|
||||
"headerRam": "Host-Arbeitsspeicher",
|
||||
"headerMax": "ARC-Obergrenze",
|
||||
"rows": [
|
||||
{
|
||||
"ram": "Formel",
|
||||
"max": "RAM / 10, höchstens 16 GiB und mindestens 64 MiB"
|
||||
},
|
||||
{
|
||||
"ram": "8 GB Host",
|
||||
"max": "≈ 819 MiB (RAM/10)"
|
||||
},
|
||||
{
|
||||
"ram": "16 GB Host",
|
||||
"max": "≈ 1.6 GiB (RAM/10)"
|
||||
},
|
||||
{
|
||||
"ram": "64 GB Host",
|
||||
"max": "≈ 6.4 GiB (RAM/10)"
|
||||
},
|
||||
{
|
||||
"ram": "≥ 160 GB Host",
|
||||
"max": "16 GiB (Obergrenze)"
|
||||
}
|
||||
],
|
||||
"after": "Die Datei <code>/etc/modprobe.d/99-zfsarc.conf</code> enthält nur <code>options zfs zfs_arc_max=…</code>. Andere ZFS-Parameter (<code>zfs_arc_min</code>, L2ARC-Vorablesen/Schreibbegrenzung, TXG-Zeitlimit) werden nicht abgestimmt. Vorher prüft ein Abgleich andere <code>*.conf</code> in <code>/etc/modprobe.d/</code> auf <code>zfs_arc_min</code> / <code>zfs_arc_max</code>, sichert sie mit Manifest unter <code>/usr/local/share/proxmenux/backups/zfs_arc/</code> und entfernt daraus die widersprüchlichen Werte <code>zfs_arc_min</code> / <code>zfs_arc_max</code> (andere Optionen dieser Zeilen bleiben erhalten). Damit legt nur die ARC-Datei von ProxMenux den Grenzwert fest. Anschließend werden <code>update-initramfs -u -k all</code> und gegebenenfalls <code>proxmox-boot-tool refresh</code> ausgeführt, damit der Grenzwert auch im initramfs für ZFS-Root-Systeme ankommt.",
|
||||
"rebootTitle": "Erfordert einen Neustart, um wirksam zu werden",
|
||||
"rebootBody": "ARC-Einstellungen werden beim Laden des Kernelmoduls <code>zfs</code> gelesen. Für ZFS-Root-Hosts erzeugt ProxMenux initramfs mit <code>update-initramfs -u -k all</code> neu und aktualisiert bei Bedarf den Bootloader mit <code>proxmox-boot-tool refresh</code>. Der neue Modulparameter wird erst nach Neustart genutzt; das entsprechende Flag wird automatisch gesetzt.",
|
||||
"safeTitle": "Sicher auf Nicht-ZFS-Hosts",
|
||||
"safeBody": "Die Funktion schreibt die Konfiguration nur, wenn <code>zpool list</code> mindestens einen importierten ZFS-Pool meldet. Auf ext4 / LVM-only Proxmox-Hosts oder auf Maschinen, auf denen die ZFS-Tools installiert sind, aber kein Pool importiert wird, ist das Ankreuzen dieser Option ein No-Op - nichts wird geschrieben.",
|
||||
"verifyTitle": "Verifizierung und manuelles Rollback"
|
||||
},
|
||||
"autoSnap": {
|
||||
"heading": "ZFS-Auto-Snapshot installieren",
|
||||
"intro": "Installiert <a>zfs-auto-snapshot</a> und schreibt die Cron-Zeitpläne für automatische Snapshots in mehreren Intervallen neu. Eine einfache zusätzliche Absicherung neben regulären vzdump-Backups.",
|
||||
"cadenceTitle": "Von ProxMenux eingerichteter Snapshot-Zeitplan",
|
||||
"headerLabel": "Etikett",
|
||||
"headerRuns": "Ausführung",
|
||||
"headerKept": "Snapshots behalten",
|
||||
"rows": [
|
||||
{
|
||||
"label": "häufig",
|
||||
"runs": "jede 15 min",
|
||||
"kept": "4"
|
||||
},
|
||||
{
|
||||
"label": "stündlich",
|
||||
"runs": "jede Stunde",
|
||||
"kept": "1"
|
||||
},
|
||||
{
|
||||
"label": "täglich",
|
||||
"runs": "einmal täglich",
|
||||
"kept": "1"
|
||||
},
|
||||
{
|
||||
"label": "wöchentlich",
|
||||
"runs": "einmal pro Woche",
|
||||
"kept": "1"
|
||||
},
|
||||
{
|
||||
"label": "monatlich",
|
||||
"runs": "einmal im Monat",
|
||||
"kept": "1"
|
||||
}
|
||||
],
|
||||
"conservativeTitle": "Zurückhaltende Aufbewahrungszahlen",
|
||||
"conservativeBody": "ProxMenux wird mit konservativer Aufbewahrung ausgeliefert (nur 4 häufig + 1 jedes längeren Intervalls), sodass der ZFS snapshot-Speicher nicht überlastet wird. Wenn Sie eine längere Aufbewahrung wünschen, bearbeiten Sie die Zahlen in <code>/etc/cron.d/zfs-auto-snapshot</code>, <code>/etc/cron.hourly/zfs-auto-snapshot</code> usw., nachdem das Skript ausgeführt wird.",
|
||||
"onlyZfsTitle": "Nur nützlich für ZFS Pools",
|
||||
"onlyZfsBody": "Die Installation des Pakets auf einem Ext4-Host ist harmlos, aber sinnlos - es gibt keine ZFS-Datensätze, die es zum Schnappschuss verwenden kann. Überspringen Sie diese Option, wenn Sie ZFS nicht verwenden.",
|
||||
"verifyTitle": "Verifizierung und manuelles Rollback"
|
||||
},
|
||||
"autotrim": {
|
||||
"heading": "ZFS-Autotrim aktivieren (SSD/NVMe-Pools)",
|
||||
"intro": "Aktiviert <code>autotrim</code> auf ZFS-Pools ausschließlich mit TRIM-fähigen SSDs oder NVMe-Laufwerken. Pools mit rotierenden Laufwerken werden vorsorglich übersprungen. Vorhandenes <code>autotrim=on</code> bleibt unverändert.",
|
||||
"trimTitle": "Was TRIM macht und warum es auf ZFS wichtig ist",
|
||||
"trimBody1": "SSDs und NVMe-Laufwerke arbeiten intern mit Löschblöcken, die größer als die logischen Dateisystemsektoren sind. Nach dem Löschen einer Datei weiß das Laufwerk zunächst nicht, dass die Sektoren frei sind. Seine Speicherbereinigung kopiert daher eventuell unnötige Daten beim Freimachen weiterer Blöcke. <strong>TRIM</strong> meldet dem Laufwerk freie Sektoren, damit es sie vorab löschen kann.",
|
||||
"trimBody2": "Ohne TRIM verschlechtert sich die SSD-Leistung im Laufe der Zeit, da das Laufwerk keine vorgelöschten Blöcke mehr hat und die Lösch-on-Write-Funktion ausführen muss, und die Schreibverstärkung steigt - beides verkürzt die Lebensdauer des Laufwerks. Wenn TRIM aktiviert ist, kann das Laufwerk einen gesunden Pool leerer Blöcke zum Schreiben bereithalten.",
|
||||
"trimBody3": "Mit <code>autotrim=on</code> trimmt ZFS kürzlich freigegebenen Platz im Hintergrund und bündelt Bereiche. Regelmäßiges <code>zpool trim <pool></code> ist eine Alternative. Autotrim spart einen eigenen Zeitplan, belastet Geräte aber unterschiedlich; regelmäßiges manuelles TRIM kann für einfachere Laufwerke besser sein.",
|
||||
"practicalTitle": "Warum kann die Aktivierung nützlich sein?",
|
||||
"practicalItems": [
|
||||
"<strong>Dauerhafte Schreibleistung.</strong> TRIM kann ungenutzte Blöcke effizient freigeben helfen. Nutzen und Latenzauswirkungen hängen von Gerät und Arbeitslast ab.",
|
||||
"<strong>Laufwerkslebensdauer.</strong> Weniger unnötige interne Kopien können Schreibverstärkung und NAND-Verschleiß verringern. Eine bestimmte zusätzliche Lebensdauer ist nicht garantiert.",
|
||||
"<strong>Kein geplanter Cron-Job zum Erinnern.</strong> Im Gegensatz zu einem periodischen <code>zpool trim</code> ist Autotrim Fire-and-Forget - der Pool erledigt es selbstständig."
|
||||
],
|
||||
"whenTitle": "Wann ist das notwendig?",
|
||||
"whenIntro1": "<strong>Erwägen Sie die Aktivierung</strong> auf ZFS-Pools nur mit TRIM-fähigen SSD-/NVMe-Geräten. Prüfen Sie Verhalten und Latenz; geplantes manuelles TRIM kann geeigneter sein.",
|
||||
"whenIntro2": "<strong>Das Skript überspringt es automatisch</strong> auf:",
|
||||
"whenSkipItems": [
|
||||
"Pools mit rotierenden HDD-vdevs — ein vorsichtiger Hardwarefilter dieses Skripts.",
|
||||
"Laufwerke ohne in sysfs sichtbares <code>discard_granularity</code> — meist alte SSDs ohne TRIM oder Passthrough-Pfade, über die das Betriebssystem das zugrunde liegende Gerät nicht sieht.",
|
||||
"Pools, in denen ZFS selbst die Eigenschaft nicht unterstützt meldet (selten; sehr alte Pools).",
|
||||
"Pools bereits auf <code>autotrim=on</code> eingestellt (no-op)."
|
||||
],
|
||||
"whenIntro3": "<strong>Nicht relevant für ext4-nur Hosts</strong> - es gibt nichts für ZFS zu trimmen. Die Funktion wird in diesem Fall mit einer freundlichen Nachricht beendet.",
|
||||
"recordedTitle": "Warum nur von ProxMenux geänderte Pools erfasst werden",
|
||||
"recordedBody": "Die Funktion schreibt einen Pool nur dann in seine interne Zustandsdatei (<code>/usr/local/share/proxmenux/zfs_autotrim_pools</code>), wenn er diesen Pool aktiv von <code>off</code> nach <code>on</code> umgedreht hat. Pools, die Sie vor dem Ausführen des Skripts auf Autotrim hatten, werden aus der Liste ausgeschlossen, so dass eine zukünftige Deinstallation die Einstellungen, die Sie selbst konfiguriert haben, nicht deaktiviert - nur die eigenen Änderungen von ProxMenux werden zurückgesetzt.",
|
||||
"manualTitle": "Manuelles Äquivalent (auf Ihrem Server ausgeführt)",
|
||||
"manualIntro": "Die vollständige Sequenz, die das Skript gegen jeden Pool läuft, ist von Hand replizierbar. Dies ist, was Sie eingeben würden, wenn Sie dasselbe in einem einzelnen Pool ohne ProxMenux tun möchten:",
|
||||
"verifyTitle": "Verifizierung und manuelles Rollback",
|
||||
"oneShotTitle": "Einmaliges TRIM statt Hintergrundaktivität?",
|
||||
"oneShotBody": "Einige Betreiber bevorzugen eine manuelle Trimmung während Off-Peak-Stunden anstelle von kontinuierlichen Trimmaktivitäten. Deaktivieren Sie Autotrim und planen Sie einen Cron-Job, der <code>zpool trim <pool></code> ausführt - gleiches Endziel, unterschiedliche Kadenz."
|
||||
},
|
||||
"vzdump": {
|
||||
"heading": "Erhöhen Sie die Backup-Geschwindigkeit von vzdump",
|
||||
"intro": "Schreibt bwlimit: 0 und ionice: 5 in die globale vzdump-Konfiguration. Proxmox hat bereits standardmäßig kein Bandbreitenlimit; nur ein vorhandenes Limit wird entfernt. Gegenüber ionice: 7 erhöht 5 die Best-Effort-I/O-Priorität, sofern der Scheduler sie beachtet. Das kann Gäste beeinflussen und garantiert keine schnelleren Backups.",
|
||||
"changedTitle": "Was sich in /etc/vzdump.conf ändert",
|
||||
"backupTitle": "Erster Durchlauf erstellt ein .bak von vzdump.conf",
|
||||
"backupBody": "Beim ersten Ausführen kopiert ProxMenux <code>/etc/vzdump.conf</code> vor Änderungen nach <code>/etc/vzdump.conf.bak</code>. Spätere Läufe überschreiben diese Sicherung nicht; frühere manuelle Einstellungen bleiben wiederherstellbar. <code>bwlimit</code> und <code>ionice</code> werden mit <code>sed</code> geändert, andere Optionen wie compress, pigz, tmpdir und exclude-path bleiben erhalten.",
|
||||
"skipTitle": "Wann man das überspringt",
|
||||
"skipBody": "Auf einem Host mit langsamem lokalem Speicher und VMs, die latenzempfindlich sind, kann das Entfernen der Bandbreitenobergrenze zu spürbaren Verlangsamungen bei Backups führen. Wenn Sie aus diesem Grund zuvor einen bestimmten <code>bwlimit</code> festgelegt haben, behalten Sie ihn bei - überspringen Sie diese Option.",
|
||||
"verifyTitle": "Verifizierung und manuelles Rollback"
|
||||
},
|
||||
"related": {
|
||||
"heading": "Verwandte Themen",
|
||||
"items": [
|
||||
{
|
||||
"label": "ZFS Verwaltungsbefehle",
|
||||
"href": "/docs/help-info/zfs-commands",
|
||||
"tail": "— zpool / zfs Referenz für ARC, Snapshots, Scrub."
|
||||
},
|
||||
{
|
||||
"label": "Speicher- und Festplattenbefehle",
|
||||
"href": "/docs/help-info/storage-commands",
|
||||
"tail": "generische Blockgeräte und Proxmox-Speicherreferenz."
|
||||
},
|
||||
{
|
||||
"label": "Backup- und Wiederherstellungsbefehle",
|
||||
"href": "/docs/help-info/backup-commands",
|
||||
"tail": " — vzdump-CLI-Referenz für Bandbreite und I/O-Priorität."
|
||||
},
|
||||
{
|
||||
"label": "Optimierungen deinstallieren",
|
||||
"href": "/docs/post-install/uninstall",
|
||||
"tail": " — Änderungen an ARC / vzdump rückgängig machen."
|
||||
},
|
||||
{
|
||||
"label": "Log2RAM",
|
||||
"href": "/docs/post-install/optional#log2ram",
|
||||
"tail": "- reduziert den Verschleiß von SSD/NVMe durch Ramdisk-Backing /var/log; dokumentiert unter Optional."
|
||||
},
|
||||
{
|
||||
"label": "Anpassbare Nachinstallation",
|
||||
"href": "/docs/post-install/customizable",
|
||||
"tail": " — zurück zum übergeordneten Menü."
|
||||
}
|
||||
]
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,133 @@
|
||||
{
|
||||
"meta": {
|
||||
"title": "Post-Install: System | ProxMenux Dokumentation",
|
||||
"description": "Systemoptimierungen im anpassbaren Nachinstallationsskript von ProxMenux: Größenbegrenzungen für journald und logrotate, höhere Kernel- und Dateideskriptorgrenzen, ausgewogene Speicherabstimmung, schnelle Neustarts mit kexec und Wiederherstellung nach Kernel-Panik."
|
||||
},
|
||||
"header": {
|
||||
"title": "Nach der Installation: System",
|
||||
"section": "Einstellungen nach der Installation von Proxmox"
|
||||
},
|
||||
"intro": {
|
||||
"title": "Was diese Kategorie abdeckt",
|
||||
"body": "Sechs unabhängige Systemoptimierungen. Sie stimmen <strong>journald</strong> und <strong>logrotate</strong> ab, damit Logs nicht die Platte füllen, erhöhen <strong>Kernel- und Dateideskriptorgrenzen</strong> für Anwendungen mit vielen offenen Dateien, sorgen für <strong>ausgewogene Speichernutzung</strong> auf einem Virtualisierungshost, ergänzen <strong>kexec</strong> für Neustarts ohne BIOS und konfigurieren <strong>automatische Wiederherstellung</strong> bei Kernel-Panik. Alle sechs werden erfasst und sind über das Deinstallationsmenü rückgängig zu machen."
|
||||
},
|
||||
"journald": {
|
||||
"heading": "journald optimieren",
|
||||
"intro": "Schreibt <code>/etc/systemd/journald.conf</code> mit sinnvollen Standardwerten neu, damit das systemd-Journal nicht nach und nach die Root-Partition füllt. Startet dann <code>systemd-journald</code> neu und bereinigt vorhandene Protokolle.",
|
||||
"keyTitle": "Schlüsselwerte",
|
||||
"keyItems": [
|
||||
"<code>Storage=persistent</code> — Protokolle auf der Festplatte über Neustarts halten.",
|
||||
"<code>SystemMaxUse=64M</code> / <code>RuntimeMaxUse=60M</code> — Grenzen für die Datenträger- und Speichernutzung des Journals.",
|
||||
"<code>Compress=yes</code>, <code>Seal=no</code> — Logs komprimieren, kryptografische Vorwärtssicherung durch Versiegelung auslassen (spart CPU).",
|
||||
"<code>MaxLevelStore=info</code> — info und höhere Schweregrade speichern. Erforderlich für den Logbetrachter von ProxMenux Monitor und damit Fail2Ban fehlgeschlagene SSH-/Proxmox-Anmeldungen im Journal erkennt.",
|
||||
"Ratenbegrenzung: <code>1000 events / 30 s</code>, um eine Protokollflut zu vermeiden.",
|
||||
"<code>ForwardToSyslog=no</code>, <code>ForwardToWall=no</code> - Duplizieren Sie keine Nachrichten in syslog oder senden Sie sie an Konsolen."
|
||||
],
|
||||
"tipTitle": "Warum MaxLevelStore=info wichtig ist",
|
||||
"tipBody": "Ein strengerer Schweregrad wie <code>warning</code> lässt ProxMenux Monitor in allen Zeiträumen fast dieselben Einträge zeigen, weil die meisten Aktivitäten auf Info-Ebene liegen. Fail2Ban kann dadurch fehlgeschlagene Anmeldungen übersehen. Begrenzen Sie die Menge stattdessen mit <code>SystemMaxUse</code> und <code>RateLimitBurst</code>, ohne die gespeicherten Schweregrade einzuschränken."
|
||||
},
|
||||
"logrotate": {
|
||||
"heading": "Logrotate optimieren",
|
||||
"intro": "Schreibt <code>/etc/logrotate.conf</code> mit globalen Tages- und Größeneinstellungen, 7 aufbewahrten Rotationen, Komprimierung und <code>copytruncate</code> neu, damit Dienste ohne erneutes Öffnen der Logs weiterschreiben. Die spätere Größeneinstellung hat Vorrang vor täglich, sofern keine einzelne Logregel sie überschreibt. Original <code>logrotate.conf</code> wird beim ersten Anwenden nach <code>.bak</code> gesichert.",
|
||||
"tipTitle": "Für Log2RAM geeignet",
|
||||
"tipBody": "Die Anweisung <code>size 10M</code> hat Vorrang vor der vorherigen Tageseinstellung; es gilt <em>nicht</em> das zuerst eintretende Kriterium. Logrotate prüft den Grenzwert beim Ausführen, und einzelne Logregeln können globale Werte überschreiben. Für Log2RAMs RAM-basiertes <code>/var/log</code> sollten Regeln und Timerfrequenz geprüft werden, um die Belegung zu steuern."
|
||||
},
|
||||
"limits": {
|
||||
"heading": "Verschiedene Systemgrenzen erhöhen",
|
||||
"intro": "Erhöht Kernel-, systemd- und PAM-Grenzen, deren Standardwerte für Hosts mit vielen VMs, Containern und Netzwerkdiensten zu niedrig sein können.",
|
||||
"headerFile": "Datei",
|
||||
"headerSets": "Was es setzt",
|
||||
"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> und <code>nproc</code> bis 1,048,576 (unbegrenzt für root)"
|
||||
},
|
||||
{
|
||||
"file": "/etc/systemd/system.conf + user.conf",
|
||||
"sets": "<code>DefaultLimitNOFILE=1048576</code> für systemd-Dienste"
|
||||
},
|
||||
{
|
||||
"file": "/etc/pam.d/common-session + runuser-l",
|
||||
"sets": "<code>session required pam_limits.so</code>, also gelten die oben genannten für Login-Shells"
|
||||
},
|
||||
{
|
||||
"file": "/root/.profile",
|
||||
"sets": "<code>ulimit -n 1048576</code> für die Root-Shell"
|
||||
}
|
||||
],
|
||||
"tipTitle": "Warum inotify wichtig ist",
|
||||
"tipBody": "Docker, Syncthing, Node.js-Dateibeobachter und Plex-Bibliotheksscans können <code>max_user_watches</code> ausschöpfen. Der Standard hängt von Kernel und Host-RAM ab und ist nicht immer 8192. 1M erlaubt mehr Überwachungen, ohne sie vorab anzulegen. Aktive Überwachungen benötigen Kernel-Speicher; prüfen Sie die Nutzung auf speicherknappen Hosts."
|
||||
},
|
||||
"memory": {
|
||||
"heading": "Optimieren der Speichereinstellungen",
|
||||
"intro": "Schreibt ein ausgewogenes sysctl-Profil in <code>/etc/sysctl.d/99-memory.conf</code>. Entwickelt für einen Hypervisor-Host - bevorzugt es, VM-Arbeitssets in RAM zu halten und Seiten proaktiv freizugeben, damit Zuweisungsbursts nicht zum Stillstand kommen.",
|
||||
"warnTitle": "swappiness=10 auf Hosts mit wenig freiem Speicher",
|
||||
"warnBody": "Auf einem Host mit 16 GB RAM, auf dem viele VMs ausgeführt werden, kann die Senkung der Swappiness den Kernel zu OOM-Kill-Prozessen anstelle von Swaping bringen. Wenn Sie routinemäßig OOM-Ereignisse sehen, erhöhen Sie die Swappiness nach dem Ausführen des Skripts in <code>/etc/sysctl.d/99-memory.conf</code> auf 30–60."
|
||||
},
|
||||
"kexec": {
|
||||
"heading": "Schnelle Neustarts ermöglichen (kexec)",
|
||||
"intro": "Installiert <code>kexec-tools</code> und verkabelt es, so dass Sie den Host direkt in einen neuen Kernel <em> neu starten können, ohne die BIOS/UEFI-Firmware </em> zu durchlaufen. Auf großen Servern, auf denen POST 45 bis 90 Sekunden benötigt, verwandelt sich ein Neustart von einer Kaffeepause in einige Sekunden Ausfallzeit.",
|
||||
"installsTitle": "Was ProxMenux installiert",
|
||||
"installsItems": [
|
||||
"Paket <code>kexec-tools</code> (debconf mit <code>kexec-tools/load_kexec boolean false</code> vorbeantwortet, damit apt nicht nachfragt und automatisches Laden beim Herunterfahren deaktiviert bleibt).",
|
||||
"Systemd-Einheit <code>/etc/systemd/system/kexec-pve.service</code> lädt den Proxmox-Kernel und initrd beim Booten in den Speicher, wobei die aktuelle cmdline wiederverwendet wird.",
|
||||
"Ein Aliasname in <code>/root/.bash_profile</code>: <code>reboot-quick</code> → <code>systemctl kexec</code>."
|
||||
],
|
||||
"usageIntro": "Nutzung nach dem nächsten Reboot (oder manuell <code>systemctl start kexec-pve</code>):",
|
||||
"warnTitle": "Wann man Kexec nicht benutzt",
|
||||
"warnBody": "kexec überspringt Firmware-Level Init. Wenn Sie sich auf BIOS/UEFI verlassen, um den Hardwarezustand zurückzusetzen - beispielsweise einen GPU, der Passthrough durchführt, der nur bei voller POST sauber zurückgesetzt wird, oder eine lästige HBA-Firmware - können Kexec-Neustarts diese Geräte in einem halbinitialisierten Zustand belassen. Verwenden Sie einen normalen <code>reboot</code> nach Kernel-Upgrades oder wenn Sie BIOS/UEFI Änderungen benötigen, um wirksam zu werden. <code>reboot-quick</code> ist für alltägliche Neustarts gedacht."
|
||||
},
|
||||
"panic": {
|
||||
"heading": "Neustart bei Kernel-Panic aktivieren",
|
||||
"intro": "Lässt den Kernel <strong>automatisch neu starten</strong>, statt dauerhaft am Panikbildschirm zu hängen. Besonders wichtig für entfernte Proxmox-Hosts ohne lokale Konsole: Bei blockiertem Kernel bleiben alle VMs aus, bis Sie den Host aus- und wieder einschalten können.",
|
||||
"tipTitle": "Verbinden Sie dies mit Remote-Konsolenzugriff",
|
||||
"tipBody": "Der automatische Neustart dient der Wiederherstellung, nicht der Fehlersuche. Um eine Panik zu <em>untersuchen</em>, statt nur neu zu starten, nutzen Sie <link>die kexec-Option</link> oben zusammen mit Kernel-kdump-Unterstützung, die ProxMenux nicht einrichtet. Alternativ zeichnen Sie vor Aktivierung eine serielle Konsole auf einem anderen Host auf."
|
||||
},
|
||||
"verify": {
|
||||
"heading": "Verifizierung",
|
||||
"intro": "Nach Anwendung der Systemoptimierungen:",
|
||||
"tipTitle": "Wiederherstellung und Grenzen",
|
||||
"tipBody": "Alle sechs Optionen werden in <code>installed_tools.json</code> erfasst und unter <link>Optimierungen deinstallieren</link> angeboten. Die Wiederherstellung entfernt die Konfigurationsdateien sowie kexec-Unit und Alias, schreibt journald.conf mit den systemd-Standardwerten neu und stellt logrotate.conf aus der Sicherung wieder her. Manche aktiven Grenzen brauchen eine neue Sitzung oder einen Neustart."
|
||||
},
|
||||
"related": {
|
||||
"heading": "Verwandte Themen",
|
||||
"items": [
|
||||
{
|
||||
"label": "Nützliche Systembefehle",
|
||||
"href": "/docs/help-info/system-commands",
|
||||
"tail": "— die Änderungen überprüfen (free -h, journalctl, ulimit -a)."
|
||||
},
|
||||
{
|
||||
"label": "Leistung",
|
||||
"href": "/docs/post-install/performance",
|
||||
"tail": " — zusätzliche Systemabstimmung (pigz)."
|
||||
},
|
||||
{
|
||||
"label": "Optimierungen deinstallieren",
|
||||
"href": "/docs/post-install/uninstall",
|
||||
"tail": " — diese Änderungen rückgängig machen."
|
||||
},
|
||||
{
|
||||
"label": "Anpassbare Nachinstallation",
|
||||
"href": "/docs/post-install/customizable",
|
||||
"tail": " — zurück zum übergeordneten Menü."
|
||||
}
|
||||
]
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,271 @@
|
||||
{
|
||||
"meta": {
|
||||
"title": "Optimierungen deinstallieren | ProxMenux Dokumentation",
|
||||
"description": "Macht reversible Nachinstallationsänderungen von ProxMenux rückgängig. Registrierte Werkzeuge haben eigene Deinstallationsfunktionen, die den vorherigen Hostzustand nach Möglichkeit erhalten."
|
||||
},
|
||||
"header": {
|
||||
"title": "Optimierungen deinstallieren",
|
||||
"description": "Stellen Sie reversible Änderungen wieder her, die durch die automatisierten oder anpassbaren Skripte nach der Installation vorgenommen wurden. ProxMenux registriert jede unterstützte Optimierung mit ihrer dedizierten Wiederherstellungsfunktion; Paket-Upgrades sind absichtlich ausgeschlossen.",
|
||||
"section": "Einstellungen nach der Installation von Proxmox"
|
||||
},
|
||||
"intro": {
|
||||
"title": "Warum es das gibt",
|
||||
"body": "Jede unterstützte rückgängig zu machende Änderung wird <strong>erfasst</strong> in <code>/usr/local/share/proxmenux/installed_tools.json</code>. Dieses Verzeichnis steuert die Deinstallation: Es zeigt aktive Optimierungen und ruft deren Wiederherstellungsfunktion auf. Aktionen ohne sicheres Zurücksetzen, etwa vollständige Paket-Upgrades, werden nicht aufgenommen."
|
||||
},
|
||||
"openMenu": {
|
||||
"heading": "Wie man es öffnet",
|
||||
"body": "Öffnen Sie im Hauptmenü <strong>Proxmox-Nachinstallationseinstellungen → Optimierungen deinstallieren</strong>. Die Liste zeigt <em>aktuell angewendete</em> Optimierungen; nicht angewendete Einträge fehlen.",
|
||||
"imageAlt": "Auswahlliste „Optimierungen deinstallieren“ mit aktiven Änderungen und Kontrollkästchen zum Zurücksetzen"
|
||||
},
|
||||
"howWorks": {
|
||||
"heading": "Wie die Umkehrung funktioniert",
|
||||
"steps": [
|
||||
{
|
||||
"title": "Gespeicherte Einträge und automatische Erkennung",
|
||||
"body1": "Beim ersten Lauf sucht ProxMenux nach Erkennungsmerkmalen auf dem Host, etwa <code>/etc/sysctl.d/99-memory.conf</code>, <code>/etc/apt/apt.conf.d/99-force-ipv4</code>, installiertem <code>haveged</code> oder aktivem Log2RAM-Dienst. Erkannte Änderungen werden als rückgängig zu machen erfasst, auch wenn eine ältere ProxMenux-Version ohne Register sie vorgenommen hat.",
|
||||
"body2": "Diese Migration wird nur einmal ausgeführt. Anschließend aktualisiert jeder Anwenden- oder Rückgängig-Vorgang den gespeicherten Eintrag direkt."
|
||||
},
|
||||
{
|
||||
"title": "Änderungen zum Zurücksetzen auswählen",
|
||||
"body1": "Die Checkliste zeigt pro Artikel ein menschenlesbares Label (z.B. <em>Speichereinstellungen Optimierung</em>, <em>IOMMU/VFIO PCI-Durchgang</em>, <em>Log2RAM (SSD-Schutz)</em>). Klicken Sie auf die, die Sie umkehren möchten. Nichts, was Sie nicht ankreuzen, wird berührt."
|
||||
},
|
||||
{
|
||||
"title": "Rückgängigmachen wird ausgeführt",
|
||||
"body1": "Für jedes ausgewählte Element ruft ProxMenux seine passende Deinstallationsfunktion auf. Die meisten Umkehrungen folgen einem von drei Mustern:",
|
||||
"items": [
|
||||
"<strong>Backup-basierte </strong> — Wiederherstellung eines <code>.bak</code>, das zum Zeitpunkt der Anwendung erfasst wurde (bashrc, logrotate.conf, journald.conf, GRUB/kernel cmdline).",
|
||||
"<strong>Konfiguration löschen</strong> — ProxMenux-Dateien <code>/etc/sysctl.d/99-*.conf</code>, <code>/etc/apt/apt.conf.d/99-*</code> oder die systemd-Unit entfernen und neu laden.",
|
||||
"<strong>Pakete neu installieren</strong> — bei UI-Änderungen wie dem Abonnementhinweis die Originalpakete mit <code>--force-confnew</code> neu installieren, um ausgelieferte Einstellungen wiederherzustellen."
|
||||
],
|
||||
"body2": "Jede Umkehrung protokolliert ihren Fortschritt. Elemente, die einen Neustart erfordern (VFIO, persistente Schnittstellennamen), setzen ein Flag, das die Neustartaufforderung am Ende auslöst."
|
||||
},
|
||||
{
|
||||
"title": "Neustartabfrage am Ende",
|
||||
"body1": "Nachdem die Umkehrung beendet ist, zeigt das Menü eine Neustartaufforderung an. Elemente, die Kernelparameter, Kernelmodule oder Netzwerknamen (VFIO, persistente Schnittstellennamen) geändert haben, benötigen den Neustart, um wirksam zu werden; andere Elemente nicht, und die Eingabeaufforderung ist ein Sicherheitsstandard und keine Per-Item-Überprüfung."
|
||||
}
|
||||
]
|
||||
},
|
||||
"reversible": {
|
||||
"heading": "Was reversibel ist",
|
||||
"intro": "Registrierte reversible Optimierungen und deren passende Deinstallateure werden hier nach Bereichen gruppiert:",
|
||||
"groups": [
|
||||
{
|
||||
"title": "Repositories und APT",
|
||||
"items": [
|
||||
{
|
||||
"tool": "Abonnementbanner entfernen",
|
||||
"restores": "Zunächst wird versucht, die UI-Dateien aus ProxMenux-eigenen Backups wiederherzustellen (/usr/local/share/proxmenux/backups/proxmoxlib.js.backup.* und, wenn die mobile UI gepatcht wird, index.html.tpl.backup.*). Nur wenn ein Backup fehlt oder beschädigt ist, greift man auf die Neuinstallation von pve-manager, proxmox-widget-toolkit, libjs-extjs und libpve-http-server-perl mit force-confnew zurück. Löscht auch zwischengespeicherte .js / .gz-Kopien."
|
||||
},
|
||||
{
|
||||
"tool": "APT-Sprachdateien überspringen",
|
||||
"restores": "Entfernt /etc/apt/apt.conf.d/99-disable-translations, damit APT übersetzte Paketbeschreibungsindizes gemäß den übrigen Spracheinstellungen herunterladen kann."
|
||||
},
|
||||
{
|
||||
"tool": "IPv4 für APT erzwingen",
|
||||
"restores": "Entfernen von /etc/apt/apt.conf.d/99-force-ipv4."
|
||||
},
|
||||
{
|
||||
"tool": "Systemwerkzeuge",
|
||||
"restores": "Entfernt nur ausgewählte Werkzeugpakete vollständig, die ProxMenux als neu installiert erfasst hat. Zuvor vorhandene Pakete werden nie in diese Liste aufgenommen und bleiben unverändert."
|
||||
}
|
||||
]
|
||||
},
|
||||
{
|
||||
"title": "Kernel, Speicher und Systemgrenzen",
|
||||
"items": [
|
||||
{
|
||||
"tool": "Speichereinstellungen",
|
||||
"restores": "Entfernt /etc/sysctl.d/99-memory.conf und lädt sysctl neu."
|
||||
},
|
||||
{
|
||||
"tool": "Kernel Panic Konfiguration",
|
||||
"restores": "Entfernen von /etc/sysctl.d/99-kernelpanic.conf."
|
||||
},
|
||||
{
|
||||
"tool": "Systemgrenzen erhöhen",
|
||||
"restores": "Entfernt /etc/sysctl.d/99-maxwatches.conf, 99-maxkeys.conf, 99-swap.conf, 99-fs.conf und /etc/security/limits.d/99-limits.conf. Setzt PAM-Grenzen und systemd DefaultLimitNOFILE zurück. In /root/.profile entfernt es nur die alte Zeile ulimit -n 256000; ulimit -n 1048576 des aktuellen Installers kann bleiben und manuelle Entfernung erfordern."
|
||||
},
|
||||
{
|
||||
"tool": "ZRAM-Swapprofil",
|
||||
"restores": "Deaktiviert den Swap auf /dev/zram0, stoppt dev-zram0.swap und entfernt /etc/systemd/zram-generator.conf.d/90-proxmenux.conf. Das systemd-zram-generator-Paket wird nur gelöscht, wenn ProxMenux es installiert hat und kein anderes ZRAM-Setup vorhanden ist. Wenn die Seiten in ZRAM nicht verschoben werden können, bleibt das Profil aktiv und es wird nichts entfernt."
|
||||
}
|
||||
]
|
||||
},
|
||||
{
|
||||
"title": "Vernetzung",
|
||||
"items": [
|
||||
{
|
||||
"tool": "Netzwerkoptimierungen",
|
||||
"restores": "Entfernt /etc/sysctl.d/99-network.conf, 97-proxmenux-fwbr.conf und 98-proxmenux-rpf.conf sowie proxmenux-fwbr-tune.service, das Hilfsskript /usr/local/sbin/proxmenux-fwbr-tune und die udev-Regel /etc/udev/rules.d/99-zz-proxmenux-fwbr-tune.rules. Entfernt außerdem source /etc/network/interfaces.d/* aus /etc/network/interfaces. Lädt sysctl, systemd und udev-Regeln neu."
|
||||
},
|
||||
{
|
||||
"tool": "Open vSwitch",
|
||||
"restores": "Führt apt purge für openvswitch-switch und openvswitch-common aus. Migrieren Sie OVS-Bridges vorher zu Linux-Bridges, sonst verlieren die VMs darauf beim nächsten Start die Netzwerkanbindung."
|
||||
},
|
||||
{
|
||||
"tool": "TCP BBR + TCP Fast Open",
|
||||
"restores": "Entfernt /etc/sysctl.d/99-kernel-bbr.conf und 99-tcp-fastopen.conf und lädt übrige sysctl-Konfiguration neu. Das Löschen setzt aktive Werte nicht zurück; Standards wie cubic und tcp_fastopen=1 gelten nach Neustart, sofern keine andere Konfiguration sie überschreibt."
|
||||
},
|
||||
{
|
||||
"tool": "Persistente Schnittstellennamen",
|
||||
"restores": "Entfernt nur die 10-proxmenux-*.link-Dateien mit dem ProxMenux-Header aus /etc/systemd/network/. Jede .link-Datei, die von einem anderen Paket bereitgestellt oder vom Benutzer geschrieben wurde, bleibt an Ort und Stelle. Schnittstellennamen kehren beim nächsten Neustart zum Standardverhalten von systemd zurück."
|
||||
}
|
||||
]
|
||||
},
|
||||
{
|
||||
"title": "Protokollierung",
|
||||
"items": [
|
||||
{
|
||||
"tool": "journald-Optimierung",
|
||||
"restores": "Schreibt /etc/systemd/journald.conf mit ursprünglichen Standardwerten neu und startet systemd-journald neu."
|
||||
},
|
||||
{
|
||||
"tool": "Logrotate-Optimierung",
|
||||
"restores": "Stellt /etc/logrotate.conf aus der vor der Änderung erstellten .bak-Datei wieder her."
|
||||
},
|
||||
{
|
||||
"tool": "Log2RAM",
|
||||
"restores": "Stoppt und deaktiviert Dienst und Timer. Entfernt Cron-Jobs, systemd-Units, Programmdateien, Konfiguration und /var/log.hdd. Entfernt auch das apt-Paket, falls darüber installiert."
|
||||
},
|
||||
{
|
||||
"tool": "Automatisches ZFS-TRIM",
|
||||
"restores": "Liest /usr/local/share/proxmenux/zfs_autotrim_pools mit den tatsächlich geänderten Pools und führt jeweils zpool set autotrim=off aus. Bereits vor ProxMenux manuell aktivierter Autotrim bleibt bestehen."
|
||||
}
|
||||
]
|
||||
},
|
||||
{
|
||||
"title": "Shell und Erscheinungsbild",
|
||||
"items": [
|
||||
{
|
||||
"tool": "Bashrc anpassen",
|
||||
"restores": "Wiederherstellt /root/.bashrc aus dem .bak-Backup. Wenn kein Backup vorhanden ist, wird der PMX_CORE_BASHRC-Block durch Markierungen entfernt."
|
||||
},
|
||||
{
|
||||
"tool": "Eigenes MOTD-Banner",
|
||||
"restores": "Stellen Sie den genauen ursprünglichen /etc/motd-Inhalt, der unter /usr/local/share/proxmenux gespeichert ist, wieder her, entfernen Sie die Datei, wenn sie vorher nicht vorhanden war, oder entfernen Sie den alten Marker sicher, wenn Sie eine ältere Installation migrieren."
|
||||
},
|
||||
{
|
||||
"tool": "Fastfetch",
|
||||
"restores": "Entfernt Programmdatei, Konfigurationsverzeichnis, update-motd-Hook und den abgegrenzten Block BEGIN FASTFETCH / END FASTFETCH aus /root/.bashrc, ~/.profile, /etc/profile und /etc/profile.d/fastfetch.sh. Entfernt ein installiertes apt-Paket vollständig."
|
||||
},
|
||||
{
|
||||
"tool": "Figurine",
|
||||
"restores": "Entfernt den Binär-, profile.d-Eintrag und den Alias-Block in bashrc/profile."
|
||||
}
|
||||
]
|
||||
},
|
||||
{
|
||||
"title": "Hardware & Virtualisierung",
|
||||
"items": [
|
||||
{
|
||||
"tool": "IOMMU / VFIO",
|
||||
"restores": "Entfernt vfio Module aus /etc/modules, die Nouveau / Radeon / nvidia Blacklist Einträge und intel_iommu=on / amd_iommu=on / iommu=pt / pcie_acs_override Parameter aus /etc/kernel/cmdline (ZFS) oder GRUB. Baut Initramfs wieder auf."
|
||||
},
|
||||
{
|
||||
"tool": "AMD-CPU-Korrekturen (Ryzen/EPYC)",
|
||||
"restores": "Entfernt idle=nomwait aus Kernel cmdline (ZFS) oder GRUB und die ignore_msrs / report_ignored_msrs Optionen aus /etc/modprobe.d/kvm.conf."
|
||||
},
|
||||
{
|
||||
"tool": "Gast-Agent für einen virtualisierten Proxmox-Host",
|
||||
"restores": "Liest /usr/local/share/proxmenux/guest_agent.pkg und entfernt das erfasste Hostpaket vollständig. Der Installer wählt qemu-guest-agent, open-vm-tools oder virtualbox-guest-utils nach Hypervisor. Ohne Eintrag versucht die Deinstallation diese drei Pakete. Betroffen ist der verschachtelte Proxmox-Host, nicht Gastvorlagen."
|
||||
}
|
||||
]
|
||||
},
|
||||
{
|
||||
"title": "Speicher",
|
||||
"items": [
|
||||
{
|
||||
"tool": "ZFS-ARC-Größe anpassen",
|
||||
"restores": "Entfernt /etc/modprobe.d/99-zfsarc.conf, stellt gesicherte widersprüchliche externe *.conf aus /usr/local/share/proxmenux/backups/zfs_arc/ wieder her, baut initramfs neu und führt proxmox-boot-tool refresh auf systemd-boot-Hosts aus."
|
||||
},
|
||||
{
|
||||
"tool": "Automatische ZFS-Snapshots",
|
||||
"restores": "Entfernt die Cron-Einträge, die das Skript geschrieben hat, und bietet an, zfs-auto-snapshot zu bereinigen. Bestehende Snapshot-Datensätze in den Pools bleiben intakt - entfernen Sie sie separat, wenn Sie sie weghaben möchten."
|
||||
},
|
||||
{
|
||||
"tool": "vzdump-Geschwindigkeitsbegrenzung",
|
||||
"restores": "Stellt /etc/vzdump.conf aus der Installationssicherung .bak wieder her und setzt bwlimit und ionice auf die Werte vor ProxMenux zurück."
|
||||
}
|
||||
]
|
||||
},
|
||||
{
|
||||
"title": "Dienstleistungen & Extras",
|
||||
"items": [
|
||||
{
|
||||
"tool": "Zeitsynchronisation",
|
||||
"restores": "Setzt die Zeitzone mit timedatectl auf UTC als sicheren Standard zurück."
|
||||
},
|
||||
{
|
||||
"tool": "Entropieerzeugung (haveged)",
|
||||
"restores": "Stoppt und deaktiviert haveged und entfernt das Paket vollständig."
|
||||
},
|
||||
{
|
||||
"tool": "kexec (schnelle Neustarts)",
|
||||
"restores": "Deaktiviert kexec-pve.service, entfernt die Unit-Datei und den Alias reboot-quick aus /root/.bash_profile und entfernt kexec-tools vollständig."
|
||||
},
|
||||
{
|
||||
"tool": "RPC / rpcbind deaktiviert",
|
||||
"restores": "Stellt rpcbind.service und rpcbind.socket jeweils auf den zuvor erfassten Aktivierungs- und Laufzustand zurück: aktiviert/deaktiviert und aktiv/inaktiv."
|
||||
},
|
||||
{
|
||||
"tool": "pigz (paralleles gzip)",
|
||||
"restores": "Kopiert den echten gzip von gzip.distrib zurück, entfernt die dpkg-Umleitung und /bin/pigzwrapper, kommentiert die pigz-Linie in /etc/vzdump.conf und löscht pigz, sobald gzip verifiziert ist."
|
||||
},
|
||||
{
|
||||
"tool": "Dienste mit hoher Verfügbarkeit",
|
||||
"restores": "Stoppt und deaktiviert pve-ha-lrm, pve-ha-crm und corosync. Bestehende HA-Gruppen und Ressourcendefinitionen werden nicht gelöscht – entfernen Sie sie aus der Web-Benutzeroberfläche, wenn Sie sie nicht mehr benötigen."
|
||||
},
|
||||
{
|
||||
"tool": "Ceph-Repository",
|
||||
"restores": "Bereinigt die mit dieser Option installierten Ceph-Pakete, entfernt die deb822 /etc/apt/sources.list.d/ceph.sources auf PVE 9 (oder die alte Ceph-Liste auf PVE 8) und aktualisiert den APT-Cache."
|
||||
},
|
||||
{
|
||||
"tool": "OVH RTM (Überwachung)",
|
||||
"restores": "Entfernt Pakete passend zu ovh-rtm*, rtm und rtm-*, löscht /etc/rtm und entfernt den RTM-Registereintrag. Puppet-Reste unter /etc/puppet/ müssen eventuell manuell geprüft und bereinigt werden; das Verzeichnis wird nicht gelöscht. Auf Nicht-OVH-Hosts nimmt der Installer normalerweise keine Änderungen vor."
|
||||
}
|
||||
]
|
||||
}
|
||||
]
|
||||
},
|
||||
"edge": {
|
||||
"heading": "Sonderfälle und Einschränkungen",
|
||||
"packageTitle": "Neuinstallation betrifft laufende Proxmox-Pakete",
|
||||
"packageBody": "Können ProxMenux-Sicherungen <strong>Abonnementhinweis entfernen</strong> nicht zurücksetzen, installiert der Rückfallweg <code>pve-manager</code>, <code>proxmox-widget-toolkit</code>, <code>libjs-extjs</code> und <code>libpve-http-server-perl</code> mit <code>--force-confnew</code> neu. Das betrifft die laufende Weboberfläche: Browser neu laden und einige Sekunden zum Wiederverbinden abwarten. Nicht während Migrationen oder Klonvorgängen ausführen.",
|
||||
"rebootTitle": "Persistente Namen und VFIO benötigen einen Neustart",
|
||||
"rebootBody": "Das Entfernen der <code>10-proxmenux-*.link</code>-Dateien (<em>Persistente Schnittstellennamen</em>) und Zurücksetzen von <em>IOMMU/VFIO</em> ändern den bereits gestarteten Zustand nicht; sie werden nach Neustart wirksam. ProxMenux setzt dafür automatisch das Neustart-Flag.",
|
||||
"perItemTitle": "Sie können eine Sache rückgängig machen und den Rest behalten",
|
||||
"perItemBody": "Der Deinstaller arbeitet per Item. Wenn Sie nur Log2RAM entfernen möchten, aber die Netzwerk-Tuning- und Bashrc-Änderungen beibehalten möchten, kreuzen Sie nur <em>Log2RAM</em> an. Nichts anderes wird berührt und die Registry wird entsprechend aktualisiert."
|
||||
},
|
||||
"inspect": {
|
||||
"heading": "Kontrolle des Registers manuell",
|
||||
"intro": "Wenn Sie sehen möchten, was verfolgt wird, ohne das Menü zu öffnen:",
|
||||
"outro": "Jeder <code>\"tool\": true</code>-Eintrag entspricht etwas ProxMenux angewendet und kann umgekehrt werden. Das manuelle Entfernen eines Eintrags wird nicht empfohlen - verwenden Sie immer das Menü, das auch die Umkehrfunktion ausführt, anstatt nur die Änderung zu vergessen.",
|
||||
"reinstallTitle": "Neuinstallieren nach Deinstallieren",
|
||||
"reinstallBody": "Eine zurückgesetzte Optimierung kann später erneut angewendet werden. Öffnen Sie <link>das Nachinstallationsmenü</link> und starten Sie Automatisiert oder Anpassbar; das Register erfasst den neuen Zustand."
|
||||
},
|
||||
"related": {
|
||||
"heading": "Verwandte Themen",
|
||||
"items": [
|
||||
{
|
||||
"label": "Automatisiertes Post-Install",
|
||||
"href": "/docs/post-install/automated",
|
||||
"tail": " — die sinnvolle Grundkonfiguration erneut anwenden."
|
||||
},
|
||||
{
|
||||
"label": "Anpassbare Nachinstallation",
|
||||
"href": "/docs/post-install/customizable",
|
||||
"tail": " — eine andere Auswahl treffen."
|
||||
},
|
||||
{
|
||||
"label": "Deinstallieren Sie ProxMenux",
|
||||
"href": "/docs/settings/uninstall-proxmenux",
|
||||
"tail": "- andere Operation: entfernt ProxMenux selbst, nicht seine angewandten Optimierungen."
|
||||
},
|
||||
{
|
||||
"label": "Übersicht Post-Install",
|
||||
"href": "/docs/post-install",
|
||||
"tail": "."
|
||||
}
|
||||
]
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,112 @@
|
||||
{
|
||||
"meta": {
|
||||
"title": "Verfügbare Updates anwenden — Optimierungen nach der Installation | ProxMenux Dokumentation",
|
||||
"description": "Wie ProxMenux neue Versionen von Nachinstallationsoptimierungen wie Log2Ram, Speichereinstellungen, Systemlimits, Logrotate und Netzwerkanpassungen erkennt und wie Sie sie im Nachinstallationsmenü oder Monitor-Dashboard anwenden."
|
||||
},
|
||||
"header": {
|
||||
"title": "Verfügbare Updates anwenden",
|
||||
"description": "Liegt eine Nachinstallationsoptimierung (Log2Ram, Speichereinstellungen, Systemlimits, Logrotate …) auf dem Datenträger in einer neueren Version vor als der auf dem Host erfassten, zeigt ProxMenux ein verfügbares Update an. Sie können es im Nachinstallationsmenü der Skriptoberfläche oder im Monitor-Dashboard anwenden. Beide Wege führen dieselbe Nachinstallationsfunktion erneut aus und aktualisieren den gespeicherten Versionsstand.",
|
||||
"section": "Einstellungen nach der Installation von Proxmox"
|
||||
},
|
||||
"intro": {
|
||||
"title": "Was das ist",
|
||||
"body": "ProxMenux-Nachinstallationsoptimierungen haben Versionsnummern, etwa <code>Log2ram SSD Protection v1.2</code>. Der Host erfasst aktive Optimierungen und ihre Versionen in <code>/usr/local/share/proxmenux/installed_tools.json</code>. Liefert eine neue ProxMenux-Version eine aktualisierte Optimierung, erkennt ProxMenux den Unterschied und bietet an, nur diese erneut anzuwenden, ohne die gesamte Nachinstallation zu wiederholen."
|
||||
},
|
||||
"why": {
|
||||
"heading": "Warum es das gibt",
|
||||
"body": "Nachinstallationsoptimierungen erhalten Verbesserungen wie bessere sysctl-Einstellungen, strengere Logrotate-Limits, neue Log2RAM-Größenregeln oder Fehlerkorrekturen. Ohne Updateweg mussten Sie den ganzen Skriptlauf mit <em>allen</em> Optimierungen wiederholen oder auf die Verbesserung verzichten. Verfügbare Updates anwenden erlaubt die ausdrückliche Auswahl einzelner Optimierungen, deren Version sich geändert hat."
|
||||
},
|
||||
"detection": {
|
||||
"heading": "Wie Updates erkannt werden",
|
||||
"steps": [
|
||||
{
|
||||
"title": "Versionierte Skripte auf Disk",
|
||||
"body": "Jede Funktion nach der Installation deklariert ihre Version innerhalb des Skripts (<code>scripts/post_install/auto_post_install.sh</code> und <code>scripts/post_install/customizable_post_install.sh</code>). Ein Scanner extrahiert diese Versionen aus der Quelle auf der Festplatte."
|
||||
},
|
||||
{
|
||||
"title": "Versioniertes Register auf dem Host",
|
||||
"body": "Wenn der Operator jede Optimierung anwendete, schrieb der entsprechende <code>register_tool</code>-Aufruf die aktive Version in <code>/usr/local/share/proxmenux/installed_tools.json</code>. Diese Datei ist die Quelle der Wahrheit für \"was auf diesem Host gerade aktiv ist\"."
|
||||
},
|
||||
{
|
||||
"title": "Monitor vergleicht beide Seiten",
|
||||
"body": "Beim Start und alle 24 Stunden vergleicht der Monitor Festplattenversionen mit Registrierungsversionen. Jede Inkongruenz führt zu einem Eintrag in <code>/usr/local/share/proxmenux/updates_available.json</code>. Diese Datei steuert sowohl den Post-Install-Menüeintrag als auch die Monitor-Dashboardkarte."
|
||||
},
|
||||
{
|
||||
"title": "Eine Benachrichtigung pro neuer Version",
|
||||
"body": "Wenn mindestens eine Optimierung ein ausstehendes Update hat, sendet der Monitor eine einzelne gruppierte Benachrichtigung aus - zum Beispiel <em>\"4 ProxMenux Optimierungsupdate(s) verfügbar\"</em> - mit einer Zeile pro Tool im selben <code>name (vX → vY)</code>-Format, das für Proxmox-Paketupdates verwendet wird. Die Benachrichtigung ist Anti-Kaskade, so dass sie sich nicht Tag für Tag für denselben Satz wiederholt; nur eine neue Version (oder ein neues Tool, das in die Liste eintritt) löst sie erneut aus."
|
||||
}
|
||||
]
|
||||
},
|
||||
"pathA": {
|
||||
"heading": "Pfad A — Aus dem Menü nach der Installation",
|
||||
"intro": "Öffnen Sie im ProxMenux-Hauptmenü <strong>Einstellungen nach der Installation von Proxmox</strong>. Bei ausstehenden Updates erscheint <strong>Verfügbare Updates anwenden (N)</strong> direkt über <em>Optimierungen deinstallieren</em>. Die Zahl zeigt die Optimierungen mit neuerer Version auf dem Datenträger als im Register. Ist alles aktuell, bleibt der Eintrag verborgen.",
|
||||
"menuAlt": "Das Menü Post-Install Scripts zeigt den bedingte Eintrag \"Verfügbare Updates anwenden (N)\" direkt über \"Optimierungen deinstallieren\" an, wobei das Zählabzeichen anzeigt, wie viele Optimierungen eine neuere Version auf der Festplatte haben",
|
||||
"menuCaption": "<em>Verfügbare Updates anwenden (N)</em> erscheint nur, wenn mindestens eine Optimierung ein Update hat, und wird bei aktuellem Host ausgeblendet.",
|
||||
"checklistBody": "Öffnet eine Auswahlliste aller ausstehenden Updates, jeweils im Format <code>name (vX → vY)</code>. Alle Zeilen sind standardmäßig ausgewählt; wählen Sie die ab, die Sie diesmal nicht anwenden möchten.",
|
||||
"checklistAlt": "Auswahldialog Verfügbare Updates anwenden mit einer Zeile pro Optimierung, ihrem Namen und Versionswechsel (aktuell → verfügbar). Alle Zeilen sind ausgewählt.",
|
||||
"checklistCaption": "Jede Optimierung einzeln wählen: Entscheiden Sie, welche Versionen aktualisiert werden. Dieselbe Grundlage wie Automatisch und Anpassbar wendet die Funktionen im Hintergrund erneut an und aktualisiert ihre Registerversionen."
|
||||
},
|
||||
"pathB": {
|
||||
"heading": "Pfad B — Vom Monitor-Dashboard",
|
||||
"intro": "Dieselben Updates erscheinen unter <link>Einstellungen → ProxMenux-Optimierungen</link> im Monitor. Bei ausstehenden Updates zeigt die Karte ein <strong>Update-Zählabzeichen</strong>, das die Auswahl einzelner Optimierungen öffnet. Jedes Werkzeug bietet auch eine eigene Updateaktion.",
|
||||
"imageAlt": "Karte ProxMenux-Optimierungen in den Monitor-Einstellungen mit Zählabzeichen für ausstehende Updates zum Öffnen der Auswahl und Updateaktionen pro Werkzeug",
|
||||
"imageCaption": "Die Optimierungskarte im Monitor bietet über ihr Zählabzeichen Zugriff auf Updates, sobald eine neuere Version auf dem Datenträger liegt, ohne Shell-Zugriff."
|
||||
},
|
||||
"applying": {
|
||||
"heading": "Was beim Anwenden passiert",
|
||||
"steps": [
|
||||
{
|
||||
"title": "Führt die Post-Installation-Funktion erneut aus",
|
||||
"body": "Die Funktion der ausgewählten Optimierung wird gegen den Host erneut ausgeführt. Da jede Funktion nach der Installation <strong>idempotent</strong> ist, wird die Konfiguration nicht dupliziert - sie überschreibt die vorherige Version mit der neuen (Sysctl-Dateien, Drop-Ins, Serviceeinheiten usw.)."
|
||||
},
|
||||
{
|
||||
"title": "Aktualisieren des Registers",
|
||||
"body": "Der <code>register_tool</code>-Aufruf innerhalb der Funktion schreibt die neue Version in <code>installed_tools.json</code>. Beim nächsten Scan wird keine Diskrepanz mehr festgestellt und der Updateeintrag verschwindet sowohl aus dem Menü als auch aus der Monitorkarte."
|
||||
},
|
||||
{
|
||||
"title": "Kein Neustart, es sei denn, die Funktion sagt es",
|
||||
"body": "Die meisten Updates werden sofort wirksam. Updates, die Kernelmodule, persistente Schnittstellennamen oder VFIO berühren, zeigen die gleiche Neustartaufforderung wie eine Neuinstallation."
|
||||
},
|
||||
{
|
||||
"title": "Registrieraktualisierung an den Monitor gesendet",
|
||||
"body": "Nach dem Durchlauf sendet das Menü eine POST-Anfrage an <code>http://127.0.0.1:8008/api/updates/post-install/scan</code>, um <code>/usr/local/share/proxmenux/updates_available.json</code> neu zu erstellen. Nach Anwendung aller Updates verschwinden das Update-Zählabzeichen und der bedingte Shell-Menüeintrag ohne Warten auf den nächsten Scan. Die Optimierungskarte bleibt verfügbar."
|
||||
}
|
||||
],
|
||||
"jqTitle": "jq ist erforderlich",
|
||||
"jqBody": "Die Path-A-Checkliste basiert auf <code>jq</code>, um die ausstehenden Updates JSON zu analysieren. Wenn <code>jq</code> fehlt, verlässt der Fluss lautlos - Sie würden den Menüeintrag mit einer Zählung sehen, aber nach dem Auswählen von Zeilen würde nichts passieren. Auf jeder modernen Proxmox-Installation ist <code>jq</code> vorhanden; im Zweifelsfall führen Sie <code>apt install -y jq</code> aus."
|
||||
},
|
||||
"differs": {
|
||||
"heading": "Wie es sich von den anderen Pfaden unterscheidet",
|
||||
"headerPath": "Path",
|
||||
"headerScope": "Umfang",
|
||||
"headerWhen": "Wenn es Sinn macht",
|
||||
"rows": [
|
||||
{
|
||||
"pathLabel": "Automatisch",
|
||||
"pathHref": "/docs/post-install/automated",
|
||||
"scope": "Wendet <em>jede</em> Optimierung des Pakets erneut an.",
|
||||
"when": "Frischer Host oder vollständige Re-Baseline eines vollständig verwalteten Knotens."
|
||||
},
|
||||
{
|
||||
"pathLabel": "Anpassbar",
|
||||
"pathHref": "/docs/post-install/customizable",
|
||||
"scope": "Wählen Sie aus dem vollständigen Katalog.",
|
||||
"when": "Gezielt auswählen, welche Optimierungen auf dem Host aktiv sind."
|
||||
},
|
||||
{
|
||||
"pathLabel": "Verfügbare Updates anwenden",
|
||||
"pathHref": null,
|
||||
"scope": "Nur Optimierungen mit neuerer Version auf dem Datenträger.",
|
||||
"when": "Halten Sie bereits installierte Optimierungen aktuell, ohne den Rest zu berühren."
|
||||
},
|
||||
{
|
||||
"pathLabel": "Optimierungen deinstallieren",
|
||||
"pathHref": "/docs/post-install/uninstall",
|
||||
"scope": "Optimierung rückgängig machen und ihren Registereintrag entfernen.",
|
||||
"when": "Rollen Sie eine bestimmte Änderung zurück."
|
||||
}
|
||||
]
|
||||
},
|
||||
"notifTitle": "Benachrichtigung steuern",
|
||||
"notifBody": "Ausstehende Updates werden durch <em>ProxMenux-Optimierungsupdates verfügbar</em> angekündigt. Das Ereignis ist auf allen Kanälen standardmäßig aktiv und kann unter <link>Einstellungen → Benachrichtigungen</link> pro Kanal stummgeschaltet werden. Es wird nur einmal pro unterschiedlicher Updategruppe ausgelöst, nicht bei jedem 24-Stunden-Scan."
|
||||
}
|
||||
@@ -0,0 +1,116 @@
|
||||
{
|
||||
"meta": {
|
||||
"title": "Post-Install: Virtualisierung | ProxMenux Dokumentation",
|
||||
"description": "Virtualisierungsoptionen im ProxMenux Anpassbares Post-Installationsskript: Installieren Sie automatisch den richtigen Gastagenten, wenn Proxmox in einem VM läuft, und aktivieren Sie IOMMU / VFIO, damit Sie PCI-Geräte (GPUs, NICs, HBAs) an Ihre eigenen VMs weitergeben können."
|
||||
},
|
||||
"header": {
|
||||
"title": "Post-Install: Virtualisierung",
|
||||
"section": "Einstellungen nach der Installation von Proxmox"
|
||||
},
|
||||
"intro": {
|
||||
"title": "Was diese Kategorie abdeckt",
|
||||
"body": "Zwei unabhängige Optionen. <strong>Passenden Gastagenten installieren</strong> hilft, wenn Proxmox selbst in einem anderen Hypervisor verschachtelt läuft. <strong>VFIO-IOMMU-Unterstützung aktivieren</strong> ist für die meisten Benutzer relevant: Es aktiviert die Kernelfunktionen zur direkten Zuweisung einer GPU, HBA oder Netzwerkkarte an eine VM mit nahezu nativer Leistung."
|
||||
},
|
||||
"guestAgent": {
|
||||
"heading": "Relevanten Gastagenten installieren",
|
||||
"intro": "Erkennt die Virtualisierungsumgebung des Proxmox-Hosts mit <code>systemd-detect-virt</code> und <code>dmidecode</code> und installiert das passende Gastwerkzeugpaket für die Kommunikation mit dem äußeren Hypervisor: geordnetes Herunterfahren, Uhrzeitsynchronisierung, IP-Meldung usw.",
|
||||
"headerDetected": "Erkannter Host",
|
||||
"headerPackage": "Installiertes Paket",
|
||||
"rows": [
|
||||
{
|
||||
"detected": "QEMU / KVM",
|
||||
"package": "qemu-guest-agent"
|
||||
},
|
||||
{
|
||||
"detected": "VMware (ESXi, Workstation)",
|
||||
"package": "open-vm-tools"
|
||||
},
|
||||
{
|
||||
"detected": "VirtualBox",
|
||||
"package": "virtualbox-guest-utils"
|
||||
},
|
||||
{
|
||||
"detected": "Direkt auf Hardware (keiner)",
|
||||
"package": "— no-op, nichts installiert"
|
||||
}
|
||||
],
|
||||
"skipTitle": "Überspringen Sie dies auf Bare-Metal Proxmox",
|
||||
"skipBody": "Wenn Proxmox direkt auf Hardware läuft (der übliche Fall), ist das Ankreuzen dieser Option ein No-Op - der Detektor gibt <code>none</code> zurück und das Skript wird ohne Änderungen beendet. Die Option ist nur für die Minderheit der Setups wichtig, die Proxmox <em> als Gast</em> für Tests oder Labors ausführen."
|
||||
},
|
||||
"vfio": {
|
||||
"heading": "VFIO IOMMU-Unterstützung aktivieren",
|
||||
"intro": "Aktiviert IOMMU auf dem Host und lädt die Kernelmodule für PCI-Passthrough (<code>vfio</code>, <code>vfio_iommu_type1</code>, <code>vfio_pci</code>). Damit kann ein physisches Gerät direkt einer VM zugewiesen werden, deren Gast einen nahezu hardwaredirekten Zugriff erhält.",
|
||||
"whoTitle": "Wer das braucht",
|
||||
"whoItems": [
|
||||
"Sie möchten eine GPU an eine Windows-Gaming-VM oder macOS-VM durchreichen.",
|
||||
"Sie haben eine dedizierte 10G NIC für eine Firewall / Router VM (OPNsense, pfSense).",
|
||||
"Sie möchten einen HBA direkt an einen TrueNAS/Unraid VM für ZFS auf nackten Festplatten übergeben.",
|
||||
"Sie planen, <em>Coral TPU</em>, eine Capture-Karte oder einen SDR-Dongle in einem VM zu verwenden."
|
||||
],
|
||||
"whoOutro": "Trifft nichts davon zu, können Sie die Option sicher überspringen. Für die Geräteweitergabe an einen <strong>LXC</strong>-Container statt an eine VM ist IOMMU <em>nicht</em> erforderlich.",
|
||||
"doesTitle": "Was ProxMenux tut",
|
||||
"doesIntro": "Die Funktion ist bootloaderbewusst: Sie erkennt, ob Proxmox auf ZFS (systemd-boot) oder LVM/ext4 (GRUB) ist und schreibt in die richtige Datei. Es ist auch idempotent - wenn die Parameter bereits vorhanden sind, wird nichts hinzugefügt.",
|
||||
"headerBoot": "Bootstyp",
|
||||
"headerFile": "Geänderte Datei",
|
||||
"headerPost": "Schritt nach der Aktualisierung",
|
||||
"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": "Zusätzliche Kernelparameter:",
|
||||
"modulesIntro": "Kernelmodule, die <code>/etc/modules</code> hinzugefügt wurden:",
|
||||
"blacklistIntro": "Konfliktierende Treiber auf der schwarzen Liste in <code>/etc/modprobe.d/blacklist.conf</code>:",
|
||||
"blacklistTitle": "GPU-Treibersperren verhindern die GPU-Nutzung auf dem Host",
|
||||
"blacklistBody": "Die Sperrliste verhindert, dass der Host-Kernel <em>irgendeinen</em> GPU-Treiber bindet, damit VFIO die GPU übernehmen kann. Das ist für die Durchreichung an eine VM erwünscht, aber das <strong>Gegenteil</strong> dessen, was Sie zum <link>Installieren von NVIDIA-Treibern auf dem Host</link> benötigen, etwa für LXC-Transcodierung. Wählen Sie pro GPU einen Weg:",
|
||||
"pathItems": [
|
||||
"<strong>GPU → VM:</strong> aktivieren VFIO/IOMMU hier, lassen Sie die GPU-Treiber auf der schwarzen Liste.",
|
||||
"<strong>GPU → LXC (oder Host):</strong> überspringen Sie diese Option, installieren Sie NVIDIA auf dem Host und sperren Sie nvidia/nouveau nicht.",
|
||||
"<strong>Zwei GPUs:</strong> Eine kann einer VM, die andere einem LXC zugeordnet werden. Dafür ist eine gezieltere Konfiguration nötig: Binden Sie nur eine Karte über ihre PCI-ID an <code>vfio-pci</code>. Die Standardsperrliste ist dafür zu umfassend; bearbeiten Sie danach <code>blacklist.conf</code>."
|
||||
],
|
||||
"acsTitle": "Über pcie_acs_override - wissen, was Sie aktivieren",
|
||||
"acsBody": "<code>pcie_acs_override=downstream,multifunction</code> entspannt den PCIe Access Control Services Check. Es ermöglicht dem Kernel, IOMMU-Gruppen aufzuteilen, die von der Firmware als monolithisch gemeldet werden, was manchmal die einzige Möglichkeit ist, ein Gerät einer Gruppe zu durchlaufen, ohne den Rest zu ziehen. Der Kompromiss ist <strong> reduzierte Isolation zwischen Geräten</strong>: ein bösartiger oder kompromittierter VM mit Durchgang hat eine größere Angriffsfläche über DMA. Gut für ein Heimlabor; Überlegen Sie zweimal, bevor Sie einen Host aktivieren, der nicht vertrauenswürdige Workloads ausführt. Wenn Sie es nicht benötigen, entfernen Sie dieses Token aus <code>/etc/kernel/cmdline</code> oder <code>/etc/default/grub</code>, nachdem das Skript ausgeführt wurde, und führen Sie den Schritt zur Aktualisierung des Bootloaders erneut aus.",
|
||||
"rebootTitle": "Reboot erforderlich",
|
||||
"rebootBody": "IOMMU, VFIO-Module und Sperrliste werden erst nach initramfs-Neuerstellung und Neustart wirksam. Das Skript führt <code>update-initramfs -u -k all</code> und die Bootloader-Aktualisierung aus und setzt „Neustart erforderlich“, sodass Anpassbar am Ende danach fragt.",
|
||||
"verifyTitle": "Überprüfung nach dem Neustart",
|
||||
"revertTitle": "Reversibel aus dem Menü Deinstallieren",
|
||||
"revertBody": "<link>Optimierungen deinstallieren</link> macht alle Änderungen rückgängig: entfernt IOMMU-Parameter aus <code>/etc/kernel/cmdline</code> oder GRUB, VFIO-Module aus <code>/etc/modules</code> und die Treibersperren und erstellt initramfs neu. Erst ein Neustart wendet die Rücknahme an."
|
||||
},
|
||||
"related": {
|
||||
"heading": "Verwandte Themen",
|
||||
"items": [
|
||||
{
|
||||
"label": "GPU zu VM hinzufügen (Passthrough)",
|
||||
"href": "/docs/hardware/gpu-vm-passthrough",
|
||||
"tail": "— natürlicher nächster Schritt, sobald IOMMU + VFIO aktiviert sind."
|
||||
},
|
||||
{
|
||||
"label": "Controller oder NVMe zu VM hinzufügen",
|
||||
"href": "/docs/disk-manager/add-controller-nvme-vm",
|
||||
"tail": " — dieselbe Passthrough-Infrastruktur für Speichercontroller."
|
||||
},
|
||||
{
|
||||
"label": "GPU-Passthrough-Befehle",
|
||||
"href": "/docs/help-info/gpu-commands",
|
||||
"tail": "Referenz der IOMMU-Prüfung."
|
||||
},
|
||||
{
|
||||
"label": "Optimierungen deinstallieren",
|
||||
"href": "/docs/post-install/uninstall",
|
||||
"tail": " — IOMMU/VFIO sauber rückgängig machen."
|
||||
},
|
||||
{
|
||||
"label": "Anpassbare Nachinstallation",
|
||||
"href": "/docs/post-install/customizable",
|
||||
"tail": " — zurück zum übergeordneten Menü."
|
||||
}
|
||||
]
|
||||
}
|
||||
}
|
||||
@@ -1,13 +1,13 @@
|
||||
{
|
||||
"meta": {
|
||||
"title": "Automated Post-Install Script | ProxMenux Documentation",
|
||||
"description": "The ProxMenux Automated post-install script applies a curated set of 14 safe, hardware-aware optimizations to a fresh Proxmox VE host with zero prompts. Reversible configuration changes are registered for later restoration.",
|
||||
"description": "The ProxMenux Automated post-install script runs a fixed set of 14 hardware-aware optimizations on a fresh Proxmox VE host. It has no feature-selection checklist, but the system update, banner removal, some Log2RAM installations and rebooting can ask for confirmation. Reversible configuration changes are registered for later restoration.",
|
||||
"ogTitle": "Automated Post-Install Script | ProxMenux Documentation",
|
||||
"ogDescription": "14 curated optimizations applied to a fresh Proxmox VE host with zero prompts. Hardware-aware, with reversible configuration changes tracked."
|
||||
"ogDescription": "14 fixed, hardware-aware optimizations for a fresh Proxmox VE host, with confirmations for some actions and reversible configuration changes tracked."
|
||||
},
|
||||
"header": {
|
||||
"title": "Automated Post-Install Script",
|
||||
"description": "One click, zero prompts — ProxMenux applies a curated set of 14 safe optimizations that almost every Proxmox host benefits from. Reversible configuration changes are registered for Uninstall Optimizations; package upgrades are not described as reversible.",
|
||||
"description": "ProxMenux runs a fixed set of 14 baseline optimizations without a feature-selection checklist. Some actions still ask for confirmation. Reversible configuration changes are registered for Uninstall Optimizations; package upgrades are not described as reversible.",
|
||||
"section": "Post-Install · Automated"
|
||||
},
|
||||
"intro": {
|
||||
@@ -43,7 +43,7 @@
|
||||
},
|
||||
{
|
||||
"tool": "Skip language packages",
|
||||
"what": "Writes /etc/apt/apt.conf.d/99-disable-translations to stop downloading locale-specific packages. Faster, lighter apt updates.",
|
||||
"what": "Writes /etc/apt/apt.conf.d/99-disable-translations to stop downloading translated package-description indexes, reducing the data fetched by apt updates.",
|
||||
"category": "Basic Settings",
|
||||
"categorySlug": "basic-settings"
|
||||
},
|
||||
@@ -97,7 +97,7 @@
|
||||
},
|
||||
{
|
||||
"tool": "Logrotate tuning",
|
||||
"what": "Daily rotation with size cap 10M, 7 rotations, compression and copytruncate — Log2RAM-friendly.",
|
||||
"what": "Sets daily and then size 10M globally, keeps 7 rotations, enables compression and copytruncate. The later size criterion takes precedence; per-log rules may override it. Suitable for Log2RAM, but rotation frequency depends on the rules and timer.",
|
||||
"category": "System",
|
||||
"categorySlug": "system"
|
||||
},
|
||||
|
||||
@@ -31,7 +31,7 @@
|
||||
],
|
||||
"officialTitle": "The official Proxmox recommendation",
|
||||
"officialBody": "Proxmox's own upgrade guidance is to run, in this exact order:",
|
||||
"officialOutro": "That single line is all you need on any current Proxmox release. The challenge isn't the command itself — it's making sure the repositories on the host are sane <em>before</em> running it.",
|
||||
"officialOutro": "For routine updates within the installed Proxmox VE major version, this is the usual command. Check the host’s repositories and review the proposed package changes <em>before</em> proceeding. Upgrading to another major version requires the official migration procedure.",
|
||||
"doesTitle": "What the ProxMenux option does — verified against the script",
|
||||
"doesIntro": "The ProxMenux update wraps the exact apt commands above and adds a number of pre/post steps you would otherwise have to remember by hand. Every item below is what the dispatcher script actually does (see <link>Proxmox System Update</link> for the full breakdown):",
|
||||
"doesItems": [
|
||||
@@ -59,7 +59,7 @@
|
||||
},
|
||||
"languages": {
|
||||
"heading": "Skip downloading additional languages",
|
||||
"intro": "On every <code>apt update</code>, Debian by default pulls translation files for every locale it ships — a lot of traffic and disk space for something you'll rarely see. This option tells APT to only fetch the main metadata. Before disabling, ProxMenux <strong>makes sure the host's own locale is actually generated</strong> (reads <code>/etc/default/locale</code> or <code>/etc/environment</code>, appends to <code>/etc/locale.gen</code> if missing, and runs <code>locale-gen</code>). So you don't lose your shell locale as a side effect.",
|
||||
"intro": "During <code>apt update</code>, APT can download translated package descriptions as well as the main metadata. This option disables those translation downloads to save bandwidth and disk space. Before disabling them, ProxMenux <strong>makes sure the host’s own locale is actually generated</strong> (reads <code>/etc/default/locale</code> or <code>/etc/environment</code>, appends to <code>/etc/locale.gen</code> if missing, and runs <code>locale-gen</code>). So you do not lose your shell locale as a side effect.",
|
||||
"writtenTitle": "What gets written",
|
||||
"revertTitle": "Reversible from the Uninstall menu",
|
||||
"revertBody": "Deleting <code>/etc/apt/apt.conf.d/99-disable-translations</code> (either manually or from the Uninstall menu) restores the default behaviour and APT downloads language files again."
|
||||
|
||||
@@ -7,12 +7,12 @@
|
||||
},
|
||||
"header": {
|
||||
"title": "Customizable Post-Install Script",
|
||||
"description": "Cherry-pick exactly which optimizations to apply to a Proxmox VE host. ProxMenux groups ~35 individual tools into 10 categories, each with its own checklist dialog. Same engine as Automated, but with full control over what gets applied.",
|
||||
"description": "Cherry-pick exactly which optimizations to apply to a Proxmox VE host. ProxMenux groups ~35 individual tools into 10 categories in one checklist dialog. Same engine as Automated, but with full control over what gets applied.",
|
||||
"section": "Post-Install · Customizable"
|
||||
},
|
||||
"intro": {
|
||||
"title": "When to pick Customizable",
|
||||
"body": "Choose this path when you already know which tweaks you want on the host — or which you definitely do not want. The script presents a checklist per category so you can pre-select, deselect or mix-and-match optimizations. Items can be applied again later, and reversible configuration changes are tracked for <link>Uninstall Optimizations</link>. Package upgrades are not presented as reversible."
|
||||
"body": "Choose this path when you already know which tweaks you want on the host — or which you definitely do not want. The script presents a checklist grouped by category so you can pre-select, deselect or mix-and-match optimizations. Items can be applied again later, and reversible configuration changes are tracked for <link>Uninstall Optimizations</link>. Package upgrades are not presented as reversible."
|
||||
},
|
||||
"compare": {
|
||||
"heading": "How it compares to Automated",
|
||||
@@ -20,7 +20,7 @@
|
||||
},
|
||||
"categoriesSection": {
|
||||
"heading": "The 10 categories",
|
||||
"body": "The Customizable script groups optimizations into 10 categories. Each category has its own checklist dialog and its own documentation page — open one of the cards below for the per-option rationale, defaults and verification steps."
|
||||
"body": "The Customizable script groups optimizations into 10 categories in one checklist dialog. Each category has its own documentation page — open one of the cards below for the per-option rationale, defaults and verification steps."
|
||||
},
|
||||
"categories": [
|
||||
{
|
||||
@@ -33,7 +33,7 @@
|
||||
},
|
||||
{
|
||||
"name": "Virtualization",
|
||||
"description": "Prepare the host for advanced virtualization. Auto-installs the guest agent on templates and enables IOMMU/VFIO for PCI passthrough of GPUs, controllers and TPUs."
|
||||
"description": "Prepare the host for advanced virtualization. Installs a matching guest agent when Proxmox itself runs inside a supported VM, and enables IOMMU/VFIO for PCI passthrough of GPUs, controllers and TPUs."
|
||||
},
|
||||
{
|
||||
"name": "Network",
|
||||
@@ -53,7 +53,7 @@
|
||||
},
|
||||
{
|
||||
"name": "Monitoring",
|
||||
"description": "Integrate the host with OVH Real-Time Monitoring. Only appears when ProxMenux detects an OVH server."
|
||||
"description": "Integrate the host with OVH Real-Time Monitoring. Installs RTM only when ProxMenux detects an OVH server; on other hosts the option makes no changes."
|
||||
},
|
||||
{
|
||||
"name": "Performance",
|
||||
|
||||
@@ -38,7 +38,7 @@
|
||||
"breakTitle": "Can break after Proxmox updates",
|
||||
"breakBody": "Proxmox regularly ships UI updates that overwrite <code>proxmoxlib.js</code>. When that happens, the banner comes back. You can re-apply this option after every Proxmox update to re-patch the file, or just accept the nag until you reapply. ProxMenux also installs an APT hook that auto-re-patches on package upgrades — see <link>Uninstall Optimizations</link> for how that hook is reversed.",
|
||||
"legalTitle": "Legal note (always worth repeating)",
|
||||
"legalBody": "This option only hides the UI nag. It does <strong>not</strong> grant you enterprise support, access to the enterprise repository, or any rights to ship Proxmox commercially without a subscription. If you run Proxmox in a revenue-generating environment, buy a subscription — it supports the project and gets you the stable enterprise channel."
|
||||
"legalBody": "This option only hides the UI notice. It does <strong>not</strong> grant enterprise support or access to the enterprise repository, and it does not change the software license. Proxmox VE is released under the GNU AGPLv3. A subscription supports the project and provides access to the enterprise update channel; choose the appropriate support level for your environment."
|
||||
},
|
||||
"verify": {
|
||||
"heading": "Verification",
|
||||
|
||||
@@ -30,8 +30,8 @@
|
||||
"verifyTitle": "Verification",
|
||||
"verifyBody": "On a real OVH host, after a reboot you should see the <a>RTM dashboard</a> in your OVH Manager populated with live data for the host. On the Proxmox side, the RTM collector is a systemd service — check it directly:",
|
||||
"troubleTitle": "Troubleshooting",
|
||||
"revertTitle": "Not reversible from the Uninstall menu",
|
||||
"revertBody": "There is no dedicated uninstall entry for RTM. On a real OVH host, remove the packages manually with <code>apt purge ovh-*</code> and delete any puppet manifests under <code>/etc/puppet/</code> that RTM installed. On a non-OVH host, nothing was ever installed, so there's nothing to revert."
|
||||
"revertTitle": "Remove RTM from the Uninstall menu",
|
||||
"revertBody": "When RTM is registered as installed, Uninstall Optimizations offers an OVH Real-Time Monitoring entry. It runs <code>apt-get purge -y ''ovh-rtm*'' ''rtm'' ''rtm-*''</code>, removes /etc/rtm, and marks RTM as uninstalled. Puppet artefacts may still need manual cleanup; review any RTM-specific manifests under <code>/etc/puppet/</code>. On a non-OVH host, no RTM packages were installed, so there is nothing to remove."
|
||||
},
|
||||
"related": {
|
||||
"heading": "Related",
|
||||
|
||||
@@ -74,7 +74,7 @@
|
||||
"impactTitle": "Impact is workload-dependent",
|
||||
"impactBody": "BBR shines on high-latency or lossy links (cross-continent replication, VPN tunnels, mobile clients). On a LAN between two machines on the same switch, the difference is often within noise. TFO helps short, repeated HTTP connections the most.",
|
||||
"revertTitle": "Reversible from the Uninstall menu",
|
||||
"revertBody": "BBR/TFO are tracked. <link>Uninstall Optimizations</link> removes the two sysctl files (<code>/etc/sysctl.d/99-tcp-bbr.conf</code> and <code>99-tcp-fastopen.conf</code>) and reloads sysctl so the kernel returns to <code>cubic</code> and <code>tcp_fastopen=1</code>. Manual equivalent:"
|
||||
"revertBody": "BBR/TFO are tracked. <link>Uninstall Optimizations</link> removes the two sysctl files (<code>/etc/sysctl.d/99-kernel-bbr.conf</code> and <code>99-tcp-fastopen.conf</code>) and reloads the remaining sysctl configuration. Removing a file does not itself reset its live kernel values. Defaults such as <code>cubic</code> and <code>tcp_fastopen=1</code> return after a reboot unless another configuration overrides them. Manual equivalent:"
|
||||
},
|
||||
"names": {
|
||||
"heading": "Interface Names (persistent)",
|
||||
@@ -83,13 +83,13 @@
|
||||
"whyItems": [
|
||||
"Adding or removing PCIe devices can shift the bus numbering, turning <code>enp3s0</code> into <code>enp4s0</code>. If your <code>/etc/network/interfaces</code> references the old name, the bridge vanishes on reboot.",
|
||||
"BIOS / firmware updates sometimes change how devices enumerate, with the same effect.",
|
||||
"LXC containers with <code>hotplug</code> NICs and bonded links can race on boot and end up named inconsistently. Pinning fixes that."
|
||||
"The helper writes <code>.link</code> files for physical NICs, including bond member ports, using the MAC currently reported in sysfs; for bond members this may be the bond’s shared MAC, so check their names after a reboot. It skips virtual interfaces such as LXC veth devices and the bond devices themselves; it does not fix naming races for virtual <code>hotplug</code> NICs."
|
||||
],
|
||||
"writtenTitle": "What gets written",
|
||||
"writtenIntro": "One file per physical NIC, at <code>/etc/systemd/network/10-proxmenux-<iface>.link</code>. Each file starts with the header <code># Managed by ProxMenux — do not edit</code> so ProxMenux can distinguish its own files from user- or package-provided <code>.link</code> files.",
|
||||
"writtenOutro": "<code>.link</code> files from other packages or hand-written by the user are left in place — only files carrying the ProxMenux header are managed. On re-run, the function reconciles its own set: it re-reads <code>MACAddress=</code> from every <code>10-proxmenux-*.link</code> and drops any whose MAC no longer appears under <code>/sys/class/net/</code>. Files written by an earlier ProxMenux release in the old <code>10-<iface>.link</code> format are migrated automatically the first time.",
|
||||
"pveTitle": "PVE 9 vs PVE 8",
|
||||
"pveBody": "On Proxmox VE 9 (<code>systemd-networkd</code> native), the script reloads udev rules after writing the <code>.link</code> files so new hotplug NICs pick up the correct name without a reboot. On PVE 8 (<code>ifupdown2</code>), interface naming is resolved at boot anyway — a reboot is required for the changes to take effect. The script sets the reboot flag either way so Customizable prompts you.",
|
||||
"pveBody": "The script uses systemd <code>.link</code> files for persistent names. On Proxmox VE 9 it also reloads udev rules after writing them, so a pinned NIC that is re-added or re-probed can pick up its rule without rebooting. Existing interfaces should be checked after a reboot on both PVE 8 and PVE 9. This does not switch the host away from <code>ifupdown2</code>. The script sets the reboot flag in either case so Customizable prompts you.",
|
||||
"reviewTitle": "Review existing /etc/network/interfaces first",
|
||||
"reviewBody": "If your host has legacy configuration in <code>/etc/network/interfaces</code> that references NIC names generated by the kernel's default scheme, pinning <em>today's</em> names is exactly what you want. But if you've already manually customised the config around specific names, double-check the pinning matches what the interfaces file expects before rebooting.",
|
||||
"revertTitle": "Reversible from the Uninstall menu",
|
||||
|
||||
@@ -133,7 +133,7 @@
|
||||
},
|
||||
"log2ram": {
|
||||
"title": "Install Log2RAM (SSD/NVMe wear reduction)",
|
||||
"intro": "Log2RAM mounts <code>/var/log</code> on a tmpfs ramdisk and periodically syncs the contents back to the underlying disk. On a hypervisor journald churn hits the root SSD every few seconds; moving the writes to RAM reduces wear and disk I/O without losing logs — the periodic sync flushes them to disk and a clean shutdown flushes them too.",
|
||||
"intro": "Log2RAM mounts <code>/var/log</code> on a tmpfs ramdisk and periodically syncs it to the underlying disk. Buffering frequent journald writes in RAM can reduce root SSD wear and disk I/O. Periodic sync and a clean shutdown save logs to disk, but an abrupt power loss can lose entries written since the last sync.",
|
||||
"upstreamLabel": "Upstream project:",
|
||||
"upstreamUrl": "https://github.com/azlux/log2ram",
|
||||
"upstreamLinkLabel": "azlux/log2ram on GitHub",
|
||||
@@ -149,7 +149,7 @@
|
||||
"Registers itself in <code>installed_tools.json</code> so it can be reverted from Uninstall Optimizations."
|
||||
],
|
||||
"howUseLabel": "How to use:",
|
||||
"howUseBody": "On the Automated flow Log2RAM applies unattended when an SSD/NVMe root is detected. On the Customizable flow the script prompts for size, sync interval and whether to enable the 90% auto-sync guard.",
|
||||
"howUseBody": "On the Automated flow Log2RAM installs unattended when an SSD/NVMe root is detected. The Customizable flow asks for size, sync interval and whether to enable the auto-sync guard. Its prompt currently says 90%, but the generated guard uses the 80% cleanup and 92% aggressive thresholds described above.",
|
||||
"verifyLabel": "Verify and manage from the 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"
|
||||
},
|
||||
@@ -172,6 +172,6 @@
|
||||
},
|
||||
"autoApplication": {
|
||||
"title": "Automatic Application",
|
||||
"body": "These optional features are applied only when specifically selected during the post-install process. Each feature can be individually chosen based on your specific needs and preferences."
|
||||
"body": "In the Customizable flow, select each optional feature according to your needs. Log2RAM is also part of the Automated flow with hardware detection; ZRAM remains Customizable-only. Review the individual sections for prompts and prerequisites."
|
||||
}
|
||||
}
|
||||
|
||||
@@ -16,7 +16,7 @@
|
||||
"heading": "Use pigz for faster gzip compression",
|
||||
"intro": "Standard <code>gzip</code> compresses data using a <strong>single CPU core</strong>. On modern Proxmox hosts with 8, 16 or 32 cores, that is a huge bottleneck during <code>vzdump</code> VM/CT backups, log rotation, and anything else that pipes through <code>gzip</code>. <a>pigz</a> is a drop-in parallel replacement: same gzip-compatible output, but it spreads the work across every core.",
|
||||
"doesTitle": "What ProxMenux does",
|
||||
"doesIntro": "Four steps, all idempotent:",
|
||||
"doesIntro": "Five steps, all idempotent:",
|
||||
"doesItems": [
|
||||
"Sets <code>pigz: 1</code> in <code>/etc/vzdump.conf</code> so Proxmox's backup tool uses pigz natively.",
|
||||
"Installs the <code>pigz</code> apt package if not already present.",
|
||||
|
||||
@@ -15,7 +15,7 @@
|
||||
"trackedBody": "Each of these options registers a tool in <code>installed_tools.json</code>, so they appear in <link>Uninstall Optimizations</link>. Reverting <code>zfs_arc</code> removes <code>/etc/modprobe.d/99-zfsarc.conf</code> and rebuilds initramfs; <code>zfs_auto_snapshot</code> reverses the cron schedule and offers to purge the package; <code>zfs_autotrim</code> sets <code>autotrim=off</code> on the pools it enabled; <code>vzdump_speed</code> restores <code>/etc/vzdump.conf</code> from the <code>.bak</code> the install created.",
|
||||
"arc": {
|
||||
"heading": "Optimize ZFS ARC size",
|
||||
"intro": "The <strong>Adaptive Replacement Cache (ARC)</strong> is ZFS's in-memory read cache. Without explicit tuning, ZFS happily grabs up to half the host RAM for itself, which is excessive on a Proxmox host that also needs memory for VMs and LXCs. This option caps ARC to a sane fraction of total RAM based on the size of the machine.",
|
||||
"intro": "The <strong>Adaptive Replacement Cache (ARC)</strong> is ZFS’s in-memory read cache. Proxmox VE installations since 8.1 set a limit of 10% of RAM, capped at 16 GiB; older or upgraded hosts may differ. This option writes that same policy explicitly (RAM/10, capped at 16 GiB, with a 64 MiB floor) to its own file, which also covers older or upgraded hosts. Check existing settings and workload needs before changing it; a smaller cache is not always faster.",
|
||||
"sizingTitle": "Sizing rules",
|
||||
"headerRam": "Host RAM",
|
||||
"headerMax": "ARC cap",
|
||||
@@ -41,7 +41,7 @@
|
||||
"max": "16 GiB (cap)"
|
||||
}
|
||||
],
|
||||
"after": "The file <code>/etc/modprobe.d/99-zfsarc.conf</code> contains a single directive — <code>options zfs zfs_arc_max=…</code>. Every other ZFS module parameter (<code>zfs_arc_min</code>, L2ARC prefetch/write throttle, TXG timeout) is left at its OpenZFS default. Before writing, a reconcile step scans any other <code>*.conf</code> in <code>/etc/modprobe.d/</code> that sets <code>zfs_arc_min</code> / <code>zfs_arc_max</code>, backs them up to <code>/usr/local/share/proxmenux/backups/zfs_arc/</code> with a manifest, and strips the conflicting lines so only ProxMenux's file is active. After writing the file, ProxMenux runs <code>update-initramfs -u -k all</code> and, when applicable, <code>proxmox-boot-tool refresh</code>, so the cap also lands in the initramfs used by ZFS-on-root setups.",
|
||||
"after": "The file <code>/etc/modprobe.d/99-zfsarc.conf</code> contains a single directive — <code>options zfs zfs_arc_max=…</code>. This option does not tune other ZFS module parameters (<code>zfs_arc_min</code>, L2ARC prefetch/write throttle, TXG timeout). Before writing, a reconcile step scans other <code>*.conf</code> in <code>/etc/modprobe.d/</code> that set <code>zfs_arc_min</code> / <code>zfs_arc_max</code>, backs them up to <code>/usr/local/share/proxmenux/backups/zfs_arc/</code> with a manifest, and removes the conflicting <code>zfs_arc_min</code> / <code>zfs_arc_max</code> values (other options on those lines are kept), so only ProxMenux’s ARC file sets the limit. After writing, it runs <code>update-initramfs -u -k all</code> and, when applicable, <code>proxmox-boot-tool refresh</code>, so the limit also reaches the initramfs used by ZFS-on-root setups.",
|
||||
"rebootTitle": "Requires a reboot to take effect",
|
||||
"rebootBody": "ARC settings are read when the <code>zfs</code> kernel module loads. To make the cap take effect on ZFS-on-root hosts, ProxMenux regenerates the initramfs with <code>update-initramfs -u -k all</code> and, when applicable, refreshes the boot loader with <code>proxmox-boot-tool refresh</code>. A reboot is still required to pick up the new module parameter; the \"reboot required\" flag is set automatically.",
|
||||
"safeTitle": "Safe on non-ZFS hosts",
|
||||
@@ -90,22 +90,22 @@
|
||||
},
|
||||
"autotrim": {
|
||||
"heading": "Enable ZFS autotrim (SSD/NVMe pools)",
|
||||
"intro": "Enables the <code>autotrim</code> property on every ZFS pool that is backed exclusively by SSDs or NVMe drives with TRIM support. Pools that include a single HDD vdev are skipped automatically — TRIM on rotational drives is meaningless and ZFS will refuse it. Pools that were already set to <code>autotrim=on</code> are left as they are.",
|
||||
"intro": "Enables the <code>autotrim</code> property on ZFS pools backed exclusively by SSDs or NVMe drives with TRIM support. The script conservatively skips pools containing a rotational device. Pools already set to <code>autotrim=on</code> are left unchanged.",
|
||||
"trimTitle": "What TRIM does, and why it matters on ZFS",
|
||||
"trimBody1": "SSDs / NVMe drives manage internal storage in fixed-size erase blocks that are much larger than the logical sectors the filesystem talks to. When a filesystem deletes a file, the drive doesn't know — it still thinks those sectors are in use, so its internal garbage collector keeps shuffling stale data around to free new erase blocks. <strong>TRIM</strong> is the standard command the OS uses to tell the drive \"these sectors are now free, you can erase them ahead of time\".",
|
||||
"trimBody2": "Without TRIM, SSD performance degrades over time as the drive runs out of pre-erased blocks and has to do erase-on-write, and write amplification increases — both shortening the drive's useful life. With TRIM enabled, the drive can keep a healthy pool of empty blocks ready to write into.",
|
||||
"trimBody3": "On ZFS, <code>autotrim=on</code> is the modern equivalent of the periodic <code>zpool trim <pool></code> command — instead of having to remember to run a trim manually (or schedule one), the pool issues TRIM commands automatically and continuously as blocks become free. It's low-overhead and the recommended setting for SSD-backed pools.",
|
||||
"trimBody3": "With <code>autotrim=on</code>, ZFS trims recently freed space in the background, grouping ranges before issuing commands. A periodic <code>zpool trim <pool></code> is another option. Autotrim avoids a separate schedule, but its performance impact depends on the devices; periodic manual trim may suit some lower-end drives better.",
|
||||
"practicalTitle": "Why is this practical to enable?",
|
||||
"practicalItems": [
|
||||
"<strong>Sustained write performance.</strong> SSDs that never see TRIM commands slow down measurably over months. Autotrim keeps the controller's job easier.",
|
||||
"<strong>Drive longevity.</strong> Lower write amplification means fewer total NAND writes for the same amount of data — measurable in years of useful life for the disk.",
|
||||
"<strong>Sustained write performance.</strong> TRIM can help a drive reclaim unused blocks efficiently. The benefit and any latency impact depend on the device and workload.",
|
||||
"<strong>Drive longevity.</strong> Avoiding unnecessary internal copying can reduce write amplification and NAND wear. It does not guarantee a specific increase in drive lifespan.",
|
||||
"<strong>No scheduled cron job to remember.</strong> Unlike a periodic <code>zpool trim</code>, autotrim is fire-and-forget — the pool handles it on its own."
|
||||
],
|
||||
"whenTitle": "When is this necessary?",
|
||||
"whenIntro1": "<strong>You should enable it</strong> on any ZFS pool whose vdevs are all SSD or NVMe with TRIM support — the typical Proxmox install on consumer or enterprise SSDs.",
|
||||
"whenIntro1": "<strong>Consider enabling it</strong> on ZFS pools made entirely of TRIM-capable SSD or NVMe devices. Check device behaviour and workload latency; a scheduled manual trim can be preferable on some hardware.",
|
||||
"whenIntro2": "<strong>The script skips it automatically</strong> on:",
|
||||
"whenSkipItems": [
|
||||
"Pools containing any HDD (rotational) vdev — TRIM is meaningless there.",
|
||||
"Pools containing any HDD (rotational) vdev — a conservative hardware filter used by this script.",
|
||||
"Drives without <code>discard_granularity</code> exposed in sysfs — usually old SSDs without TRIM, or pass-through paths where the OS can't see the underlying device.",
|
||||
"Pools where ZFS itself reports the property unsupported (rare; very old pools).",
|
||||
"Pools already set to <code>autotrim=on</code> (no-op)."
|
||||
@@ -121,7 +121,7 @@
|
||||
},
|
||||
"vzdump": {
|
||||
"heading": "Increase vzdump backup speed",
|
||||
"intro": "By default, Proxmox vzdump throttles backups to protect running VMs/CTs from IO starvation. On many setups that throttle is more conservative than needed. This option removes the bandwidth cap and lowers the I/O priority so vzdump can saturate the storage path during backup windows.",
|
||||
"intro": "Writes bwlimit: 0 and ionice: 5 in the global vzdump configuration. Proxmox already defaults to no bandwidth limit, so this removes a cap only if one was configured. Compared with the default ionice: 7, the value 5 gives a higher best-effort I/O priority where the scheduler honours it. This can affect running guests and does not guarantee faster backups.",
|
||||
"changedTitle": "What gets changed in /etc/vzdump.conf",
|
||||
"backupTitle": "First run creates a .bak of vzdump.conf",
|
||||
"backupBody": "The first time this option runs, ProxMenux copies <code>/etc/vzdump.conf</code> to <code>/etc/vzdump.conf.bak</code> before touching it. Subsequent runs re-use that backup and won't overwrite it, so a hand-edited config from before the first apply stays recoverable. The changes to <code>bwlimit</code> and <code>ionice</code> are then made with <code>sed</code>, and any other options in the file (compress, pigz, tmpdir, exclude-path, etc.) are preserved.",
|
||||
@@ -145,7 +145,7 @@
|
||||
{
|
||||
"label": "Backup and Restore commands",
|
||||
"href": "/docs/help-info/backup-commands",
|
||||
"tail": " — vzdump CLI reference (now without the legacy bwlimit / ionice caps)."
|
||||
"tail": " — vzdump CLI reference for bandwidth and I/O-priority settings."
|
||||
},
|
||||
{
|
||||
"label": "Uninstall Optimizations",
|
||||
|
||||
@@ -28,9 +28,9 @@
|
||||
},
|
||||
"logrotate": {
|
||||
"heading": "Optimize logrotate",
|
||||
"intro": "Rewrites <code>/etc/logrotate.conf</code> with a tighter policy suitable for a host that's also part of an SSD-protecting Log2RAM setup: daily rotation, 7-day retention, 10 MB size trigger, compression, and <code>copytruncate</code> so active services keep writing without reopening their log files. Original <code>logrotate.conf</code> is backed up to <code>.bak</code> on first apply.",
|
||||
"intro": "Rewrites <code>/etc/logrotate.conf</code> with global daily and size settings, 7 retained rotations, compression and <code>copytruncate</code>, so active services can keep writing without reopening their log files. The size setting follows daily and takes precedence unless a per-log rule overrides it. Original <code>logrotate.conf</code> is backed up to <code>.bak</code> on first apply.",
|
||||
"tipTitle": "Log2RAM-friendly",
|
||||
"tipBody": "The <code>size 10M</code> trigger means logs rotate on size <em>or</em> daily, whichever comes first. Combined with Log2RAM's RAM-backed <code>/var/log</code>, this keeps the working set small so flushes to disk stay cheap."
|
||||
"tipBody": "The <code>size 10M</code> directive takes precedence over the earlier daily setting; it does <em>not</em> mean whichever comes first. Logrotate checks the threshold when it runs, and per-log rules may override the global settings. With Log2RAM’s RAM-backed <code>/var/log</code>, review both the rules and the timer frequency to control disk usage."
|
||||
},
|
||||
"limits": {
|
||||
"heading": "Increase various system limits",
|
||||
@@ -72,7 +72,7 @@
|
||||
}
|
||||
],
|
||||
"tipTitle": "Why inotify matters",
|
||||
"tipBody": "Applications like Docker, Syncthing, Node.js watchers, Plex's library scanner and many more hit <code>max_user_watches</code> quickly. Default on Debian is 8192 — a single running Plex can exhaust it. 1M is generous and costs ~1 KB of RAM per watch, which is negligible."
|
||||
"tipBody": "Docker, Syncthing, Node.js file watchers and Plex library scans can exhaust <code>max_user_watches</code>. The default depends on the kernel and host memory; it is not always 8192. Raising the limit to 1M allows more watches, but does not preallocate them. Active watches consume kernel memory, so monitor actual usage on memory-constrained hosts."
|
||||
},
|
||||
"memory": {
|
||||
"heading": "Optimize memory settings",
|
||||
@@ -102,8 +102,8 @@
|
||||
"verify": {
|
||||
"heading": "Verification",
|
||||
"intro": "After applying the System optimizations:",
|
||||
"tipTitle": "Fully reversible",
|
||||
"tipBody": "All six options are tracked in <code>installed_tools.json</code>, so they appear in <link>Uninstall Optimizations</link> if you want to back any of them out. Reverts restore the sysctl files' defaults, drop the systemd unit and alias for kexec, and reset journald/logrotate to stock Debian configs."
|
||||
"tipTitle": "Restoration and limitations",
|
||||
"tipBody": "All six options are tracked in <code>installed_tools.json</code> and offered in <link>Uninstall Optimizations</link>. Restoration removes the configuration files and the kexec unit and alias, rewrites journald.conf with the stock systemd defaults and restores logrotate.conf from its backup. Some live limits need a new session or reboot."
|
||||
},
|
||||
"related": {
|
||||
"heading": "Related",
|
||||
|
||||
@@ -58,7 +58,7 @@
|
||||
},
|
||||
{
|
||||
"tool": "APT Language Skip",
|
||||
"restores": "Removes /etc/apt/apt.conf.d/99-disable-translations. APT will download language packages again."
|
||||
"restores": "Removes /etc/apt/apt.conf.d/99-disable-translations, allowing APT to download translated package-description indexes according to its remaining language settings."
|
||||
},
|
||||
{
|
||||
"tool": "APT IPv4 Force",
|
||||
@@ -83,7 +83,7 @@
|
||||
},
|
||||
{
|
||||
"tool": "System Limits Increase",
|
||||
"restores": "Removes /etc/sysctl.d/99-maxwatches.conf, 99-maxkeys.conf, 99-swap.conf, 99-fs.conf and /etc/security/limits.d/99-limits.conf. Reverts PAM limits and systemd DefaultLimitNOFILE, and strips the ulimit -n 256000 line from /root/.profile."
|
||||
"restores": "Removes /etc/sysctl.d/99-maxwatches.conf, 99-maxkeys.conf, 99-swap.conf, 99-fs.conf and /etc/security/limits.d/99-limits.conf. Reverts PAM limits and systemd DefaultLimitNOFILE. Its /root/.profile cleanup targets the legacy ulimit -n 256000 line; a ulimit -n 1048576 line from the current installer can remain and may need manual removal."
|
||||
},
|
||||
{
|
||||
"tool": "ZRAM swap profile",
|
||||
@@ -104,7 +104,7 @@
|
||||
},
|
||||
{
|
||||
"tool": "TCP BBR + TCP Fast Open",
|
||||
"restores": "Removes /etc/sysctl.d/99-tcp-bbr.conf and 99-tcp-fastopen.conf and reloads sysctl so the kernel returns to the cubic congestion control and to tcp_fastopen=1."
|
||||
"restores": "Removes /etc/sysctl.d/99-kernel-bbr.conf and 99-tcp-fastopen.conf and reloads remaining sysctl configuration. File removal does not itself reset live values; defaults such as cubic and tcp_fastopen=1 return after reboot unless another configuration overrides them."
|
||||
},
|
||||
{
|
||||
"tool": "Persistent Interface Names",
|
||||
@@ -166,8 +166,8 @@
|
||||
"restores": "Removes idle=nomwait from kernel cmdline (ZFS) or GRUB, and the ignore_msrs / report_ignored_msrs options from /etc/modprobe.d/kvm.conf."
|
||||
},
|
||||
{
|
||||
"tool": "QEMU Guest Agent (templates)",
|
||||
"restores": "Reads /usr/local/share/proxmenux/guest_agent.pkg (recorded at install time) and apt purges whichever package was installed (qemu-guest-agent for standard hosts, spice-vdagent when Spice mode is used)."
|
||||
"tool": "Guest agent for a virtualized Proxmox host",
|
||||
"restores": "Reads /usr/local/share/proxmenux/guest_agent.pkg and purges the recorded host package. The installer selects qemu-guest-agent, open-vm-tools or virtualbox-guest-utils according to the detected hypervisor. If the record is missing, the uninstaller tries those three packages. This acts on the nested Proxmox host, not guest templates."
|
||||
}
|
||||
]
|
||||
},
|
||||
@@ -221,7 +221,7 @@
|
||||
},
|
||||
{
|
||||
"tool": "OVH RTM (monitoring)",
|
||||
"restores": "apt purges any ovh-* packages the RTM installer added and deletes the puppet manifests it dropped under /etc/puppet/. On non-OVH hosts nothing was ever installed, so nothing is removed."
|
||||
"restores": "Purges packages matching ovh-rtm*, rtm and rtm-*, removes /etc/rtm and clears the RTM registry entry. Puppet artefacts under /etc/puppet/ may need manual inspection and cleanup; the uninstaller does not delete that directory. On non-OVH hosts the installer normally makes no changes."
|
||||
}
|
||||
]
|
||||
}
|
||||
@@ -230,7 +230,7 @@
|
||||
"edge": {
|
||||
"heading": "Edge cases and caveats",
|
||||
"packageTitle": "Package reinstall touches live Proxmox packages",
|
||||
"packageBody": "Reverting <strong>Subscription Banner Removal</strong> reinstalls <code>pve-manager</code>, <code>proxmox-widget-toolkit</code>, <code>libjs-extjs</code> and <code>libpve-http-server-perl</code> with <code>--force-confnew</code>. This is generally safe but does touch the running web UI — refresh your browser afterwards, and expect a few seconds of reconnection. Don't run this in the middle of a migration or clone operation.",
|
||||
"packageBody": "If ProxMenux’s own backups cannot restore <strong>Subscription Banner Removal</strong>, the fallback reinstalls <code>pve-manager</code>, <code>proxmox-widget-toolkit</code>, <code>libjs-extjs</code> and <code>libpve-http-server-perl</code> with <code>--force-confnew</code>. This touches the running web UI: refresh the browser afterwards and allow a few seconds to reconnect. Avoid doing it during a migration or clone operation.",
|
||||
"rebootTitle": "Persistent names and VFIO need a reboot",
|
||||
"rebootBody": "Removing ProxMenux's <code>10-proxmenux-*.link</code> files (<em>Persistent Interface Names</em>) and reverting <em>IOMMU/VFIO</em> do not affect the running system — they only matter after a reboot. ProxMenux sets the reboot flag automatically for these.",
|
||||
"perItemTitle": "You can revert one thing and keep the rest",
|
||||
|
||||
@@ -48,9 +48,9 @@
|
||||
},
|
||||
"pathB": {
|
||||
"heading": "Path B — From the Monitor dashboard",
|
||||
"intro": "The same updates appear in the Monitor under <link>Settings → ProxMenux Optimizations</link>. When pending updates are detected the card shows an \"Updates available\" banner with the count and an <strong>Apply</strong> action that opens the same per-optimization picker.",
|
||||
"imageAlt": "ProxMenux Optimizations card on the Monitor dashboard with an Updates available banner at the top showing the count of pending updates and an Apply button that opens the per-optimization picker",
|
||||
"imageCaption": "The Optimizations card in the Monitor — when at least one optimization has a newer version on disk, the banner surfaces it without requiring shell access."
|
||||
"intro": "The same updates appear in the Monitor under <link>Settings → ProxMenux Optimizations</link>. When pending updates are detected, the card shows an <strong>updates count badge</strong> that opens the per-optimization picker. Individual tools also provide their own update action.",
|
||||
"imageAlt": "ProxMenux Optimizations card in Monitor settings, with a pending-updates count badge that opens the per-optimization picker and update actions on individual tools",
|
||||
"imageCaption": "The Optimizations card in the Monitor — when at least one optimization has a newer version on disk, its count badge makes the updates accessible without shell access."
|
||||
},
|
||||
"applying": {
|
||||
"heading": "What happens when you apply",
|
||||
@@ -69,7 +69,7 @@
|
||||
},
|
||||
{
|
||||
"title": "Registry refresh sent to the Monitor",
|
||||
"body": "Once the batch finishes, the menu POSTs to <code>http://127.0.0.1:8008/api/updates/post-install/scan</code> to rebuild <code>/usr/local/share/proxmenux/updates_available.json</code>. That is what makes the Monitor's Optimizations card and the shell menu entry disappear immediately after the update, without waiting for the next scheduled scan."
|
||||
"body": "Once the batch finishes, the menu POSTs to <code>http://127.0.0.1:8008/api/updates/post-install/scan</code> to rebuild <code>/usr/local/share/proxmenux/updates_available.json</code>. After all pending updates are applied, the update badge in the Monitor’s Optimizations card and the conditional shell menu entry disappear without waiting for the next scheduled scan. The Optimizations card itself remains available."
|
||||
}
|
||||
],
|
||||
"jqTitle": "jq is required",
|
||||
|
||||
@@ -1,14 +1,14 @@
|
||||
{
|
||||
"meta": {
|
||||
"title": "Script Automatizado post-instalación | ProxMenux Documentation",
|
||||
"description": "El script Automatizado post-instalación de ProxMenux aplica un conjunto seleccionado de 14 optimizaciones seguras y adaptadas al hardware a un host Proxmox VE recién instalado, sin preguntas. Los cambios de configuración reversibles quedan registrados para restaurarlos después.",
|
||||
"ogTitle": "Script Automatizado post-instalación | ProxMenux Documentation",
|
||||
"ogDescription": "14 optimizaciones aplicadas a un host Proxmox VE recién instalado sin preguntas. Adaptadas al hardware y con los cambios reversibles registrados."
|
||||
"title": "Script automatizado post-instalación | Documentación de ProxMenux",
|
||||
"description": "El script automatizado post-instalación de ProxMenux ejecuta un conjunto fijo de 14 optimizaciones adaptadas al hardware en un host Proxmox VE recién instalado. No ofrece una lista de funciones para elegir, pero puede pedir confirmación para la actualización del sistema, ocultar el aviso de suscripción, instalar Log2RAM en ciertos casos y reiniciar. Los cambios reversibles se registran para restaurarlos después.",
|
||||
"ogTitle": "Script automatizado post-instalación | Documentación de ProxMenux",
|
||||
"ogDescription": "14 optimizaciones fijas adaptadas al hardware para un host Proxmox VE nuevo, con confirmaciones para algunas acciones y registro de cambios reversibles."
|
||||
},
|
||||
"header": {
|
||||
"title": "Script Automatizado post-instalación",
|
||||
"description": "Un clic, sin preguntas: ProxMenux aplica 14 optimizaciones seguras de las que se beneficia casi cualquier host Proxmox. Los cambios de configuración reversibles quedan registrados para Uninstall Optimizations; las actualizaciones de paquetes no se describen como reversibles.",
|
||||
"section": "Post-Install · Automated"
|
||||
"description": "ProxMenux ejecuta 14 optimizaciones de base sin lista de funciones para elegir. Algunas acciones piden confirmación. Los cambios reversibles se registran para Desinstalar optimizaciones; las actualizaciones de paquetes no se describen como reversibles.",
|
||||
"section": "Post-instalación · Automatizada"
|
||||
},
|
||||
"intro": {
|
||||
"title": "Cuándo elegir Automatizado",
|
||||
@@ -24,91 +24,91 @@
|
||||
},
|
||||
"optimizations": [
|
||||
{
|
||||
"tool": "Repositorios APT + full upgrade",
|
||||
"tool": "Repositorios APT + actualización completa",
|
||||
"what": "Desactiva pve-enterprise.sources y ceph.sources enterprise, escribe una fuente limpia sin suscripción para el codename Debian del host, y luego ejecuta apt update && apt full-upgrade -y (el comando oficial de upgrade de Proxmox).",
|
||||
"category": "Basic Settings",
|
||||
"category": "Ajustes básicos",
|
||||
"categorySlug": "basic-settings"
|
||||
},
|
||||
{
|
||||
"tool": "Eliminación del banner de suscripción",
|
||||
"what": "Parchea la UI web para ocultar el banner 'No valid subscription'. Pide confirmación antes de aplicar; reversible desde Uninstall Optimizations.",
|
||||
"category": "Customization",
|
||||
"what": "Modifica la interfaz web para ocultar el aviso «No valid subscription». Pide confirmación antes de aplicarlo; reversible desde Desinstalar optimizaciones.",
|
||||
"category": "Personalización",
|
||||
"categorySlug": "customization"
|
||||
},
|
||||
{
|
||||
"tool": "Forzar IPv4",
|
||||
"what": "Escribe /etc/apt/apt.conf.d/99-force-ipv4 para que apt use solo IPv4 — esquiva setups de mirror IPv6 inestables.",
|
||||
"category": "Network",
|
||||
"category": "Red",
|
||||
"categorySlug": "network"
|
||||
},
|
||||
{
|
||||
"tool": "Saltar paquetes de idioma",
|
||||
"what": "Escribe /etc/apt/apt.conf.d/99-disable-translations para dejar de descargar paquetes específicos de locale. Updates de apt más rápidos y ligeros.",
|
||||
"category": "Basic Settings",
|
||||
"what": "Escribe /etc/apt/apt.conf.d/99-disable-translations para dejar de descargar índices de descripciones traducidas de paquetes y reducir los datos de las actualizaciones de apt.",
|
||||
"category": "Ajustes básicos",
|
||||
"categorySlug": "basic-settings"
|
||||
},
|
||||
{
|
||||
"tool": "Aumentar límites del sistema",
|
||||
"what": "Sube los inotify watches, los límites nofile/nproc, los límites del keyring del kernel y fs.file-max en sysctl.d, limits.d, pam y systemd — lo bastante altos para hosts con muchos contenedores.",
|
||||
"category": "System",
|
||||
"category": "Sistema",
|
||||
"categorySlug": "system"
|
||||
},
|
||||
{
|
||||
"tool": "Tuning de memoria",
|
||||
"tool": "Ajuste de memoria",
|
||||
"what": "Establece vm.swappiness=10, dirty ratios balanceados, vm.max_map_count=262144 y compaction proactiveness cuando es soportado. La política de memory-overcommit del kernel se deja en el valor por defecto de Proxmox.",
|
||||
"category": "System",
|
||||
"category": "Sistema",
|
||||
"categorySlug": "system"
|
||||
},
|
||||
{
|
||||
"tool": "Comportamiento ante kernel panic",
|
||||
"what": "Configura el host para reiniciar 10 segundos después de un panic / oops / hardlockup en lugar de quedarse congelado indefinidamente.",
|
||||
"category": "System",
|
||||
"category": "Sistema",
|
||||
"categorySlug": "system"
|
||||
},
|
||||
{
|
||||
"tool": "Tuning del stack de red",
|
||||
"what": "Dimensionado de buffers TCP, hardening IPv4 (redirects off, rp_filter=2, martian log off), rango de puertos locales 1024-65535, TCP MTU probing, RFC 1337, más un helper en /usr/local/sbin/proxmenux-fwbr-tune conectado a una unit systemd oneshot y a una regla udev, de forma que rp_filter=0 / log_martians=0 se reapliquen a las interfaces fwbr*/fwln*/fwpr*/tap* cada vez que Proxmox las recrea al iniciar/parar VMs, en reinicios o en migraciones en vivo.",
|
||||
"category": "Network",
|
||||
"category": "Red",
|
||||
"categorySlug": "network"
|
||||
},
|
||||
{
|
||||
"tool": "Customización de bashrc (root)",
|
||||
"what": "PS1 con colores, aliases comunes (l/la/ll/ls/grep), historial con marcas de tiempo y sourcing de bash-completion, todo dentro de un bloque PMX_CORE_BASHRC delimitado para que sea fácil de quitar.",
|
||||
"category": "Customization",
|
||||
"category": "Personalización",
|
||||
"categorySlug": "customization"
|
||||
},
|
||||
{
|
||||
"tool": "Log2RAM (consciente de SSD, automático)",
|
||||
"tool": "Log2RAM (según el SSD, automático)",
|
||||
"what": "Reduce el desgaste del SSD/NVMe moviendo /var/log a una ramdisk tmpfs con sync periódico al disco. Se instala desde el proyecto oficial cuando el disco raíz es SSD o NVMe. Dimensiona la ramdisk según la RAM (128M / 256M / 512M), programa el sync periódico y un guardián de auto-sync que compacta al 80% y trunca los logs calientes al 92% antes de escribir. Ajusta los límites de journald para caber en la ramdisk. Detalle completo en <link>Log2RAM</link>.",
|
||||
"category": "Storage",
|
||||
"category": "Almacenamiento",
|
||||
"categorySlug": "storage"
|
||||
},
|
||||
{
|
||||
"tool": "ZFS autotrim (solo SSD)",
|
||||
"what": "Activa zpool autotrim=on en cada pool ZFS cuyos vdevs sean todos SSD/NVMe con soporte TRIM (comprueba /sys/block/[dev]/queue/rotational y discard_granularity). Los pools respaldados por HDDs se saltan automáticamente. Solo los pools realmente cambiados por ProxMenux quedan registrados para el uninstall — los pools en los que activaste autotrim a mano se dejan en paz.",
|
||||
"category": "Storage",
|
||||
"category": "Almacenamiento",
|
||||
"categorySlug": "storage"
|
||||
},
|
||||
{
|
||||
"tool": "Límites de tamaño de journald",
|
||||
"what": "Fuerza almacenamiento persistente, capa SystemMaxUse=64M / RuntimeMaxUse=60M, activa compresión, logging a nivel info (requerido para el Monitor). Se salta automáticamente cuando Log2RAM está activo (hace su propio ajuste).",
|
||||
"category": "System",
|
||||
"what": "Fuerza almacenamiento persistente, limita SystemMaxUse=64M / RuntimeMaxUse=60M, activa compresión y registros de nivel info (necesarios para Monitor). Se omite cuando Log2RAM está activo, pues hace su propio ajuste.",
|
||||
"category": "Sistema",
|
||||
"categorySlug": "system"
|
||||
},
|
||||
{
|
||||
"tool": "Tuning de logrotate",
|
||||
"what": "Rotación diaria con tope de tamaño 10M, 7 rotaciones, compresión y copytruncate — amigable con Log2RAM.",
|
||||
"category": "System",
|
||||
"tool": "Ajuste de logrotate",
|
||||
"what": "Configura globalmente daily y después size 10M, conserva 7 rotaciones y activa compresión y copytruncate. El criterio de tamaño posterior prevalece; las reglas particulares pueden cambiarlo. Adecuado para Log2RAM, pero la frecuencia depende de reglas y temporizador.",
|
||||
"category": "Sistema",
|
||||
"categorySlug": "system"
|
||||
},
|
||||
{
|
||||
"tool": "Nombres de interfaz persistentes",
|
||||
"what": "Escribe un <code>/etc/systemd/network/10-proxmenux-<iface>.link</code> por NIC física (cada uno comenzando con la cabecera 'Managed by ProxMenux') que fija el MAC al nombre actual, de forma que los nombres <code>eth0</code> / <code>enp…</code> se mantengan estables tras reinicios y al añadir nuevas NICs.",
|
||||
"category": "Network",
|
||||
"category": "Red",
|
||||
"categorySlug": "network"
|
||||
}
|
||||
],
|
||||
"hardwareTitle": "Valores por defecto conscientes del hardware",
|
||||
"hardwareTitle": "Valores predeterminados adaptados al hardware",
|
||||
"hardwareBody": "El script lee el hardware del host antes de aplicar los ajustes. Log2RAM solo se instala en discos raíz SSD / NVMe por defecto (pregunta si la detección dice lo contrario). El tamaño del ramdisk de Log2RAM se elige a partir de la RAM total (<code>≤ 8 GB → 128M</code>, <code>≤ 16 GB → 256M</code>, <code>'>' 16 GB → 512M</code>). Los límites de journald se ajustan al tamaño del ramdisk cuando Log2RAM está activo, para no llenarlo.",
|
||||
"upgrade": {
|
||||
"heading": "Actualizar y hacer upgrade del sistema",
|
||||
@@ -118,9 +118,9 @@
|
||||
"Desactiva enterprise <code>pve-enterprise.sources</code> / <code>ceph.sources</code>, elimina archivos de repos legacy, escribe una fuente limpia sin suscripción para el codename del host.",
|
||||
"Ejecuta el upgrade de forma no interactiva con <code>DEBIAN_FRONTEND=noninteractive</code> y <code>--force-confdef --force-confold</code> — los archivos de configuración que has customizado siguen siendo tuyos cuando upstream también ha cambiado.",
|
||||
"Instala paquetes esenciales de Proxmox si faltan (<code>zfsutils-linux</code>, <code>proxmox-backup-restore-image</code>, <code>chrony</code>).",
|
||||
"Comprobación de cordura de metadatos LVM, <code>apt-get autoremove -y</code> + <code>apt-get autoclean -y</code>, y prompt de reinicio solo si el kernel realmente cambió."
|
||||
"Comprobación de coherencia de metadatos LVM, <code>apt-get autoremove -y</code> + <code>apt-get autoclean -y</code> y solicitud de reinicio solo si cambió el núcleo."
|
||||
],
|
||||
"sameTitle": "Mismo updater, dos puntos de entrada",
|
||||
"sameTitle": "Mismo actualizador, dos puntos de entrada",
|
||||
"sameBody": "El bundle Automatizado y la utilidad independiente <link>Proxmox System Update</link> comparten los mismos scripts subyacentes (<code>update-pve8.sh</code> / <code>update-pve9_2.sh</code>). Usa la utilidad por separado cuando solo quieras hacer upgrade del host sin aplicar el resto de las optimizaciones."
|
||||
},
|
||||
"endResult": {
|
||||
@@ -142,18 +142,18 @@
|
||||
"xshokBody": "Si el host ha ejecutado previamente el script <code>xshok-proxmox</code>, ProxMenux detecta el archivo marcador y te avisa antes de continuar. Algunos tweaks pueden solaparse. El script complementario está deprecado — si decides continuar de todos modos, revisa <link>el resumen</link> para contexto.",
|
||||
"revert": {
|
||||
"heading": "Revertir",
|
||||
"body": "Cada herramienta de la tabla anterior se registra a sí misma en <code>/usr/local/share/proxmenux/installed_tools.json</code>. Abre <link>Uninstall Optimizations</link> para elegir items individuales que revertir. Los backups de los archivos de configuración modificados se dejan junto a los originales con sufijo <code>.bak</code>."
|
||||
"body": "Cada herramienta de la tabla se registra en <code>/usr/local/share/proxmenux/installed_tools.json</code>. Abre <link>Desinstalar optimizaciones</link> para elegir los elementos que quieras revertir. Las copias de los archivos modificados se guardan junto a los originales con sufijo <code>.bak</code>."
|
||||
},
|
||||
"related": {
|
||||
"heading": "Relacionado",
|
||||
"items": [
|
||||
{
|
||||
"label": "Customizable Post-Install",
|
||||
"label": "Post-instalación personalizable",
|
||||
"href": "/docs/post-install/customizable",
|
||||
"tail": " — elige exactamente qué quieres del mismo catálogo."
|
||||
},
|
||||
{
|
||||
"label": "Uninstall Optimizations",
|
||||
"label": "Desinstalar optimizaciones",
|
||||
"href": "/docs/post-install/uninstall",
|
||||
"tail": " — revierte cualquier subconjunto de lo aplicado aquí."
|
||||
},
|
||||
@@ -163,7 +163,7 @@
|
||||
"tail": " — verifica los cambios (uptime, free, journalctl, etc.)."
|
||||
},
|
||||
{
|
||||
"label": "Resumen de Post-Install",
|
||||
"label": "Resumen de post-instalación",
|
||||
"href": "/docs/post-install",
|
||||
"tail": "."
|
||||
}
|
||||
|
||||
@@ -1,11 +1,11 @@
|
||||
{
|
||||
"meta": {
|
||||
"title": "Post-instalación: Basic Settings | ProxMenux Documentation",
|
||||
"title": "Post-instalación: Ajustes básicos | Documentación de ProxMenux",
|
||||
"description": "Opciones post-instalación fundamentales: cambiar a los repositorios sin suscripción de Proxmox y hacer upgrade, autodetectar la zona horaria y activar NTP, saltar la descarga de idiomas de APT, y elegir entre 25 utilidades de sistema comunes para instalar."
|
||||
},
|
||||
"header": {
|
||||
"title": "Post-instalación: Basic Settings",
|
||||
"section": "Settings post-install Proxmox"
|
||||
"title": "Post-instalación: Ajustes básicos",
|
||||
"section": "Configuración post instalación de Proxmox"
|
||||
},
|
||||
"intro": {
|
||||
"title": "Qué cubre esta categoría",
|
||||
@@ -15,8 +15,8 @@
|
||||
"heading": "Actualizar y hacer upgrade del sistema",
|
||||
"intro": "Reconfigura APT para usar el repositorio gratuito <em>pve-no-subscription</em> (en lugar del repo enterprise que requiere suscripción) y ejecuta un upgrade completo del sistema. Los pasos exactos dependen de la versión mayor de Proxmox VE: ProxMenux la detecta y despacha al script correcto.",
|
||||
"headerVersion": "Versión PVE",
|
||||
"headerScript": "Script despachador",
|
||||
"headerCodename": "Codename Debian",
|
||||
"headerScript": "Script de selección por versión",
|
||||
"headerCodename": "Nombre en clave de Debian",
|
||||
"rows": [
|
||||
{
|
||||
"version": "9.x",
|
||||
@@ -31,7 +31,7 @@
|
||||
],
|
||||
"officialTitle": "La recomendación oficial de Proxmox",
|
||||
"officialBody": "La guía oficial de upgrade de Proxmox es ejecutar, exactamente en este orden:",
|
||||
"officialOutro": "Esa única línea es todo lo que necesitas en cualquier release actual de Proxmox. El reto no es el comando en sí — es asegurarse de que los repositorios del host están sanos <em>antes</em> de ejecutarlo.",
|
||||
"officialOutro": "Este es el comando habitual para actualizaciones dentro de la misma versión mayor de Proxmox VE. Comprueba los repositorios del host y revisa los cambios de paquetes propuestos <em>antes</em> de continuar. Cambiar de versión mayor requiere el procedimiento oficial de migración.",
|
||||
"doesTitle": "Qué hace la opción de ProxMenux — verificado contra el script",
|
||||
"doesIntro": "El update de ProxMenux envuelve los comandos apt exactos de arriba y añade una serie de pasos pre/post que tendrías que recordar tú a mano. Cada item de abajo es lo que el script despachador realmente hace (mira <link>Proxmox System Update</link> para el desglose completo):",
|
||||
"doesItems": [
|
||||
@@ -39,37 +39,37 @@
|
||||
"<strong>Repos Debian reescritos</strong> con main / updates / security, incluyendo <code>non-free-firmware</code>, para que la advertencia de firmware durante el upgrade desaparezca.",
|
||||
"<strong>Ejecuta el upgrade oficial.</strong> <code>apt-get update</code> seguido de <code>apt full-upgrade -y</code> (PVE 9) o <code>apt dist-upgrade -y</code> (PVE 8), ambos lanzados de forma no interactiva con <code>--force-confdef --force-confold</code> para que cualquier archivo de configuración que hayas customizado siga siendo tuyo.",
|
||||
"<strong>Instala paquetes esenciales</strong> si faltan: <code>zfsutils-linux</code>, <code>proxmox-backup-restore-image</code>, <code>chrony</code>.",
|
||||
"<strong>Comprobación de cordura de metadatos LVM.</strong> Busca VMs con passthrough de disco que puedan haber garabateado cabeceras stale de physical-volume sobre discos en bruto; avisa si hay algo raro (no hay fix automático).",
|
||||
"<strong>Comprueba los metadatos LVM.</strong> Busca VM con passthrough de disco que puedan haber dejado cabeceras antiguas de volúmenes físicos en discos en bruto; avisa si detecta anomalías, sin corregirlas automáticamente.",
|
||||
"<strong>Limpia al final:</strong> <code>apt-get autoremove -y</code> + <code>apt-get autoclean -y</code>, y luego pregunta por un reinicio si el kernel fue actualizado o si está presente <code>/var/run/reboot-required</code>."
|
||||
],
|
||||
"shortTitle": "En resumen",
|
||||
"shortBody": "La opción ejecuta el exacto <code>apt update && apt full-upgrade -y</code> que Proxmox recomienda, lo envuelve con la limpieza de repos y la limpieza post-upgrade que la guía oficial también te dice que hagas, y pregunta por el reinicio al final. Mira <link>Proxmox System Update</link> — el mismo updater también está disponible como utilidad independiente en el menú principal, con el diagrama completo del proceso.",
|
||||
"subTitle": "No apliques esto a un host con suscripción",
|
||||
"subBody": "Si tienes una suscripción de Proxmox y quieres seguir usando los repositorios enterprise, omite esta opción. Al ejecutarla se desactiva el repositorio enterprise y el host pasa al canal comunitario. La actualización de paquetes y la reescritura de repositorios no se presentan como reversibles en Uninstall Optimizations; restaura deliberadamente la configuración de repositorios si más adelante necesitas cambiar de canal.",
|
||||
"subBody": "Si tienes una suscripción de Proxmox y quieres mantener los repositorios Enterprise, omite esta opción. Al ejecutarla, el host pasa al canal comunitario. La actualización de paquetes y la reescritura de repositorios no se pueden revertir desde Desinstalar optimizaciones; si quieres cambiar de canal después, debes configurar los repositorios expresamente.",
|
||||
"safetyTitle": "Comprobación de seguridad post-update",
|
||||
"safetyBody": "Tras el upgrade, el script comprueba si hay discos con metadatos PV (Physical Volume) obsoletos — un caso límite que puede pasar cuando una VM con passthrough de disco garabatea cabeceras LVM sobre un disco en bruto. Si encuentra algo sospechoso verás un aviso sugiriendo <code>pvs</code> para inspeccionarlo. No se toma ninguna acción automáticamente."
|
||||
"safetyBody": "Tras actualizar, el script busca discos con metadatos antiguos de volúmenes físicos (PV). Puede ocurrir si una VM con passthrough de disco escribe cabeceras LVM en un disco en bruto. Si encuentra algo sospechoso, avisa y sugiere inspeccionarlo con <code>pvs</code>. No modifica nada automáticamente."
|
||||
},
|
||||
"time": {
|
||||
"heading": "Sincronizar la hora automáticamente",
|
||||
"intro": "Detecta la IP pública del servidor vía <code>dig myip.opendns.com @resolver1.opendns.com</code>, luego consulta <code>ipapi.co/'{'ip'}'/timezone</code> para buscar la zona horaria IANA correspondiente, y la aplica con <code>timedatectl set-timezone</code>. Finalmente activa NTP con <code>timedatectl set-ntp true</code>.",
|
||||
"depTitle": "Depende de dos servicios externos",
|
||||
"depBody": "El lookup depende de que OpenDNS e <code>ipapi.co</code> sean accesibles, y de que sus respuestas sean correctas. Si ejecutas Proxmox detrás de una VPN o en una VLAN que sale por una región distinta, la zona horaria autodetectada puede ser incorrecta. En ese caso sáltate esta opción y configura la zona horaria a mano:",
|
||||
"revertTitle": "Reversible desde el menú Uninstall",
|
||||
"revertBody": "<link>Uninstall Optimizations</link> resetea la zona horaria a UTC (un valor por defecto seguro). No desactiva NTP — tu reloj sigue sincronizándose, solo anclado a UTC hasta que pongas una nueva zona horaria manualmente."
|
||||
"revertTitle": "Reversible desde el menú Desinstalar",
|
||||
"revertBody": "<link>Desinstalar optimizaciones</link> restablece la zona horaria a UTC, un valor predeterminado seguro. No desactiva NTP: el reloj sigue sincronizándose y muestra UTC hasta que configures otra zona manualmente."
|
||||
},
|
||||
"languages": {
|
||||
"heading": "Saltar la descarga de idiomas adicionales",
|
||||
"intro": "En cada <code>apt update</code>, Debian por defecto descarga archivos de traducción para cada locale que distribuye — mucho tráfico y espacio en disco para algo que rara vez verás. Esta opción le dice a APT que solo descargue los metadatos principales. Antes de desactivarlo, ProxMenux <strong>se asegura de que el propio locale del host está realmente generado</strong> (lee <code>/etc/default/locale</code> o <code>/etc/environment</code>, lo añade a <code>/etc/locale.gen</code> si falta, y ejecuta <code>locale-gen</code>). Así no pierdes tu locale de shell como efecto colateral.",
|
||||
"intro": "Durante <code>apt update</code>, APT puede descargar descripciones de paquetes traducidas además de los metadatos principales. Esta opción desactiva esas traducciones para ahorrar ancho de banda y disco. Antes, ProxMenux <strong>comprueba que la configuración regional del host está generada</strong>: lee <code>/etc/default/locale</code> o <code>/etc/environment</code>, la añade a <code>/etc/locale.gen</code> si falta y ejecuta <code>locale-gen</code>. Así se conserva la configuración regional de la shell.",
|
||||
"writtenTitle": "Qué se escribe",
|
||||
"revertTitle": "Reversible desde el menú Uninstall",
|
||||
"revertTitle": "Reversible desde el menú Desinstalar",
|
||||
"revertBody": "Borrar <code>/etc/apt/apt.conf.d/99-disable-translations</code> (manualmente o desde el menú Uninstall) restaura el comportamiento por defecto y APT vuelve a descargar los archivos de idioma."
|
||||
},
|
||||
"utilities": {
|
||||
"heading": "Instalar utilidades de sistema comunes",
|
||||
"intro": "Abre un checklist con <strong>25 utilidades curadas</strong> organizadas en grupos. Elige las que quieras, confirma, y ProxMenux instala cada una vía <code>apt</code>, verificando que el paquete funcionó y mostrando un resumen al final.",
|
||||
"imageAlt": "Diálogo de checklist mostrando la lista de utilidades de sistema de ProxMenux con espacio para seleccionar y enter para confirmar",
|
||||
"intro": "Abre una lista con <strong>25 utilidades seleccionadas</strong> organizadas en grupos. Elige las que quieras y confirma; ProxMenux las instala mediante <code>apt</code>, comprueba el resultado y muestra un resumen final.",
|
||||
"imageAlt": "Diálogo de selección de utilidades de ProxMenux: Espacio selecciona y Entrar confirma",
|
||||
"reuseTitle": "La misma lista se reutiliza en otro sitio",
|
||||
"reuseBody": "El catálogo de 25 utilidades vive en una única fuente de verdad (<code>PROXMENUX_UTILS</code> en <code>scripts/global/utils-install-functions.sh</code>). El menú <em>Utilities and Tools → System Utilities</em> del menú principal de ProxMenux expone la misma lista, así que puedes volver más tarde e instalar más sin volver a ejecutar la post-instalación.",
|
||||
"reuseBody": "El catálogo de 25 utilidades tiene una única definición: <code>PROXMENUX_UTILS</code> en <code>scripts/global/utils-install-functions.sh</code>. El menú <em>Utilidades y herramientas → Utilidades del sistema</em> ofrece la misma lista para instalar más adelante sin repetir la post-instalación.",
|
||||
"listTitle": "Qué hay en la lista",
|
||||
"groups": [
|
||||
{
|
||||
@@ -177,7 +177,7 @@
|
||||
},
|
||||
{
|
||||
"pkg": "tmux",
|
||||
"desc": "Multiplexador de terminal — sesiones que se separan, paneles divididos, sobrevive a desconexiones"
|
||||
"desc": "Multiplexador de terminal: separa sesiones, divide paneles y mantiene las sesiones tras desconectarte"
|
||||
}
|
||||
]
|
||||
},
|
||||
@@ -210,18 +210,18 @@
|
||||
],
|
||||
"actionTitle": "Algunas de ellas en acción",
|
||||
"noBulkTitle": "Solo se eliminan las utilidades instaladas por ProxMenux",
|
||||
"noBulkBody": "ProxMenux registra únicamente los paquetes seleccionados que no estaban instalados antes de esta acción. Uninstall Optimizations puede purgar después esos paquetes, mientras que las utilidades que ya existían en el host permanecen intactas. La actualización general mediante APT no se registra como reversible porque los paquetes actualizados no disponen de una restauración atómica segura."
|
||||
"noBulkBody": "ProxMenux registra únicamente los paquetes seleccionados que no estaban ya instalados. Al ejecutar Desinstalar optimizaciones, purga esos paquetes y conserva los que ya tenías. Las actualizaciones de APT no tienen una reversión atómica segura: desinstalar utilidades no deshace la actualización del sistema."
|
||||
},
|
||||
"related": {
|
||||
"heading": "Relacionado",
|
||||
"items": [
|
||||
{
|
||||
"label": "Proxmox System Update",
|
||||
"label": "Actualización del sistema Proxmox",
|
||||
"href": "/docs/utils/system-update",
|
||||
"tail": " — vuelve a ejecutar el ciclo apt update + dist-upgrade bajo demanda."
|
||||
},
|
||||
{
|
||||
"label": "System Utilities Installer",
|
||||
"label": "Instalador de utilidades del sistema",
|
||||
"href": "/docs/utils/system-utils",
|
||||
"tail": " — instala (o reinstala) utilidades individualmente tras la post-instalación."
|
||||
},
|
||||
@@ -231,7 +231,7 @@
|
||||
"tail": " — referencia de apt."
|
||||
},
|
||||
{
|
||||
"label": "Customizable Post-Install",
|
||||
"label": "Post-instalación personalizable",
|
||||
"href": "/docs/post-install/customizable",
|
||||
"tail": " — volver al menú padre."
|
||||
}
|
||||
|
||||
@@ -1,103 +1,103 @@
|
||||
{
|
||||
"meta": {
|
||||
"title": "Script Personalizable post-instalación | ProxMenux Documentation",
|
||||
"title": "Script post-instalación personalizable | Documentación de ProxMenux",
|
||||
"description": "Elige exactamente qué optimizaciones aplicar a un host Proxmox VE con ProxMenux. 10 categorías, ~35 herramientas individuales, UI de selección. Incluye todo lo que hace el script Automatizado, más funcionalidades opcionales (IOMMU, Fastfetch, Figurine, Ceph, HA, ajustes de AMD…).",
|
||||
"ogTitle": "Script Personalizable post-instalación | ProxMenux Documentation",
|
||||
"ogTitle": "Script post-instalación personalizable | Documentación de ProxMenux",
|
||||
"ogDescription": "10 categorías, ~35 optimizaciones individuales. Elige exactamente qué quieres en un host Proxmox VE. Los cambios reversibles quedan registrados."
|
||||
},
|
||||
"header": {
|
||||
"title": "Script Personalizable post-instalación",
|
||||
"description": "Elige exactamente qué optimizaciones aplicar a un host Proxmox VE. ProxMenux agrupa ~35 herramientas individuales en 10 categorías, cada una con su propio diálogo de selección. Mismo motor que el Automatizado, pero con control total sobre qué se aplica.",
|
||||
"section": "Post-Install · Customizable"
|
||||
"description": "Elige exactamente qué optimizaciones aplicar a un host Proxmox VE. ProxMenux agrupa unas 35 herramientas en 10 categorías dentro de un único diálogo de selección. Usa el mismo motor que Automatizado, con control total sobre lo que se aplica.",
|
||||
"section": "Post-instalación · Personalizable"
|
||||
},
|
||||
"intro": {
|
||||
"title": "Cuándo elegir Personalizable",
|
||||
"body": "Elige esta ruta cuando ya sabes qué ajustes quieres en el host — o cuáles definitivamente no quieres. El script presenta una selección por categoría para que puedas combinar optimizaciones. Las opciones se pueden volver a aplicar y los cambios de configuración reversibles quedan registrados para <link>Uninstall Optimizations</link>. Las actualizaciones de paquetes no se presentan como reversibles."
|
||||
"body": "Elige esta opción si ya sabes qué ajustes quieres en el host o cuáles no quieres. El script muestra una lista con casillas agrupada por categorías para seleccionar, desmarcar y combinar optimizaciones. Puedes volver a aplicarlas después; los cambios reversibles se registran para <link>Desinstalar optimizaciones</link>. Las actualizaciones de paquetes no se presentan como reversibles."
|
||||
},
|
||||
"compare": {
|
||||
"heading": "Comparación con el Automatizado",
|
||||
"body": "Personalizable es un superset del <link>script Automatizado</link>. Cubre las mismas 14 optimizaciones de baseline más una larga lista de opt-ins que el Automatizado se salta a propósito — cosas que solo son útiles en hardware específico (fixes de AMD), hosting específico (OVH RTM), o cargas específicas (IOMMU/VFIO, repo de Ceph, High Availability, Fastfetch, Figurine, tuning del ARC de ZFS, pigz, ZFS auto-snapshot, límites de velocidad de vzdump, Open vSwitch, TCP BBR + TCP Fast Open, refresco del índice del PVE Appliance Manager…)."
|
||||
"body": "Personalizable incluye todo el <link>script Automatizado</link>. Cubre las mismas 14 optimizaciones básicas y una larga lista de opciones que Automatizado omite deliberadamente, útiles para hardware específico (correcciones AMD), alojamiento específico (OVH RTM) o cargas concretas (IOMMU/VFIO, repositorio Ceph, alta disponibilidad, Fastfetch, Figurine, ajuste del ARC de ZFS, pigz, snapshots automáticos de ZFS, límites de velocidad vzdump, Open vSwitch, TCP BBR…)."
|
||||
},
|
||||
"categoriesSection": {
|
||||
"heading": "Las 10 categorías",
|
||||
"body": "El script Personalizable agrupa optimizaciones en 10 categorías. Cada categoría tiene su propio diálogo de selección y su propia página de documentación — abre una de las tarjetas para consultar el razonamiento, los valores predeterminados y los pasos de verificación."
|
||||
"body": "El script Personalizable agrupa las optimizaciones en 10 categorías dentro de un único diálogo de selección. Cada categoría tiene su propia página de documentación; abre una tarjeta para consultar la justificación, los valores predeterminados y la verificación de cada opción."
|
||||
},
|
||||
"categories": [
|
||||
{
|
||||
"name": "Basic Settings",
|
||||
"name": "Ajustes básicos",
|
||||
"description": "Sanea las fuentes APT, ejecuta el upgrade oficial de Proxmox y fija zona horaria, locale y utilidades básicas. Es la base sobre la que apoyan todas las demás categorías."
|
||||
},
|
||||
{
|
||||
"name": "System",
|
||||
"name": "Sistema",
|
||||
"description": "Ajusta el subsistema de logs y los límites del kernel para un host que aloja muchas VMs y contenedores. Cubre journald, logrotate, sysctl (memoria, límites de ficheros), comportamiento en panic y reinicios rápidos."
|
||||
},
|
||||
{
|
||||
"name": "Virtualization",
|
||||
"description": "Prepara el host para virtualización avanzada. Auto-instala el guest agent en las plantillas y activa IOMMU/VFIO para passthrough de dispositivos PCI (GPU, controladoras, TPU)."
|
||||
"name": "Virtualización",
|
||||
"description": "Prepara el host para virtualización avanzada. Instala el agente invitado correspondiente si el propio Proxmox se ejecuta dentro de una VM compatible y activa IOMMU/VFIO para el passthrough PCI de GPU, controladoras y TPU."
|
||||
},
|
||||
{
|
||||
"name": "Network",
|
||||
"name": "Red",
|
||||
"description": "Endurece y afina la pila de red del host. Fuerza APT sobre IPv4, aplica sysctl con hardening y tuning de buffers TCP, ofrece Open vSwitch, TCP BBR + TCP Fast Open, y fija nombres persistentes de interfaces por MAC."
|
||||
},
|
||||
{
|
||||
"name": "Storage",
|
||||
"name": "Almacenamiento",
|
||||
"description": "Configura los subsistemas de almacenamiento habituales de Proxmox: ARC de ZFS, auto-snapshots, ZFS autotrim para pools SSD/NVMe y límites de velocidad de vzdump para evitar saturar el disco durante backups."
|
||||
},
|
||||
{
|
||||
"name": "Security",
|
||||
"name": "Seguridad",
|
||||
"description": "Reduce la superficie de ataque expuesta por defecto. Desactiva los servicios RPC (portmapper/rpcbind) que Proxmox no necesita pero deja escuchando."
|
||||
},
|
||||
{
|
||||
"name": "Customization",
|
||||
"name": "Personalización",
|
||||
"description": "Cambia la experiencia visual y de shell del host: colores y aliases en bashrc, banner MOTD y eliminación del aviso de suscripción del web UI."
|
||||
},
|
||||
{
|
||||
"name": "Monitoring",
|
||||
"description": "Integra el host con Real-Time Monitoring de OVH. Sólo aparece cuando ProxMenux detecta un servidor OVH."
|
||||
"name": "Monitorización",
|
||||
"description": "Integra el host con OVH Real-Time Monitoring. Solo instala RTM cuando ProxMenux detecta un servidor OVH; en otros hosts no hace cambios."
|
||||
},
|
||||
{
|
||||
"name": "Performance",
|
||||
"name": "Rendimiento",
|
||||
"description": "Acelera las operaciones de compresión (backups, transferencias) sustituyendo gzip por su versión paralela pigz."
|
||||
},
|
||||
{
|
||||
"name": "Optional",
|
||||
"name": "Opcional",
|
||||
"description": "Opciones que no necesita todo host: ajustes de CPU AMD, banner Fastfetch, nombre 3D con Figurine, actualización del índice de PVE Appliance Manager, repositorio Ceph, servicios de alta disponibilidad, Log2RAM para reducir el desgaste del SSD y un perfil de swap con ZRAM."
|
||||
}
|
||||
],
|
||||
"mixTip": {
|
||||
"title": "Mezcla Automatizado y Personalizable",
|
||||
"body": "Un patrón común: ejecutar primero <strong>Automatizado</strong> para fijar el baseline sensato, luego abrir <strong>Personalizable</strong> y elegir solo las herramientas opt-in que te interesan (por ejemplo, IOMMU en un host que va a hacer passthrough de GPU). Los cambios se registran de forma independiente; el menú Uninstall muestra todo lo que has aplicado independientemente de qué ruta lo añadió."
|
||||
"body": "Un uso habitual: ejecuta primero <strong>Automatizado</strong> para aplicar una base sensata, abre después <strong>Personalizable</strong> y elige solo las herramientas opcionales que necesitas, como IOMMU para passthrough de GPU. Los cambios se registran por separado; Desinstalar muestra lo aplicado con independencia de la opción que lo añadió."
|
||||
},
|
||||
"related": {
|
||||
"heading": "Relacionado",
|
||||
"items": [
|
||||
{
|
||||
"label": "Automated Post-Install",
|
||||
"label": "Post-instalación automatizada",
|
||||
"href": "/docs/post-install/automated",
|
||||
"tail": " — valores por defecto sensatos aplicados sin preguntas."
|
||||
},
|
||||
{
|
||||
"label": "Uninstall Optimizations",
|
||||
"label": "Desinstalar optimizaciones",
|
||||
"href": "/docs/post-install/uninstall",
|
||||
"tail": " — revierte cualquier selección de forma limpia."
|
||||
},
|
||||
{
|
||||
"label": "Basic Settings",
|
||||
"label": "Ajustes básicos",
|
||||
"href": "/docs/post-install/basic-settings",
|
||||
"tail": " — repos, hora, idioma, utilidades."
|
||||
},
|
||||
{
|
||||
"label": "Virtualization",
|
||||
"label": "Virtualización",
|
||||
"href": "/docs/post-install/virtualization",
|
||||
"tail": " — IOMMU + VFIO para passthrough."
|
||||
},
|
||||
{
|
||||
"label": "Security",
|
||||
"label": "Seguridad",
|
||||
"href": "/docs/post-install/security",
|
||||
"tailRich": " · <storageLink>Storage</storageLink> · <networkLink>Network</networkLink> · <customLink>Customization</customLink> — otras categorías."
|
||||
"tailRich": " · <storageLink>Almacenamiento</storageLink> · <networkLink>Red</networkLink> · <customLink>Personalización</customLink> — otras categorías."
|
||||
},
|
||||
{
|
||||
"label": "Resumen de Post-Install",
|
||||
"label": "Resumen de post-instalación",
|
||||
"href": "/docs/post-install",
|
||||
"tail": "."
|
||||
}
|
||||
|
||||
@@ -1,24 +1,24 @@
|
||||
{
|
||||
"meta": {
|
||||
"title": "Post-instalación: Customización | ProxMenux Documentation",
|
||||
"description": "Opciones de customización en el script post-instalación Customizable de ProxMenux: un prompt de bash con colores y aliases útiles, un banner de ProxMenux en el MOTD, y la opción de eliminar el aviso de suscripción de Proxmox de la interfaz web."
|
||||
"title": "Post-instalación: Personalización | Documentación de ProxMenux",
|
||||
"description": "Opciones de personalización en el script post-instalación Personalizable de ProxMenux: un prompt de bash con colores y alias útiles, un banner de ProxMenux en el MOTD y la opción de eliminar el aviso de suscripción de la interfaz web de Proxmox."
|
||||
},
|
||||
"header": {
|
||||
"title": "Post-instalación: Customización",
|
||||
"description": "Ajustes estéticos y de comodidad para el host Proxmox. Hacen más agradable el uso de la consola y ocultan el aviso de suscripción de la interfaz web. Bashrc, MOTD y el banner de suscripción quedan registrados y son reversibles desde el menú Uninstall.",
|
||||
"section": "Settings post-install Proxmox"
|
||||
"title": "Post-instalación: Personalización",
|
||||
"description": "Ajustes estéticos y de comodidad para el host Proxmox. Mejoran el uso de la shell y ocultan el aviso de suscripción de la interfaz web. Bashrc, MOTD y el banner de suscripción se registran y se pueden revertir desde Desinstalar.",
|
||||
"section": "Configuración post instalación de Proxmox"
|
||||
},
|
||||
"intro": {
|
||||
"title": "Qué cubre esta categoría",
|
||||
"body": "Tres opciones pequeñas e independientes: un <strong>prompt de bash con colores + aliases</strong> para la shell de root, un <strong>banner MOTD</strong> de una línea visible al hacer login por SSH, y la eliminación del <strong>popup \"No valid subscription\"</strong> que Proxmox muestra en cada login a la UI web."
|
||||
},
|
||||
"bashrc": {
|
||||
"heading": "Customizar bashrc",
|
||||
"heading": "Personalizar bashrc",
|
||||
"intro": "Inyecta un bloque curado en <code>/root/.bashrc</code> con un prompt con colores, historial con marcas de tiempo, aliases estándar de <code>ls</code> / <code>grep</code> y un <code>source</code> para autocompletado de bash. Hace que trabajar sobre SSH sea bastante más agradable y deja claro en qué host estás cuando tienes muchas pestañas abiertas.",
|
||||
"writesTitle": "Qué añade ProxMenux a .bashrc",
|
||||
"writesOutro": "El bloque está delimitado por los marcadores <code>PMX_CORE_BASHRC</code>. Ejecutar el script de nuevo reemplaza el bloque anterior en lugar de duplicarlo. El <code>.bashrc</code> original se respalda una vez en <code>/root/.bashrc.bak</code>, y se añade una línea <code>source /root/.bashrc</code> a <code>/root/.bash_profile</code> para que el prompt también se aplique en shells de login (p. ej. tras <code>su -</code>).",
|
||||
"rootTitle": "Solo se aplica a root",
|
||||
"rootBody": "La customización apunta a la shell de la cuenta root. Otros usuarios que crees en el host conservan sus propios valores por defecto. Si administras Proxmox exclusivamente por la UI web y nunca usas la shell, esta opción es pura estética y puedes saltártela."
|
||||
"rootBody": "La personalización afecta a la shell de la cuenta root. Otros usuarios del host conservan sus propios valores predeterminados. Si administras Proxmox exclusivamente desde la interfaz web y nunca usas la shell, puedes omitir esta opción estética."
|
||||
},
|
||||
"motd": {
|
||||
"heading": "Configurar banner MOTD personalizado",
|
||||
@@ -29,43 +29,43 @@
|
||||
"banner": {
|
||||
"heading": "Eliminar banner de suscripción",
|
||||
"intro": "Elimina el modal <em>\"You do not have a valid subscription for this server\"</em> que aparece cada vez que alguien entra en la UI web de Proxmox sin una suscripción enterprise. El parche es consciente de la versión: las distintas versiones mayores de Proxmox tienen distintos bundles de UI, así que ProxMenux despacha al script correcto.",
|
||||
"versionTitle": "Despacho consciente de la versión",
|
||||
"versionTitle": "Selección de script según la versión",
|
||||
"versionItems": [
|
||||
"<strong>PVE 9.x</strong> → ejecuta <code>remove-banner-pve-v3.sh</code> (parchea tanto el <code>proxmoxlib.js</code> de escritorio como la nueva UI móvil basada en Yew).",
|
||||
"<strong>PVE 8.x</strong> → ejecuta <code>remove-banner-pve8.sh</code> (solo escritorio)."
|
||||
],
|
||||
"versionOutro": "Antes de parchear, ProxMenux respalda los archivos JS/template originales en <code>/usr/local/share/proxmenux/backups/</code> con una marca de tiempo. El flujo Uninstall usa esos backups para restaurar los archivos originales, y como fallback reinstala los paquetes de la UI de Proxmox si el backup falta o está corrupto.",
|
||||
"breakTitle": "Puede romperse tras actualizaciones de Proxmox",
|
||||
"breakBody": "Proxmox publica regularmente actualizaciones de UI que sobrescriben <code>proxmoxlib.js</code>. Cuando eso pasa, el banner vuelve. Puedes reaplicar esta opción tras cada actualización de Proxmox para volver a parchear el archivo, o simplemente aceptar el aviso hasta que la vuelvas a aplicar. ProxMenux también instala un hook APT que vuelve a parchear automáticamente en los upgrades de paquetes — mira <link>Uninstall Optimizations</link> para ver cómo se revierte ese hook.",
|
||||
"breakBody": "Las actualizaciones de la interfaz de Proxmox pueden sobrescribir <code>proxmoxlib.js</code> y hacer que vuelva el aviso. Puedes volver a aplicar esta opción para parchearlo o mantener el aviso hasta entonces. ProxMenux también instala un hook de APT para volver a parchear tras las actualizaciones de paquetes; consulta <link>Desinstalar optimizaciones</link> para saber cómo se elimina.",
|
||||
"legalTitle": "Nota legal (siempre conviene repetirla)",
|
||||
"legalBody": "Esta opción solo oculta el aviso de la UI. <strong>No</strong> te concede soporte enterprise, acceso al repositorio enterprise, ni derecho alguno a distribuir Proxmox comercialmente sin suscripción. Si ejecutas Proxmox en un entorno que genera ingresos, compra una suscripción — apoya al proyecto y te da el canal enterprise estable."
|
||||
"legalBody": "Esta opción solo oculta el aviso de la interfaz. <strong>No</strong> concede soporte Enterprise ni acceso al repositorio Enterprise, y no cambia la licencia del software. Proxmox VE se distribuye bajo GNU AGPLv3. Una suscripción apoya el proyecto y da acceso al canal de actualizaciones Enterprise; elige el nivel de soporte adecuado para tu entorno."
|
||||
},
|
||||
"verify": {
|
||||
"heading": "Verificación",
|
||||
"intro": "Tras aplicar los tres:",
|
||||
"reversibleTitle": "Los tres cambios de personalización quedan registrados",
|
||||
"reversibleBody": "<link>Uninstall Optimizations</link> restaura <code>/root/.bashrc</code>, devuelve MOTD exactamente al contenido anterior a ProxMenux (o elimina el archivo si antes no existía) y restaura los archivos parcheados de la interfaz desde sus copias o reinstala los paquetes de Proxmox afectados cuando sea necesario."
|
||||
"reversibleBody": "<link>Desinstalar optimizaciones</link> restaura <code>/root/.bashrc</code>, devuelve MOTD al contenido exacto anterior a ProxMenux o elimina el archivo si antes no existía, y restaura los archivos de interfaz parcheados desde sus copias o reinstala los paquetes afectados cuando sea necesario."
|
||||
},
|
||||
"related": {
|
||||
"heading": "Relacionado",
|
||||
"items": [
|
||||
{
|
||||
"label": "Optional",
|
||||
"label": "Opcional",
|
||||
"href": "/docs/post-install/optional",
|
||||
"tail": " — Fastfetch y Figurine (otras customizaciones visuales)."
|
||||
"tail": " — Fastfetch y Figurine, otras personalizaciones visuales."
|
||||
},
|
||||
{
|
||||
"label": "Mostrar información de versión",
|
||||
"href": "/docs/settings/show-version-information",
|
||||
"tail": " — confirma que las customizaciones están registradas como instaladas."
|
||||
"tail": " — confirma que las personalizaciones están registradas como instaladas."
|
||||
},
|
||||
{
|
||||
"label": "Uninstall Optimizations",
|
||||
"label": "Desinstalar optimizaciones",
|
||||
"href": "/docs/post-install/uninstall",
|
||||
"tail": " — revierte bashrc, motd, aviso de suscripción."
|
||||
},
|
||||
{
|
||||
"label": "Customizable Post-Install",
|
||||
"label": "Post-instalación personalizable",
|
||||
"href": "/docs/post-install/customizable",
|
||||
"tail": " — volver al menú padre."
|
||||
}
|
||||
|
||||
@@ -1,7 +1,7 @@
|
||||
{
|
||||
"meta": {
|
||||
"title": "Script post-instalación de Proxmox VE — Automatizado y personalizable | ProxMenux",
|
||||
"description": "Resumen de los scripts post-instalación de ProxMenux para Proxmox VE. Ejecuta el script Automatizado para aplicar valores recomendados sin preguntas, usa Personalizable para elegir entre 10 categorías o restaura los cambios reversibles compatibles mediante Uninstall Optimizations.",
|
||||
"description": "Resumen de los scripts post-instalación de ProxMenux para Proxmox VE. Ejecuta el script Automatizado para aplicar valores recomendados sin preguntas, usa Personalizable para elegir exactamente lo que quieres entre 10 categorías o restaura los cambios reversibles compatibles mediante Desinstalar optimizaciones.",
|
||||
"ogTitle": "Script post-instalación de Proxmox VE — Automatizado y personalizable",
|
||||
"ogDescription": "Aplica optimizaciones comunes post-instalación de Proxmox VE en 10 categorías — automatizadas o a la carta, con opciones reversibles.",
|
||||
"twitterTitle": "Script post-instalación de Proxmox VE | ProxMenux",
|
||||
@@ -10,7 +10,7 @@
|
||||
"header": {
|
||||
"title": "Scripts post-instalación",
|
||||
"description": "Configura un host de Proxmox VE recién instalado con las optimizaciones post-instalación de ProxMenux. Aplica la configuración base automáticamente, elige opciones individuales, actualiza funciones instaladas o restaura cambios reversibles compatibles. Las actualizaciones de paquetes no se presentan como reversibles.",
|
||||
"section": "Settings post-install Proxmox"
|
||||
"section": "Configuración post instalación de Proxmox"
|
||||
},
|
||||
"intro": {
|
||||
"title": "Para qué sirve este menú",
|
||||
@@ -18,8 +18,8 @@
|
||||
},
|
||||
"openingMenu": {
|
||||
"heading": "Abrir el menú",
|
||||
"body": "Desde el menú principal de ProxMenux, selecciona <strong>Settings post-install Proxmox</strong>. Verás esto:",
|
||||
"imageAlt": "Menú de scripts post-instalación — Automatizado, Personalizable, la entrada condicional Aplicar Actualizaciones Disponibles (solo cuando hay updates pendientes) y Uninstall, seguidos de la sección Community Scripts"
|
||||
"body": "Desde el menú principal de ProxMenux, selecciona <strong>Configuración post instalación de Proxmox</strong>. Verás esto:",
|
||||
"imageAlt": "Menú de scripts post-instalación: Automatizado, Personalizable, la entrada condicional Aplicar actualizaciones disponibles (solo cuando hay actualizaciones pendientes) y Desinstalar, seguidos de la sección Scripts de la comunidad"
|
||||
},
|
||||
"threeWays": {
|
||||
"heading": "Cuatro formas de aplicar optimizaciones",
|
||||
@@ -34,29 +34,29 @@
|
||||
"Tuning de memoria, kernel y red",
|
||||
"Log2RAM (autodetectado en SSD/NVMe)",
|
||||
"Límites de tamaño de journald + logrotate",
|
||||
"Nombres de interfaz persistentes"
|
||||
"Nombres persistentes de interfaz"
|
||||
]
|
||||
},
|
||||
{
|
||||
"title": "Personalizable",
|
||||
"description": "~35 optimizaciones individuales en 10 categorías. Eliges exactamente cuáles aplicar. Mismo motor que el Automatizado, pero con control total.",
|
||||
"bullets": [
|
||||
"UI de checklist por categoría",
|
||||
"Incluye todo lo que hace el Automatizado, más opciones opt-in (IOMMU, Fastfetch, Figurine, Ceph, HA, fixes de AMD…)",
|
||||
"Interfaz con casillas de selección por categoría",
|
||||
"Incluye todo lo que hace Automatizado, más opciones que debes activar expresamente (IOMMU, Fastfetch, Figurine, Ceph, HA, correcciones de AMD…)",
|
||||
"Ejecuta tantas veces como quieras — los cambios son idempotentes"
|
||||
]
|
||||
},
|
||||
{
|
||||
"title": "Apply Available Updates",
|
||||
"description": "Cuando una optimización post-instalación (Log2Ram, Memory Settings, Logrotate…) tiene en disco una versión más nueva que la registrada en el host, esta entrada muestra solo las que se han movido. Re-ejecuta la función correspondiente y refresca el registro — no toca nada más.",
|
||||
"title": "Aplicar actualizaciones disponibles",
|
||||
"description": "Cuando una optimización post-instalación (Log2Ram, ajustes de memoria, Logrotate…) tiene en disco una versión más nueva que la registrada en el host, esta entrada muestra solo las optimizaciones que han cambiado. Vuelve a ejecutar la función correspondiente y actualiza el registro, sin tocar nada más.",
|
||||
"bullets": [
|
||||
"Opt-in por optimización (solo lo que ha cambiado)",
|
||||
"Aceptación individual por optimización (solo lo que ha cambiado)",
|
||||
"Mismo selector disponible desde el panel del Monitor",
|
||||
"Una única notificación agrupada cuando llegan actualizaciones nuevas"
|
||||
]
|
||||
},
|
||||
{
|
||||
"title": "Uninstall Optimizations",
|
||||
"title": "Desinstalar optimizaciones",
|
||||
"description": "Los cambios reversibles compatibles quedan registrados en un JSON y asociados a una función de restauración. Las acciones sin reversión segura, como una actualización completa de paquetes, se excluyen deliberadamente.",
|
||||
"bullets": [
|
||||
"Detecta automáticamente las optimizaciones aplicadas previamente",
|
||||
@@ -66,7 +66,7 @@
|
||||
}
|
||||
],
|
||||
"whichTitle": "¿Cuál deberías elegir?",
|
||||
"whichBody": "Si es una instalación recién hecha de Proxmox y quieres el baseline sensato sin tener que decidir: <autoLink><strong>Automatizado</strong></autoLink>. Si ya sabes qué tweaks quieres (o cuáles definitivamente no quieres): <customLink><strong>Personalizable</strong></customLink>. Si algo que ya aplicaste tiene una versión más nueva en disco y solo quieres subir esa: <updatesLink><strong>Apply Available Updates</strong></updatesLink>. Si aplicaste algo antes y quieres revertirlo de forma limpia: <uninstallLink><strong>Uninstall Optimizations</strong></uninstallLink>. Puedes mezclarlas — aplicar primero Automatizado, luego abrir Personalizable para añadir opt-ins como Fastfetch o IOMMU, y revertir cualquier item individual más tarde.",
|
||||
"whichBody": "Si acabas de instalar Proxmox y quieres una base sensata sin tomar decisiones: <autoLink><strong>Automatizado</strong></autoLink>. Si ya sabes qué ajustes quieres o cuáles no quieres: <customLink><strong>Personalizable</strong></customLink>. Si una optimización aplicada tiene una versión más nueva en disco y solo quieres actualizar esa: <updatesLink><strong>Aplicar actualizaciones disponibles</strong></updatesLink>. Para revertir algo aplicado anteriormente: <uninstallLink><strong>Desinstalar optimizaciones</strong></uninstallLink>. Puedes combinarlos: aplica primero Automatizado, abre después Personalizable para añadir opciones como Fastfetch o IOMMU y revierte cualquier elemento individual más adelante.",
|
||||
"mixing": {
|
||||
"heading": "Mezclar con otros scripts post-instalación",
|
||||
"stackTitle": "No apiles varios scripts post-instalación",
|
||||
@@ -75,25 +75,25 @@
|
||||
"xshokBody": "Versiones anteriores de ProxMenux referenciaban <a>xshok-proxmox</a> como herramienta post-instalación complementaria. Ese proyecto ahora está deprecado y ya no se ofrece desde ProxMenux. Si una ejecución anterior de xshok-proxmox dejó marcadores en el host, ProxMenux todavía los detecta y te avisa — pero no es algo que debas instalar junto a ProxMenux hoy."
|
||||
},
|
||||
"community": {
|
||||
"heading": "Community scripts",
|
||||
"body": "El menú también expone dos scripts de terceros del proyecto <a>community-scripts</a>: <em>Proxmox VE Post Install</em> y <em>Proxmox VE Microcode</em>. Son wrappers que hacen <code>wget | bash</code> de los scripts de los autores originales. No los mantiene ProxMenux. Mira <link>External Repositories</link> para detalles y consideraciones de confianza antes de ejecutarlos."
|
||||
"heading": "Scripts de la comunidad",
|
||||
"body": "El menú también ofrece dos scripts de terceros del proyecto <a>community-scripts</a>: <em>Proxmox VE Post Install</em> y <em>Proxmox VE Microcode</em>. Son envoltorios que descargan y ejecutan los scripts originales mediante <code>wget | bash</code>. ProxMenux no los mantiene. Consulta <link>Repositorios externos</link> para conocer los detalles y valorar la confianza antes de ejecutarlos."
|
||||
},
|
||||
"pbs": {
|
||||
"heading": "En Proxmox Backup Server",
|
||||
"body": "En un host Proxmox Backup Server, el mismo menú se abre desde <strong>Settings post-install Proxmox</strong> en el menú de PBS. Automatizado, Personalizable, Apply Available Updates y Uninstall Optimizations funcionan igual que en Proxmox VE, con estas diferencias:",
|
||||
"body": "En un host Proxmox Backup Server, el mismo menú se abre desde <strong>Configuración post instalación de Proxmox</strong> en el menú de PBS. Automatizado, Personalizable, Aplicar actualizaciones disponibles y Desinstalar optimizaciones funcionan igual que en Proxmox VE, con estas diferencias:",
|
||||
"items": [
|
||||
"<strong>Repositorios y actualización:</strong> cuando el servidor no tiene suscripción y solo está activo el repositorio Enterprise de PBS, ProxMenux pregunta antes de cambiar al repositorio sin suscripción de PBS. El cambio se hace con la API de repositorios del propio servidor, la misma que usa <em>Administration > Repositories</em>. Con una suscripción activa, o con un repositorio sin suscripción o de pruebas ya configurado, las fuentes se mantienen como están.",
|
||||
"<strong>Lista personalizable:</strong> no aparecen las opciones que solo se aplican a Proxmox VE: agente de invitado, VFIO IOMMU, Open vSwitch, velocidad de backups vzdump, pigz, Appliance Manager, Ceph, alta disponibilidad y OVH Real Time Monitoring.",
|
||||
"<strong>Banner de suscripción:</strong> el parche se aplica a la interfaz web de Proxmox Backup Server, y Uninstall Optimizations lo restaura.",
|
||||
"<strong>Banner de suscripción:</strong> el parche se aplica a la interfaz web de Proxmox Backup Server, y Desinstalar optimizaciones lo restaura.",
|
||||
"<strong>Figurine:</strong> se instala sin los alias de Proxmox VE.",
|
||||
"<strong>Scripts de la comunidad:</strong> la sección ofrece <em>Proxmox Backup Server Post Install</em> y <em>Proxmox Backup Server Microcode</em> en lugar de los scripts de Proxmox VE."
|
||||
"<strong>Scripts comunitarios:</strong> la sección ofrece <em>Proxmox Backup Server Post Install</em> y <em>Proxmox Backup Server Microcode</em> en lugar de los scripts de Proxmox VE."
|
||||
]
|
||||
},
|
||||
"related": {
|
||||
"heading": "Relacionado",
|
||||
"items": [
|
||||
{
|
||||
"label": "Proxmox System Update",
|
||||
"label": "Actualización del sistema Proxmox",
|
||||
"href": "/docs/utils/system-update",
|
||||
"tail": " — mantiene el host actualizado una vez ya se ha hecho la post-instalación."
|
||||
},
|
||||
|
||||
@@ -1,12 +1,12 @@
|
||||
{
|
||||
"meta": {
|
||||
"title": "Post-instalación: Monitorización | ProxMenux Documentation",
|
||||
"description": "Opciones de monitorización en el script post-instalación Customizable de ProxMenux. Por ahora una sola opción: instalar OVH Real-Time Monitoring (RTM), que solo se activa si se detecta que el host es un servidor OVH."
|
||||
"title": "Post-instalación: Monitorización | Documentación de ProxMenux",
|
||||
"description": "Opciones de monitorización en el script post-instalación Personalizable de ProxMenux. Por ahora una sola opción: instalar OVH Real-Time Monitoring (RTM), que solo se activa si se detecta que el host es un servidor OVH."
|
||||
},
|
||||
"header": {
|
||||
"title": "Post-instalación: Monitorización",
|
||||
"description": "Opciones de monitorización dentro del script post-instalación Customizable. Esta categoría es pequeña y específica del proveedor — instala el agente OVH Real-Time Monitoring en servidores dedicados de OVH y no hace nada en cualquier otro sitio.",
|
||||
"section": "Settings post-install Proxmox"
|
||||
"description": "Opciones de monitorización del script post-instalación Personalizable. Esta categoría es pequeña y específica del proveedor: instala el agente OVH Real-Time Monitoring en servidores dedicados de OVH y no hace nada en otros servidores.",
|
||||
"section": "Configuración post instalación de Proxmox"
|
||||
},
|
||||
"intro": {
|
||||
"title": "Alcance estrecho a propósito",
|
||||
@@ -23,15 +23,15 @@
|
||||
"Si el resultado <em>no</em> menciona OVH, no se instala nada. La opción es un no-op."
|
||||
],
|
||||
"remoteTitle": "Script remoto pasado por tubería a bash",
|
||||
"remoteBody": "La instalación ejecuta <code>wget -qO - https://…apply.sh | bash</code>. Si el mirror de OVH se ve comprometido alguna vez, el script se ejecuta como root en tu host. Antes de activar esta opción, decide si confías más en la cadena de mirrors de OVH que en la monitorización que ganas. Para la mayoría de usuarios de home-lab o no-OVH esta opción debería quedarse simplemente apagada.",
|
||||
"remoteBody": "La instalación ejecuta <code>wget -qO - https://…apply.sh | bash</code>. Si el servidor espejo de OVH se ve comprometido, el script se ejecutará como root en tu host. Antes de activar esta opción, valora la confianza en la cadena de servidores espejo de OVH frente al beneficio de monitorización. Para la mayoría de usuarios de laboratorios domésticos o servidores ajenos a OVH, la opción debe permanecer desactivada.",
|
||||
"noOpTitle": "Actívalo solo si el host está realmente en OVH",
|
||||
"noOpBody": "La opción es un no-op en servidores no-OVH, así que marcarla en un Proxmox de home-lab no rompe nada. En un host no-OVH el script imprime <em>\"Not an OVH server, skipping RTM installation\"</em> y termina limpiamente; no se instala ningún paquete.",
|
||||
"noOpBody": "La opción no hace cambios en servidores ajenos a OVH, así que marcarla en un Proxmox doméstico no rompe nada. El script muestra <em>«No es un servidor OVH, se omite la instalación de RTM»</em> y termina sin instalar paquetes.",
|
||||
"runsTitle": "Qué ejecuta ProxMenux",
|
||||
"verifyTitle": "Verificación",
|
||||
"verifyBody": "En un host OVH real, tras un reinicio deberías ver el <a>panel de RTM</a> en tu OVH Manager con datos en vivo del host. En el lado de Proxmox, el colector RTM es un servicio systemd — compruébalo directamente:",
|
||||
"troubleTitle": "Solución de problemas",
|
||||
"revertTitle": "No reversible desde el menú Uninstall",
|
||||
"revertBody": "No hay una entrada de uninstall dedicada para RTM. En un host OVH real, elimina los paquetes a mano con <code>apt purge ovh-*</code> y borra cualquier manifest puppet bajo <code>/etc/puppet/</code> que RTM haya instalado. En un host no-OVH no se instaló nada, así que no hay nada que revertir."
|
||||
"revertTitle": "Eliminar RTM desde el menú Desinstalar",
|
||||
"revertBody": "Cuando RTM está registrado como instalado, Desinstalar optimizaciones ofrece una entrada OVH Real-Time Monitoring. Ejecuta <code>apt-get purge -y ''ovh-rtm*'' ''rtm'' ''rtm-*''</code>, elimina /etc/rtm y marca RTM como desinstalado. Los restos de Puppet pueden requerir limpieza manual; revisa los manifiestos específicos de RTM en <code>/etc/puppet/</code>. En un host ajeno a OVH no se instalaron paquetes RTM, así que no hay nada que eliminar."
|
||||
},
|
||||
"related": {
|
||||
"heading": "Relacionado",
|
||||
@@ -47,7 +47,7 @@
|
||||
"tail": " — referencia de monitorización del host local."
|
||||
},
|
||||
{
|
||||
"label": "Customizable Post-Install",
|
||||
"label": "Post-instalación personalizable",
|
||||
"href": "/docs/post-install/customizable",
|
||||
"tail": " — volver al menú padre."
|
||||
}
|
||||
|
||||
@@ -1,11 +1,11 @@
|
||||
{
|
||||
"meta": {
|
||||
"title": "Post-instalación: Red | ProxMenux Documentation",
|
||||
"description": "Optimizaciones relacionadas con la red en el script post-instalación Customizable de ProxMenux: forzar APT sobre IPv4, aplicar un perfil curado de tuning de sysctl, instalar Open vSwitch, activar TCP BBR + Fast Open, y fijar nombres de interfaz a sus direcciones MAC."
|
||||
"title": "Post-instalación: Red | Documentación de ProxMenux",
|
||||
"description": "Opciones de red de la post-instalación personalizable de ProxMenux: forzar APT sobre IPv4, aplicar un perfil sysctl seleccionado, instalar Open vSwitch, activar TCP BBR + Fast Open y vincular los nombres de interfaz a sus direcciones MAC."
|
||||
},
|
||||
"header": {
|
||||
"title": "Post-instalación: Red",
|
||||
"section": "Settings post-install Proxmox"
|
||||
"section": "Configuración post instalación de Proxmox"
|
||||
},
|
||||
"intro": {
|
||||
"title": "Qué cubre esta categoría",
|
||||
@@ -19,13 +19,13 @@
|
||||
},
|
||||
"sysctl": {
|
||||
"heading": "Aplicar optimizaciones de red",
|
||||
"intro": "Escribe un perfil sysctl curado en <code>/etc/sysctl.d/99-network.conf</code> que cubre buffers de socket core, hardening de ICMP, protección básica contra spoof y tamaños de buffer TCP que tienen sentido en un hipervisor con muchos flujos concurrentes.",
|
||||
"tunedTitle": "Qué se tunea",
|
||||
"intro": "Escribe un perfil sysctl seleccionado en <code>/etc/sysctl.d/99-network.conf</code> que ajusta los búferes de sockets del núcleo, refuerza ICMP, añade protección básica contra suplantación y configura búferes TCP adecuados para un hipervisor con muchos flujos simultáneos.",
|
||||
"tunedTitle": "Qué se ajusta",
|
||||
"headerArea": "Área",
|
||||
"headerSettings": "Ajustes clave",
|
||||
"rows": [
|
||||
{
|
||||
"area": "Buffers de socket core",
|
||||
"area": "Búferes de sockets del núcleo",
|
||||
"settings": "<code>netdev_max_backlog=8192</code>, <code>rmem_max=16M</code>, <code>wmem_max=16M</code>, <code>somaxconn=8192</code>"
|
||||
},
|
||||
{
|
||||
@@ -37,7 +37,7 @@
|
||||
"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": "Reverse path filter",
|
||||
"area": "Filtro de ruta inversa",
|
||||
"settings": "<code>rp_filter=2</code> (modo loose, mira la nota abajo)"
|
||||
},
|
||||
{
|
||||
@@ -64,17 +64,17 @@
|
||||
"intro": "Instala <code>openvswitch-switch</code> + <code>openvswitch-common</code>. Estos paquetes añaden OVS como implementación alternativa de bridges a los bridges Linux estándar que Proxmox usa por defecto. La instalación por sí sola no cambia ninguna configuración de red — los bridges <code>vmbrX</code> existentes siguen funcionando. OVS pasa a estar disponible en la UI de Proxmox cuando <em>creas</em> un bridge nuevo y lo eliges del desplegable de tipo.",
|
||||
"tipTitle": "Cuándo tiene sentido OVS",
|
||||
"tipBody": "Considera OVS si necesitas <strong>trunking VLAN con IDs de VLAN no contiguos</strong>, <strong>LACP con LLDP en modos específicos</strong>, <strong>programación de flujos granular</strong> (OpenFlow), o interoperación con controladores SDN. Para un home lab con un par de VLANs y un único uplink LACP, los bridges Linux estándar + <code>vmbrX.VID</code> son más simples y van perfectamente bien.",
|
||||
"revertTitle": "Reversible desde el menú Uninstall",
|
||||
"revertBody": "OVS está registrado. <link>Uninstall Optimizations</link> ejecuta <code>apt purge</code> sobre <code>openvswitch-switch</code> y <code>openvswitch-common</code>. Migra cualquier bridge OVS de vuelta a bridges Linux <em>antes</em> de desinstalar, si no las VMs sobre esos bridges pierden red en el próximo arranque. Equivalente manual:"
|
||||
"revertTitle": "Reversible desde el menú Desinstalar",
|
||||
"revertBody": "OVS queda registrado. <link>Desinstalar optimizaciones</link> ejecuta <code>apt purge</code> sobre <code>openvswitch-switch</code> y <code>openvswitch-common</code>. Migra los bridges OVS a bridges Linux <em>antes</em> de desinstalar; de lo contrario, sus VM perderán la red en el próximo arranque. Equivalente manual:"
|
||||
},
|
||||
"bbr": {
|
||||
"heading": "Activar TCP BBR + TCP Fast Open",
|
||||
"intro": "Escribe dos archivos sysctl y los recarga. BBR sustituye el control de congestión por defecto CUBIC por el algoritmo basado en ancho de banda de Google, que maneja long-fat pipes y enlaces con pérdidas mucho mejor. TCP Fast Open (TFO) elimina un round trip en conexiones TCP repetidas al transportar datos en el SYN.",
|
||||
"intro": "Escribe dos archivos sysctl y los recarga. BBR sustituye el control de congestión CUBIC por el algoritmo de Google basado en ancho de banda, que gestiona mejor los enlaces de gran capacidad y alta latencia y los enlaces con pérdidas. TCP Fast Open (TFO) elimina un intercambio de ida y vuelta en conexiones TCP repetidas enviando datos en el SYN.",
|
||||
"verifyTitle": "Verificación",
|
||||
"impactTitle": "El impacto depende de la carga",
|
||||
"impactBody": "BBR brilla en enlaces de alta latencia o con pérdidas (replicación intercontinental, túneles VPN, clientes móviles). En una LAN entre dos máquinas en el mismo switch, la diferencia a menudo está dentro del ruido. TFO ayuda más a conexiones HTTP cortas y repetidas.",
|
||||
"revertTitle": "Reversible desde el menú Uninstall",
|
||||
"revertBody": "BBR/TFO están registrados. <link>Uninstall Optimizations</link> elimina los dos ficheros sysctl (<code>/etc/sysctl.d/99-tcp-bbr.conf</code> y <code>99-tcp-fastopen.conf</code>) y recarga sysctl para que el kernel vuelva a <code>cubic</code> y a <code>tcp_fastopen=1</code>. Equivalente manual:"
|
||||
"revertTitle": "Reversible desde el menú Desinstalar",
|
||||
"revertBody": "BBR/TFO quedan registrados. <link>Desinstalar optimizaciones</link> elimina los dos archivos sysctl (<code>/etc/sysctl.d/99-kernel-bbr.conf</code> y <code>99-tcp-fastopen.conf</code>) y recarga la configuración restante. Borrar un archivo no restablece sus valores activos en el núcleo. Los valores predeterminados como <code>cubic</code> y <code>tcp_fastopen=1</code> vuelven tras reiniciar, salvo que otra configuración los sobrescriba. Equivalente manual:"
|
||||
},
|
||||
"names": {
|
||||
"heading": "Nombres de interfaz (persistentes)",
|
||||
@@ -83,17 +83,17 @@
|
||||
"whyItems": [
|
||||
"Añadir o quitar dispositivos PCIe puede desplazar la numeración del bus, convirtiendo <code>enp3s0</code> en <code>enp4s0</code>. Si tu <code>/etc/network/interfaces</code> referencia el nombre antiguo, el bridge desaparece al reiniciar.",
|
||||
"Actualizaciones de BIOS / firmware a veces cambian cómo se enumeran los dispositivos, con el mismo efecto.",
|
||||
"Contenedores LXC con NICs <code>hotplug</code> y enlaces bonded pueden hacer race en el arranque y acabar nombrados de forma inconsistente. Fijarlos lo soluciona."
|
||||
"El auxiliar escribe archivos <code>.link</code> para las NIC físicas, incluidos los puertos de los bonds, con la MAC que muestra sysfs en ese momento; en los puertos de un bond puede ser la MAC compartida del bond, así que comprueba sus nombres tras reiniciar. Omite interfaces virtuales como veth de LXC y los propios dispositivos bond; no corrige carreras de nombres de NIC virtuales <code>hotplug</code>."
|
||||
],
|
||||
"writtenTitle": "Qué se escribe",
|
||||
"writtenIntro": "Un archivo por NIC física, en <code>/etc/systemd/network/10-proxmenux-<iface>.link</code>. Cada archivo comienza con la cabecera <code># Managed by ProxMenux — do not edit</code>, marca que permite a ProxMenux distinguir sus propios archivos de los <code>.link</code> provistos por el usuario o por otros paquetes.",
|
||||
"writtenOutro": "Los archivos <code>.link</code> de otros paquetes o escritos a mano por el usuario se dejan intactos — solo se gestionan los archivos que llevan la cabecera de ProxMenux. En cada nueva ejecución la función reconcilia su propio conjunto: relee <code>MACAddress=</code> de cada <code>10-proxmenux-*.link</code> y elimina los cuya MAC ya no aparece en <code>/sys/class/net/</code>. Los archivos escritos por una versión antigua de ProxMenux en el formato <code>10-<iface>.link</code> se migran automáticamente en la primera ejecución.",
|
||||
"pveTitle": "PVE 9 vs PVE 8",
|
||||
"pveBody": "En Proxmox VE 9 (<code>systemd-networkd</code> nativo), el script recarga las reglas udev tras escribir los archivos <code>.link</code> para que las nuevas NICs hotplug cojan el nombre correcto sin reiniciar. En PVE 8 (<code>ifupdown2</code>), el naming de interfaz se resuelve en el arranque de todos modos — se requiere un reinicio para que los cambios surtan efecto. El script activa el flag de reinicio en cualquier caso para que Personalizable te lo pregunte.",
|
||||
"pveBody": "El script utiliza archivos <code>.link</code> de systemd para los nombres persistentes. En Proxmox VE 9 también recarga las reglas udev al escribirlos, para que una NIC ya fijada que se vuelva a conectar o detectar aplique su regla sin reiniciar. Comprueba las interfaces existentes tras reiniciar tanto en PVE 8 como en PVE 9. Esto no sustituye <code>ifupdown2</code> en el host. El script marca el reinicio como necesario en ambos casos para que la post-instalación personalizable lo solicite.",
|
||||
"reviewTitle": "Revisa antes el /etc/network/interfaces existente",
|
||||
"reviewBody": "Si tu host tiene configuración legacy en <code>/etc/network/interfaces</code> que referencia nombres de NIC generados por el esquema por defecto del kernel, fijar los nombres <em>de hoy</em> es exactamente lo que quieres. Pero si ya has customizado manualmente la configuración alrededor de nombres específicos, comprueba dos veces que el pinning coincide con lo que el archivo interfaces espera antes de reiniciar.",
|
||||
"revertTitle": "Reversible desde el menú Uninstall",
|
||||
"revertBody": "<link>Uninstall Optimizations</link> solo borra los archivos <code>10-proxmenux-*.link</code> que llevan la cabecera de ProxMenux en <code>/etc/systemd/network/</code>. Cualquier archivo <code>.link</code> añadido por el usuario o por otro paquete se preserva. Los nombres de interfaz vuelven al comportamiento por defecto de systemd en el siguiente reinicio."
|
||||
"revertTitle": "Reversible desde el menú Desinstalar",
|
||||
"revertBody": "<link>Desinstalar optimizaciones</link> elimina solo los archivos <code>10-proxmenux-*.link</code> con cabecera ProxMenux de <code>/etc/systemd/network/</code>. Conserva cualquier <code>.link</code> añadido por el usuario u otro paquete. Los nombres vuelven al comportamiento predeterminado de systemd al reiniciar."
|
||||
},
|
||||
"related": {
|
||||
"heading": "Relacionado",
|
||||
@@ -114,12 +114,12 @@
|
||||
"tail": " — ip, ss, ethtool, sysctl."
|
||||
},
|
||||
{
|
||||
"label": "Uninstall Optimizations",
|
||||
"label": "Desinstalar optimizaciones",
|
||||
"href": "/docs/post-install/uninstall",
|
||||
"tail": " — revierte cualquiera de estos cambios de red."
|
||||
},
|
||||
{
|
||||
"label": "Customizable Post-Install",
|
||||
"label": "Post-instalación personalizable",
|
||||
"href": "/docs/post-install/customizable",
|
||||
"tail": " — volver al menú padre."
|
||||
}
|
||||
|
||||
@@ -1,13 +1,13 @@
|
||||
{
|
||||
"meta": {
|
||||
"title": "ProxMenux Post-instalación: Optional Settings",
|
||||
"description": "Guía de Optional Settings en el script post-instalación de ProxMenux para funcionalidades y optimizaciones adicionales de Proxmox VE.",
|
||||
"ogTitle": "ProxMenux Post-instalación: Optional Settings",
|
||||
"ogDescription": "Guía de Optional Settings en el script post-instalación de ProxMenux para funcionalidades y optimizaciones adicionales de Proxmox VE.",
|
||||
"ogImageAlt": "ProxMenux Post-instalación Optional Settings"
|
||||
"title": "Post-instalación de ProxMenux: Ajustes opcionales",
|
||||
"description": "Guía de los ajustes opcionales del script post-instalación de ProxMenux para añadir funciones y optimizaciones a Proxmox VE.",
|
||||
"ogTitle": "Post-instalación de ProxMenux: Ajustes opcionales",
|
||||
"ogDescription": "Guía de los ajustes opcionales del script post-instalación de ProxMenux para añadir funciones y optimizaciones a Proxmox VE.",
|
||||
"ogImageAlt": "Ajustes opcionales post-instalación de ProxMenux"
|
||||
},
|
||||
"title": "Optional Settings",
|
||||
"intro": "La categoría <strong>Optional Settings</strong> ofrece funcionalidades y optimizaciones adicionales que puedes elegir aplicar a tu instalación de Proxmox VE. Estos ajustes no son esenciales pero pueden mejorar las capacidades de tu sistema en escenarios específicos.",
|
||||
"title": "Ajustes opcionales",
|
||||
"intro": "La categoría <strong>Ajustes opcionales</strong> ofrece funciones y optimizaciones adicionales para tu instalación de Proxmox VE. No son esenciales, pero pueden mejorar las capacidades del sistema en situaciones concretas.",
|
||||
"available": "Funcionalidades opcionales disponibles",
|
||||
"stepLabel": "Paso",
|
||||
"ceph": {
|
||||
@@ -24,7 +24,7 @@
|
||||
"automates": "Este ajuste automatiza los siguientes comandos:"
|
||||
},
|
||||
"amd": {
|
||||
"title": "Aplicar fixes para CPUs AMD",
|
||||
"title": "Aplicar correcciones para CPU AMD",
|
||||
"intro": "Esta opción aplica fixes específicos para CPUs AMD EPYC y Ryzen para mejorar la estabilidad y la compatibilidad.",
|
||||
"doesIntro": "Qué hace:",
|
||||
"doesItems": [
|
||||
@@ -32,11 +32,11 @@
|
||||
"Aplica el parámetro de kernel 'idle=nomwait' para prevenir crashes aleatorios (vía /etc/kernel/cmdline en hosts con systemd-boot, o /etc/default/grub en hosts con GRUB — con un .bak del original)",
|
||||
"Configura KVM para que ignore ciertos MSRs (Model Specific Registers) y mejorar la compatibilidad con guests Windows"
|
||||
],
|
||||
"howUse": "Cómo usarlo: Estos fixes se aplican automáticamente y requieren un reinicio del sistema para surtir efecto.",
|
||||
"howUse": "Cómo usarlo: Estas correcciones se aplican automáticamente y requieren reiniciar el sistema para surtir efecto.",
|
||||
"automates": "Este ajuste automatiza los siguientes comandos:"
|
||||
},
|
||||
"ha": {
|
||||
"title": "Activar servicios High Availability",
|
||||
"title": "Activar servicios de alta disponibilidad",
|
||||
"intro": "Esta opción activa los servicios High Availability (HA) en Proxmox VE, permitiendo failover automático de VMs y contenedores en caso de fallo de un nodo.",
|
||||
"doesIntro": "Qué hace:",
|
||||
"doesItems": [
|
||||
@@ -64,8 +64,8 @@
|
||||
"doesLabel": "Qué hace:",
|
||||
"doesItems": [
|
||||
"Descarga e instala silenciosamente la última versión de Fastfetch",
|
||||
"Te permite elegir un logo personalizado (<strong>ProxMenux, Proxmox, Helper-Scripts, Home-Labs-Club, Proxmology</strong>, o uno custom)",
|
||||
"Configura Fastfetch para mostrar <em>\"System optimised by ProxMenux\"</em>",
|
||||
"Permite elegir un logo (<strong>ProxMenux, Proxmox, Helper-Scripts, Home-Labs-Club, Proxmology</strong> o uno personalizado)",
|
||||
"Configura Fastfetch para mostrar <em>«Sistema optimizado por ProxMenux»</em>",
|
||||
"Configura Fastfetch para que se ejecute automáticamente al hacer login en consola"
|
||||
],
|
||||
"importantLabel": "Importante:",
|
||||
@@ -133,7 +133,7 @@
|
||||
},
|
||||
"log2ram": {
|
||||
"title": "Instalar Log2RAM (reducción de desgaste en SSD/NVMe)",
|
||||
"intro": "Log2RAM monta <code>/var/log</code> sobre una ramdisk tmpfs y sincroniza periódicamente el contenido al disco subyacente. En un hipervisor el churn de journald golpea el SSD del sistema cada pocos segundos; mover las escrituras a RAM reduce el desgaste y la I/O de disco sin perder logs — la sincronización periódica los vuelca a disco y un apagado limpio también los vuelca.",
|
||||
"intro": "Log2RAM monta <code>/var/log</code> en una ramdisk tmpfs y lo sincroniza periódicamente al disco. Almacenar temporalmente en RAM las escrituras frecuentes de journald puede reducir el desgaste del SSD y la E/S. La sincronización y un apagado limpio guardan los registros, pero un corte brusco puede perder las entradas posteriores a la última sincronización.",
|
||||
"upstreamLabel": "Proyecto oficial:",
|
||||
"upstreamUrl": "https://github.com/azlux/log2ram",
|
||||
"upstreamLinkLabel": "azlux/log2ram en GitHub",
|
||||
@@ -146,12 +146,12 @@
|
||||
"Instala un guardián de auto-sync en <code>/usr/local/bin/log2ram-check.sh</code>, conectado a <code>/etc/cron.d/log2ram-auto-sync</code> para ejecutarse cada 10 minutos. Cuando <code>/var/log</code> alcanza el 80% del tamaño de la ramdisk el guardián compacta journald; al 92% primero ejecuta <code>logrotate -f /etc/logrotate.d/proxmox-backup-api</code> si ese archivo existe (para forzar la rotación de los logs del API de PBS, que suelen ser los que más crecen en un host con PBS) y a continuación trunca <code>pveproxy access/error</code> y <code>pveam.log</code> antes de sincronizar. El comando <code>log2ram write</code> por sí solo copia tmpfs a disco pero NO reduce la tmpfs, así que este guardián evita que PVE caiga con <em>No space left on device</em> cuando los logs crecen sin control.",
|
||||
"Detecta si <code>proxmox-backup-server</code> corre como servicio en el host. Cuando está presente, deposita <code>/etc/logrotate.d/proxmox-backup-api</code> (rotación de 20 MB × 3) y <code>/etc/cron.hourly/proxmox-backup-logrotate</code>, de forma que los logs del API de PBS — el origen habitual del crecimiento en un host con PBS — queden acotados incluso entre las sincronizaciones periódicas de Log2RAM. En hosts sin PBS este paso es un no-op.",
|
||||
"Ajusta los límites de systemd-journald (<code>SystemMaxUse</code>, <code>RuntimeMaxUse</code>) para que quepan en la ramdisk y así una ráfaga puntual no la llene.",
|
||||
"Se registra en <code>installed_tools.json</code> para poder revertirlo desde Uninstall Optimizations."
|
||||
"Se registra en <code>installed_tools.json</code> para poder revertirlo desde Desinstalar optimizaciones."
|
||||
],
|
||||
"howUseLabel": "Cómo se usa:",
|
||||
"howUseBody": "En el flujo Automatizado Log2RAM se aplica sin intervención cuando se detecta un disco raíz SSD/NVMe. En el flujo Personalizable el script pregunta por el tamaño, el intervalo de sincronización y si activar el guardián de auto-sync al 90%.",
|
||||
"howUseBody": "En el flujo automatizado Log2RAM se instala sin intervención al detectar un disco raíz SSD/NVMe. El personalizable pregunta por tamaño, intervalo y activación del auxiliar de sincronización. El mensaje indica 90%, pero el auxiliar generado usa los umbrales de limpieza del 80% y actuación intensiva del 92% descritos arriba.",
|
||||
"verifyLabel": "Verificar y gestionar desde la shell:",
|
||||
"verifyCode": "# Estado del servicio y timers configurados\nsystemctl status log2ram\nsystemctl list-timers log2ram*\n\n# Uso actual de la ramdisk — /var/log ES la tmpfs\ndf -h /var/log\n\n# Forzar sincronización ahora (tmpfs → disco); NO reduce la tmpfs\nlog2ram write\n\n# Disparar el guardián de auto-sync manualmente (compacta + sincroniza si el uso es alto)\n/usr/local/bin/log2ram-check.sh\n\n# Configuración actual: SIZE, mail, path\ncat /etc/log2ram.conf\n\n# Crons específicos de ProxMenux\ncat /etc/cron.d/log2ram /etc/cron.d/log2ram-auto-sync\n\n# Actividad reciente de Log2RAM\njournalctl -u log2ram -n 50 --no-pager"
|
||||
"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": "Activar el perfil de swap con ZRAM",
|
||||
@@ -163,15 +163,15 @@
|
||||
"Con esa prioridad el kernel llena primero ZRAM. Un swap en disco que ya exista conserva su prioridad y recibe las páginas que ya no caben en ZRAM.",
|
||||
"Antes de cambiar nada, busca otra configuración de ZRAM: un swap zram activo, una línea zram en <code>/etc/fstab</code>, una unidad de systemd u otro fichero del generador. Si encuentra una, la opción se detiene y la deja como está.",
|
||||
"Arranca <code>dev-zram0.swap</code> y comprueba que el dispositivo activo coincide con el perfil. Si no coincide, se restaura el estado anterior.",
|
||||
"Se registra en <code>installed_tools.json</code> para poder revertirlo desde Uninstall Optimizations."
|
||||
"Se registra en <code>installed_tools.json</code> para poder revertirlo desde Desinstalar optimizaciones."
|
||||
],
|
||||
"howUseLabel": "Cómo se usa:",
|
||||
"howUseBody": "La opción solo forma parte del flujo Personalizable; el flujo Automatizado no la aplica. El dispositivo se crea de nuevo en cada arranque. Mientras está activo, la tarjeta de Memoria del ProxMenux Monitor muestra su capacidad, el swap usado, el algoritmo, la relación de compresión y la memoria física que ocupa.",
|
||||
"verifyLabel": "Verificar desde la shell:",
|
||||
"verifyCode": "# Dispositivos de swap activos y su prioridad\nswapon --show\n\n# Dispositivo ZRAM: algoritmo, tamaño y datos comprimidos\nzramctl\n\n# Perfil escrito por ProxMenux\ncat /etc/systemd/zram-generator.conf.d/90-proxmenux.conf\n\n# Estado de la unidad de swap\nsystemctl status dev-zram0.swap"
|
||||
"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": "Aplicación automática",
|
||||
"body": "Estas funcionalidades opcionales solo se aplican cuando se seleccionan específicamente durante el proceso post-instalación. Cada funcionalidad puede elegirse individualmente según tus necesidades y preferencias específicas."
|
||||
"body": "En el flujo personalizable, selecciona cada función opcional según tus necesidades. Log2RAM también forma parte del automatizado con detección de hardware; ZRAM es exclusivo del personalizable. Revisa cada sección para conocer las preguntas y requisitos."
|
||||
}
|
||||
}
|
||||
|
||||
@@ -1,12 +1,12 @@
|
||||
{
|
||||
"meta": {
|
||||
"title": "Post-instalación: Rendimiento | ProxMenux Documentation",
|
||||
"description": "Opciones de rendimiento en el script post-instalación Customizable de ProxMenux. Sustituye gzip de un solo hilo por pigz (gzip paralelo) para backups y compresión más rápidos en hosts multinúcleo."
|
||||
"title": "Post-instalación: Rendimiento | Documentación de ProxMenux",
|
||||
"description": "Opciones de rendimiento en el script post-instalación Personalizable de ProxMenux. Sustituye gzip de un solo hilo por pigz (gzip paralelo) para backups y compresión más rápidos en hosts multinúcleo."
|
||||
},
|
||||
"header": {
|
||||
"title": "Post-instalación: Rendimiento",
|
||||
"description": "Opciones de rendimiento dentro del script post-instalación Customizable. Por ahora esta categoría contiene una sola optimización: sustituir gzip por pigz para que los backups y la compresión usen todos los núcleos de la CPU en lugar de uno.",
|
||||
"section": "Settings post-install Proxmox"
|
||||
"description": "Opciones de rendimiento del script post-instalación Personalizable. Esta categoría contiene una sola optimización: sustituir gzip por pigz para que los backups y la compresión usen todos los núcleos de la CPU en lugar de uno.",
|
||||
"section": "Configuración post instalación de Proxmox"
|
||||
},
|
||||
"intro": {
|
||||
"title": "Qué cubre esta categoría",
|
||||
@@ -16,7 +16,7 @@
|
||||
"heading": "Usar pigz para compresión gzip más rápida",
|
||||
"intro": "El <code>gzip</code> estándar comprime datos usando <strong>un solo núcleo de CPU</strong>. En hosts Proxmox modernos con 8, 16 o 32 núcleos, eso es un cuello de botella enorme durante backups <code>vzdump</code> de VM/CT, rotación de logs y cualquier otra cosa que pase por <code>gzip</code>. <a>pigz</a> es un reemplazo paralelo drop-in: misma salida compatible con gzip, pero reparte el trabajo entre todos los núcleos.",
|
||||
"doesTitle": "Qué hace ProxMenux",
|
||||
"doesIntro": "Cuatro pasos, todos idempotentes:",
|
||||
"doesIntro": "Cinco pasos, todos idempotentes:",
|
||||
"doesItems": [
|
||||
"Establece <code>pigz: 1</code> en <code>/etc/vzdump.conf</code> para que la herramienta de backup de Proxmox use pigz de forma nativa.",
|
||||
"Instala el paquete apt <code>pigz</code> si no está presente.",
|
||||
@@ -26,8 +26,8 @@
|
||||
],
|
||||
"replacesTitle": "Esto sustituye un binario del sistema",
|
||||
"replacesBody": "Colocar un wrapper en el lugar de <code>gzip</code> es inusual. Es seguro (el wrapper produce salida compatible con gzip), pero conviene saberlo: scripts que tengan paths hardcodeados, que se ejecuten dentro de chroots restrictivos o que verifiquen hashes de binarios pueden comportarse de forma distinta. El binario real se conserva como <code>gzip.distrib</code> y, al ser una desviación de dpkg, una actualización del paquete <code>gzip</code> — o la actualización de Proxmox VE 8 a 9 — actualiza ese fichero y deja el wrapper en su sitio.",
|
||||
"revertTitle": "Reversible desde el menú Uninstall",
|
||||
"revertBody": "Esta optimización está registrada. <link>Uninstall Optimizations</link> copia el binario real desde <code>gzip.distrib</code> sobre el wrapper, elimina la desviación y el <code>pigzwrapper</code>, comenta la línea <code>pigz</code> de <code>/etc/vzdump.conf</code> y ejecuta <code>apt purge pigz</code> una vez verificado que gzip funciona. Equivalente manual en Proxmox VE 9:",
|
||||
"revertTitle": "Reversible desde el menú Desinstalar",
|
||||
"revertBody": "Esta optimización está registrada. <link>Desinstalar optimizaciones</link> copia el binario real desde <code>gzip.distrib</code> sobre el wrapper, elimina la desviación y el <code>pigzwrapper</code>, comenta la línea <code>pigz</code> de <code>/etc/vzdump.conf</code> y ejecuta <code>apt purge pigz</code> tras verificar que gzip funciona. Equivalente manual en Proxmox VE 9:",
|
||||
"verifyTitle": "Verificación",
|
||||
"verifyBody": "Tras aplicar, <code>gzip --version</code> debería mencionar pigz. Un benchmark rápido también muestra la diferencia de velocidad en un host multinúcleo:",
|
||||
"whenTitle": "Cuándo importa más",
|
||||
@@ -52,7 +52,7 @@
|
||||
"tail": " — tuning de descriptores de fichero y de memoria."
|
||||
},
|
||||
{
|
||||
"label": "Customizable Post-Install",
|
||||
"label": "Post-instalación personalizable",
|
||||
"href": "/docs/post-install/customizable",
|
||||
"tail": " — volver al menú padre."
|
||||
}
|
||||
|
||||
@@ -1,15 +1,15 @@
|
||||
{
|
||||
"meta": {
|
||||
"title": "Post-instalación: Seguridad | ProxMenux Documentation",
|
||||
"description": "Opciones de seguridad disponibles en el script post-instalación Customizable de ProxMenux. Por ahora una sola opción: desactivar el servicio portmapper/rpcbind para reducir la superficie de ataque del host."
|
||||
"title": "Post-instalación: Seguridad | Documentación de ProxMenux",
|
||||
"description": "Opciones de seguridad disponibles en el script post-instalación Personalizable de ProxMenux. Por ahora una sola opción: desactivar el servicio portmapper/rpcbind para reducir la superficie de ataque del host."
|
||||
},
|
||||
"header": {
|
||||
"title": "Post-instalación: Seguridad",
|
||||
"section": "Settings post-install Proxmox"
|
||||
"section": "Configuración post instalación de Proxmox"
|
||||
},
|
||||
"intro": {
|
||||
"title": "Qué cubre esta categoría",
|
||||
"body": "La seguridad post-instalación se limita al <strong>hardening del host que es seguro aplicar sin supervisión</strong> — cosas que desactivan servicios que casi nadie necesita y que se pueden deshacer desde el menú Uninstall. Las herramientas de seguridad activa (Fail2Ban para prevención de intrusiones, Lynis para auditoría) viven bajo la entrada dedicada <em>Seguridad</em> del menú principal de ProxMenux, no aquí en post-instalación."
|
||||
"body": "La seguridad post-instalación se limita al <strong>refuerzo del host que se puede aplicar sin supervisión de forma segura</strong>: desactivar servicios que casi nadie necesita y poder revertirlo desde Desinstalar. Las herramientas de seguridad activa (Fail2Ban para prevenir intrusiones y Lynis para auditorías) están en la entrada <em>Seguridad</em> del menú principal de ProxMenux, fuera de la post-instalación."
|
||||
},
|
||||
"rpcbind": {
|
||||
"heading": "Desactivar portmapper / rpcbind",
|
||||
@@ -27,7 +27,7 @@
|
||||
"verifyTitle": "Verificación",
|
||||
"verifyBody": "Tras aplicar, confirma que <code>rpcbind</code> está apagado y que nada escucha en el puerto 111:",
|
||||
"reversibleTitle": "Restaura el estado original del servicio",
|
||||
"reversibleBody": "El cambio queda registrado en <code>installed_tools.json</code>. <link>Uninstall Optimizations</link> devuelve cada unidad de rpcbind al estado habilitado o deshabilitado y activo o inactivo que tenía antes de aplicar ProxMenux; no presupone que rpcbind estuviera habilitado en todos los hosts."
|
||||
"reversibleBody": "El cambio queda registrado en <code>installed_tools.json</code>. <link>Desinstalar optimizaciones</link> devuelve cada unidad de rpcbind al estado habilitado o deshabilitado y activo o inactivo que tenía antes de aplicar ProxMenux; no presupone que rpcbind estuviera habilitado en todos los hosts."
|
||||
},
|
||||
"related": {
|
||||
"heading": "Relacionado",
|
||||
@@ -48,7 +48,7 @@
|
||||
"tail": " — estado de servicios, journalctl, referencia de lynis audit."
|
||||
},
|
||||
{
|
||||
"label": "Customizable Post-Install",
|
||||
"label": "Post-instalación personalizable",
|
||||
"href": "/docs/post-install/customizable",
|
||||
"tail": " — volver al menú padre."
|
||||
}
|
||||
|
||||
@@ -1,24 +1,24 @@
|
||||
{
|
||||
"meta": {
|
||||
"title": "Post-instalación: Almacenamiento | ProxMenux Documentation",
|
||||
"title": "Post-instalación: Almacenamiento | Documentación de ProxMenux",
|
||||
"description": "Optimizaciones de almacenamiento en el script post-instalación Customizable de ProxMenux: dimensionado del ARC de ZFS basado en la RAM del host, zfs-auto-snapshot para snapshots periódicas, y eliminación de los límites de velocidad de backups vzdump."
|
||||
},
|
||||
"header": {
|
||||
"title": "Post-instalación: Almacenamiento",
|
||||
"section": "Settings post-install Proxmox"
|
||||
"section": "Configuración post instalación de Proxmox"
|
||||
},
|
||||
"intro": {
|
||||
"title": "Qué cubre esta categoría",
|
||||
"body": "Cuatro optimizaciones relacionadas con almacenamiento: tunear el tamaño de la caché <strong>ARC de ZFS</strong> a una fracción sensata de la RAM del host, instalar y programar <strong>auto-snapshots de ZFS</strong>, activar <strong>autotrim de ZFS</strong> en pools SSD/NVMe y eliminar throttles de <strong>vzdump</strong> para que los backups corran a máxima velocidad. Las cuatro son independientes — elige las que se ajusten a tu setup. Una quinta optimización cercana al almacenamiento, <link>Log2RAM</link>, reduce el desgaste del SSD/NVMe moviendo <code>/var/log</code> a una ramdisk — vive en la página Optional porque el menú Personalizable de ProxMenux la agrupa allí."
|
||||
},
|
||||
"trackedTitle": "Las cuatro están registradas en el menú Uninstall",
|
||||
"trackedBody": "Cada una de estas opciones registra un tool en <code>installed_tools.json</code>, así que aparecen en <link>Uninstall Optimizations</link>. Revertir <code>zfs_arc</code> elimina <code>/etc/modprobe.d/99-zfsarc.conf</code> y reconstruye initramfs; <code>zfs_auto_snapshot</code> revierte la programación cron y ofrece purgar el paquete; <code>zfs_autotrim</code> pone <code>autotrim=off</code> en los pools que activó; <code>vzdump_speed</code> restaura <code>/etc/vzdump.conf</code> desde el <code>.bak</code> que la instalación creó.",
|
||||
"trackedTitle": "Las cuatro se registran en el menú Desinstalar",
|
||||
"trackedBody": "Cada una de estas opciones registra un tool en <code>installed_tools.json</code>, así que aparecen en <link>Desinstalar optimizaciones</link>. Revertir <code>zfs_arc</code> elimina <code>/etc/modprobe.d/99-zfsarc.conf</code> y reconstruye initramfs; <code>zfs_auto_snapshot</code> revierte la programación cron y ofrece purgar el paquete; <code>zfs_autotrim</code> pone <code>autotrim=off</code> en los pools que activó; <code>vzdump_speed</code> restaura <code>/etc/vzdump.conf</code> desde el <code>.bak</code> que la instalación creó.",
|
||||
"arc": {
|
||||
"heading": "Optimizar el tamaño del ARC de ZFS",
|
||||
"intro": "El <strong>Adaptive Replacement Cache (ARC)</strong> es la caché de lectura en memoria de ZFS. Sin tuning explícito, ZFS coge alegremente hasta la mitad de la RAM del host para sí mismo, lo que es excesivo en un host Proxmox que también necesita memoria para VMs y LXCs. Esta opción limita el ARC a una fracción sensata de la RAM total según el tamaño de la máquina.",
|
||||
"intro": "La <strong>Adaptive Replacement Cache (ARC)</strong> es la caché de lectura en memoria de ZFS. Las instalaciones Proxmox VE desde 8.1 fijan un límite del 10% de RAM, con máximo 16 GiB; hosts antiguos o actualizados pueden diferir. Esta opción escribe esa misma política de forma explícita (RAM/10, con un máximo de 16 GiB y un mínimo de 64 MiB) en su propio archivo, lo que cubre también hosts antiguos o actualizados. Revisa ajustes y carga: una caché menor no siempre es más rápida.",
|
||||
"sizingTitle": "Reglas de dimensionado",
|
||||
"headerRam": "RAM del host",
|
||||
"headerMax": "Cap ARC",
|
||||
"headerMax": "Límite del ARC",
|
||||
"rows": [
|
||||
{
|
||||
"ram": "Fórmula",
|
||||
@@ -41,12 +41,12 @@
|
||||
"max": "16 GiB (tope)"
|
||||
}
|
||||
],
|
||||
"after": "El archivo <code>/etc/modprobe.d/99-zfsarc.conf</code> contiene una única directiva — <code>options zfs zfs_arc_max=…</code>. El resto de parámetros del módulo (<code>zfs_arc_min</code>, prefetch/write throttle de L2ARC, timeout de TXG) se dejan en los valores por defecto de OpenZFS. Antes de escribir, un paso de reconciliación escanea otros <code>*.conf</code> en <code>/etc/modprobe.d/</code> que definan <code>zfs_arc_min</code> / <code>zfs_arc_max</code>, los respalda a <code>/usr/local/share/proxmenux/backups/zfs_arc/</code> con un manifest, y elimina las líneas en conflicto para que solo quede activo el fichero de ProxMenux. Tras escribir el archivo, ProxMenux ejecuta <code>update-initramfs -u -k all</code> y, cuando corresponde, <code>proxmox-boot-tool refresh</code>, para que el cap llegue también al initramfs que usan las instalaciones con ZFS-on-root.",
|
||||
"after": "El archivo <code>/etc/modprobe.d/99-zfsarc.conf</code> contiene solo <code>options zfs zfs_arc_max=…</code>. Esta opción no ajusta otros parámetros ZFS (<code>zfs_arc_min</code>, lectura anticipada/límite de escritura L2ARC, tiempo de espera TXG). Antes busca otros <code>*.conf</code> en <code>/etc/modprobe.d/</code> que definan <code>zfs_arc_min</code> / <code>zfs_arc_max</code>, los copia con un manifiesto a <code>/usr/local/share/proxmenux/backups/zfs_arc/</code> y elimina de ellos los valores <code>zfs_arc_min</code> / <code>zfs_arc_max</code> en conflicto (el resto de opciones de esas líneas se conserva), para que solo el archivo ARC de ProxMenux fije el límite. Después ejecuta <code>update-initramfs -u -k all</code> y, si procede, <code>proxmox-boot-tool refresh</code> para incorporar el límite al initramfs de los sistemas con raíz ZFS.",
|
||||
"rebootTitle": "Requiere reinicio para surtir efecto",
|
||||
"rebootBody": "Los ajustes del ARC se leen cuando se carga el módulo del kernel <code>zfs</code>. Para que el cap se aplique en hosts ZFS-on-root, ProxMenux regenera el initramfs con <code>update-initramfs -u -k all</code> y, cuando corresponde, refresca el cargador de arranque con <code>proxmox-boot-tool refresh</code>. Un reinicio sigue siendo necesario para que el módulo relea el parámetro; el flag de \"se requiere reinicio\" se activa automáticamente.",
|
||||
"safeTitle": "Seguro en hosts sin ZFS",
|
||||
"safeBody": "La función solo escribe la configuración cuando <code>zpool list</code> reporta al menos un pool ZFS importado. En hosts Proxmox solo ext4 / LVM, o en máquinas con las utilidades ZFS instaladas pero sin ningún pool importado, marcar esta opción es un no-op — no se escribe nada.",
|
||||
"verifyTitle": "Verificación y rollback manual"
|
||||
"verifyTitle": "Verificación y reversión manual"
|
||||
},
|
||||
"autoSnap": {
|
||||
"heading": "Instalar ZFS auto-snapshot",
|
||||
@@ -57,27 +57,27 @@
|
||||
"headerKept": "Snapshots conservadas",
|
||||
"rows": [
|
||||
{
|
||||
"label": "frequent",
|
||||
"label": "frecuentes",
|
||||
"runs": "cada 15 min",
|
||||
"kept": "4"
|
||||
},
|
||||
{
|
||||
"label": "hourly",
|
||||
"label": "horaria",
|
||||
"runs": "cada hora",
|
||||
"kept": "1"
|
||||
},
|
||||
{
|
||||
"label": "daily",
|
||||
"label": "diario",
|
||||
"runs": "una vez al día",
|
||||
"kept": "1"
|
||||
},
|
||||
{
|
||||
"label": "weekly",
|
||||
"label": "semanales",
|
||||
"runs": "una vez por semana",
|
||||
"kept": "1"
|
||||
},
|
||||
{
|
||||
"label": "monthly",
|
||||
"label": "mensual",
|
||||
"runs": "una vez al mes",
|
||||
"kept": "1"
|
||||
}
|
||||
@@ -86,26 +86,26 @@
|
||||
"conservativeBody": "ProxMenux viene con una retención conservadora (solo 4 frequent + 1 de cada intervalo más largo) para que el almacenamiento de snapshots de ZFS no se infle. Si quieres una retención mayor, edita los números en <code>/etc/cron.d/zfs-auto-snapshot</code>, <code>/etc/cron.hourly/zfs-auto-snapshot</code>, etc. después de ejecutar el script.",
|
||||
"onlyZfsTitle": "Solo útil en pools ZFS",
|
||||
"onlyZfsBody": "Instalar el paquete en un host solo ext4 es inofensivo pero inútil — no hay datasets ZFS de los que tomar snapshot. Sáltate esta opción si no usas ZFS.",
|
||||
"verifyTitle": "Verificación y rollback manual"
|
||||
"verifyTitle": "Verificación y reversión manual"
|
||||
},
|
||||
"autotrim": {
|
||||
"heading": "Activar ZFS autotrim (pools SSD/NVMe)",
|
||||
"intro": "Activa la propiedad <code>autotrim</code> en cada pool ZFS que esté respaldado exclusivamente por SSDs o NVMe con soporte TRIM. Los pools que incluyen un solo vdev HDD se saltan automáticamente — TRIM en discos rotacionales no tiene sentido y ZFS lo rechazará. Los pools que ya estaban configurados con <code>autotrim=on</code> se dejan como están.",
|
||||
"intro": "Activa <code>autotrim</code> en pools ZFS formados exclusivamente por SSD o NVMe compatibles con TRIM. El script omite por precaución los pools con algún dispositivo rotacional. Conserva los pools que ya tenían <code>autotrim=on</code>.",
|
||||
"trimTitle": "Qué hace TRIM, y por qué importa en ZFS",
|
||||
"trimBody1": "Las SSDs / NVMe gestionan el almacenamiento interno en erase blocks de tamaño fijo que son mucho mayores que los sectores lógicos con los que habla el sistema de archivos. Cuando un sistema de archivos borra un archivo, el disco no lo sabe — sigue pensando que esos sectores están en uso, así que su garbage collector interno sigue moviendo datos obsoletos para liberar nuevos erase blocks. <strong>TRIM</strong> es el comando estándar que el SO usa para decirle al disco \"estos sectores ya están libres, puedes borrarlos por adelantado\".",
|
||||
"trimBody2": "Sin TRIM, el rendimiento de la SSD se degrada con el tiempo a medida que el disco se queda sin bloques pre-borrados y tiene que hacer erase-on-write, y la amplificación de escritura aumenta — ambas cosas acortan la vida útil del disco. Con TRIM activado, el disco puede mantener un pool saludable de bloques vacíos listos para escribir.",
|
||||
"trimBody3": "En ZFS, <code>autotrim=on</code> es el equivalente moderno del comando periódico <code>zpool trim <pool></code> — en lugar de tener que acordarte de ejecutar un trim manualmente (o programar uno), el pool emite comandos TRIM automáticamente y de forma continua a medida que los bloques se liberan. Es de bajo overhead y es el ajuste recomendado para pools respaldados por SSD.",
|
||||
"trimBody3": "Con <code>autotrim=on</code>, ZFS aplica TRIM en segundo plano al espacio liberado recientemente, agrupando rangos. Otra opción es <code>zpool trim <pool></code> periódico. Autotrim evita otra programación, pero su impacto depende del dispositivo; el TRIM manual periódico puede ir mejor en algunas unidades modestas.",
|
||||
"practicalTitle": "¿Por qué es práctico activarlo?",
|
||||
"practicalItems": [
|
||||
"<strong>Rendimiento de escritura sostenido.</strong> Las SSDs que nunca ven comandos TRIM se ralentizan de forma medible con los meses. Autotrim le facilita el trabajo a la controladora.",
|
||||
"<strong>Longevidad del disco.</strong> Menor amplificación de escritura significa menos escrituras NAND totales para la misma cantidad de datos — medible en años de vida útil del disco.",
|
||||
"<strong>Rendimiento de escritura sostenido.</strong> TRIM puede ayudar al disco a recuperar bloques sin uso. El beneficio y el impacto en latencia dependen del dispositivo y la carga.",
|
||||
"<strong>Vida útil del disco.</strong> Evitar copias internas innecesarias puede reducir la amplificación de escritura y el desgaste NAND. No garantiza una cantidad concreta de vida adicional.",
|
||||
"<strong>Sin cron programado que recordar.</strong> A diferencia de un <code>zpool trim</code> periódico, autotrim es fire-and-forget — el pool lo maneja por su cuenta."
|
||||
],
|
||||
"whenTitle": "¿Cuándo es necesario?",
|
||||
"whenIntro1": "<strong>Deberías activarlo</strong> en cualquier pool ZFS cuyos vdevs sean todos SSD o NVMe con soporte TRIM — la instalación típica de Proxmox sobre SSDs de consumo o enterprise.",
|
||||
"whenIntro1": "<strong>Considera activarlo</strong> en pools ZFS solo con SSD/NVMe compatibles con TRIM. Comprueba el comportamiento y la latencia; algunos equipos funcionan mejor con TRIM manual programado.",
|
||||
"whenIntro2": "<strong>El script se lo salta automáticamente</strong> en:",
|
||||
"whenSkipItems": [
|
||||
"Pools que contienen cualquier vdev HDD (rotacional) — TRIM no tiene sentido allí.",
|
||||
"Pools con algún vdev HDD rotacional: un filtro conservador de hardware del script.",
|
||||
"Discos sin <code>discard_granularity</code> expuesto en sysfs — normalmente SSDs viejas sin TRIM, o rutas pass-through donde el SO no puede ver el dispositivo subyacente.",
|
||||
"Pools donde ZFS mismo reporta la propiedad como no soportada (raro; pools muy antiguos).",
|
||||
"Pools ya configurados con <code>autotrim=on</code> (no-op)."
|
||||
@@ -115,19 +115,19 @@
|
||||
"recordedBody": "La función solo escribe un pool en su archivo de estado interno (<code>/usr/local/share/proxmenux/zfs_autotrim_pools</code>) cuando ha cambiado activamente ese pool de <code>off</code> a <code>on</code>. Los pools que ya tenías con autotrim antes de ejecutar el script se dejan fuera de la lista, para que un futuro Uninstall no apague ajustes que tú mismo configuraste — solo se revierten los cambios propios de ProxMenux.",
|
||||
"manualTitle": "Equivalente manual (ejecuta en tu servidor)",
|
||||
"manualIntro": "La secuencia completa que el script ejecuta contra cada pool es replicable a mano. Esto es lo que escribirías si quisieras hacer lo mismo en un solo pool sin ProxMenux:",
|
||||
"verifyTitle": "Verificación y rollback manual",
|
||||
"verifyTitle": "Verificación y reversión manual",
|
||||
"oneShotTitle": "¿Necesitas un trim puntual en lugar de continuo?",
|
||||
"oneShotBody": "Algunos operadores prefieren un trim manual durante horas de baja carga en lugar de actividad de trim continua. Desactiva autotrim y programa un cron que ejecute <code>zpool trim <pool></code> — mismo objetivo final, distinta cadencia."
|
||||
"oneShotBody": "Algunos usuarios prefieren un trim manual durante horas de baja carga en lugar de actividad de trim continua. Desactiva autotrim y programa un cron que ejecute <code>zpool trim <pool></code> — mismo objetivo final, distinta cadencia."
|
||||
},
|
||||
"vzdump": {
|
||||
"heading": "Aumentar la velocidad de backup de vzdump",
|
||||
"intro": "Por defecto, vzdump de Proxmox throttlea los backups para proteger las VMs/CTs en ejecución de inanición de IO. En muchos setups ese throttle es más conservador de lo necesario. Esta opción quita el cap de ancho de banda y baja la prioridad de I/O para que vzdump pueda saturar el path de almacenamiento durante las ventanas de backup.",
|
||||
"intro": "Escribe bwlimit: 0 e ionice: 5 en la configuración global de vzdump. Proxmox ya usa ancho de banda sin límite por defecto: solo elimina un límite si estaba configurado. Frente al ionice: 7 predeterminado, 5 da mayor prioridad de E/S de mejor esfuerzo cuando el planificador la respeta. Puede afectar a los huéspedes y no garantiza backups más rápidos.",
|
||||
"changedTitle": "Qué se cambia en /etc/vzdump.conf",
|
||||
"backupTitle": "La primera ejecución crea un .bak de vzdump.conf",
|
||||
"backupBody": "La primera vez que se ejecuta esta opción, ProxMenux copia <code>/etc/vzdump.conf</code> a <code>/etc/vzdump.conf.bak</code> antes de tocarlo. Las ejecuciones siguientes reutilizan ese backup y no lo sobrescriben, para que una configuración editada a mano previa a la primera aplicación se pueda recuperar. Los cambios sobre <code>bwlimit</code> y <code>ionice</code> se hacen con <code>sed</code>, y cualquier otra opción del fichero (compress, pigz, tmpdir, exclude-path, etc.) se preserva.",
|
||||
"skipTitle": "Cuándo saltárselo",
|
||||
"skipBody": "En un host con almacenamiento local lento y VMs sensibles a la latencia, quitar el cap de ancho de banda puede causar ralentizaciones notables durante los backups. Si previamente has puesto un <code>bwlimit</code> específico por esa razón, mantenlo — sáltate esta opción.",
|
||||
"verifyTitle": "Verificación y rollback manual"
|
||||
"verifyTitle": "Verificación y reversión manual"
|
||||
},
|
||||
"related": {
|
||||
"heading": "Relacionado",
|
||||
@@ -145,10 +145,10 @@
|
||||
{
|
||||
"label": "Comandos de backup y restauración",
|
||||
"href": "/docs/help-info/backup-commands",
|
||||
"tail": " — referencia de la CLI de vzdump (ahora sin los caps legacy de bwlimit / ionice)."
|
||||
"tail": " — referencia de la CLI de vzdump para ancho de banda y prioridad de E/S."
|
||||
},
|
||||
{
|
||||
"label": "Uninstall Optimizations",
|
||||
"label": "Desinstalar optimizaciones",
|
||||
"href": "/docs/post-install/uninstall",
|
||||
"tail": " — revierte cambios de ARC / vzdump."
|
||||
},
|
||||
@@ -158,7 +158,7 @@
|
||||
"tail": " — reduce el desgaste del SSD/NVMe usando una ramdisk para /var/log; documentado en Optional."
|
||||
},
|
||||
{
|
||||
"label": "Customizable Post-Install",
|
||||
"label": "Post-instalación personalizable",
|
||||
"href": "/docs/post-install/customizable",
|
||||
"tail": " — volver al menú padre."
|
||||
}
|
||||
|
||||
@@ -1,11 +1,11 @@
|
||||
{
|
||||
"meta": {
|
||||
"title": "Post-instalación: Sistema | ProxMenux Documentation",
|
||||
"title": "Post-instalación: Sistema | Documentación de ProxMenux",
|
||||
"description": "Optimizaciones a nivel de sistema en el script post-instalación Customizable de ProxMenux: límites de tamaño de journald y logrotate, límites de kernel y descriptores de fichero más altos, tuning de memoria balanceado, kexec para reinicios rápidos, y recuperación ante kernel panic."
|
||||
},
|
||||
"header": {
|
||||
"title": "Post-instalación: Sistema",
|
||||
"section": "Settings post-install Proxmox"
|
||||
"section": "Configuración post instalación de Proxmox"
|
||||
},
|
||||
"intro": {
|
||||
"title": "Qué cubre esta categoría",
|
||||
@@ -17,7 +17,7 @@
|
||||
"keyTitle": "Valores clave",
|
||||
"keyItems": [
|
||||
"<code>Storage=persistent</code> — conservar logs en disco entre reinicios.",
|
||||
"<code>SystemMaxUse=64M</code> / <code>RuntimeMaxUse=60M</code> — caps duros sobre el uso de disco/memoria del journal.",
|
||||
"<code>SystemMaxUse=64M</code> / <code>RuntimeMaxUse=60M</code> — límites de uso de disco y memoria del journal.",
|
||||
"<code>Compress=yes</code>, <code>Seal=no</code> — comprimir logs, saltar el forward-secure sealing (ahorra CPU).",
|
||||
"<code>MaxLevelStore=info</code> — almacenar info y superiores (requerido para el visor de logs del ProxMenux Monitor y para que Fail2Ban detecte fallos de autenticación SSH/Proxmox desde el journal).",
|
||||
"Límite de frecuencia: <code>1000 events / 30 s</code> para evitar una avalancha de registros.",
|
||||
@@ -28,9 +28,9 @@
|
||||
},
|
||||
"logrotate": {
|
||||
"heading": "Optimizar logrotate",
|
||||
"intro": "Reescribe <code>/etc/logrotate.conf</code> con una política más estricta adecuada para un host que también forma parte de un setup Log2RAM de protección de SSD: rotación diaria, retención de 7 días, trigger de tamaño 10 MB, compresión, y <code>copytruncate</code> para que los servicios activos sigan escribiendo sin reabrir sus archivos de log. El <code>logrotate.conf</code> original se respalda en <code>.bak</code> en la primera aplicación.",
|
||||
"intro": "Reescribe <code>/etc/logrotate.conf</code> con ajustes globales de frecuencia diaria y tamaño, 7 rotaciones conservadas, compresión y <code>copytruncate</code> para que los servicios sigan escribiendo sin reabrir los archivos. El tamaño aparece después de la frecuencia diaria y prevalece salvo que una regla particular lo cambie. El <code>logrotate.conf</code> original se copia a <code>.bak</code> la primera vez.",
|
||||
"tipTitle": "Amigable con Log2RAM",
|
||||
"tipBody": "El trigger <code>size 10M</code> significa que los logs rotan por tamaño <em>o</em> diariamente, lo que ocurra primero. Combinado con el <code>/var/log</code> respaldado en RAM de Log2RAM, esto mantiene el working set pequeño para que los flushes a disco sean baratos."
|
||||
"tipBody": "La directiva <code>size 10M</code> prevalece sobre el ajuste diario anterior; <em>no</em> significa lo que ocurra primero. Logrotate comprueba el umbral al ejecutarse y las reglas particulares pueden cambiar los valores globales. Con <code>/var/log</code> en la RAM de Log2RAM, revisa las reglas y la frecuencia del temporizador para controlar el espacio."
|
||||
},
|
||||
"limits": {
|
||||
"heading": "Aumentar varios límites del sistema",
|
||||
@@ -72,7 +72,7 @@
|
||||
}
|
||||
],
|
||||
"tipTitle": "Por qué importa inotify",
|
||||
"tipBody": "Aplicaciones como Docker, Syncthing, watchers de Node.js, el escáner de biblioteca de Plex y muchas más pegan rápido contra <code>max_user_watches</code>. El valor por defecto en Debian es 8192 — un solo Plex en ejecución puede agotarlo. 1M es generoso y cuesta ~1 KB de RAM por watch, lo que es despreciable."
|
||||
"tipBody": "Docker, Syncthing, los observadores de archivos de Node.js y los análisis de bibliotecas de Plex pueden agotar <code>max_user_watches</code>. El valor predeterminado depende del núcleo y la memoria; no siempre es 8192. Subirlo a 1M permite más observadores, sin preasignarlos. Los observadores activos consumen memoria del núcleo: vigila el uso en hosts con poca RAM."
|
||||
},
|
||||
"memory": {
|
||||
"heading": "Optimizar ajustes de memoria",
|
||||
@@ -102,8 +102,8 @@
|
||||
"verify": {
|
||||
"heading": "Verificación",
|
||||
"intro": "Tras aplicar las optimizaciones de Sistema:",
|
||||
"tipTitle": "Totalmente reversible",
|
||||
"tipBody": "Las seis opciones están registradas en <code>installed_tools.json</code>, así que aparecen en <link>Uninstall Optimizations</link> si quieres revertir alguna. Las reversiones restauran los valores por defecto de los archivos sysctl, eliminan la unit systemd y el alias de kexec, y resetean journald/logrotate a las configuraciones stock de Debian."
|
||||
"tipTitle": "Restauración y limitaciones",
|
||||
"tipBody": "Las seis opciones se registran en <code>installed_tools.json</code> y aparecen en <link>Desinstalar optimizaciones</link>. La restauración elimina los archivos de configuración, la unidad y el alias de kexec, reescribe journald.conf con los valores predeterminados de systemd y restaura logrotate.conf desde su backup. Algunos límites activos requieren otra sesión o reinicio."
|
||||
},
|
||||
"related": {
|
||||
"heading": "Relacionado",
|
||||
@@ -119,12 +119,12 @@
|
||||
"tail": " — tuning adicional a nivel de sistema (pigz)."
|
||||
},
|
||||
{
|
||||
"label": "Uninstall Optimizations",
|
||||
"label": "Desinstalar optimizaciones",
|
||||
"href": "/docs/post-install/uninstall",
|
||||
"tail": " — revierte cualquiera de estos cambios."
|
||||
},
|
||||
{
|
||||
"label": "Customizable Post-Install",
|
||||
"label": "Post-instalación personalizable",
|
||||
"href": "/docs/post-install/customizable",
|
||||
"tail": " — volver al menú padre."
|
||||
}
|
||||
|
||||
@@ -1,12 +1,12 @@
|
||||
{
|
||||
"meta": {
|
||||
"title": "Uninstall Optimizations | ProxMenux Documentation",
|
||||
"title": "Desinstalar optimizaciones | Documentación de ProxMenux",
|
||||
"description": "Restaura los cambios reversibles de post-instalación aplicados por ProxMenux. Las herramientas registradas usan desinstaladores específicos que conservan el estado anterior del host cuando es posible."
|
||||
},
|
||||
"header": {
|
||||
"title": "Uninstall Optimizations",
|
||||
"title": "Desinstalar optimizaciones",
|
||||
"description": "Restaura los cambios reversibles realizados por los scripts de post-instalación Automatizado o Personalizable. ProxMenux registra cada optimización compatible con su función de restauración; las actualizaciones de paquetes quedan excluidas deliberadamente.",
|
||||
"section": "Settings post-install Proxmox"
|
||||
"section": "Configuración post instalación de Proxmox"
|
||||
},
|
||||
"intro": {
|
||||
"title": "Por qué existe",
|
||||
@@ -14,8 +14,8 @@
|
||||
},
|
||||
"openMenu": {
|
||||
"heading": "Cómo abrirlo",
|
||||
"body": "Desde el menú principal de ProxMenux, <strong>Settings post-install Proxmox → Uninstall optimizations</strong>. Verás un checklist de optimizaciones <em>actualmente aplicadas</em> — los items que no has aplicado no aparecen.",
|
||||
"imageAlt": "Checklist de Uninstall Optimizations mostrando los items actualmente aplicados en el host, con checkboxes para seleccionar cuáles revertir"
|
||||
"body": "Desde el menú principal, abre <strong>Configuración post instalación de Proxmox → Desinstalar optimizaciones</strong>. Verás una lista de optimizaciones <em>actualmente aplicadas</em>; las no aplicadas no aparecen.",
|
||||
"imageAlt": "Lista de Desinstalar optimizaciones con las opciones activas del host y casillas para elegir cuáles revertir"
|
||||
},
|
||||
"howWorks": {
|
||||
"heading": "Cómo funciona la reversión",
|
||||
@@ -40,7 +40,7 @@
|
||||
"body2": "Cada reversión registra su progreso. Los items que requieren un reinicio (VFIO, nombres de interfaz persistentes) activan un flag que dispara el prompt de reinicio al final."
|
||||
},
|
||||
{
|
||||
"title": "Prompt de reinicio al final",
|
||||
"title": "Solicitud de reinicio al final",
|
||||
"body1": "Al terminar la reversión el menú muestra un prompt de reinicio. Los items que cambiaron parámetros del kernel, módulos del kernel o naming de red (VFIO, nombres de interfaz persistentes) sí necesitan el reinicio para surtir efecto; otros no lo necesitan, y el prompt es un valor por defecto de seguridad más que una comprobación por item."
|
||||
}
|
||||
]
|
||||
@@ -53,15 +53,15 @@
|
||||
"title": "Repositorios y APT",
|
||||
"items": [
|
||||
{
|
||||
"tool": "Subscription Banner Removal",
|
||||
"tool": "Eliminación del aviso de suscripción",
|
||||
"restores": "Primero intenta restaurar los archivos de la UI desde los backups propios de ProxMenux (/usr/local/share/proxmenux/backups/proxmoxlib.js.backup.* y, cuando la UI móvil está parcheada, index.html.tpl.backup.*). Solo si un backup falta o está corrupto, cae al reinstalado de pve-manager, proxmox-widget-toolkit, libjs-extjs y libpve-http-server-perl con force-confnew. También limpia las copias .js / .gz cacheadas."
|
||||
},
|
||||
{
|
||||
"tool": "APT Language Skip",
|
||||
"restores": "Elimina /etc/apt/apt.conf.d/99-disable-translations. APT volverá a descargar paquetes de idioma."
|
||||
"tool": "Omitir idiomas de APT",
|
||||
"restores": "Elimina /etc/apt/apt.conf.d/99-disable-translations para que APT pueda descargar índices de descripciones traducidas según el resto de ajustes de idioma."
|
||||
},
|
||||
{
|
||||
"tool": "APT IPv4 Force",
|
||||
"tool": "Forzar IPv4 en APT",
|
||||
"restores": "Elimina /etc/apt/apt.conf.d/99-force-ipv4."
|
||||
},
|
||||
{
|
||||
@@ -74,16 +74,16 @@
|
||||
"title": "Kernel, memoria y límites del sistema",
|
||||
"items": [
|
||||
{
|
||||
"tool": "Memory Settings",
|
||||
"tool": "Ajustes de memoria",
|
||||
"restores": "Elimina /etc/sysctl.d/99-memory.conf y recarga sysctl."
|
||||
},
|
||||
{
|
||||
"tool": "Kernel Panic Configuration",
|
||||
"tool": "Configuración de kernel panic",
|
||||
"restores": "Elimina /etc/sysctl.d/99-kernelpanic.conf."
|
||||
},
|
||||
{
|
||||
"tool": "System Limits Increase",
|
||||
"restores": "Elimina /etc/sysctl.d/99-maxwatches.conf, 99-maxkeys.conf, 99-swap.conf, 99-fs.conf y /etc/security/limits.d/99-limits.conf. Revierte los límites PAM y DefaultLimitNOFILE de systemd, y elimina la línea ulimit -n 256000 de /root/.profile."
|
||||
"tool": "Aumento de los límites del sistema",
|
||||
"restores": "Elimina /etc/sysctl.d/99-maxwatches.conf, 99-maxkeys.conf, 99-swap.conf, 99-fs.conf y /etc/security/limits.d/99-limits.conf. Revierte límites PAM y DefaultLimitNOFILE de systemd. En /root/.profile solo limpia la línea antigua ulimit -n 256000; la actual ulimit -n 1048576 puede permanecer y requerir eliminación manual."
|
||||
},
|
||||
{
|
||||
"tool": "Perfil de swap con ZRAM",
|
||||
@@ -95,7 +95,7 @@
|
||||
"title": "Red",
|
||||
"items": [
|
||||
{
|
||||
"tool": "Network Optimizations",
|
||||
"tool": "Optimización de la red",
|
||||
"restores": "Elimina /etc/sysctl.d/99-network.conf, 97-proxmenux-fwbr.conf y 98-proxmenux-rpf.conf junto con la unit proxmenux-fwbr-tune.service, el helper /usr/local/sbin/proxmenux-fwbr-tune y la regla /etc/udev/rules.d/99-zz-proxmenux-fwbr-tune.rules. También elimina la línea source /etc/network/interfaces.d/* de /etc/network/interfaces. Recarga sysctl, systemd y el conjunto de reglas udev."
|
||||
},
|
||||
{
|
||||
@@ -104,23 +104,23 @@
|
||||
},
|
||||
{
|
||||
"tool": "TCP BBR + TCP Fast Open",
|
||||
"restores": "Elimina /etc/sysctl.d/99-tcp-bbr.conf y 99-tcp-fastopen.conf y recarga sysctl para que el kernel vuelva al control de congestión cubic y a tcp_fastopen=1."
|
||||
"restores": "Elimina /etc/sysctl.d/99-kernel-bbr.conf y 99-tcp-fastopen.conf y recarga el resto de sysctl. Borrar archivos no restablece valores activos; los predeterminados como cubic y tcp_fastopen=1 vuelven al reiniciar salvo otra configuración."
|
||||
},
|
||||
{
|
||||
"tool": "Persistent Interface Names",
|
||||
"tool": "Nombres de la interfaz persistentes",
|
||||
"restores": "Elimina solo los archivos 10-proxmenux-*.link que llevan la cabecera de ProxMenux en /etc/systemd/network/. Cualquier archivo .link provisto por otro paquete o escrito por el usuario se mantiene intacto. Los nombres de interfaz vuelven al comportamiento por defecto de systemd en el siguiente reinicio."
|
||||
}
|
||||
]
|
||||
},
|
||||
{
|
||||
"title": "Logging",
|
||||
"title": "Registro",
|
||||
"items": [
|
||||
{
|
||||
"tool": "Journald Optimization",
|
||||
"restores": "Reescribe /etc/systemd/journald.conf con los valores por defecto vanilla y reinicia systemd-journald."
|
||||
"tool": "Optimización de journald",
|
||||
"restores": "Reescribe /etc/systemd/journald.conf con valores estándar y reinicia systemd-journald."
|
||||
},
|
||||
{
|
||||
"tool": "Logrotate Optimization",
|
||||
"tool": "Optimización de logrotate",
|
||||
"restores": "Restaura /etc/logrotate.conf desde el archivo .bak capturado antes del cambio."
|
||||
},
|
||||
{
|
||||
@@ -128,7 +128,7 @@
|
||||
"restores": "Para y desactiva el servicio y el timer. Purga cron jobs, units systemd, binarios, archivos de configuración y el directorio /var/log.hdd. También desinstala el paquete apt si se instaló por esa vía."
|
||||
},
|
||||
{
|
||||
"tool": "ZFS autotrim",
|
||||
"tool": "TRIM automático de ZFS",
|
||||
"restores": "Lee /usr/local/share/proxmenux/zfs_autotrim_pools (la lista de pools que ProxMenux realmente cambió) y ejecuta zpool set autotrim=off en cada uno. Los pools en los que tú activaste autotrim manualmente antes de ejecutar ProxMenux no se tocan."
|
||||
}
|
||||
]
|
||||
@@ -137,7 +137,7 @@
|
||||
"title": "Shell y apariencia",
|
||||
"items": [
|
||||
{
|
||||
"tool": "Bashrc Customization",
|
||||
"tool": "Personalización de Bashrc",
|
||||
"restores": "Restaura /root/.bashrc desde el backup .bak. Si no existe backup, elimina el bloque PMX_CORE_BASHRC por marcadores."
|
||||
},
|
||||
{
|
||||
@@ -162,28 +162,28 @@
|
||||
"restores": "Elimina los módulos vfio de /etc/modules, las entradas de blacklist nouveau / radeon / nvidia, y los parámetros intel_iommu=on / amd_iommu=on / iommu=pt / pcie_acs_override de /etc/kernel/cmdline (ZFS) o GRUB. Reconstruye initramfs."
|
||||
},
|
||||
{
|
||||
"tool": "AMD CPU fixes (Ryzen/EPYC)",
|
||||
"tool": "Correcciones para CPU AMD (Ryzen/EPYC)",
|
||||
"restores": "Elimina idle=nomwait de la cmdline del kernel (ZFS) o GRUB, y las opciones ignore_msrs / report_ignored_msrs de /etc/modprobe.d/kvm.conf."
|
||||
},
|
||||
{
|
||||
"tool": "QEMU Guest Agent (templates)",
|
||||
"restores": "Lee /usr/local/share/proxmenux/guest_agent.pkg (registrado en tiempo de instalación) y hace apt purge del paquete que se instaló (qemu-guest-agent en hosts estándar, spice-vdagent cuando se usa modo Spice)."
|
||||
"tool": "Agente invitado para un host Proxmox virtualizado",
|
||||
"restores": "Lee /usr/local/share/proxmenux/guest_agent.pkg y purga el paquete registrado del host. El instalador elige qemu-guest-agent, open-vm-tools o virtualbox-guest-utils según el hipervisor. Si falta el registro, el desinstalador prueba esos tres paquetes. Actúa en el host Proxmox anidado, no en plantillas de huéspedes."
|
||||
}
|
||||
]
|
||||
},
|
||||
{
|
||||
"title": "Storage",
|
||||
"title": "Almacenamiento",
|
||||
"items": [
|
||||
{
|
||||
"tool": "ZFS ARC sizing",
|
||||
"tool": "Ajuste del tamaño de ARC de ZFS",
|
||||
"restores": "Elimina /etc/modprobe.d/99-zfsarc.conf, restaura cualquier *.conf externo en conflicto que se dejó apartado en /usr/local/share/proxmenux/backups/zfs_arc/, reconstruye initramfs y ejecuta proxmox-boot-tool refresh en hosts con systemd-boot."
|
||||
},
|
||||
{
|
||||
"tool": "ZFS auto-snapshot",
|
||||
"tool": "Instantáneas automáticas de ZFS",
|
||||
"restores": "Elimina las entradas cron que el script escribió y ofrece hacer apt purge zfs-auto-snapshot. Los datasets de snapshots existentes en los pools se dejan intactos — bórralos por separado si los quieres fuera."
|
||||
},
|
||||
{
|
||||
"tool": "vzdump speed limits",
|
||||
"tool": "Límites de velocidad de vzdump",
|
||||
"restores": "Restaura /etc/vzdump.conf desde el .bak que creó la instalación, devolviendo bwlimit e ionice a sus valores previos a ProxMenux."
|
||||
}
|
||||
]
|
||||
@@ -192,15 +192,15 @@
|
||||
"title": "Servicios y extras",
|
||||
"items": [
|
||||
{
|
||||
"tool": "Time Synchronization",
|
||||
"tool": "Sincronización del tiempo",
|
||||
"restores": "Devuelve la zona horaria a UTC (valor por defecto seguro) vía timedatectl."
|
||||
},
|
||||
{
|
||||
"tool": "Entropy Generation (haveged)",
|
||||
"tool": "Generación de entropía (haveged)",
|
||||
"restores": "Para, desactiva y purga el paquete haveged."
|
||||
},
|
||||
{
|
||||
"tool": "kexec (fast reboots)",
|
||||
"tool": "kexec (reinicios rápidos)",
|
||||
"restores": "Desactiva kexec-pve.service, elimina el archivo de unit y el alias reboot-quick de /root/.bash_profile, purga kexec-tools."
|
||||
},
|
||||
{
|
||||
@@ -212,16 +212,16 @@
|
||||
"restores": "Copia el gzip real desde gzip.distrib, elimina la desviación de dpkg y /bin/pigzwrapper, comenta la línea pigz en /etc/vzdump.conf y hace apt purge pigz una vez verificado gzip."
|
||||
},
|
||||
{
|
||||
"tool": "High Availability services",
|
||||
"tool": "Servicios de alta disponibilidad",
|
||||
"restores": "Para y desactiva pve-ha-lrm, pve-ha-crm y corosync. Los grupos HA y las definiciones de recursos existentes no se eliminan — quítalos desde la UI web si ya no los necesitas."
|
||||
},
|
||||
{
|
||||
"tool": "Ceph repository",
|
||||
"tool": "Repositorio Ceph",
|
||||
"restores": "Purga los paquetes Ceph instalados por esta opción, elimina /etc/apt/sources.list.d/ceph.sources en PVE 9 (o la lista Ceph tradicional en PVE 8) y actualiza la caché de APT."
|
||||
},
|
||||
{
|
||||
"tool": "OVH RTM (monitoring)",
|
||||
"restores": "Ejecuta apt purge sobre cualquier paquete ovh-* que el instalador RTM añadió y borra los manifests puppet que dejó bajo /etc/puppet/. En hosts no-OVH nunca se instaló nada, así que no se elimina nada."
|
||||
"tool": "OVH RTM (monitorización)",
|
||||
"restores": "Purga paquetes que coincidan con ovh-rtm*, rtm y rtm-*, elimina /etc/rtm y borra el registro de RTM. Los restos de Puppet en /etc/puppet/ pueden requerir revisión y limpieza manual; el desinstalador no elimina ese directorio. En hosts no OVH el instalador normalmente no hace cambios."
|
||||
}
|
||||
]
|
||||
}
|
||||
@@ -229,10 +229,10 @@
|
||||
},
|
||||
"edge": {
|
||||
"heading": "Casos límite y matices",
|
||||
"packageTitle": "La reinstalación de paquetes toca paquetes vivos de Proxmox",
|
||||
"packageBody": "Revertir <strong>Subscription Banner Removal</strong> reinstala <code>pve-manager</code>, <code>proxmox-widget-toolkit</code>, <code>libjs-extjs</code> y <code>libpve-http-server-perl</code> con <code>--force-confnew</code>. Es generalmente seguro pero sí toca la UI web en ejecución — refresca tu navegador después, y espera unos segundos de reconexión. No lo ejecutes a mitad de una migración o una operación de clonado.",
|
||||
"packageTitle": "La reinstalación afecta a paquetes de Proxmox en uso",
|
||||
"packageBody": "Si las copias de ProxMenux no pueden revertir <strong>Eliminación del aviso de suscripción</strong>, la alternativa reinstala <code>pve-manager</code>, <code>proxmox-widget-toolkit</code>, <code>libjs-extjs</code> y <code>libpve-http-server-perl</code> con <code>--force-confnew</code>. Afecta a la interfaz web en uso: recarga el navegador y espera unos segundos de reconexión. Evítalo durante migraciones o clonados.",
|
||||
"rebootTitle": "Los nombres persistentes y VFIO necesitan reinicio",
|
||||
"rebootBody": "Eliminar los archivos <code>10-proxmenux-*.link</code> propios de ProxMenux (<em>Persistent Interface Names</em>) y revertir <em>IOMMU/VFIO</em> no afectan al sistema en ejecución — solo importan tras un reinicio. ProxMenux activa el flag de reinicio automáticamente para estos.",
|
||||
"rebootBody": "Eliminar los archivos <code>10-proxmenux-*.link</code> de ProxMenux (<em>Nombres de interfaz persistentes</em>) y revertir <em>IOMMU/VFIO</em> no cambia el sistema ya arrancado: los cambios se aplican tras reiniciar. ProxMenux marca el reinicio como necesario.",
|
||||
"perItemTitle": "Puedes revertir una cosa y mantener el resto",
|
||||
"perItemBody": "El uninstaller opera por item. Si solo quieres eliminar Log2RAM pero mantener el tuning de red y los cambios de bashrc, marca solo <em>Log2RAM</em>. Nada más se toca, y el registro se actualiza en consecuencia."
|
||||
},
|
||||
@@ -240,19 +240,19 @@
|
||||
"heading": "Inspeccionar el registro manualmente",
|
||||
"intro": "Si quieres ver qué está registrado sin abrir el menú:",
|
||||
"outro": "Cada entrada <code>\"tool\": true</code> se corresponde con algo que ProxMenux aplicó y puede revertir. Eliminar una entrada manualmente no se recomienda — usa siempre el menú, que también ejecuta la función de reversión en lugar de simplemente olvidarse del cambio.",
|
||||
"reinstallTitle": "Reinstalación tras uninstall",
|
||||
"reinstallTitle": "Reinstalar tras desinstalar",
|
||||
"reinstallBody": "Revertir una optimización no te impide volver a aplicarla más tarde. Abre <link>el menú Post-Install</link> de nuevo y ejecuta Automatizado o Personalizable — el registro recogerá el nuevo estado."
|
||||
},
|
||||
"related": {
|
||||
"heading": "Relacionado",
|
||||
"items": [
|
||||
{
|
||||
"label": "Automated Post-Install",
|
||||
"label": "Post-instalación automatizada",
|
||||
"href": "/docs/post-install/automated",
|
||||
"tail": " — vuelve a aplicar el baseline de valores por defecto sensatos."
|
||||
},
|
||||
{
|
||||
"label": "Customizable Post-Install",
|
||||
"label": "Post-instalación personalizable",
|
||||
"href": "/docs/post-install/customizable",
|
||||
"tail": " — elige un subconjunto distinto."
|
||||
},
|
||||
@@ -262,7 +262,7 @@
|
||||
"tail": " — operación distinta: elimina el propio ProxMenux, no sus optimizaciones aplicadas."
|
||||
},
|
||||
{
|
||||
"label": "Resumen de Post-Install",
|
||||
"label": "Resumen de post-instalación",
|
||||
"href": "/docs/post-install",
|
||||
"tail": "."
|
||||
}
|
||||
|
||||
@@ -1,12 +1,12 @@
|
||||
{
|
||||
"meta": {
|
||||
"title": "Apply Available Updates — Optimizaciones post-instalación | ProxMenux Documentation",
|
||||
"description": "Cómo ProxMenux detecta cuándo una optimización post-instalación (Log2Ram, Memory Settings, System Limits, Logrotate, tuning de red…) se ha actualizado upstream, y cómo aplicar la nueva versión — desde el menú Post-Install o desde el panel del Monitor."
|
||||
"title": "Aplicar actualizaciones disponibles — Optimizaciones post-instalación | Documentación de ProxMenux",
|
||||
"description": "Cómo ProxMenux detecta las nuevas versiones de optimizaciones post-instalación (Log2Ram, ajustes de memoria, límites del sistema, Logrotate, red…) y cómo aplicarlas desde el menú post-instalación o el panel de Monitor."
|
||||
},
|
||||
"header": {
|
||||
"title": "Apply Available Updates",
|
||||
"title": "Aplicar actualizaciones disponibles",
|
||||
"description": "Cuando una optimización post-instalación (Log2Ram, Memory Settings, System Limits, Logrotate…) tiene en disco una versión más nueva que la registrada actualmente en el host, ProxMenux la muestra como una actualización disponible. Puedes aplicarla desde el menú Post-Install (lado Scripts) o desde el panel del Monitor — ambas rutas vuelven a ejecutar la misma función post-instalación y refrescan el registro.",
|
||||
"section": "Settings post-install Proxmox"
|
||||
"section": "Configuración post instalación de Proxmox"
|
||||
},
|
||||
"intro": {
|
||||
"title": "Qué es esto",
|
||||
@@ -14,7 +14,7 @@
|
||||
},
|
||||
"why": {
|
||||
"heading": "Por qué existe",
|
||||
"body": "Las optimizaciones post-instalación reciben mejoras de vez en cuando — un mejor tuning de sysctl, un límite de Logrotate más estricto, una nueva heurística de tamaño de Log2RAM, un fix para un caso límite reportado por un tester. Sin una ruta de actualización el operador solo tenía dos opciones: volver a ejecutar manualmente el script post-instalación (lo que reaplica <em>cada</em> optimización) o saltarse la mejora por completo. Apply Available Updates es el término medio: una re-ejecución opt-in por optimización que sube solo las versiones que realmente se han movido."
|
||||
"body": "Las optimizaciones post-instalación reciben mejoras: ajustes de sysctl, límites Logrotate más estrictos, nuevas reglas para dimensionar Log2RAM o correcciones de casos límite. Sin esta vía había que repetir el script, que reaplica <em>todas</em> las optimizaciones, o renunciar a la mejora. Aplicar actualizaciones disponibles permite elegir individualmente solo las optimizaciones cuya versión ha cambiado."
|
||||
},
|
||||
"detection": {
|
||||
"heading": "Cómo se detectan las actualizaciones",
|
||||
@@ -25,7 +25,7 @@
|
||||
},
|
||||
{
|
||||
"title": "Registro versionado en el host",
|
||||
"body": "Cuando el operador aplicó cada optimización, la llamada <code>register_tool</code> correspondiente escribió la versión activa en <code>/usr/local/share/proxmenux/installed_tools.json</code>. Ese archivo es la fuente de verdad de \"qué está activo en este host ahora mismo\"."
|
||||
"body": "Cuando el usuario aplicó cada optimización, la llamada <code>register_tool</code> correspondiente escribió la versión activa en <code>/usr/local/share/proxmenux/installed_tools.json</code>. Ese archivo es la fuente de verdad de \"qué está activo en este host ahora mismo\"."
|
||||
},
|
||||
{
|
||||
"title": "El Monitor compara ambos lados",
|
||||
@@ -33,24 +33,24 @@
|
||||
},
|
||||
{
|
||||
"title": "Una notificación por versión nueva",
|
||||
"body": "Cuando al menos una optimización tiene una actualización pendiente, el Monitor emite una única notificación agrupada — por ejemplo <em>\"4 ProxMenux optimization update(s) available\"</em> — con una línea por herramienta en el mismo formato <code>name (vX → vY)</code> que se usa para las actualizaciones de paquetes de Proxmox. La notificación es anti-cascada para que no se repita día tras día con el mismo conjunto; solo una versión nueva (o una herramienta nueva que entra en la lista) la vuelve a disparar."
|
||||
"body": "Cuando hay al menos una actualización pendiente, Monitor envía una única notificación agrupada, por ejemplo <em>«4 actualizaciones de optimizaciones de ProxMenux disponibles»</em>, con una línea por herramienta en formato <code>name (vX → vY)</code>, igual que para los paquetes Proxmox. Evita repeticiones diarias del mismo conjunto: solo una versión nueva o una nueva herramienta en la lista vuelve a activarla."
|
||||
}
|
||||
]
|
||||
},
|
||||
"pathA": {
|
||||
"heading": "Ruta A — Desde el menú Post-Install",
|
||||
"intro": "Desde el menú principal de ProxMenux, abre <strong>Settings post-install Proxmox</strong>. Cuando hay actualizaciones pendientes, una entrada nueva <strong>Apply available updates (N)</strong> aparece justo encima de <em>Uninstall optimizations</em>. El número refleja cuántas optimizaciones tienen una versión más nueva en disco que la que el host tiene registrada actualmente. Cuando todo está al día la entrada simplemente no aparece, así el menú se mantiene limpio.",
|
||||
"menuAlt": "Menú de Post-Install Scripts mostrando la entrada condicional 'Apply available updates (N)' posicionada justo encima de 'Uninstall optimizations', con el contador indicando cuántas optimizaciones tienen una versión más nueva en disco",
|
||||
"menuCaption": "La entrada <em>Apply available updates (N)</em> solo se renderiza cuando al menos una optimización tiene una actualización pendiente — se oculta cuando el host está al día.",
|
||||
"heading": "Ruta A — Desde el menú post-instalación",
|
||||
"intro": "Desde el menú principal de ProxMenux, abre <strong>Configuración post instalación de Proxmox</strong>. Si hay actualizaciones pendientes, aparece <strong>Aplicar actualizaciones disponibles (N)</strong> justo encima de <em>Desinstalar optimizaciones</em>. El número indica cuántas optimizaciones tienen una versión en disco más reciente que la registrada. Si todo está al día, la entrada se oculta.",
|
||||
"menuAlt": "Menú de scripts post-instalación con la entrada condicional Aplicar actualizaciones disponibles (N) encima de Desinstalar optimizaciones; el contador indica cuántas optimizaciones tienen una versión más nueva en disco",
|
||||
"menuCaption": "La entrada <em>Aplicar actualizaciones disponibles (N)</em> solo aparece cuando al menos una optimización tiene una actualización pendiente; se oculta si el host está al día.",
|
||||
"checklistBody": "Seleccionar la entrada abre un checklist con cada actualización pendiente, cada fila formateada como <code>name (vX → vY)</code>. Todas las filas están pre-marcadas por defecto; desmarca las que no quieras aplicar esta ronda.",
|
||||
"checklistAlt": "Diálogo checklist Apply Available Updates con una fila por optimización pendiente, cada una etiquetada con el nombre de la optimización y la transición de versión (actual → disponible). Todas las filas pre-marcadas.",
|
||||
"checklistCaption": "Opt-in por optimización: elige exactamente qué versiones subir. El mismo motor que alimenta Automatizado y Personalizable post-instalación se ejecuta en segundo plano para reaplicar cada función y refrescar su versión en el registro."
|
||||
"checklistAlt": "Diálogo Aplicar actualizaciones disponibles con una fila por optimización pendiente, su nombre y el cambio de versión (actual → disponible). Todas las filas están seleccionadas.",
|
||||
"checklistCaption": "Selección individual por optimización: elige qué versiones actualizar. El mismo motor de Automatizado y Personalizable vuelve a aplicar cada función en segundo plano y actualiza su versión en el registro."
|
||||
},
|
||||
"pathB": {
|
||||
"heading": "Ruta B — Desde el panel del Monitor",
|
||||
"intro": "Las mismas actualizaciones aparecen en el Monitor bajo <link>Settings → ProxMenux Optimizations</link>. Cuando se detectan actualizaciones pendientes la tarjeta muestra un banner \"Updates available\" con el contador y una acción <strong>Apply</strong> que abre el mismo selector por optimización.",
|
||||
"imageAlt": "Tarjeta de ProxMenux Optimizations en el panel del Monitor con un banner Updates available arriba mostrando el contador de actualizaciones pendientes y un botón Apply que abre el selector por optimización",
|
||||
"imageCaption": "La tarjeta Optimizations en el Monitor — cuando al menos una optimización tiene una versión más nueva en disco, el banner lo muestra sin necesidad de acceso por shell."
|
||||
"intro": "Las mismas actualizaciones aparecen en Monitor, en <link>Ajustes → Optimizaciones de ProxMenux</link>. Si hay actualizaciones pendientes, la tarjeta muestra un <strong>contador de actualizaciones</strong> que abre el selector por optimización. Cada herramienta también ofrece su propia acción de actualización.",
|
||||
"imageAlt": "Tarjeta Optimizaciones de ProxMenux en los ajustes de Monitor, con un contador de actualizaciones pendientes que abre el selector por optimización y acciones de actualización por herramienta",
|
||||
"imageCaption": "La tarjeta Optimizaciones de Monitor permite acceder a las actualizaciones mediante su contador cuando hay una versión más nueva en disco, sin entrar en la shell."
|
||||
},
|
||||
"applying": {
|
||||
"heading": "Qué pasa cuando aplicas",
|
||||
@@ -69,7 +69,7 @@
|
||||
},
|
||||
{
|
||||
"title": "Refresco del registro enviado al Monitor",
|
||||
"body": "Al terminar el batch, el menú hace POST a <code>http://127.0.0.1:8008/api/updates/post-install/scan</code> para reconstruir <code>/usr/local/share/proxmenux/updates_available.json</code>. Eso hace que la tarjeta de Optimizations del Monitor y la entrada del menú de shell desaparezcan inmediatamente tras la actualización, sin esperar al siguiente escaneo programado."
|
||||
"body": "Al terminar el lote, el menú envía una petición POST a <code>http://127.0.0.1:8008/api/updates/post-install/scan</code> para reconstruir <code>/usr/local/share/proxmenux/updates_available.json</code>. Tras aplicar todo lo pendiente, desaparecen el contador de actualizaciones de la tarjeta Optimizaciones y la entrada condicional de la shell, sin esperar al siguiente análisis. La tarjeta Optimizaciones sigue disponible."
|
||||
}
|
||||
],
|
||||
"jqTitle": "jq es obligatorio",
|
||||
@@ -77,7 +77,7 @@
|
||||
},
|
||||
"differs": {
|
||||
"heading": "En qué se diferencia de las otras rutas",
|
||||
"headerPath": "Ruta",
|
||||
"headerPath": "Path",
|
||||
"headerScope": "Alcance",
|
||||
"headerWhen": "Cuándo tiene sentido",
|
||||
"rows": [
|
||||
@@ -85,7 +85,7 @@
|
||||
"pathLabel": "Automatizado",
|
||||
"pathHref": "/docs/post-install/automated",
|
||||
"scope": "Reaplica <em>cada</em> optimización del bundle.",
|
||||
"when": "Host recién instalado, o re-baseline completo de un nodo totalmente gestionado."
|
||||
"when": "Host recién instalado o reaplicación completa de la base de un nodo totalmente gestionado."
|
||||
},
|
||||
{
|
||||
"pathLabel": "Personalizable",
|
||||
@@ -94,13 +94,13 @@
|
||||
"when": "Selecciona qué optimizaciones están activas en el host."
|
||||
},
|
||||
{
|
||||
"pathLabel": "Apply available updates",
|
||||
"pathLabel": "Aplicar actualizaciones disponibles",
|
||||
"pathHref": null,
|
||||
"scope": "Solo las optimizaciones cuya versión ha subido en disco.",
|
||||
"when": "Mantén las optimizaciones ya instaladas al día sin tocar el resto."
|
||||
},
|
||||
{
|
||||
"pathLabel": "Uninstall optimizations",
|
||||
"pathLabel": "Desinstalar optimizaciones",
|
||||
"pathHref": "/docs/post-install/uninstall",
|
||||
"scope": "Revierte la optimización y elimina su entrada del registro.",
|
||||
"when": "Hacer rollback de un cambio específico."
|
||||
@@ -108,5 +108,5 @@
|
||||
]
|
||||
},
|
||||
"notifTitle": "Filtro de notificación",
|
||||
"notifBody": "La notificación que anuncia actualizaciones pendientes es el evento <em>ProxMenux optimization updates available</em>. Está activada por defecto en cada canal, se puede silenciar por canal desde <link>Settings → Notifications</link>, y es anti-cascada — se dispara una vez por conjunto distinto de actualizaciones pendientes, no en cada escaneo de 24h."
|
||||
"notifBody": "El evento que anuncia las actualizaciones pendientes es <em>Actualizaciones de optimizaciones de ProxMenux disponibles</em>. Se activa por defecto en todos los canales y se puede silenciar por canal en <link>Ajustes → Notificaciones</link>. Evita repeticiones: se envía una vez por conjunto distinto de actualizaciones pendientes, no en cada análisis de 24 horas."
|
||||
}
|
||||
|
||||
@@ -1,19 +1,19 @@
|
||||
{
|
||||
"meta": {
|
||||
"title": "Post-instalación: Virtualización | ProxMenux Documentation",
|
||||
"description": "Opciones de virtualización en el script post-instalación Customizable de ProxMenux: auto-instalar el guest agent correcto si Proxmox corre dentro de una VM, y activar IOMMU / VFIO para que puedas pasar dispositivos PCI (GPUs, NICs, HBAs) directamente a tus propias VMs."
|
||||
"title": "Post-instalación: Virtualización | Documentación de ProxMenux",
|
||||
"description": "Opciones de virtualización del script post-instalación Personalizable de ProxMenux: instala automáticamente el agente invitado correcto si Proxmox se ejecuta dentro de una VM y activa IOMMU / VFIO para pasar dispositivos PCI (GPU, NIC, HBA) directamente a tus VM."
|
||||
},
|
||||
"header": {
|
||||
"title": "Post-instalación: Virtualización",
|
||||
"section": "Settings post-install Proxmox"
|
||||
"section": "Configuración post instalación de Proxmox"
|
||||
},
|
||||
"intro": {
|
||||
"title": "Qué cubre esta categoría",
|
||||
"body": "Dos opciones independientes. <strong>Install relevant guest agent</strong> es una red de seguridad para cuando Proxmox mismo corre anidado dentro de otro hipervisor. <strong>Enable VFIO IOMMU support</strong> es la que le importa a la mayoría: activa las funcionalidades del kernel que necesitas para pasar una GPU, HBA o NIC directamente a una VM con rendimiento casi nativo."
|
||||
"body": "Dos opciones independientes. <strong>Instalar el guest agent correspondiente</strong> ayuda cuando el propio Proxmox se ejecuta anidado dentro de otro hipervisor. <strong>Activar soporte VFIO IOMMU</strong> es la opción que más usuarios necesitan: activa las funciones del kernel para asignar una GPU, HBA o NIC directamente a una VM con rendimiento casi nativo."
|
||||
},
|
||||
"guestAgent": {
|
||||
"heading": "Instalar guest agent relevante",
|
||||
"intro": "Detecta el entorno de virtualización en el que corre el host Proxmox (usando <code>systemd-detect-virt</code> y <code>dmidecode</code>) e instala el paquete de guest-tools correspondiente para que el hipervisor exterior pueda comunicarse con Proxmox de forma limpia (shutdown elegante, sincronización de reloj, reporte de IP, etc.).",
|
||||
"heading": "Instalar el guest agent correspondiente",
|
||||
"intro": "Detecta el entorno de virtualización del host Proxmox mediante <code>systemd-detect-virt</code> y <code>dmidecode</code> e instala el paquete de herramientas de invitado correspondiente para comunicarse correctamente con el hipervisor exterior: apagado ordenado, sincronización del reloj, información de IP, etc.",
|
||||
"headerDetected": "Host detectado",
|
||||
"headerPackage": "Paquete instalado",
|
||||
"rows": [
|
||||
@@ -76,23 +76,23 @@
|
||||
"<strong>Dos GPUs:</strong> una puede ir a una VM y la otra a un LXC, pero necesitarás una configuración más granular (vincular solo una tarjeta a <code>vfio-pci</code> por ID PCI). La blacklist por defecto es demasiado amplia para este caso — edita <code>blacklist.conf</code> después."
|
||||
],
|
||||
"acsTitle": "Sobre pcie_acs_override — sé consciente de lo que estás activando",
|
||||
"acsBody": "<code>pcie_acs_override=downstream,multifunction</code> relaja el chequeo de PCIe Access Control Services. Permite al kernel partir grupos IOMMU que el firmware reporta como monolíticos, que a veces es la única forma de hacer passthrough de un dispositivo de un grupo sin arrastrar el resto. El trade-off es <strong>aislamiento reducido entre dispositivos</strong>: una VM maliciosa o comprometida con passthrough tiene una superficie de ataque mayor vía DMA. Bien para un home lab; piénsatelo dos veces antes de activarlo en un host que ejecuta cargas no confiables. Si no lo necesitas, quita ese token de <code>/etc/kernel/cmdline</code> o <code>/etc/default/grub</code> tras ejecutar el script y vuelve a ejecutar el paso de actualización del cargador de arranque.",
|
||||
"acsBody": "<code>pcie_acs_override=downstream,multifunction</code> relaja el chequeo de PCIe Access Control Services. Permite al kernel partir grupos IOMMU que el firmware reporta como monolíticos, que a veces es la única forma de hacer passthrough de un dispositivo de un grupo sin arrastrar el resto. El trade-off es <strong>aislamiento reducido entre dispositivos</strong>: una VM maliciosa o comprometida con passthrough tiene una superficie de ataque mayor vía DMA. Bien para un home lab; piénsatelo dos veces antes de activarlo en un host que ejecuta cargas no confiables. Si no lo necesitas, elimina ese token de <code>/etc/kernel/cmdline</code> o <code>/etc/default/grub</code> tras ejecutar el script y vuelve a ejecutar el paso de actualización del cargador de arranque.",
|
||||
"rebootTitle": "Se requiere reinicio",
|
||||
"rebootBody": "IOMMU, los módulos VFIO y la blacklist solo surten efecto tras un reinicio + regeneración del initramfs. El script dispara <code>update-initramfs -u -k all</code> y el refresh del cargador de arranque, y activa el flag de \"se requiere reinicio\" para que Personalizable te lo pregunte al final.",
|
||||
"verifyTitle": "Verificación tras el reinicio",
|
||||
"revertTitle": "Reversible desde el menú Uninstall",
|
||||
"revertBody": "<link>Uninstall Optimizations</link> revierte todos los cambios: quita los tokens IOMMU de <code>/etc/kernel/cmdline</code> o GRUB, quita los módulos VFIO de <code>/etc/modules</code>, quita las entradas de blacklist de drivers y reconstruye el initramfs. Se requiere un reinicio para aplicar realmente la reversión."
|
||||
"revertTitle": "Reversible desde el menú Desinstalar",
|
||||
"revertBody": "<link>Desinstalar optimizaciones</link> revierte todos los cambios: elimina los parámetros IOMMU de <code>/etc/kernel/cmdline</code> o GRUB, elimina los módulos VFIO de <code>/etc/modules</code>, elimina las entradas de bloqueo de controladores y reconstruye initramfs. Debes reiniciar para aplicar la reversión."
|
||||
},
|
||||
"related": {
|
||||
"heading": "Relacionado",
|
||||
"items": [
|
||||
{
|
||||
"label": "Add GPU to VM (Passthrough)",
|
||||
"label": "Añadir GPU a VM (Passthrough)",
|
||||
"href": "/docs/hardware/gpu-vm-passthrough",
|
||||
"tail": " — siguiente paso natural una vez IOMMU + VFIO están activos."
|
||||
},
|
||||
{
|
||||
"label": "Add Controller or NVMe to VM",
|
||||
"label": "Añadir Controlador o NVMe a VM",
|
||||
"href": "/docs/disk-manager/add-controller-nvme-vm",
|
||||
"tail": " — misma infraestructura de passthrough para controladoras de almacenamiento."
|
||||
},
|
||||
@@ -102,12 +102,12 @@
|
||||
"tail": " — referencia de verificación de IOMMU."
|
||||
},
|
||||
{
|
||||
"label": "Uninstall Optimizations",
|
||||
"label": "Desinstalar optimizaciones",
|
||||
"href": "/docs/post-install/uninstall",
|
||||
"tail": " — revierte IOMMU / VFIO de forma limpia."
|
||||
},
|
||||
{
|
||||
"label": "Customizable Post-Install",
|
||||
"label": "Post-instalación personalizable",
|
||||
"href": "/docs/post-install/customizable",
|
||||
"tail": " — volver al menú padre."
|
||||
}
|
||||
|
||||
@@ -0,0 +1,172 @@
|
||||
{
|
||||
"meta": {
|
||||
"title": "Script de post-installation automatisé | Documentation ProxMenux",
|
||||
"description": "Le script de post-installation automatisé ProxMenux exécute 14 optimisations prédéfinies adaptées au matériel sur un nouvel hôte Proxmox VE. Il n’a pas de liste de fonctions à sélectionner, mais peut demander confirmation pour la mise à jour du système, pour masquer l’avertissement d’abonnement, installer Log2RAM dans certains cas et redémarrer. Les changements réversibles sont enregistrés.",
|
||||
"ogTitle": "Script de post-installation automatisé | Documentation ProxMenux",
|
||||
"ogDescription": "14 optimisations prédéfinies adaptées au matériel pour un nouvel hôte Proxmox VE, avec confirmation de certaines actions et suivi des changements réversibles."
|
||||
},
|
||||
"header": {
|
||||
"title": "Script de post-installation automatisé",
|
||||
"description": "ProxMenux exécute 14 optimisations de base prédéfinies sans liste de fonctions à sélectionner. Certaines actions demandent confirmation. Les changements réversibles sont enregistrés pour Désinstaller les optimisations ; les mises à niveau de paquets ne sont pas présentées comme réversibles.",
|
||||
"section": "Post-installation · Automatisée"
|
||||
},
|
||||
"intro": {
|
||||
"title": "Quand choisir Automatisé",
|
||||
"body": "Exécutez-le sur un hôte Proxmox fraîchement installé pour obtenir une configuration de base raisonnable sans choisir chaque fonction. Le script est idempotent : une deuxième exécution réapplique les mêmes paramètres. Les fonctions optionnelles (Fastfetch, IOMMU, dépôt Ceph, HA, correctifs AMD…) ne font volontairement <strong>pas</strong> partie de ce parcours ; choisissez-les dans <link>Personnalisable</link> au besoin."
|
||||
},
|
||||
"applies": {
|
||||
"heading": "Ce que le script applique",
|
||||
"intro": "Les optimisations sont appliquées dans cet ordre exact. La colonne <em>Catégorie</em> permet de consulter la documentation détaillée de chaque changement dans la référence personnalisable.",
|
||||
"headerNum": "#",
|
||||
"headerTool": "Outil",
|
||||
"headerWhat": "Ce qu'il fait",
|
||||
"headerCategory": "Catégorie"
|
||||
},
|
||||
"optimizations": [
|
||||
{
|
||||
"tool": "Dépôts APT + mise à jour complète",
|
||||
"what": "Désactive les dépôts Enterprise pve-enterprise.sources et ceph.sources, crée une source sans abonnement pour le nom de code Debian de l’hôte, puis lance apt update && apt full-upgrade -y (commande officielle de mise à niveau Proxmox).",
|
||||
"category": "Paramètres de base",
|
||||
"categorySlug": "basic-settings"
|
||||
},
|
||||
{
|
||||
"tool": "Suppression de la bannière d'abonnement",
|
||||
"what": "Modifie l’interface web pour masquer l’avertissement « Aucun abonnement valide ». Demande confirmation avant application ; réversible via Désinstaller les optimisations.",
|
||||
"category": "Personnalisation",
|
||||
"categorySlug": "customization"
|
||||
},
|
||||
{
|
||||
"tool": "Forcer IPv4",
|
||||
"what": "Écrit /etc/apt/apt.conf.d/99-force-ipv4 pour que apt utilise uniquement IPv4 et contourne les liaisons IPv6 instables vers les miroirs.",
|
||||
"category": "Réseau",
|
||||
"categorySlug": "network"
|
||||
},
|
||||
{
|
||||
"tool": "Sauter les paquets de langue",
|
||||
"what": "Écrit /etc/apt/apt.conf.d/99-disable-translations pour ne plus télécharger les index de descriptions de paquets traduites et réduire les données des mises à jour apt.",
|
||||
"category": "Paramètres de base",
|
||||
"categorySlug": "basic-settings"
|
||||
},
|
||||
{
|
||||
"tool": "Augmentation des limites du système",
|
||||
"what": "Augmente le nombre de surveillances inotify, les limites nofile/nproc, celles du trousseau du noyau et fs.file-max via sysctl.d, limits.d, pam et systemd, pour les hôtes avec de nombreux conteneurs.",
|
||||
"category": "Système",
|
||||
"categorySlug": "system"
|
||||
},
|
||||
{
|
||||
"tool": "Réglage de la mémoire",
|
||||
"what": "Définit vm.swappiness=10, des ratios équilibrés de pages modifiées non écrites, vm.max_map_count=262144 et la proactivité du compactage si disponible. La politique de surallocation mémoire du noyau reste celle de Proxmox par défaut.",
|
||||
"category": "Système",
|
||||
"categorySlug": "system"
|
||||
},
|
||||
{
|
||||
"tool": "Comportement en cas de panique du noyau",
|
||||
"what": "Configure l’hôte pour redémarrer 10 secondes après un panic / oops / hardlockup au lieu de rester bloqué indéfiniment.",
|
||||
"category": "Système",
|
||||
"categorySlug": "system"
|
||||
},
|
||||
{
|
||||
"tool": "Réglage de la pile réseau",
|
||||
"what": "Taille des tampons TCP, durcissement IPv4 (redirections désactivées, rp_filter=2, journalisation martian désactivée), ports locaux 1024-65535, détection MTU TCP, RFC 1337 et script /usr/local/sbin/proxmenux-fwbr-tune lié à une unité systemd à exécution unique et une règle udev. Ainsi, rp_filter=0 / log_martians=0 sont réappliqués aux interfaces fwbr*/fwln*/fwpr*/tap* à chaque recréation par Proxmox au démarrage/arrêt des VM, au redémarrage ou à la migration à chaud.",
|
||||
"category": "Réseau",
|
||||
"categorySlug": "network"
|
||||
},
|
||||
{
|
||||
"tool": "Personnalisation du bashrc (root)",
|
||||
"what": "PS1 coloré, alias courants (l/la/ll/ls/grep), historique horodaté et chargement de bash-completion, dans un bloc délimité PMX_CORE_BASHRC facile à retirer.",
|
||||
"category": "Personnalisation",
|
||||
"categorySlug": "customization"
|
||||
},
|
||||
{
|
||||
"tool": "Log2RAM (adapté aux SSD, automatique)",
|
||||
"what": "Réduit l’usure SSD/NVMe en déplaçant /var/log dans un disque RAM tmpfs synchronisé régulièrement vers le disque. Installation depuis le projet amont si le disque racine est SSD ou NVMe. Taille selon la RAM de l’hôte (128M / 256M / 512M), synchronisation périodique et protection automatique qui purge les anciens journaux à 80% et tronque les journaux très actifs à 92% avant écriture. Adapte les limites journald au disque RAM. Détails dans <link>Log2RAM</link>.",
|
||||
"category": "Stockage",
|
||||
"categorySlug": "storage"
|
||||
},
|
||||
{
|
||||
"tool": "ZFS autotrim (SSD seulement)",
|
||||
"what": "Active zpool autotrim=on sur chaque pool ZFS dont tous les vdevs sont des SSD ou NVMe compatibles TRIM, après vérification de /sys/block/[dev]/queue/rotational et discard_granularity. Les pools sur HDD sont ignorés. Seuls les pools effectivement modifiés par ProxMenux sont mémorisés pour la désinstallation ; ceux sur lesquels vous avez activé autotrim manuellement restent inchangés.",
|
||||
"category": "Stockage",
|
||||
"categorySlug": "storage"
|
||||
},
|
||||
{
|
||||
"tool": "Limites de taille de journald",
|
||||
"what": "Force le stockage persistant, limite SystemMaxUse=64M / RuntimeMaxUse=60M, active la compression et les journaux de niveau info requis par Monitor. Ignoré si Log2RAM est actif, car il effectue son propre réglage.",
|
||||
"category": "Système",
|
||||
"categorySlug": "system"
|
||||
},
|
||||
{
|
||||
"tool": "Réglage du logrotate",
|
||||
"what": "Définit globalement daily puis size 10M, conserve 7 rotations et active compression et copytruncate. Le critère de taille placé après prévaut ; les règles propres aux journaux peuvent le remplacer. Adapté à Log2RAM, mais la fréquence dépend des règles et du minuteur.",
|
||||
"category": "Système",
|
||||
"categorySlug": "system"
|
||||
},
|
||||
{
|
||||
"tool": "Noms d'interface persistants",
|
||||
"what": "Écrit un <code>/etc/systemd/network/10-proxmenux-<iface>.link</code> par NIC physique (chacun commençant par un en-tête 'Managed by ProxMenux') qui épingle le MAC au nom courant, de sorte que les noms <code>eth0</code> / <code>enp…</code> restent stables à travers les reboots et les nouveaux ajouts NIC.",
|
||||
"category": "Réseau",
|
||||
"categorySlug": "network"
|
||||
}
|
||||
],
|
||||
"hardwareTitle": "Valeurs par défaut adaptées au matériel",
|
||||
"hardwareBody": "Le script examine le matériel avant de configurer l’hôte. Par défaut, Log2RAM s’installe uniquement si le disque racine est SSD ou NVMe ; il demande confirmation sinon. La taille du disque RAM dépend de la RAM totale (<code>≤ 8 GB → 128M</code>, <code>≤ 16 GB → 256M</code>, <code>'>' 16 GB → 512M</code>). Quand Log2RAM est actif, les limites journald sont adaptées au disque RAM pour éviter de le remplir.",
|
||||
"upgrade": {
|
||||
"heading": "Mettre à jour les listes de paquets et le système",
|
||||
"intro": "La première étape du parcours automatisé est la mise à niveau Proxmox. Pour un hôte en fonctionnement au sein de la même version majeure, Proxmox recommande :",
|
||||
"after": "Cette ligne est la commande officielle des versions actuelles de Proxmox. Le script automatisé l’exécute <strong>exactement</strong> et ajoute le nettoyage des dépôts et les tâches après mise à niveau recommandés par le guide — comme l’utilitaire autonome <link>Mise à jour du système Proxmox</link> :",
|
||||
"items": [
|
||||
"Désactive les sources Enterprise <code>pve-enterprise.sources</code> / <code>ceph.sources</code>, supprime les anciens fichiers de dépôts et crée une source sans abonnement pour le nom de code de l’hôte.",
|
||||
"Exécute la mise à jour non interactive avec <code>DEBIAN_FRONTEND=noninteractive</code> et <code>--force-confdef --force-confold</code> — les fichiers de configuration que vous avez personnalisés restent les vôtres lorsque l'amont les a également modifiés.",
|
||||
"Installe les paquets Proxmox essentiels s’ils manquent (<code>zfsutils-linux</code>, <code>proxmox-backup-restore-image</code>, <code>chrony</code>).",
|
||||
"Vérification de cohérence des métadonnées LVM, <code>apt-get autoremove -y</code> + <code>apt-get autoclean -y</code> et demande de redémarrage seulement si le noyau a changé."
|
||||
],
|
||||
"sameTitle": "Même mise à jour, deux points d'entrée",
|
||||
"sameBody": "Le paquet automatisé et l'utilitaire autonome <link>Proxmox System Update</link> partagent les mêmes scripts sous-jacents (<code>update-pve8.sh</code> / <code>update-pve9_2.sh</code>). Utilisez l'utilitaire seul quand vous voulez seulement mettre à niveau l'hôte sans appliquer le reste des optimisations."
|
||||
},
|
||||
"endResult": {
|
||||
"heading": "Résultat final escompté",
|
||||
"body": "À la fin, un message de réussite et les sorties de chaque étape s’affichent, avec une demande de redémarrage pour les paramètres du noyau qui en ont besoin. Vous pouvez le reporter ; ces paramètres s’appliqueront au prochain démarrage.",
|
||||
"imageAlt": "script automatisé post-installation — sortie finale du terminal montrant chaque optimisation appliquée avec succès"
|
||||
},
|
||||
"notDoes": {
|
||||
"heading": "Ce que ce script ne fait PAS",
|
||||
"items": [
|
||||
"Détection automatique par fuseau horaire (commenté en amont; utiliser Personnalisable si vous le souhaitez).",
|
||||
"Désactiver portmapper / rpcbind (voir <secLink>Sécurité</secLink>).",
|
||||
"Activer IOMMU / VFIO (voir <virtLink>Virtualisation</virtLink>).",
|
||||
"Installer Fastfetch / Figurine / le dépôt Ceph / HA / les correctifs CPU AMD (voir <optLink>Options</optLink>).",
|
||||
"Installer pigz ou ajuster ZFS ARC (voir <perfLink>Performances</perfLink> / <storLink>Stockage</storLink>)."
|
||||
]
|
||||
},
|
||||
"xshokTitle": "détection xshok-proxmox",
|
||||
"xshokBody": "Si l'hôte a déjà lancé le script <code>xshok-proxmox</code>, ProxMenux détecte le fichier marqueur et vous avertit avant de continuer. Certains changements peuvent se chevaucher. Le script compagnon est déprécié — si vous décidez de continuer de toute façon, consultez <link>la vue d'ensemble</link> pour le contexte.",
|
||||
"revert": {
|
||||
"heading": "Annuler les changements",
|
||||
"body": "Chaque outil du tableau est enregistré dans <code>/usr/local/share/proxmenux/installed_tools.json</code>. Ouvrez <link>Désinstaller les optimisations</link> pour choisir les éléments à rétablir. Les sauvegardes des fichiers modifiés se trouvent à côté des originaux avec le suffixe <code>.bak</code>."
|
||||
},
|
||||
"related": {
|
||||
"heading": "Voir aussi",
|
||||
"items": [
|
||||
{
|
||||
"label": "Post-installation personnalisable",
|
||||
"href": "/docs/post-install/customizable",
|
||||
"tail": "— choisissez exactement ce que vous voulez dans le même catalogue."
|
||||
},
|
||||
{
|
||||
"label": "Désinstaller les optimisations",
|
||||
"href": "/docs/post-install/uninstall",
|
||||
"tail": "— de revenir sur tout sous-ensemble de ce qui a été appliqué ici."
|
||||
},
|
||||
{
|
||||
"label": "Commandes système utiles",
|
||||
"href": "/docs/help-info/system-commands",
|
||||
"tail": "— vérifier les changements (uptime, free, journalctl, etc.)."
|
||||
},
|
||||
{
|
||||
"label": "Aperçu après l'installation",
|
||||
"href": "/docs/post-install",
|
||||
"tail": "."
|
||||
}
|
||||
]
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,240 @@
|
||||
{
|
||||
"meta": {
|
||||
"title": "Post-installation : Paramètres de base | Documentation ProxMenux",
|
||||
"description": "Options de base après installation : passer aux dépôts Proxmox sans abonnement et mettre à niveau le système, détecter le fuseau horaire et activer NTP, ignorer les traductions APT et choisir parmi 25 utilitaires courants à installer."
|
||||
},
|
||||
"header": {
|
||||
"title": "Post-Install: Paramètres de base",
|
||||
"section": "Paramètres post-installation de Proxmox"
|
||||
},
|
||||
"intro": {
|
||||
"title": "Ce que cette catégorie couvre",
|
||||
"body": "Cinq options de base pour un hôte Proxmox neuf : passer aux dépôts communautaires sans abonnement, mettre à niveau tout le système, configurer automatiquement le fuseau horaire et NTP, supprimer les traductions APT pour économiser bande passante et espace disque et choisir parmi 25 utilitaires courants."
|
||||
},
|
||||
"upgrade": {
|
||||
"heading": "Mettre à jour les listes de paquets et le système",
|
||||
"intro": "Reconfigure APT pour utiliser le dépôt gratuit <em>pve-no-subscription</em> (au lieu de la repo d'entreprise qui nécessite un abonnement) et exécute une mise à niveau complète du système. Les étapes exactes dépendent de la version majeure de Proxmox VE : ProxMenux la détecte et envoie vers le bon script.",
|
||||
"headerVersion": "Version PVE",
|
||||
"headerScript": "Script de sélection par version",
|
||||
"headerCodename": "Nom de code Debian",
|
||||
"rows": [
|
||||
{
|
||||
"version": "9.x",
|
||||
"script": "update-pve9_2.sh",
|
||||
"codename": "trixie"
|
||||
},
|
||||
{
|
||||
"version": "8.x",
|
||||
"script": "update-pve8.sh",
|
||||
"codename": "bookworm"
|
||||
}
|
||||
],
|
||||
"officialTitle": "La recommandation officielle de Proxmox",
|
||||
"officialBody": "Le guide de mise à niveau de Proxmox est à exécuter, dans cet ordre exact:",
|
||||
"officialOutro": "C’est la commande habituelle pour les mises à jour au sein de la version majeure installée de Proxmox VE. Vérifiez les dépôts et les changements de paquets proposés <em>avant</em> de continuer. Un changement de version majeure exige la procédure officielle de migration.",
|
||||
"doesTitle": "Ce que fait l'option ProxMenux — vérifié par rapport au script",
|
||||
"doesIntro": "La mise à jour ProxMenux exécute les commandes apt ci-dessus et ajoute des étapes avant et après que vous devriez autrement gérer manuellement. Les éléments suivants correspondent au script de sélection ; voir <link>Mise à jour du système Proxmox</link> pour le détail complet.",
|
||||
"doesItems": [
|
||||
"<strong>D’abord, nettoyer les dépôts.</strong> Désactive les dépôts Enterprise <code>pve-enterprise.sources</code> / <code>ceph.sources</code>, supprime les anciens fichiers de dépôt laissés par les versions précédentes de PVE et écrit un fichier <code>proxmox.sources</code> propre pointant vers le canal gratuit <em>pve-no-subscription</em>, adapté au nom de code Debian de l’hôte : trixie pour PVE 9, bookworm pour PVE 8.",
|
||||
"<strong>Réécrit les dépôts Debian</strong> avec main / updates / security et <code>non-free-firmware</code>, pour éliminer l’avertissement du firmware pendant la mise à niveau.",
|
||||
"<strong>Exécute la mise à niveau officielle.</strong> <code>apt-get update</code> suivi de <code>apt full-upgrade -y</code> (PVE 9) ou <code>apt dist-upgrade -y</code> (PVE 8), sans interaction avec <code>--force-confdef --force-confold</code> pour conserver vos fichiers de configuration personnalisés.",
|
||||
"<strong>Installe les paquets essentiels</strong> s'ils manquent: <code>zfsutils-linux</code>, <code>proxmox-backup-restore-image</code>, <code>chrony</code>.",
|
||||
"<strong>Vérifie les métadonnées LVM.</strong> Recherche les VM avec accès direct aux disques qui ont pu laisser d’anciens en-têtes de volumes physiques sur les disques bruts. Signale les anomalies sans correction automatique.",
|
||||
"<strong>Nettoye ensuite :</strong> <code>apt-get autoremove -y</code> + <code>apt-get autoclean -y</code>, puis demande un redémarrage si le noyau a été mis à jour ou si <code>/var/run/reboot-required</code> est présent."
|
||||
],
|
||||
"shortTitle": "Bref",
|
||||
"shortBody": "L’option exécute <code>apt update && apt full-upgrade -y</code> comme recommandé par Proxmox, avec le nettoyage des dépôts et les étapes finales mentionnés dans le guide officiel, puis propose un redémarrage. Voir <link>Mise à jour du système Proxmox</link> pour le diagramme complet ; le même outil est disponible seul dans le menu principal.",
|
||||
"subTitle": "Ne pas appliquer à un hôte avec abonnement",
|
||||
"subBody": "Si vous avez un abonnement Proxmox et souhaitez garder les dépôts Enterprise, ignorez cette option. Elle désactive Enterprise et passe au canal communautaire. La mise à niveau des paquets et la réécriture des dépôts ne sont pas réversibles dans Désinstaller les optimisations ; reconfigurez explicitement les dépôts pour changer de canal plus tard.",
|
||||
"safetyTitle": "Contrôle de sécurité après mise à jour",
|
||||
"safetyBody": "Après la mise à niveau, le script cherche d’anciennes métadonnées de volume physique (PV) sur les disques. Cela peut arriver lorsqu’une VM avec accès direct écrit des en-têtes LVM sur un disque brut. Toute anomalie produit un avertissement suggérant <code>pvs</code> pour l’inspection. Aucune action automatique."
|
||||
},
|
||||
"time": {
|
||||
"heading": "Synchroniser l'heure automatiquement",
|
||||
"intro": "Détecte l'IP public du serveur via <code>dig myip.opendns.com @resolver1.opendns.com</code>, puis interroge <code>ipapi.co/'{'ip'}'/timezone</code> pour rechercher le fuseau horaire IANA correspondant, et l'applique avec <code>timedatectl set-timezone</code>. Enfin permet NTP avec <code>timedatectl set-ntp true</code>.",
|
||||
"depTitle": "Dépend de deux services externes",
|
||||
"depBody": "La recherche repose sur OpenDNS et <code>ipapi.co</code> étant accessibles, et leurs réponses étant correctes. Si vous exécutez Proxmox derrière un VPN ou sur un VLAN qui s'échappe d'une autre région, le fuseau horaire détecté automatiquement peut être erroné. Dans ce cas, sautez cette option et définissez le fuseau horaire à la main:",
|
||||
"revertTitle": "Réversible depuis le menu Désinstaller",
|
||||
"revertBody": "<link>Désinstaller les optimisations</link> remet le fuseau horaire à UTC, une valeur par défaut sûre. NTP reste actif : l’horloge continue de se synchroniser et affiche UTC jusqu’au réglage manuel d’un autre fuseau."
|
||||
},
|
||||
"languages": {
|
||||
"heading": "ignorer le téléchargement de langues supplémentaires",
|
||||
"intro": "Pendant <code>apt update</code>, APT peut télécharger des descriptions de paquets traduites en plus des métadonnées principales. Cette option les désactive pour économiser bande passante et espace. Avant cela, ProxMenux <strong>vérifie que les paramètres régionaux de l’hôte sont générés</strong> : lit <code>/etc/default/locale</code> ou <code>/etc/environment</code>, ajoute à <code>/etc/locale.gen</code> si nécessaire et lance <code>locale-gen</code>. Les paramètres régionaux du shell sont ainsi conservés.",
|
||||
"writtenTitle": "Ce qui est écrit",
|
||||
"revertTitle": "Réversible depuis le menu Désinstaller",
|
||||
"revertBody": "Suppression de <code>/etc/apt/apt.conf.d/99-disable-translations</code> (soit manuellement soit à partir du menu Désinstaller) restaure le comportement par défaut et APT télécharge à nouveau les fichiers linguistiques."
|
||||
},
|
||||
"utilities": {
|
||||
"heading": "Installer les utilitaires système courants",
|
||||
"intro": "Ouvre une liste groupée de <strong>25 utilitaires sélectionnés</strong>. Choisissez et confirmez ; ProxMenux les installe via <code>apt</code>, vérifie le résultat et affiche un résumé final.",
|
||||
"imageAlt": "Sélecteur des utilitaires ProxMenux : Espace pour sélectionner, Entrée pour confirmer",
|
||||
"reuseTitle": "La même liste est réutilisée ailleurs",
|
||||
"reuseBody": "Le catalogue des 25 utilitaires est défini à un seul endroit : <code>PROXMENUX_UTILS</code> dans <code>scripts/global/utils-install-functions.sh</code>. Le menu <em>Utilitaires et outils → Utilitaires système</em> présente la même liste pour en ajouter plus tard sans refaire la post-installation.",
|
||||
"listTitle": "Ce qui est dans la liste",
|
||||
"groups": [
|
||||
{
|
||||
"group": "Moniteurs système",
|
||||
"items": [
|
||||
{
|
||||
"pkg": "htop",
|
||||
"desc": "Affichage interactif des processus"
|
||||
},
|
||||
{
|
||||
"pkg": "btop",
|
||||
"desc": "Moniteur de ressources modernes (CPU, RAM, disques, net, processus)"
|
||||
},
|
||||
{
|
||||
"pkg": "s-tui",
|
||||
"desc": "Interface terminal pour les tests de charge CPU et la surveillance"
|
||||
},
|
||||
{
|
||||
"pkg": "iftop",
|
||||
"desc": "Utilisation de bande passante par connexion en direct"
|
||||
},
|
||||
{
|
||||
"pkg": "iotop",
|
||||
"desc": "E/S disque par processus"
|
||||
},
|
||||
{
|
||||
"pkg": "iptraf-ng",
|
||||
"desc": "Moniteur IP LAN interactif"
|
||||
}
|
||||
]
|
||||
},
|
||||
{
|
||||
"group": "Réseau",
|
||||
"items": [
|
||||
{
|
||||
"pkg": "iperf3",
|
||||
"desc": "Mesurer la bande passante maximale réalisable entre les hôtes"
|
||||
},
|
||||
{
|
||||
"pkg": "net-tools",
|
||||
"desc": "Anciens outils (ifconfig, netstat, route). Toujours utiles pour les vérifications rapides"
|
||||
},
|
||||
{
|
||||
"pkg": "ipset",
|
||||
"desc": "Gérer les grands ensembles IP dans le noyau — utile avec les règles iptables/nftables."
|
||||
}
|
||||
]
|
||||
},
|
||||
{
|
||||
"group": "Téléchargement et archive",
|
||||
"items": [
|
||||
{
|
||||
"pkg": "axel",
|
||||
"desc": "accélérateur de téléchargement parallèle léger"
|
||||
},
|
||||
{
|
||||
"pkg": "aria2",
|
||||
"desc": "Téléchargeur multisource / multiprotocole (HTTP, FTP, BitTorrent, Metalink)"
|
||||
},
|
||||
{
|
||||
"pkg": "unzip",
|
||||
"desc": "Extraire les archives ZIP"
|
||||
},
|
||||
{
|
||||
"pkg": "zip",
|
||||
"desc": "Créer des archives ZIP"
|
||||
},
|
||||
{
|
||||
"pkg": "cabextract",
|
||||
"desc": "Extraire les archives Microsoft CAB (utile avec les ISO Windows)"
|
||||
},
|
||||
{
|
||||
"pkg": "wimtools",
|
||||
"desc": "Manipuler les images WIM Windows (extraire, fractionner, monter, appliquer)"
|
||||
},
|
||||
{
|
||||
"pkg": "genisoimage",
|
||||
"desc": "Construire des images ISO 9660 à partir d'un arbre de répertoires"
|
||||
}
|
||||
]
|
||||
},
|
||||
{
|
||||
"group": "Texte et fichiers",
|
||||
"items": [
|
||||
{
|
||||
"pkg": "dos2unix",
|
||||
"desc": "Convertir les fins de ligne CRLF (Windows) en LF (Unix)"
|
||||
},
|
||||
{
|
||||
"pkg": "grc",
|
||||
"desc": "Coloration générique : applique une coloration syntaxique aux sorties de ping, traceroute, dig, tail, etc."
|
||||
},
|
||||
{
|
||||
"pkg": "plocate",
|
||||
"desc": "Recherche rapide de fichiers (indexée). Exécutez `updatedb` après l'installation pour construire l'index."
|
||||
}
|
||||
]
|
||||
},
|
||||
{
|
||||
"group": "Accès distant et sessions",
|
||||
"items": [
|
||||
{
|
||||
"pkg": "sshpass",
|
||||
"desc": "Authentification SSH par mot de passe sans interaction (pour les scripts, pas pour l’usage quotidien)"
|
||||
},
|
||||
{
|
||||
"pkg": "tmux",
|
||||
"desc": "Multiplexeur de terminal : détacher les sessions, diviser les panneaux et conserver les sessions après une déconnexion"
|
||||
}
|
||||
]
|
||||
},
|
||||
{
|
||||
"group": "Matériel et bas niveau",
|
||||
"items": [
|
||||
{
|
||||
"pkg": "msr-tools",
|
||||
"desc": "Registres spécifiques au modèle CPU de lecture/écriture (rdmsr, wrmsr)"
|
||||
},
|
||||
{
|
||||
"pkg": "intel-gpu-tools",
|
||||
"desc": "utilitaires de diagnostic Intel GPU y compris `intel_gpu_top`"
|
||||
}
|
||||
]
|
||||
},
|
||||
{
|
||||
"group": "Virtualisation",
|
||||
"items": [
|
||||
{
|
||||
"pkg": "libguestfs-tools",
|
||||
"desc": "Inspecter et modifier les images de disque VM (virt-ls, virt-cat, guestmount...)"
|
||||
},
|
||||
{
|
||||
"pkg": "chntpw",
|
||||
"desc": "Modifier Windows SAM — utile pour la récupération de mot de passe sur Windows VMs que vous héritez"
|
||||
}
|
||||
]
|
||||
}
|
||||
],
|
||||
"actionTitle": "Quelques-uns en action",
|
||||
"noBulkTitle": "Seuls les utilitaires installés par ProxMenux sont supprimés",
|
||||
"noBulkBody": "ProxMenux enregistre uniquement les paquets sélectionnés qui n’étaient pas déjà installés. Désinstaller les optimisations les supprime complètement et conserve les paquets présents auparavant. Une mise à niveau APT n’a pas de retour arrière atomique sûr : désinstaller les utilitaires n’annule pas la mise à niveau du système."
|
||||
},
|
||||
"related": {
|
||||
"heading": "Voir aussi",
|
||||
"items": [
|
||||
{
|
||||
"label": "Mise à jour du système Proxmox",
|
||||
"href": "/docs/utils/system-update",
|
||||
"tail": "— relance le cycle apt update + dist-upgrade sur demande."
|
||||
},
|
||||
{
|
||||
"label": "Installateur des utilitaires système",
|
||||
"href": "/docs/utils/system-utils",
|
||||
"tail": "— installer (ou réinstaller) les utilitaires individuellement après l'installation."
|
||||
},
|
||||
{
|
||||
"label": "Commandes de mises à jour et de paquets",
|
||||
"href": "/docs/help-info/update-commands",
|
||||
"tail": " — Référence apt pour le shell."
|
||||
},
|
||||
{
|
||||
"label": "Post-installation personnalisable",
|
||||
"href": "/docs/post-install/customizable",
|
||||
"tail": "— retour au menu parent."
|
||||
}
|
||||
]
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,106 @@
|
||||
{
|
||||
"meta": {
|
||||
"title": "Script post-installation personnalisable | Documentation ProxMenux",
|
||||
"description": "Choisissez précisément les optimisations à appliquer à un hôte Proxmox VE avec ProxMenux. 10 catégories, environ 35 outils et une interface à cases à cocher. Inclut tout le script Automatisé, plus des options à activer explicitement (IOMMU, Fastfetch, Figurine, Ceph, HA, correctifs AMD…).",
|
||||
"ogTitle": "Script post-installation personnalisable | Documentation ProxMenux",
|
||||
"ogDescription": "10 catégories, environ 35 optimisations individuelles. Choisissez précisément ce que vous voulez sur un hôte Proxmox VE. Les modifications réversibles sont suivies."
|
||||
},
|
||||
"header": {
|
||||
"title": "Script post-installation personnalisable",
|
||||
"description": "Choisissez précisément les optimisations à appliquer à un hôte Proxmox VE. ProxMenux regroupe environ 35 outils dans 10 catégories au sein d’une seule boîte de dialogue à cases à cocher. Même moteur qu’Automatisé, avec un contrôle complet.",
|
||||
"section": "Post-Installation · Personnalisable"
|
||||
},
|
||||
"intro": {
|
||||
"title": "Quand choisir Personnalisable",
|
||||
"body": "Choisissez cette voie si vous connaissez déjà les réglages souhaités ou à éviter. Une liste à cases à cocher, groupée par catégorie, permet de sélectionner, désélectionner et combiner les optimisations. Vous pouvez les réappliquer plus tard ; les modifications réversibles sont suivies pour <link>Désinstaller les optimisations</link>. Les mises à niveau de paquets ne sont pas présentées comme réversibles."
|
||||
},
|
||||
"compare": {
|
||||
"heading": "Comment il se compare à Automatisé",
|
||||
"body": "Personnalisable inclut tout le <link>script Automatisé</link> : les mêmes 14 optimisations de base et de nombreuses options volontairement omises par Automatisé, utiles à certains matériels (correctifs AMD), hébergeurs (OVH RTM) ou usages (IOMMU/VFIO, dépôt Ceph, haute disponibilité, Fastfetch, Figurine, réglage de l’ARC ZFS, pigz, instantanés ZFS automatiques, limites de vitesse vzdump, Open vSwitch, TCP BBR…)."
|
||||
},
|
||||
"categoriesSection": {
|
||||
"heading": "Les 10 catégories",
|
||||
"body": "Le script Personnalisable regroupe les optimisations en 10 catégories dans une seule boîte de dialogue à cases à cocher. Chaque catégorie a sa propre page de documentation : ouvrez une carte pour consulter la justification, les valeurs par défaut et les vérifications de chaque option."
|
||||
},
|
||||
"categories": [
|
||||
{
|
||||
"name": "Paramètres de base",
|
||||
"description": "Nettoyer les sources APT, lancer la mise à niveau officielle Proxmox et définir le fuseau horaire, les paramètres régionaux et les utilitaires courants. La base de toutes les autres catégories."
|
||||
},
|
||||
{
|
||||
"name": "Système",
|
||||
"description": "Règle la journalisation et les limites du noyau pour un hôte hébergeant de nombreuses VM et conteneurs. Couvre journald, logrotate, sysctl (mémoire, limites de fichiers), le comportement en cas de kernel panic et les redémarrages rapides."
|
||||
},
|
||||
{
|
||||
"name": "Virtualisation",
|
||||
"description": "Prépare l’hôte à la virtualisation avancée. Installe l’agent invité adapté lorsque Proxmox lui-même fonctionne dans une VM prise en charge et active IOMMU/VFIO pour l’accès direct PCI des GPU, contrôleurs et TPU."
|
||||
},
|
||||
{
|
||||
"name": "Réseau",
|
||||
"description": "Renforce et règle la pile réseau de l’hôte. Force APT sur IPv4, applique des réglages de sécurité sysctl et des tampons TCP, propose Open vSwitch, TCP BBR et TCP Fast Open et associe les noms d’interface persistants aux adresses MAC."
|
||||
},
|
||||
{
|
||||
"name": "Stockage",
|
||||
"description": "Configure les sous-systèmes de stockage courants de Proxmox : taille de l’ARC ZFS, instantanés ZFS automatiques, autotrim ZFS pour les pools SSD/NVMe et limites de vitesse vzdump pour éviter de saturer les disques pendant les sauvegardes."
|
||||
},
|
||||
{
|
||||
"name": "Sécurité",
|
||||
"description": "Réduit la surface d’attaque exposée par défaut. Désactive les services RPC portmapper/rpcbind dont Proxmox n’a pas besoin mais qu’il laisse en écoute."
|
||||
},
|
||||
{
|
||||
"name": "Personnalisation",
|
||||
"description": "Changer l'expérience visuelle et shell de l'hôte: couleurs et alias dans bashrc, bannière MOTD et suppression de l'avis d'abonnement dans l'interface utilisateur web."
|
||||
},
|
||||
{
|
||||
"name": "Surveillance",
|
||||
"description": "Intègre l’hôte à OVH Real-Time Monitoring. Installe RTM uniquement si ProxMenux détecte un serveur OVH ; l’option ne modifie rien sur les autres hôtes."
|
||||
},
|
||||
{
|
||||
"name": "Performances",
|
||||
"description": "Accélère la compression (sauvegardes, transferts) en remplaçant gzip par son équivalent parallèle pigz."
|
||||
},
|
||||
{
|
||||
"name": "Facultatif",
|
||||
"description": "Options spécialisées dont tous les hôtes n’ont pas besoin : correctifs CPU AMD, bannière Fastfetch, nom d’hôte 3D Figurine, actualisation de l’index PVE Appliance Manager, dépôt Ceph, services haute disponibilité, Log2RAM pour limiter l’usure des SSD et profil de swap ZRAM."
|
||||
}
|
||||
],
|
||||
"mixTip": {
|
||||
"title": "Combiner Automatisé et Personnalisable",
|
||||
"body": "Un usage courant : commencez par <strong>Automatisé</strong> pour établir une base raisonnable, puis ouvrez <strong>Personnalisable</strong> et choisissez seulement les options utiles, comme IOMMU pour l’accès direct à un GPU. Les modifications sont suivies séparément ; Désinstaller affiche tout ce qui a été appliqué, quelle que soit la voie utilisée."
|
||||
},
|
||||
"related": {
|
||||
"heading": "Voir aussi",
|
||||
"items": [
|
||||
{
|
||||
"label": "Post-installation automatisée",
|
||||
"href": "/docs/post-install/automated",
|
||||
"tail": " — valeurs par défaut raisonnables appliquées sans question."
|
||||
},
|
||||
{
|
||||
"label": "Désinstaller les optimisations",
|
||||
"href": "/docs/post-install/uninstall",
|
||||
"tail": " — annuler proprement les éléments sélectionnés."
|
||||
},
|
||||
{
|
||||
"label": "Paramètres de base",
|
||||
"href": "/docs/post-install/basic-settings",
|
||||
"tail": "— repos, temps, langue, utilitaires."
|
||||
},
|
||||
{
|
||||
"label": "Virtualisation",
|
||||
"href": "/docs/post-install/virtualization",
|
||||
"tail": "— IOMMU + VFIO pour transmission."
|
||||
},
|
||||
{
|
||||
"label": "Sécurité",
|
||||
"href": "/docs/post-install/security",
|
||||
"tailRich": " · <storageLink>Stockage</storageLink> · <networkLink>Réseau</networkLink> · <customLink>Personnalisation</customLink> — autres catégories."
|
||||
},
|
||||
{
|
||||
"label": "Aperçu après l'installation",
|
||||
"href": "/docs/post-install",
|
||||
"tail": "."
|
||||
}
|
||||
]
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,74 @@
|
||||
{
|
||||
"meta": {
|
||||
"title": "Post-installation : Personnalisation | Documentation ProxMenux",
|
||||
"description": "Options de personnalisation du script post-installation personnalisable de ProxMenux : invite bash colorée avec des alias utiles, bannière ProxMenux dans le MOTD et suppression du rappel d’abonnement de l’interface web Proxmox."
|
||||
},
|
||||
"header": {
|
||||
"title": "Après installation : personnalisation",
|
||||
"description": "Réglages visuels et pratiques de l’hôte Proxmox. Ils rendent le shell plus agréable et masquent le rappel d’abonnement de l’interface web. Bashrc, MOTD et la bannière sont suivis et réversibles depuis Désinstaller.",
|
||||
"section": "Paramètres post-installation de Proxmox"
|
||||
},
|
||||
"intro": {
|
||||
"title": "Ce que cette catégorie couvre",
|
||||
"body": "Trois petites options indépendantes : une <strong>invite bash colorée avec alias</strong> pour le shell root, une <strong>bannière MOTD</strong> d’une ligne à la connexion SSH et la suppression de la <strong>fenêtre « Aucun abonnement valide »</strong> affichée à chaque connexion web Proxmox."
|
||||
},
|
||||
"bashrc": {
|
||||
"heading": "Personnaliser bashrc",
|
||||
"intro": "Insère dans <code>/root/.bashrc</code> un bloc préparé avec une invite colorée, un historique horodaté, les alias habituels de <code>ls</code> / <code>grep</code> et un <code>source</code> pour l’autocomplétion bash. Rend le travail via SSH plus agréable et permet d’identifier facilement l’hôte lorsque plusieurs onglets sont ouverts.",
|
||||
"writesTitle": "Ce que ProxMenux ajoute à .bashrc",
|
||||
"writesOutro": "Le bloc est délimité par les marqueurs <code>PMX_CORE_BASHRC</code>. Exécuter le script remplace à nouveau le bloc précédent au lieu de le dupliquer. Le <code>.bashrc</code> original est sauvegardé une fois sur <code>/root/.bashrc.bak</code>, et une ligne <code>source /root/.bashrc</code> est annexée au <code>/root/.bash_profile</code> de sorte que l'invite s'applique également sur les shells de connexion (par exemple après <code>su -</code>).",
|
||||
"rootTitle": "S’applique uniquement à root",
|
||||
"rootBody": "La personnalisation concerne le shell du compte root. Les autres utilisateurs gardent leurs propres réglages par défaut. Si vous administrez Proxmox uniquement par l’interface web sans utiliser le shell, vous pouvez ignorer cette option purement esthétique."
|
||||
},
|
||||
"motd": {
|
||||
"heading": "Configurer une bannière MOTD personnalisée",
|
||||
"intro": "Ajoute <em>\"This system is optimised by: ProxMenux\"</em> au début de <code>/etc/motd</code>, le message après une connexion SSH réussie, au-dessus de l’invite et avant les scripts <code>update-motd</code>. Sans danger et purement informatif : confirme visuellement que ProxMenux a été appliqué sur l’hôte.",
|
||||
"writesTitle": "Ce que ProxMenux écrit",
|
||||
"writesOutro": "À la première application, ProxMenux enregistre si <code>/etc/motd</code> existait et conserve son contenu original sous <code>/usr/local/share/proxmenux</code>. L’opération est idempotente : si la ligne de repère existe déjà, rien n’est ajouté. Les anciennes installations avec <code>/etc/motd.bak</code> sont migrées vers le même état réversible."
|
||||
},
|
||||
"banner": {
|
||||
"heading": "Supprimer la bannière d'abonnement",
|
||||
"intro": "Supprime la fenêtre <em>« Vous n’avez pas d’abonnement valide pour ce serveur »</em> affichée à chaque connexion web Proxmox sans abonnement Enterprise. ProxMenux tient compte de la version et lance le script adapté aux différents fichiers d’interface des versions majeures.",
|
||||
"versionTitle": "Choix du script selon la version",
|
||||
"versionItems": [
|
||||
"<strong>PVE 9.x</strong> → exécute <code>remove-banner-pve-v3.sh</code>, qui modifie <code>proxmoxlib.js</code> pour le bureau et la nouvelle interface mobile basée sur Yew.",
|
||||
"<strong>PVE 8.x</strong> → exécute <code>remove-banner-pve8.sh</code>, uniquement pour l’interface de bureau."
|
||||
],
|
||||
"versionOutro": "Avant le patching, ProxMenux sauvegarde les fichiers JS/template originaux vers <code>/usr/local/share/proxmenux/backups/</code> avec un horodatage. Le flux Désinstaller utilise ces sauvegardes pour restaurer les fichiers originaux, et revient à réinstaller les paquets de l'interface utilisateur Proxmox si la sauvegarde est manquante ou corrompue.",
|
||||
"breakTitle": "Peut se casser après les mises à jour Proxmox",
|
||||
"breakBody": "Les mises à jour de l’interface Proxmox écrasent régulièrement <code>proxmoxlib.js</code>, ce qui peut faire revenir le rappel. Vous pouvez réappliquer l’option pour modifier le fichier ou garder le rappel jusque-là. ProxMenux installe aussi un hook APT qui réapplique la modification après les mises à niveau de paquets ; voir <link>Désinstaller les optimisations</link> pour sa suppression.",
|
||||
"legalTitle": "Note juridique (il vaut toujours la peine de répéter)",
|
||||
"legalBody": "Cette option masque seulement le rappel de l’interface. Elle ne donne <strong>pas</strong> droit au support Enterprise ni au dépôt Enterprise et ne change pas la licence du logiciel. Proxmox VE est publié sous GNU AGPLv3. Un abonnement soutient le projet et donne accès au canal de mises à jour Enterprise ; choisissez le niveau de support adapté à votre environnement."
|
||||
},
|
||||
"verify": {
|
||||
"heading": "Vérification",
|
||||
"intro": "Après avoir appliqué les trois :",
|
||||
"reversibleTitle": "Les trois changements de personnalisation sont suivis",
|
||||
"reversibleBody": "<link>Désinstaller les optimisations</link> restaure <code>/root/.bashrc</code>, remet MOTD dans son état exact d’avant ProxMenux ou supprime le fichier s’il n’existait pas, et restaure les fichiers d’interface modifiés depuis la sauvegarde ou réinstalle les paquets concernés si nécessaire."
|
||||
},
|
||||
"related": {
|
||||
"heading": "Voir aussi",
|
||||
"items": [
|
||||
{
|
||||
"label": "Facultatif",
|
||||
"href": "/docs/post-install/optional",
|
||||
"tail": "— Fastfetch et Figurine (autres personnalisations visuelles)."
|
||||
},
|
||||
{
|
||||
"label": "Afficher les informations sur la version",
|
||||
"href": "/docs/settings/show-version-information",
|
||||
"tail": "— confirme que les personnalisations sont suivies comme installées."
|
||||
},
|
||||
{
|
||||
"label": "Désinstaller les optimisations",
|
||||
"href": "/docs/post-install/uninstall",
|
||||
"tail": " — restaurer bashrc, motd et le rappel d’abonnement."
|
||||
},
|
||||
{
|
||||
"label": "Post-installation personnalisable",
|
||||
"href": "/docs/post-install/customizable",
|
||||
"tail": "— retour au menu parent."
|
||||
}
|
||||
]
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,106 @@
|
||||
{
|
||||
"meta": {
|
||||
"title": "Script post-installation de Proxmox VE — Automatisé et personnalisable | ProxMenux",
|
||||
"description": "Présentation des scripts post-installation de ProxMenux pour Proxmox VE. Le script Automatisé applique des valeurs par défaut raisonnables sans question ; le script Personnalisable permet de choisir précisément parmi 10 catégories ; Désinstaller les optimisations restaure les modifications réversibles prises en charge.",
|
||||
"ogTitle": "Proxmox VE Script post-installation — automatisé et personnalisable",
|
||||
"ogDescription": "Appliquez les optimisations courantes après installation de Proxmox VE dans 10 catégories, automatiquement ou à la carte, avec des options réversibles.",
|
||||
"twitterTitle": "Script post-installation de Proxmox VE | ProxMenux",
|
||||
"twitterDescription": "Optimisations automatisées et personnalisables post-installation pour Proxmox VE — avec options réversibles."
|
||||
},
|
||||
"header": {
|
||||
"title": "Scripts post-installation",
|
||||
"description": "Configurez un hôte Proxmox VE fraîchement installé avec les optimisations post-installation de ProxMenux. Appliquez automatiquement la configuration de base, choisissez des options individuelles, mettez à jour les fonctions installées ou restaurez les modifications réversibles prises en charge. Les mises à niveau de paquets ne sont pas présentées comme réversibles.",
|
||||
"section": "Paramètres post-installation de Proxmox"
|
||||
},
|
||||
"intro": {
|
||||
"title": "À quoi sert ce menu",
|
||||
"body": "Après l’installation de Proxmox VE, des dizaines de petites modifications rendent l’hôte plus rapide et plus facile à entretenir : dépôts sans abonnement, limites journald raisonnables, tampons TCP adaptés, stockage des journaux ménageant les SSD, améliorations de bashrc et plus encore. ProxMenux les automatise et suit les modifications de configuration réversibles prises en charge."
|
||||
},
|
||||
"openingMenu": {
|
||||
"heading": "Ouverture du menu",
|
||||
"body": "Dans le menu principal de ProxMenux, sélectionnez <strong>Paramètres après l'installation Proxmox</strong>. Vous verrez ceci :",
|
||||
"imageAlt": "Menu des scripts post-installation : Automatisé, Personnalisable, l’entrée conditionnelle Appliquer les mises à jour disponibles (uniquement si des mises à jour sont en attente) et Désinstaller, suivis de la section Scripts communautaires"
|
||||
},
|
||||
"threeWays": {
|
||||
"heading": "Quatre façons d'appliquer les optimisations",
|
||||
"body": "Les quatre entrées ProxMenux partagent le même code et le même registre d’outils installés, mais offrent différents niveaux de contrôle. <em>Appliquer les mises à jour disponibles</em> n’apparaît que si la version sur disque d’au moins une optimisation installée est plus récente que la version enregistrée ; l’entrée reste masquée juste après la configuration de l’hôte."
|
||||
},
|
||||
"routes": [
|
||||
{
|
||||
"title": "Automatisé",
|
||||
"description": "Une sélection de 14 optimisations sûres et toujours utiles, appliquées successivement sans question. Un bon choix par défaut pour la plupart des utilisateurs.",
|
||||
"bullets": [
|
||||
"Dépôts sans abonnement + mise à niveau du système",
|
||||
"Mémoire, noyau, réglage réseau",
|
||||
"Log2RAM (détecté automatiquement sur SSD/NVMe)",
|
||||
"Limites de taille pour journald + logrotate",
|
||||
"Noms d'interface persistants"
|
||||
]
|
||||
},
|
||||
{
|
||||
"title": "Personnalisable",
|
||||
"description": "Environ 35 optimisations individuelles dans 10 catégories. Vous choisissez précisément lesquelles appliquer. Même moteur qu’Automatisé, avec un contrôle complet.",
|
||||
"bullets": [
|
||||
"Interface à cases à cocher par catégorie",
|
||||
"Inclut tout ce que fait Automatisé, plus des options à activer explicitement (IOMMU, Fastfetch, Figurine, Ceph, HA, correctifs AMD…)",
|
||||
"Exécutez-le autant de fois que voulu : les modifications sont idempotentes"
|
||||
]
|
||||
},
|
||||
{
|
||||
"title": "Appliquer les mises à jour disponibles",
|
||||
"description": "Si une optimisation post-installation (Log2Ram, paramètres de mémoire, Logrotate…) a une version sur disque plus récente que celle enregistrée sur l’hôte, cette entrée affiche uniquement les optimisations concernées. Elle relance leur fonction et actualise le registre, sans rien toucher d’autre.",
|
||||
"bullets": [
|
||||
"Activation individuelle par optimisation, uniquement celles modifiées",
|
||||
"Même sélecteur disponible dans le tableau de bord Monitor",
|
||||
"Une seule notification groupée lorsque de nouvelles mises à jour sont disponibles"
|
||||
]
|
||||
},
|
||||
{
|
||||
"title": "Désinstaller les optimisations",
|
||||
"description": "Les modifications réversibles prises en charge sont suivies dans un registre JSON et associées à une fonction de restauration. Les actions sans retour en arrière sûr, comme une mise à niveau complète des paquets, sont volontairement exclues.",
|
||||
"bullets": [
|
||||
"Détecte automatiquement les optimisations précédemment appliquées",
|
||||
"Choisit le retour adapté à chaque élément : restaurer une sauvegarde .bak si elle existe, supprimer le fragment de configuration sysctl.d si rien ne nécessitait de sauvegarde, ou réinstaller le paquet d’origine avec --force-confnew (par exemple pour la bannière d’abonnement)",
|
||||
"Demande de redémarrage si nécessaire (VFIO, noms persistants, etc.)"
|
||||
]
|
||||
}
|
||||
],
|
||||
"whichTitle": "Lequel choisir ?",
|
||||
"whichBody": "Pour une nouvelle installation de Proxmox avec une configuration de base raisonnable sans décisions à prendre : <autoLink><strong>Automatisé</strong></autoLink>. Si vous connaissez déjà les réglages souhaités ou à éviter : <customLink><strong>Personnalisable</strong></customLink>. Pour ne mettre à jour qu’une optimisation déjà appliquée dont une version plus récente est sur disque : <updatesLink><strong>Appliquer les mises à jour disponibles</strong></updatesLink>. Pour annuler proprement une modification précédente : <uninstallLink><strong>Désinstaller les optimisations</strong></uninstallLink>. Vous pouvez combiner ces modes : commencez par Automatisé, ajoutez Fastfetch ou IOMMU avec Personnalisable, puis annulez des éléments individuels plus tard.",
|
||||
"mixing": {
|
||||
"heading": "Mélange avec d'autres scripts post-installation",
|
||||
"stackTitle": "Ne pas empiler plusieurs scripts post-installation",
|
||||
"stackBody": "Exécuter plusieurs scripts post-installation sur le même hôte peut créer des fichiers de configuration en double, des entrées sysctl contradictoires ou même casser le réseau après redémarrage. Si vous avez déjà appliqué <strong>Helper-Scripts Post Install</strong>, certaines optimisations ProxMenux peuvent recouper sa configuration. Utilisez un seul outil post-installation par hôte.",
|
||||
"xshokTitle": "xshok-proxmox: déprécié",
|
||||
"xshokBody": "Les anciennes versions de ProxMenux présentaient <a>xshok-proxmox</a> comme outil post-installation complémentaire. Ce projet est désormais obsolète et n’est plus proposé dans ProxMenux. Si une ancienne exécution a laissé des marqueurs sur l’hôte, ProxMenux les détecte toujours et vous avertit. Ce n’est toutefois plus un outil à installer aux côtés de ProxMenux."
|
||||
},
|
||||
"community": {
|
||||
"heading": "Scripts communautaires",
|
||||
"body": "Le menu propose aussi deux scripts tiers du projet <a>community-scripts</a> : <em>Proxmox VE Post Install</em> et <em>Proxmox VE Microcode</em>. Ces enveloppes téléchargent et exécutent les scripts originaux via <code>wget | bash</code>. ProxMenux ne les maintient pas. Consultez <link>Dépôts externes</link> pour les détails et les questions de confiance avant de les lancer."
|
||||
},
|
||||
"related": {
|
||||
"heading": "Voir aussi",
|
||||
"items": [
|
||||
{
|
||||
"label": "Mise à jour du système Proxmox",
|
||||
"href": "/docs/utils/system-update",
|
||||
"tail": "— tient l'hôte à jour une fois qu'il a été installé."
|
||||
},
|
||||
{
|
||||
"label": "Sécurité",
|
||||
"href": "/docs/security",
|
||||
"tail": "— Fail2Ban + Lynis au-dessus du durcissement post-installation."
|
||||
},
|
||||
{
|
||||
"label": "Afficher les informations sur la version",
|
||||
"href": "/docs/settings/show-version-information",
|
||||
"tail": "— voir quels composants post-installation sont suivis comme installés."
|
||||
},
|
||||
{
|
||||
"label": "Commandes de mises à jour et de paquets",
|
||||
"href": "/docs/help-info/update-commands",
|
||||
"tail": "— référence pour apt / pveupgrade."
|
||||
}
|
||||
]
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,56 @@
|
||||
{
|
||||
"meta": {
|
||||
"title": "Post-installation : Surveillance | Documentation ProxMenux",
|
||||
"description": "Options de surveillance dans le script de post-installation personnalisable ProxMenux. Actuellement une seule option : installer OVH Real-Time Monitoring (RTM), qui ne s'active que si l'hôte est détecté comme serveur OVH."
|
||||
},
|
||||
"header": {
|
||||
"title": "Après installation : surveillance",
|
||||
"description": "Options de surveillance dans le script de post-installation personnalisable. Cette catégorie est petite et spécifique au fournisseur, elle installe l'agent de surveillance en temps réel OVH sur des serveurs OVH dédiés et ne fait rien ailleurs.",
|
||||
"section": "Paramètres post-installation de Proxmox"
|
||||
},
|
||||
"intro": {
|
||||
"title": "Un périmètre volontairement limité",
|
||||
"body": "La surveillance post-installation se limite à <strong>un agent propre à un fournisseur</strong>. Les outils généraux (Prometheus, Grafana, node_exporter) sont hors périmètre, car leurs choix d’architecture — hôte séparé, conservation des données, destinataires des alertes — dépassent une étape en un clic. ProxMenux Monitor, inclus dans ProxMenux, remplit l’essentiel de ce rôle sans agent externe."
|
||||
},
|
||||
"ovh": {
|
||||
"heading": "Installer la surveillance en temps réel OVH (RTM)",
|
||||
"intro": "Si votre hôte Proxmox est un serveur dédié loué à partir de <a>OVHcloud</a>, vous pouvez permettre à RTM d'exposer la télémétrie matérielle (température CPU, statut PSU, disque SMART, état contrôleur RAID, etc.) au panneau de contrôle OVH. C'est le même agent OVH utilise pour leur propre fonction \"Surveillance du serveur\".",
|
||||
"decisionsTitle": "La décision de ProxMenux",
|
||||
"decisionsItems": [
|
||||
"Obtenez l'IP public de l'hôte via <code>curl ipinfo.io/ip</code>.",
|
||||
"Examine le FAI propriétaire avec une requête <code>whois</code> sur <code>v4.whois.cymru.com</code>.",
|
||||
"Si le résultat mentionne OVH, télécharge <code>last-public-ovh-infra-yak.snap.mirrors.ovh.net/yak/archives/apply.sh</code> et le transmet à <code>bash</code> avec le manifeste Puppet de RTM v2.",
|
||||
"Si le résultat ne mentionne <em>pas</em> OVH, rien n'est installé. L'option est sans opération."
|
||||
],
|
||||
"remoteTitle": "Le script distant est passé à bash",
|
||||
"remoteBody": "L’installation exécute <code>wget -qO - https://…apply.sh | bash</code>. Si le miroir OVH est compromis, le script s’exécute en root sur votre hôte. Avant d’activer l’option, mettez en balance la confiance dans la chaîne de miroirs OVH et le bénéfice de surveillance. Pour la plupart des utilisateurs de laboratoires domestiques ou hors OVH, l’option devrait rester désactivée.",
|
||||
"noOpTitle": "Activer uniquement si l'hôte est effectivement à OVH",
|
||||
"noOpBody": "L'option est un non-op sur les serveurs non-OVH, donc cochez-le sur un Proxmox home-lab ne casse rien. Sur un hôte non-OVH le script imprime <em>\"Pas un serveur OVH, sauter l'installation RTM\"</em> et sortir proprement; aucun paquet n'est installé.",
|
||||
"runsTitle": "Ce que ProxMenux exécute",
|
||||
"verifyTitle": "Vérification",
|
||||
"verifyBody": "Sur un véritable hôte OVH, après un redémarrage, vous devriez voir le tableau de bord <a>RTM</a> dans votre gestionnaire OVH peuplé de données en direct pour l'hôte. Du côté Proxmox, le capteur RTM est un service systemd — vérifiez-le directement:",
|
||||
"troubleTitle": "Dépannage",
|
||||
"revertTitle": "Supprimer RTM depuis le menu Désinstaller",
|
||||
"revertBody": "Si RTM est enregistré comme installé, Désinstaller les optimisations propose une entrée OVH Real-Time Monitoring. Elle exécute <code>apt-get purge -y ''ovh-rtm*'' ''rtm'' ''rtm-*''</code>, supprime /etc/rtm et marque RTM comme désinstallé. Des éléments Puppet peuvent encore nécessiter un nettoyage manuel ; examinez les manifestes propres à RTM dans <code>/etc/puppet/</code>. Sur un hôte hors OVH, aucun paquet RTM n’a été installé, donc rien n’est à supprimer."
|
||||
},
|
||||
"related": {
|
||||
"heading": "Voir aussi",
|
||||
"items": [
|
||||
{
|
||||
"label": "ProxMenux Monitor",
|
||||
"href": "/docs/settings/proxmenux-monitor",
|
||||
"tail": "— tableau de bord web local pour l'hôte (travaille sur n'importe quel fournisseur, pas seulement OVH)."
|
||||
},
|
||||
{
|
||||
"label": "Commandes système utiles",
|
||||
"href": "/docs/help-info/system-commands",
|
||||
"tail": "— référence de surveillance des hôtes locaux."
|
||||
},
|
||||
{
|
||||
"label": "Post-installation personnalisable",
|
||||
"href": "/docs/post-install/customizable",
|
||||
"tail": "— retour au menu parent."
|
||||
}
|
||||
]
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,128 @@
|
||||
{
|
||||
"meta": {
|
||||
"title": "Post-installation : Réseau | Documentation ProxMenux",
|
||||
"description": "Options réseau du script de post-installation personnalisable ProxMenux : forcer APT sur IPv4, appliquer un profil sysctl sélectionné, installer Open vSwitch, activer TCP BBR + Fast Open et associer les noms d’interfaces aux adresses MAC."
|
||||
},
|
||||
"header": {
|
||||
"title": "Post-Installation: Réseau",
|
||||
"section": "Paramètres post-installation de Proxmox"
|
||||
},
|
||||
"intro": {
|
||||
"title": "Ce que cette catégorie couvre",
|
||||
"body": "Cinq options réseau indépendantes. Deux sont simples (<strong>APT sur IPv4</strong>, <strong>installation d’Open vSwitch</strong>), deux règlent le comportement TCP (<strong>profil sysctl réseau</strong>, <strong>BBR + Fast Open</strong>) et une résout un problème courant : <strong>fixer les noms d’interfaces</strong> pour qu’une nouvelle carte réseau ou une mise à jour du BIOS ne renomme pas <code>enp3s0</code> en <code>enp4s0</code> et ne casse pas vos ponts."
|
||||
},
|
||||
"ipv4": {
|
||||
"heading": "Forcer APT à utiliser IPv4",
|
||||
"intro": "Écrit <code>Acquire::ForceIPv4 \"true\";</code> à <code>/etc/apt/apt.conf.d/99-force-ipv4</code>. APT refuse alors d'utiliser IPv6 pour les téléchargements de paquets, même si l'hôte a une connectivité IPv6.",
|
||||
"tipTitle": "Bénéficiaires",
|
||||
"tipBody": "Utile si la connexion IPv6 est instable, plus lente qu’IPv4 ou si le miroir Debian/Proxmox échoue parfois en IPv6. Sans effet indésirable sur les hôtes sans IPv6. Sur un réseau double pile sain, le comportement devient prévisible : apt ne vous surprendra pas avec un délai d’attente IPv6 dépassé."
|
||||
},
|
||||
"sysctl": {
|
||||
"heading": "Appliquer les optimisations réseau",
|
||||
"intro": "Écrit un profil sysctl sélectionné dans <code>/etc/sysctl.d/99-network.conf</code> : tampons de sockets du noyau, durcissement ICMP, protection de base contre l’usurpation d’adresse et tailles de tampons TCP adaptées à un hyperviseur avec de nombreux flux simultanés.",
|
||||
"tunedTitle": "Paramètres ajustés",
|
||||
"headerArea": "Domaine",
|
||||
"headerSettings": "Paramètres clés",
|
||||
"rows": [
|
||||
{
|
||||
"area": "Tampons de sockets du noyau",
|
||||
"settings": "<code>netdev_max_backlog=8192</code>, <code>rmem_max=16M</code>, <code>wmem_max=16M</code>, <code>somaxconn=8192</code>"
|
||||
},
|
||||
{
|
||||
"area": "durcissement ICMP",
|
||||
"settings": "<code>icmp_echo_ignore_broadcasts=1</code>, <code>icmp_ignore_bogus_error_responses=1</code>"
|
||||
},
|
||||
{
|
||||
"area": "Sécurité du routage",
|
||||
"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": "Filtre de chemin inversé",
|
||||
"settings": "<code>rp_filter=2</code> (mode souple, voir la note ci-dessous)"
|
||||
},
|
||||
{
|
||||
"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": "Ports",
|
||||
"settings": "<code>ip_local_port_range=1024 65535</code> (plage de ports éphémères)"
|
||||
},
|
||||
{
|
||||
"area": "Sockets Unix",
|
||||
"settings": "<code>net.unix.max_dgram_qlen=4096</code>"
|
||||
}
|
||||
],
|
||||
"sourceOutro": "Il ajoute également <code>source /etc/network/interfaces.d/*</code> à <code>/etc/network/interfaces</code> si ce n'est déjà présent — pratique standard pour que vous puissiez déposer des extraits d'interface modulaires sans modifier le fichier principal.",
|
||||
"fwbrTitle": "Réglage automatique des ponts pare-feu virtuels",
|
||||
"fwbrBody": "En plus du profil sysctl, ProxMenux installe le script auxiliaire <code>/usr/local/sbin/proxmenux-fwbr-tune</code>, qui applique <code>rp_filter=0</code> et <code>log_martians=0</code> aux interfaces <code>fwbr*</code> / <code>fwln*</code> / <code>fwpr*</code> / <code>tap*</code> créées par Proxmox pour les VM et conteneurs. L’unité à exécution unique <code>proxmenux-fwbr-tune.service</code> le lance au démarrage, et la règle <code>/etc/udev/rules.d/99-zz-proxmenux-fwbr-tune.rules</code> à chaque événement <code>net add</code> correspondant à ces préfixes. Cela couvre les interfaces recréées au démarrage ou à l’arrêt des VM, au redémarrage et à la migration à chaud. Le script traite aussi les interfaces existantes immédiatement après l’installation.",
|
||||
"rpFilterTitle": "Pourquoi rp_filter=2 (souple) plutôt que 1 (strict)",
|
||||
"rpFilterBody": "Le filtrage strict du chemin inverse rejette les paquets dont l’adresse source serait accessible par une interface <em>différente</em>. C’est une valeur par défaut adaptée aux clients, mais problématique sur un hôte Proxmox où le trafic VM arrive souvent par un pont et repart par une liaison montante avec des routes asymétriques. <code>rp_filter=2</code> (souple) ne rejette que les paquets dont la source est réellement injoignable par routage. Le compromis réduit légèrement la détection de l’usurpation d’IP locale pour préserver le réseau des VM."
|
||||
},
|
||||
"ovs": {
|
||||
"heading": "Installer Open vSwitch",
|
||||
"intro": "Installe <code>openvswitch-switch</code> + <code>openvswitch-common</code>. Ces paquets ajoutent OVS comme alternative aux ponts Linux utilisés par défaut par Proxmox. L’installation seule ne modifie pas le réseau : les ponts <code>vmbrX</code> existants continuent de fonctionner. Lorsque vous <em>créez</em> un nouveau pont dans Proxmox, OVS devient disponible dans la liste des types.",
|
||||
"tipTitle": "Quand OVS a du sens",
|
||||
"tipBody": "Envisagez OVS pour <strong>des trunks VLAN avec des ID non contigus</strong>, <strong>LACP avec LLDP dans certains modes</strong>, <strong>la programmation fine des flux</strong> (OpenFlow) ou l’interopérabilité avec les contrôleurs SDN. Pour un laboratoire domestique avec quelques VLAN et une seule liaison montante LACP, les ponts Linux + <code>vmbrX.VID</code> sont plus simples et tout à fait adaptés.",
|
||||
"revertTitle": "Réversible depuis le menu Désinstaller",
|
||||
"revertBody": "OVS est enregistré. <link>Désinstaller les optimisations</link> lance <code>apt purge</code> pour <code>openvswitch-switch</code> et <code>openvswitch-common</code>. Migrez les ponts OVS vers des ponts Linux <em>avant</em> la désinstallation, sinon leurs VM perdront le réseau au prochain démarrage. Équivalent manuel :"
|
||||
},
|
||||
"bbr": {
|
||||
"heading": "Activer TCP BBR + TCP Fast Open",
|
||||
"intro": "Écrit deux fichiers sysctl et les recharge. BBR remplace CUBIC par l’algorithme de congestion de Google fondé sur la bande passante, qui gère mieux les liaisons à forte capacité et latence ou avec pertes. TCP Fast Open (TFO) économise un aller-retour sur les connexions TCP répétées en envoyant des données dans le SYN.",
|
||||
"verifyTitle": "Vérification",
|
||||
"impactTitle": "L'impact dépend de la charge de travail",
|
||||
"impactBody": "BBR brille sur des liaisons à haute latence ou à perte (réplication transcontinentale, tunnels VPN, clients mobiles). Sur un LAN entre deux machines sur le même commutateur, la différence est souvent dans le bruit. TFO aide les connexions courtes et répétées HTTP le plus.",
|
||||
"revertTitle": "Réversible depuis le menu Désinstaller",
|
||||
"revertBody": "BBR/TFO sont enregistrés. <link>Désinstaller les optimisations</link> supprime les deux fichiers sysctl (<code>/etc/sysctl.d/99-kernel-bbr.conf</code> et <code>99-tcp-fastopen.conf</code>) et recharge la configuration restante. Supprimer un fichier ne réinitialise pas ses valeurs actives dans le noyau. Les valeurs par défaut comme <code>cubic</code> et <code>tcp_fastopen=1</code> reviennent après un redémarrage, sauf si une autre configuration les remplace. Équivalent manuel :"
|
||||
},
|
||||
"names": {
|
||||
"heading": "Noms d’interfaces persistants",
|
||||
"intro": "Parcourt les cartes réseau physiques de l’hôte, en excluant loopback, les veth Docker, les ponts, les périphériques TAP, les bonds, Cilium, ZeroTier et WireGuard. Écrit un fichier systemd <code>.link</code> associant le nom actuel à l’adresse MAC actuelle. Cette association prend alors le pas sur le nommage automatique du noyau.",
|
||||
"whyTitle": "Pourquoi cela est important",
|
||||
"whyItems": [
|
||||
"L'ajout ou la suppression de périphériques PCIe peut déplacer la numérotation du bus, transformer <code>enp3s0</code> en <code>enp4s0</code>. Si votre <code>/etc/network/interfaces</code> fait référence à l'ancien nom, le pont disparaît sur le redémarrage.",
|
||||
"Les mises à jour du BIOS ou du firmware changent parfois l’énumération des périphériques, avec le même effet.",
|
||||
"Le script écrit des fichiers <code>.link</code> pour les cartes physiques, y compris les ports des bonds, avec la MAC indiquée par sysfs à ce moment ; pour les ports d’un bond, il peut s’agir de la MAC partagée du bond, vérifiez donc leurs noms après un redémarrage. Il ignore les interfaces virtuelles, comme les veth LXC et les bonds eux-mêmes ; il ne corrige pas les courses au nommage des cartes virtuelles <code>hotplug</code>."
|
||||
],
|
||||
"writtenTitle": "Ce qui est écrit",
|
||||
"writtenIntro": "Un fichier par NIC physique, au <code>/etc/systemd/network/10-proxmenux-<iface>.link</code>. Chaque fichier commence par l'en-tête <code># Managed by ProxMenux — do not edit</code> de sorte que ProxMenux puisse distinguer ses propres fichiers des fichiers <code>.link</code> fournis par l'utilisateur ou le paquet.",
|
||||
"writtenOutro": "Les fichiers <code>.link</code> d’autres paquets ou écrits par l’utilisateur sont conservés ; seuls ceux portant l’en-tête ProxMenux sont gérés. À chaque nouvelle exécution, la fonction vérifie ses fichiers : elle relit <code>MACAddress=</code> dans chaque <code>10-proxmenux-*.link</code> et supprime ceux dont la MAC n’apparaît plus sous <code>/sys/class/net/</code>. Les fichiers d’anciennes versions ProxMenux au format <code>10-<iface>.link</code> sont migrés automatiquement la première fois.",
|
||||
"pveTitle": "PVE 9 vs PVE 8",
|
||||
"pveBody": "Le script utilise des fichiers systemd <code>.link</code> pour les noms persistants. Sur Proxmox VE 9, il recharge aussi les règles udev après écriture afin qu’une carte déjà fixée qui est rebranchée ou redétectée applique sa règle sans redémarrage. Vérifiez les interfaces existantes après un redémarrage sur PVE 8 comme sur PVE 9. Cela ne remplace pas <code>ifupdown2</code> sur l’hôte. Le script demande un redémarrage dans les deux cas via la post-installation personnalisable.",
|
||||
"reviewTitle": "Examiner d'abord les /etc/network/interfaces existants",
|
||||
"reviewBody": "Si l’ancienne configuration dans <code>/etc/network/interfaces</code> utilise des noms de cartes générés par le noyau, fixer les noms <em>actuels</em> est le résultat souhaité. Si vous avez déjà adapté la configuration à des noms précis, vérifiez soigneusement que les noms fixés correspondent au fichier interfaces avant de redémarrer.",
|
||||
"revertTitle": "Réversible depuis le menu Désinstaller",
|
||||
"revertBody": "<link>Désinstaller les optimisations</link> supprime uniquement les fichiers <code>10-proxmenux-*.link</code> portant l’en-tête ProxMenux dans <code>/etc/systemd/network/</code>. Les fichiers <code>.link</code> de l’utilisateur ou d’autres paquets sont conservés. Le nommage par défaut de systemd revient au prochain redémarrage."
|
||||
},
|
||||
"related": {
|
||||
"heading": "Voir aussi",
|
||||
"items": [
|
||||
{
|
||||
"label": "Gestion du réseau",
|
||||
"href": "/docs/network",
|
||||
"tail": "— diagnostic, analyse des ponts, réparations guidées."
|
||||
},
|
||||
{
|
||||
"label": "Noms d'interface persistants",
|
||||
"href": "/docs/network/persistent-names",
|
||||
"tail": " — la même fonction dans un menu distinct pour plus tard ; utilisez l’une ou l’autre option, pas les deux."
|
||||
},
|
||||
{
|
||||
"label": "Référence des commandes réseau",
|
||||
"href": "/docs/help-info/network-commands",
|
||||
"tail": " — ip, ss, ethtool, sysctl."
|
||||
},
|
||||
{
|
||||
"label": "Désinstaller les optimisations",
|
||||
"href": "/docs/post-install/uninstall",
|
||||
"tail": " — annuler ces changements réseau."
|
||||
},
|
||||
{
|
||||
"label": "Post-installation personnalisable",
|
||||
"href": "/docs/post-install/customizable",
|
||||
"tail": "— retour au menu parent."
|
||||
}
|
||||
]
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,177 @@
|
||||
{
|
||||
"meta": {
|
||||
"title": "ProxMenux Post-Installation: Paramètres optionnels",
|
||||
"description": "Guide des paramètres optionnels dans le script ProxMenux post-installation pour les fonctionnalités et optimisations supplémentaires de Proxmox VE.",
|
||||
"ogTitle": "ProxMenux Post-Installation: Paramètres optionnels",
|
||||
"ogDescription": "Guide des paramètres optionnels dans le script ProxMenux post-installation pour les fonctionnalités et optimisations supplémentaires de Proxmox VE.",
|
||||
"ogImageAlt": "Paramètres optionnels après l'installation de ProxMenux"
|
||||
},
|
||||
"title": "Paramètres optionnels",
|
||||
"intro": "La catégorie <strong>Paramètres optionnels</strong> fournit des fonctions et optimisations supplémentaires à appliquer à Proxmox VE. Elles ne sont pas essentielles, mais peuvent améliorer les possibilités du système dans certains cas.",
|
||||
"available": "Fonctions optionnelles disponibles",
|
||||
"stepLabel": "Étape",
|
||||
"ceph": {
|
||||
"title": "Ajouter le dernier support Ceph",
|
||||
"intro": "Cette option installe la dernière prise en charge du système de stockage Ceph pour Proxmox VE. Ceph est un système de stockage distribué qui offre des performances élevées, la fiabilité et l'évolutivité.",
|
||||
"doesIntro": "Ce qu'il fait:",
|
||||
"doesItems": [
|
||||
"Ajoute le dépôt Ceph à votre système",
|
||||
"Mise à jour des listes de paquets",
|
||||
"Installe les paquets Ceph en utilisant la commande 'pveceph install'",
|
||||
"Vérification de l'installation"
|
||||
],
|
||||
"howUse": "Comment utiliser : Après l'installation, vous pouvez configurer et gérer le stockage Ceph en utilisant l'interface web ou les outils en ligne de commande Proxmox VE.",
|
||||
"automates": "Ce réglage automatise les commandes suivantes :"
|
||||
},
|
||||
"amd": {
|
||||
"title": "Appliquer les correctifs AMD CPU",
|
||||
"intro": "Cette option applique des corrections spécifiques pour les processeurs AMD EPYC et Ryzen pour améliorer la stabilité et la compatibilité.",
|
||||
"doesIntro": "Ce qu'il fait:",
|
||||
"doesItems": [
|
||||
"Détecte si un AMD EPYC ou Ryzen CPU est présent",
|
||||
"Applique le paramètre du noyau idle=nomwait pour prévenir les plantages aléatoires (via /etc/kernel/cmdline sur les hôtes systemd-boot ou /etc/default/grub sur les hôtes GRUB, avec une copie .bak de l’original).",
|
||||
"Configure KVM pour ignorer certains MSR (Registres spécifiques au modèle) pour une meilleure compatibilité des clients Windows"
|
||||
],
|
||||
"howUse": "Comment utiliser: Ces corrections sont appliquées automatiquement et nécessitent un redémarrage du système pour prendre effet.",
|
||||
"automates": "Ce réglage automatise les commandes suivantes :"
|
||||
},
|
||||
"ha": {
|
||||
"title": "Activer les services à haute disponibilité",
|
||||
"intro": "Cette option active les services de haute disponibilité (HA) de Proxmox VE, permettant la reprise automatique des VM et conteneurs sur un autre nœud en cas de panne.",
|
||||
"doesIntro": "Ce qu'il fait:",
|
||||
"doesItems": [
|
||||
"Active et démarre le service pve-ha-lrm (gestionnaire des ressources locales)",
|
||||
"Active et démarre le service pve-ha-crm (Gestionnaire des ressources de la grappe)",
|
||||
"Active et démarre le service Corosync pour la communication cluster"
|
||||
],
|
||||
"howUse": "Comment utiliser: Après avoir activé ces services, vous pouvez configurer des groupes et des ressources HA dans l'interface web Proxmox VE.",
|
||||
"automates": "Ce réglage automatise les commandes suivantes :"
|
||||
},
|
||||
"pveam": {
|
||||
"title": "Mettre à jour le gestionnaire d'appliances Proxmox VE",
|
||||
"intro": "Actualise l’index local des modèles de conteneurs exposé par <code>pveam</code> dans Proxmox, afin que les appliances logicielles disponibles soient à jour à la prochaine création d’un LXC.",
|
||||
"doesIntro": "Ce qu'il fait:",
|
||||
"doesItems": [
|
||||
"Exécute <code>pveam update</code> sur les miroirs Proxmox pour récupérer le catalogue actuel des appliances logicielles",
|
||||
"Remplit la liste des appliances logicielles affichée lors de la création d’un conteneur"
|
||||
],
|
||||
"howUse": "Utilisation : exécutez-le si la liste des appliances logicielles semble ancienne ou après un changement de miroir. Il télécharge uniquement l’index du catalogue, pas les modèles eux-mêmes.",
|
||||
"automates": "Ce réglage automatise la commande suivante :"
|
||||
},
|
||||
"fastfetch": {
|
||||
"title": "Installer et configurer Fastfetch",
|
||||
"intro": "Cette option installe et configure en silence Fastfetch, un outil d'information système qui affiche les spécifications du système et un logo personnalisé lors de la connexion.",
|
||||
"doesLabel": "Ce qu'il fait:",
|
||||
"doesItems": [
|
||||
"Télécharge et installe silencieusement la dernière version de Fastfetch",
|
||||
"Vous permet de choisir un logo personnalisé (<strong>ProxMenux, Proxmox, Helper-Scripts, Home-Labs-Club, Proxmology</strong>, ou un logo personnalisé)",
|
||||
"Configure Fastfetch pour afficher <em>\"Système optimisé par ProxMenux\"</em>",
|
||||
"Configure Fastfetch pour fonctionner automatiquement à la connexion de la console"
|
||||
],
|
||||
"importantLabel": "Important:",
|
||||
"importantBody": "Si vous vous connectez à Proxmox via SSH, sélectionnez le logo <strong>Proxmox</strong> ou créez un logo personnalisé en utilisant <code>jp2a</code> ou <code>img2txt</code>. Les autres logos sont générés en utilisant <code>chafa</code> et peuvent ne pas s'afficher correctement dans une session standard SSH.",
|
||||
"customLabel": "Logos personnalisés :",
|
||||
"customBody1": "Pour utiliser un logo personnalisé, placez votre fichier texte art ASCII dans : <code>/usr/local/share/fastfetch/logos/</code>",
|
||||
"customBody2": "Vous pouvez créer des logos personnalisés en utilisant des outils tels que <code>chafa</code>, <code>jp2a</code> ou <code>img2txt</code>.",
|
||||
"customBody3": "Pour de meilleurs résultats:",
|
||||
"customItems": [
|
||||
"Limitez la hauteur du logo à 35 lignes pour conserver les proportions et tenir dans le terminal",
|
||||
"Utilisez <code>chafa</code> pour les logos couleur (peut ne pas s'afficher correctement dans les sessions SSH)",
|
||||
"Utiliser <code>jp2a</code> ou <code>img2txt</code> pour les logos compatibles SSH"
|
||||
],
|
||||
"examplesLabel": "Exemple de logos :",
|
||||
"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 JC Channel",
|
||||
"src": "/fastfetch/jc-channel.png"
|
||||
},
|
||||
{
|
||||
"name": "Helper-Scripts",
|
||||
"alt": "Logo Helper-Scripts",
|
||||
"src": "https://macrimi.github.io/ProxMenux/fastfetch/helper-scripts.png"
|
||||
},
|
||||
{
|
||||
"name": "Home-Labs-Club",
|
||||
"alt": "Logo 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": "Ce réglage automatise les commandes suivantes :"
|
||||
},
|
||||
"figurine": {
|
||||
"title": "Installer et configurer Figurine",
|
||||
"intro": "Cette option installe et configure Figurine, un outil qui crée des bannières texte ASCII élégantes pour votre terminal, affichant votre nom d'hôte dans un format 3D attrayant visuellement.",
|
||||
"doesLabel": "Ce qu'il fait:",
|
||||
"doesItems": [
|
||||
"Télécharge et installe Figurine v2.1.1 depuis GitHub pour l’architecture de l’hôte (AMD64, ARM64 ou ARMv7)",
|
||||
"Crée un message de bienvenue qui affiche votre nom d'hôte dans l'art 3D ASCII lorsque vous vous connectez",
|
||||
"Met à jour le binaire Figurine existant une fois le téléchargement et l’extraction terminés avec succès",
|
||||
"Configure le message de bienvenue à exécuter automatiquement à la connexion"
|
||||
],
|
||||
"practicalLabel": "Utilisation pratique:",
|
||||
"practicalBody": "Lors de la gestion de plusieurs nœuds Proxmox dans un cluster, Figurine fournit une indication visuelle immédiate du noeud dans lequel vous êtes actuellement connecté. Cela permet d'éviter les commandes accidentelles sur le mauvais noeud et améliore votre workflow lors de la gestion de plusieurs serveurs.",
|
||||
"exampleLabel": "Exemple de sortie :",
|
||||
"imageAlt": "Figurine Exemple de sortie",
|
||||
"automates": "Ce réglage automatise le processus suivant :",
|
||||
"outro": "Après l'installation, vous verrez votre nom d'hôte affiché dans l'art 3D ASCII chaque fois que vous vous connectez, rendant immédiatement clair sur quel noeud Proxmox vous travaillez."
|
||||
},
|
||||
"log2ram": {
|
||||
"title": "Installer Log2RAM (SSD/NVMe réduction de l'usure)",
|
||||
"intro": "Log2RAM monte <code>/var/log</code> sur un disque RAM tmpfs et le synchronise régulièrement vers le disque. Mettre en mémoire les écritures journald fréquentes peut réduire l’usure SSD et les E/S. La synchronisation et un arrêt propre sauvegardent les journaux ; une coupure brutale peut perdre les entrées depuis la dernière synchronisation.",
|
||||
"upstreamLabel": "Projet en amont:",
|
||||
"upstreamUrl": "https://github.com/azlux/log2ram",
|
||||
"upstreamLinkLabel": "azlux/log2ram sur GitHub",
|
||||
"doesLabel": "Que fait ProxMenux:",
|
||||
"doesItems": [
|
||||
"Détecte si le disque racine est SSD/NVMe en lisant <code>/sys/block/<dev>/queue/rotational</code>. Sur un disque rotatif, le flux automatisé demande d'abord avant d'installer.",
|
||||
"Clone le dépôt original (<code>azlux/log2ram</code>) dans <code>/tmp/log2ram</code> et modifie <code>install.sh</code> en remplaçant <code>rsync -aAXv</code> par <code>rsync -aXv --no-acls</code>. Cela évite l’erreur <em>set_acl: Operation not supported</em> avec code de sortie 23, déclenchée par le script original lors du déplacement de /var/log sur un système sans ACL. L’unité systemd <code>log2ram</code> est activée après installation.",
|
||||
"Dimensionne le disque RAM selon la mémoire de l’hôte : <code>≤ 8 GB → 128M</code>, <code>≤ 16 GB → 256M</code>, <code>> 16 GB → 512M</code>. Écrit la valeur dans <code>SIZE=</code> de <code>/etc/log2ram.conf</code>.",
|
||||
"Planifie une synchronisation périodique du disque via <code>/etc/cron.d/log2ram</code> : toutes les 1h / 3h / 6h selon le même niveau RAM.",
|
||||
"Installe <code>/usr/local/bin/log2ram-check.sh</code>, lancé toutes les 10 minutes par <code>/etc/cron.d/log2ram-auto-sync</code>. Quand <code>/var/log</code> atteint 80% du disque RAM, il purge les anciens journaux journald. À 92%, il lance d’abord <code>logrotate -f /etc/logrotate.d/proxmox-backup-api</code> si le fichier existe : les journaux API PBS occupent souvent le plus d’espace sur un hôte PBS. Il tronque ensuite <code>pveproxy access/error</code> et <code>pveam.log</code> avant synchronisation. <code>log2ram write</code> seul copie tmpfs sur disque sans le réduire. Cette protection aide à éviter un arrêt de PVE avec <em>No space left on device</em> lorsque les journaux grossissent sans contrôle.",
|
||||
"Détecte le service <code>proxmox-backup-server</code> sur l’hôte. S’il est présent, crée <code>/etc/logrotate.d/proxmox-backup-api</code> (20 Mo × 3 rotations) et <code>/etc/cron.hourly/proxmox-backup-logrotate</code> pour limiter les journaux API PBS, souvent à l’origine de la croissance, même entre les synchronisations Log2RAM. Sans PBS, cette étape ne change rien.",
|
||||
"Ajuste les limites systemd-journald (<code>SystemMaxUse</code>, <code>RuntimeMaxUse</code>) pour qu'elles s'adaptent au disque virtuel afin qu'une seule rafale ne puisse pas le remplir.",
|
||||
"S’enregistre dans <code>installed_tools.json</code> pour pouvoir être annulé via Désinstaller les optimisations."
|
||||
],
|
||||
"howUseLabel": "Comment utiliser:",
|
||||
"howUseBody": "Le parcours automatisé installe Log2RAM sans intervention si le disque racine est SSD/NVMe. Le parcours personnalisable demande taille, intervalle et activation de la protection. L’invite indique actuellement 90%, mais le script généré utilise les seuils de nettoyage à 80% et intensif à 92% décrits plus haut.",
|
||||
"verifyLabel": "Vérifier et gérer à partir du 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": "Activer le profil d'échange ZRAM",
|
||||
"intro": "Crée un périphérique swap compressé en RAM, <code>/dev/zram0</code>, avec <code>systemd-zram-generator</code>. Les pages déplacées vers le swap sont compressées par zstd et conservées en mémoire avant l’utilisation du swap sur disque.",
|
||||
"doesLabel": "Ce qu'il fait:",
|
||||
"doesItems": [
|
||||
"Installe <code>systemd-zram-generator</code> s'il manque, et enregistre si ProxMenux l'a installé.",
|
||||
"Écrit <code>/etc/systemd/zram-generator.conf.d/90-proxmenux.conf</code> : un périphérique <code>zram0</code> d’un dixième de la RAM de l’hôte, compression zstd (<code>zstd(level=9)</code> avec systemd-zram-generator 1.2.0 ou ultérieur) et priorité swap 32767.",
|
||||
"Avec cette priorité, le noyau remplit d'abord ZRAM. Un swap existant sur disque conserve sa propre priorité et prend les pages qui ne correspondent plus à ZRAM.",
|
||||
"Avant de changer quoi que ce soit, recherche une autre configuration ZRAM: un swap zram actif, une ligne zram dans <code>/etc/fstab</code>, une unité systemd ou un autre fichier générateur. Si elle en trouve un, l'option s'arrête et laisse cette configuration telle qu'elle est.",
|
||||
"Démarre <code>dev-zram0.swap</code> et vérifie que l'appareil actif correspond au profil. Sinon, l'état précédent est rétabli.",
|
||||
"S’enregistre dans <code>installed_tools.json</code> pour pouvoir être annulé via Désinstaller les optimisations."
|
||||
],
|
||||
"howUseLabel": "Comment utiliser:",
|
||||
"howUseBody": "Cette option appartient uniquement au parcours personnalisable ; le parcours automatisé ne l’applique pas. Le périphérique est recréé à chaque démarrage. Lorsqu’il est actif, le panneau Mémoire de ProxMenux Monitor affiche capacité, swap utilisé, algorithme, taux de compression et mémoire physique occupée.",
|
||||
"verifyLabel": "Vérifier depuis le 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": "Application automatique",
|
||||
"body": "Dans le parcours personnalisable, choisissez les fonctions selon vos besoins. Log2RAM appartient aussi au parcours automatisé avec détection matérielle ; ZRAM reste réservé au personnalisable. Consultez chaque section pour les confirmations et prérequis."
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,61 @@
|
||||
{
|
||||
"meta": {
|
||||
"title": "Post-installation : Performances | Documentation ProxMenux",
|
||||
"description": "Options de performance du script post-installation personnalisable de ProxMenux. Remplace gzip à un seul thread par pigz (gzip parallèle) pour accélérer les sauvegardes et la compression sur les hôtes multicœurs."
|
||||
},
|
||||
"header": {
|
||||
"title": "Après installation : performances",
|
||||
"description": "Options de performance du script post-installation personnalisable. Cette catégorie contient une seule optimisation : remplacer gzip par pigz pour que les sauvegardes et la compression utilisent tous les cœurs du processeur au lieu d’un seul.",
|
||||
"section": "Paramètres post-installation de Proxmox"
|
||||
},
|
||||
"intro": {
|
||||
"title": "Ce que cette catégorie couvre",
|
||||
"body": "La seule option de performance ici redirige gzip vers une implémentation parallèle. Les autres réglages de performance (mémoire, ordonnancement des E/S, taille de l’ARC ZFS, limites du noyau) se trouvent dans leurs catégories (<em>Système</em>, <em>Stockage</em>), car ils concernent d’autres sous-systèmes."
|
||||
},
|
||||
"pigz": {
|
||||
"heading": "Utilisez pigz pour une compression gzip plus rapide",
|
||||
"intro": "<code>gzip</code> standard compresse avec <strong>un seul cœur de processeur</strong>. Sur les hôtes Proxmox modernes à 8, 16 ou 32 cœurs, cela limite fortement les sauvegardes VM/CT avec <code>vzdump</code>, la rotation des journaux et tout ce qui passe par <code>gzip</code>. <a>pigz</a> est un remplacement parallèle directement compatible : même sortie compatible gzip, mais travail réparti sur tous les cœurs.",
|
||||
"doesTitle": "Ce que fait ProxMenux",
|
||||
"doesIntro": "Cinq étapes, toutes idempotentes :",
|
||||
"doesItems": [
|
||||
"Définit <code>pigz: 1</code> dans <code>/etc/vzdump.conf</code> pour que l’outil de sauvegarde Proxmox utilise pigz nativement.",
|
||||
"Installe le paquet apt <code>pigz</code> s’il est absent.",
|
||||
"Écrit un script wrapper dans <code>/bin/pigzwrapper</code> qui transmet tous les arguments à <code>/usr/bin/pigz</code>.",
|
||||
"Enregistre un détournement dpkg du binaire système <code>gzip</code> (<code>/usr/bin/gzip</code> sur Proxmox VE 9, <code>/bin/gzip</code> sur Proxmox VE 8). Le binaire original est conservé à côté sous <code>gzip.distrib</code> et le wrapper prend sa place. Désormais, <em>tout</em> ce qui appelle <code>gzip</code> — logrotate, <code>tar czf</code>, scripts, vzdump — utilise pigz de façon transparente.",
|
||||
"Vérifie que le fichier conservé sous <code>gzip.distrib</code> est un gzip fonctionnel avant de placer le wrapper ; sinon, réinstalle d’abord le paquet <code>gzip</code>. Un hôte utilisant encore l’ancien remplacement <code>/bin/gzip.original</code> passe au détournement lors de la prochaine application."
|
||||
],
|
||||
"replacesTitle": "Cela remplace un binaire système",
|
||||
"replacesBody": "Placer un wrapper à la place de <code>gzip</code> est inhabituel. C’est sûr, car il produit une sortie compatible gzip, mais les scripts à chemins codés en dur, exécutés dans des chroots restrictifs ou vérifiant les empreintes des binaires peuvent se comporter différemment. Le binaire original reste sous <code>gzip.distrib</code>. Grâce au détournement dpkg, une mise à jour du paquet <code>gzip</code> ou le passage de Proxmox VE 8 à 9 met à jour ce fichier et laisse le wrapper en place.",
|
||||
"revertTitle": "Réversible depuis le menu Désinstaller",
|
||||
"revertBody": "Cette optimisation est suivie. <link>Désinstaller les optimisations</link> remet le binaire original de <code>gzip.distrib</code> à la place du wrapper, supprime le détournement et <code>pigzwrapper</code>, commente la ligne <code>pigz</code> dans <code>/etc/vzdump.conf</code>, puis exécute <code>apt purge pigz</code> après vérification du fonctionnement de gzip. Équivalent manuel sur Proxmox VE 9 :",
|
||||
"verifyTitle": "Vérification",
|
||||
"verifyBody": "Après application, <code>gzip --version</code> doit mentionner pigz. Un test rapide montre aussi la différence de vitesse sur un hôte multicœur :",
|
||||
"whenTitle": "Quand cela importe le plus",
|
||||
"whenBody": "Le gain dépend du <strong>nombre de cœurs de l’hôte</strong> et de la <strong>fréquence des sauvegardes</strong>. Sur un serveur de laboratoire domestique à 2 cœurs avec un vzdump quotidien, le gain est faible. Sur un hôte de production à 16 cœurs sauvegardant une douzaine de VM chaque nuit, pigz peut réduire la fenêtre de sauvegarde à une fraction du temps de gzip à un seul thread."
|
||||
},
|
||||
"related": {
|
||||
"heading": "Voir aussi",
|
||||
"items": [
|
||||
{
|
||||
"label": "Commandes de sauvegarde et de restauration",
|
||||
"href": "/docs/help-info/backup-commands",
|
||||
"tailRich": " — référence CLI de vzdump, dont l’option de nombre de threads <code>--pigz</code>."
|
||||
},
|
||||
{
|
||||
"label": "Stockage",
|
||||
"href": "/docs/post-install/storage",
|
||||
"tail": "— limites de vitesse vzdump et réglage ARC ZFS."
|
||||
},
|
||||
{
|
||||
"label": "Système",
|
||||
"href": "/docs/post-install/system",
|
||||
"tail": "— descripteur de fichiers et réglage de mémoire."
|
||||
},
|
||||
{
|
||||
"label": "Post-installation personnalisable",
|
||||
"href": "/docs/post-install/customizable",
|
||||
"tail": "— retour au menu parent."
|
||||
}
|
||||
]
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,57 @@
|
||||
{
|
||||
"meta": {
|
||||
"title": "Post-installation : Sécurité | Documentation ProxMenux",
|
||||
"description": "Options de sécurité disponibles dans le script de post-installation personnalisable ProxMenux. Actuellement une seule option : désactiver le service portmapper/rpcbind pour réduire la surface d'attaque de l'hôte."
|
||||
},
|
||||
"header": {
|
||||
"title": "Post-Installation: Sécurité",
|
||||
"section": "Paramètres post-installation de Proxmox"
|
||||
},
|
||||
"intro": {
|
||||
"title": "Ce que cette catégorie couvre",
|
||||
"body": "La sécurité post-installation se limite au <strong>renforcement de l’hôte applicable sans surveillance en toute sécurité</strong> : désactiver des services rarement nécessaires et pouvoir l’annuler dans Désinstaller. Les outils actifs (Fail2Ban pour prévenir les intrusions, Lynis pour les audits) se trouvent dans <em>Sécurité</em> du menu principal de ProxMenux, hors de la post-installation."
|
||||
},
|
||||
"rpcbind": {
|
||||
"heading": "Désactiver le portmapper / rpcbind",
|
||||
"intro": "<code>rpcbind</code> (anciennement <code>portmap</code>) associe les numéros de programmes RPC aux ports réseau. NFS et certains anciens outils RPC en dépendent. Sur un hôte Proxmox typique qui ne sert pas de serveur NFS, <strong>rien ne l’utilise</strong> ; le laisser actif maintient le port <code>111/tcp</code> en écoute sur toutes les interfaces.",
|
||||
"whyTitle": "Pourquoi ça vaut la peine d'être désactivé",
|
||||
"whyItems": [
|
||||
"Réduit la surface d'attaque de l'hôte — un service d'écoute de moins pour s'inquiéter.",
|
||||
"Historiquement utilisé comme vecteur de réflexion/amplification dans les attaques DDoS. Désactiver <code>rpcbind</code> supprime ce facteur d'amplification pour votre hôte.",
|
||||
"Supprime le bruit qu’il génère dans les journaux et les sorties de <code>netstat</code> / <code>ss</code>, pour repérer plus facilement l’activité réelle."
|
||||
],
|
||||
"nfsTitle": "Ne pas désactiver cela si vous utilisez NFS",
|
||||
"nfsBody": "Le serveur NFS <strong>et</strong> le client NFS utilisent <code>rpcbind</code> pour négocier les ports de <code>mountd</code>, <code>statd</code>, <code>lockd</code>, etc. N’appliquez pas cette option si l’hôte Proxmox <em>exporte</em> des partages NFS vers d’autres machines ou <em>monte</em> des partages NFS d’un NAS. Les montages échoueront avec <code>mount.nfs: rpc.statd is not running</code> ou une erreur similaire.",
|
||||
"runsTitle": "Ce que ProxMenux exécute",
|
||||
"runsOutro": "Le paquet reste installé. ProxMenux enregistre les états d’activation et d’exécution d’origine de rpcbind.service et rpcbind.socket, puis désactive et arrête les deux unités pour empêcher la réactivation du service par le socket.",
|
||||
"verifyTitle": "Vérification",
|
||||
"verifyBody": "Après application, vérifiez que <code>rpcbind</code> est arrêté et que rien n’écoute sur le port 111 :",
|
||||
"reversibleTitle": "Restaurer l'état de service original",
|
||||
"reversibleBody": "Cette modification est enregistrée dans <code>installed_tools.json</code>. <link>Désinstaller les optimisations</link> restaure chaque unité rpcbind à ses états d’activation et d’exécution relevés avant la modification par ProxMenux. L’outil ne suppose pas que rpcbind était activé sur tous les hôtes."
|
||||
},
|
||||
"related": {
|
||||
"heading": "Voir aussi",
|
||||
"items": [
|
||||
{
|
||||
"label": "Menu de sécurité",
|
||||
"href": "/docs/security",
|
||||
"tail": " — des outils plus poussés : Fail2Ban (prévention des intrusions) et Lynis (audit)."
|
||||
},
|
||||
{
|
||||
"label": "Lynis",
|
||||
"href": "/docs/security/lynis",
|
||||
"tail": " — pour auditer l’hôte et trouver d’autres possibilités de renforcer la sécurité."
|
||||
},
|
||||
{
|
||||
"label": "Commandes système utiles",
|
||||
"href": "/docs/help-info/system-commands",
|
||||
"tail": "— état de service, journalctl, référence d'audit lynis."
|
||||
},
|
||||
{
|
||||
"label": "Post-installation personnalisable",
|
||||
"href": "/docs/post-install/customizable",
|
||||
"tail": "— retour au menu parent."
|
||||
}
|
||||
]
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,167 @@
|
||||
{
|
||||
"meta": {
|
||||
"title": "Post-Installation: Stockage - Documentation ProxMenux",
|
||||
"description": "Optimisations de stockage du script de post-installation personnalisable ProxMenux : taille ZFS ARC selon la RAM de l’hôte, instantanés périodiques avec zfs-auto-snapshot et suppression des limites de vitesse des sauvegardes vzdump."
|
||||
},
|
||||
"header": {
|
||||
"title": "Post-Installation: Stockage",
|
||||
"section": "Paramètres post-installation de Proxmox"
|
||||
},
|
||||
"intro": {
|
||||
"title": "Ce que cette catégorie couvre",
|
||||
"body": "Quatre optimisations de stockage : régler <strong>ZFS ARC</strong> sur une part raisonnable de la RAM, installer et programmer <strong>les instantanés ZFS automatiques</strong>, activer <strong>ZFS autotrim</strong> sur les pools SSD/NVMe et retirer les limitations de <strong>vzdump</strong> pour accélérer les sauvegardes. Choisissez chaque option indépendante selon votre configuration. Une cinquième option, <link>Log2RAM</link>, réduit l’usure SSD/NVMe en déplaçant <code>/var/log</code> en RAM. Elle figure dans Options car le menu personnalisable la classe ainsi."
|
||||
},
|
||||
"trackedTitle": "Les quatre sont suivis dans le menu Désinstaller",
|
||||
"trackedBody": "Chaque option s’enregistre dans <code>installed_tools.json</code> pour <link>Désinstaller les optimisations</link>. <code>zfs_arc</code> supprime <code>/etc/modprobe.d/99-zfsarc.conf</code> et reconstruit initramfs ; <code>zfs_auto_snapshot</code> annule le calendrier cron et propose de purger le paquet ; <code>zfs_autotrim</code> définit <code>autotrim=off</code> sur les pools activés ; <code>vzdump_speed</code> restaure <code>/etc/vzdump.conf</code> depuis le <code>.bak</code> créé à l’installation.",
|
||||
"arc": {
|
||||
"heading": "Optimiser la taille de ZFS ARC",
|
||||
"intro": "Le <strong>Adaptive Replacement Cache (ARC)</strong> est le cache de lecture ZFS en mémoire. Les installations Proxmox VE depuis 8.1 fixent 10% de RAM, au maximum 16 GiB ; les hôtes anciens ou mis à niveau peuvent différer. Cette option écrit explicitement cette même règle (RAM/10, au maximum 16 GiB, au minimum 64 MiB) dans son propre fichier, ce qui couvre aussi les hôtes anciens ou mis à niveau. Vérifiez les réglages et la charge : un cache plus petit n’est pas toujours plus rapide.",
|
||||
"sizingTitle": "Règles de calibrage",
|
||||
"headerRam": "RAM de l'hôte",
|
||||
"headerMax": "Plafond ARC",
|
||||
"rows": [
|
||||
{
|
||||
"ram": "Formule",
|
||||
"max": "RAM / 10, plafonné à 16 GiB, avec un plancher 64 MiB"
|
||||
},
|
||||
{
|
||||
"ram": "Hôte 8 GB",
|
||||
"max": "≈ 819 MiB (RAM/10)"
|
||||
},
|
||||
{
|
||||
"ram": "Hôte 16 GB",
|
||||
"max": "≈ 1.6 GiB (RAM/10)"
|
||||
},
|
||||
{
|
||||
"ram": "Hôte 64 GB",
|
||||
"max": "≈ 6.4 GiB (RAM/10)"
|
||||
},
|
||||
{
|
||||
"ram": "≥ 160 GB hôte",
|
||||
"max": "16 GiB (plafond)"
|
||||
}
|
||||
],
|
||||
"after": "Le fichier <code>/etc/modprobe.d/99-zfsarc.conf</code> contient uniquement <code>options zfs zfs_arc_max=…</code>. Les autres paramètres ZFS (<code>zfs_arc_min</code>, prélecture/limitation des écritures L2ARC, délai TXG) ne sont pas ajustés. Au préalable, une vérification recherche les autres <code>*.conf</code> de <code>/etc/modprobe.d/</code> définissant <code>zfs_arc_min</code> / <code>zfs_arc_max</code>, les sauvegarde avec manifeste dans <code>/usr/local/share/proxmenux/backups/zfs_arc/</code> et en retire les valeurs <code>zfs_arc_min</code> / <code>zfs_arc_max</code> conflictuelles (les autres options de ces lignes sont conservées), pour que seul le fichier ARC ProxMenux fixe la limite. Puis <code>update-initramfs -u -k all</code> et, si nécessaire, <code>proxmox-boot-tool refresh</code> intègrent la limite à l’initramfs des systèmes avec racine ZFS.",
|
||||
"rebootTitle": "Nécessite un redémarrage pour prendre effet",
|
||||
"rebootBody": "Les réglages ARC sont lus au chargement du module <code>zfs</code>. Pour les hôtes avec racine ZFS, ProxMenux régénère initramfs avec <code>update-initramfs -u -k all</code> et actualise si nécessaire le chargeur avec <code>proxmox-boot-tool refresh</code>. Le nouveau paramètre exige toujours un redémarrage, signalé automatiquement.",
|
||||
"safeTitle": "Sans effet indésirable sur les hôtes sans ZFS",
|
||||
"safeBody": "La fonction n’écrit la configuration que si <code>zpool list</code> signale au moins un pool ZFS importé. Sur un hôte Proxmox ext4/LVM uniquement, ou avec outils ZFS mais sans pool importé, cocher cette option ne fait rien : aucun fichier n’est écrit.",
|
||||
"verifyTitle": "Vérification et retour arrière manuel"
|
||||
},
|
||||
"autoSnap": {
|
||||
"heading": "Installer l'instantané automatique ZFS",
|
||||
"intro": "Installe le paquet <a>zfs-auto-snapshot</a> et réécrit ses horaires cron afin que les instantanés soient pris automatiquement à plusieurs intervalles. Un grand filet de sécurité sans effort en plus de vos sauvegardes Vzdump régulières.",
|
||||
"cadenceTitle": "Fréquence des instantanés configurée par ProxMenux",
|
||||
"headerLabel": "Étiquette",
|
||||
"headerRuns": "Exécution",
|
||||
"headerKept": "Captures instantanées conservées",
|
||||
"rows": [
|
||||
{
|
||||
"label": "fréquent",
|
||||
"runs": "chaque 15 min",
|
||||
"kept": "4"
|
||||
},
|
||||
{
|
||||
"label": "horaire",
|
||||
"runs": "toutes les heures",
|
||||
"kept": "1"
|
||||
},
|
||||
{
|
||||
"label": "quotidiennement",
|
||||
"runs": "une fois par jour",
|
||||
"kept": "1"
|
||||
},
|
||||
{
|
||||
"label": "hebdomadaire",
|
||||
"runs": "une fois par semaine",
|
||||
"kept": "1"
|
||||
},
|
||||
{
|
||||
"label": "mensuel",
|
||||
"runs": "une fois par mois",
|
||||
"kept": "1"
|
||||
}
|
||||
],
|
||||
"conservativeTitle": "Rétention limitée",
|
||||
"conservativeBody": "ProxMenux est livré avec une rétention prudente (juste 4 fréquent + 1 de chaque intervalle plus long) de sorte que le stockage des instantanés ZFS ne ballonne pas. Si vous souhaitez une conservation plus longue, modifiez les numéros dans <code>/etc/cron.d/zfs-auto-snapshot</code>, <code>/etc/cron.hourly/zfs-auto-snapshot</code>, etc. après le script.",
|
||||
"onlyZfsTitle": "Utile uniquement sur les pools ZFS",
|
||||
"onlyZfsBody": "Installer le paquet sur un hôte ext4 seulement est inoffensif mais inutile — il n'y a pas d'ensembles de données ZFS pour qu'il snapshot. Passez cette option si vous n'utilisez pas ZFS.",
|
||||
"verifyTitle": "Vérification et retour arrière manuel"
|
||||
},
|
||||
"autotrim": {
|
||||
"heading": "Activer ZFS autotrim (pools SSD/NVMe)",
|
||||
"intro": "Active <code>autotrim</code> sur les pools ZFS composés uniquement de SSD ou NVMe compatibles TRIM. Le script ignore par précaution les pools avec un disque rotatif. Les pools déjà en <code>autotrim=on</code> restent inchangés.",
|
||||
"trimTitle": "Ce que TRIM fait, et pourquoi il importe sur ZFS",
|
||||
"trimBody1": "Les SSD et NVMe utilisent des blocs d’effacement internes plus grands que les secteurs logiques du système de fichiers. Après suppression d’un fichier, le disque ne sait pas encore que les secteurs sont libres ; son nettoyage interne peut donc recopier des données obsolètes pour libérer d’autres blocs. <strong>TRIM</strong> lui signale les secteurs libres pour permettre leur effacement anticipé.",
|
||||
"trimBody2": "Sans TRIM, les performances de SSD se dégradent au fil du temps car le lecteur n'a plus de blocs pré-effacés et doit faire effacer-à-écrire, et l'amplification de l'écriture augmente — les deux raccourcissant la vie utile du lecteur. Avec TRIM activé, le lecteur peut garder un bassin sain de blocs vides prêts à écrire.",
|
||||
"trimBody3": "Avec <code>autotrim=on</code>, ZFS traite en arrière-plan l’espace récemment libéré en regroupant les plages. Un <code>zpool trim <pool></code> périodique est une alternative. Autotrim évite un calendrier séparé, mais son impact dépend des disques ; le TRIM manuel périodique peut mieux convenir à certains modèles modestes.",
|
||||
"practicalTitle": "Pourquoi est-ce pratique?",
|
||||
"practicalItems": [
|
||||
"<strong>Performances d’écriture durables.</strong> TRIM peut aider le disque à récupérer efficacement les blocs inutilisés. Le bénéfice et l’impact sur la latence dépendent du matériel et de la charge.",
|
||||
"<strong>Longévité du disque.</strong> Éviter des copies internes inutiles peut réduire l’amplification d’écriture et l’usure NAND, sans garantir une durée de vie supplémentaire précise.",
|
||||
"<strong>Pas de tâche cron à prévoir.</strong> Contrairement à un <code>zpool trim</code> périodique, autotrim est géré automatiquement par le pool."
|
||||
],
|
||||
"whenTitle": "Quand est-ce nécessaire ?",
|
||||
"whenIntro1": "<strong>Envisagez de l’activer</strong> sur les pools ZFS uniquement en SSD/NVMe compatibles TRIM. Vérifiez le comportement et la latence ; un TRIM manuel planifié peut mieux convenir.",
|
||||
"whenIntro2": "<strong>Le script le saute automatiquement</strong> sur:",
|
||||
"whenSkipItems": [
|
||||
"Pools avec un vdev sur disque dur rotatif : filtre matériel prudent de ce script.",
|
||||
"Disques sans <code>discard_granularity</code> exposé dans sysfs : anciens SSD sans TRIM ou accès direct ne permettant pas au système de voir le périphérique sous-jacent.",
|
||||
"Pools où ZFS lui-même signale la propriété non supportée (rare; très vieux pools).",
|
||||
"Pools déjà mis à <code>autotrim=on</code> (non-op)."
|
||||
],
|
||||
"whenIntro3": "<strong>Non pertinent sur les hôtes ext4 seulement</strong> — il n'y a rien pour ZFS à découper. La fonction sort avec un message amical dans ce cas.",
|
||||
"recordedTitle": "Pourquoi seuls les pools ProxMenux modifiés sont enregistrés",
|
||||
"recordedBody": "La fonction n'écrit un pool à son fichier d'état interne (<code>/usr/local/share/proxmenux/zfs_autotrim_pools</code>) que lorsqu'elle a activement retourné ce pool de <code>off</code> à <code>on</code>. Les pools que vous aviez sur autotrim avant d'exécuter le script sont laissés en dehors de la liste, de sorte qu'un futur désinstallation ne désactive pas les paramètres que vous avez configurés vous-même — seuls les changements de ProxMenux sont retournés.",
|
||||
"manualTitle": "Équivalent manuel (exécutez sur votre serveur)",
|
||||
"manualIntro": "La séquence complète du script s'exécute contre chaque pool est reproductible à la main. C'est ce que vous taperiez si vous vouliez faire la même chose sur un seul pool sans ProxMenux:",
|
||||
"verifyTitle": "Vérification et retour arrière manuel",
|
||||
"oneShotTitle": "Besoin d’un TRIM ponctuel plutôt que continu ?",
|
||||
"oneShotBody": "Certains administrateurs préfèrent un TRIM manuel aux heures creuses. Désactivez autotrim et programmez une tâche cron exécutant <code>zpool trim <pool></code> : même objectif, fréquence différente."
|
||||
},
|
||||
"vzdump": {
|
||||
"heading": "Augmenter la vitesse de sauvegarde de vzdump",
|
||||
"intro": "Écrit bwlimit: 0 et ionice: 5 dans la configuration globale vzdump. Proxmox n’a déjà pas de limite de bande passante par défaut : seul un plafond configuré est retiré. Par rapport à ionice: 7, la valeur 5 augmente la priorité E/S best-effort si l’ordonnanceur la respecte. Cela peut affecter les invités sans garantir des sauvegardes plus rapides.",
|
||||
"changedTitle": "Ce qui est changé dans /etc/vzdump.conf",
|
||||
"backupTitle": "La première exécution crée un .bak de vzdump.conf",
|
||||
"backupBody": "Au premier passage, ProxMenux copie <code>/etc/vzdump.conf</code> vers <code>/etc/vzdump.conf.bak</code> avant modification. Les exécutions suivantes conservent cette sauvegarde pour récupérer la configuration antérieure. <code>bwlimit</code> et <code>ionice</code> sont modifiés par <code>sed</code> ; les autres options comme compress, pigz, tmpdir et exclude-path sont conservées.",
|
||||
"skipTitle": "Quand sauter ça",
|
||||
"skipBody": "Sur un hôte à stockage local lent avec des VM sensibles à la latence, retirer la limite de bande passante peut causer des ralentissements pendant les sauvegardes. Si vous avez défini un <code>bwlimit</code> pour cela, conservez-le et ignorez cette option.",
|
||||
"verifyTitle": "Vérification et retour arrière manuel"
|
||||
},
|
||||
"related": {
|
||||
"heading": "Voir aussi",
|
||||
"items": [
|
||||
{
|
||||
"label": "Commandes de gestion ZFS",
|
||||
"href": "/docs/help-info/zfs-commands",
|
||||
"tail": " — référence zpool / zfs pour ARC, instantanés et scrub."
|
||||
},
|
||||
{
|
||||
"label": "Commandes de stockage et de disques",
|
||||
"href": "/docs/help-info/storage-commands",
|
||||
"tail": " — référence des périphériques de blocs et du stockage Proxmox."
|
||||
},
|
||||
{
|
||||
"label": "Commandes de sauvegarde et restauration",
|
||||
"href": "/docs/help-info/backup-commands",
|
||||
"tail": " — référence CLI vzdump pour la bande passante et la priorité E/S."
|
||||
},
|
||||
{
|
||||
"label": "Désinstaller les optimisations",
|
||||
"href": "/docs/post-install/uninstall",
|
||||
"tail": " — annuler les modifications ARC / vzdump."
|
||||
},
|
||||
{
|
||||
"label": "Log2RAM",
|
||||
"href": "/docs/post-install/optional#log2ram",
|
||||
"tail": "— réduit l'usure du SSD/NVMe par le support de ramdisque /var/log; documenté sous Facultatif."
|
||||
},
|
||||
{
|
||||
"label": "Post-installation personnalisable",
|
||||
"href": "/docs/post-install/customizable",
|
||||
"tail": "— retour au menu parent."
|
||||
}
|
||||
]
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,133 @@
|
||||
{
|
||||
"meta": {
|
||||
"title": "Post-installation : Système | Documentation ProxMenux",
|
||||
"description": "Optimisations système du script de post-installation personnalisable ProxMenux : limites de taille journald et logrotate, limites du noyau et des descripteurs de fichiers relevées, réglage équilibré de la mémoire, redémarrages rapides par kexec et récupération après panique du noyau."
|
||||
},
|
||||
"header": {
|
||||
"title": "Après installation : système",
|
||||
"section": "Paramètres post-installation de Proxmox"
|
||||
},
|
||||
"intro": {
|
||||
"title": "Ce que cette catégorie couvre",
|
||||
"body": "Six optimisations système indépendantes. Elles règlent <strong>journald</strong> et <strong>logrotate</strong> pour éviter de remplir le disque, relèvent <strong>les limites du noyau et des descripteurs de fichiers</strong> pour les applications ouvrant beaucoup de fichiers, <strong>équilibrent la mémoire</strong> d’un hôte de virtualisation, ajoutent <strong>kexec</strong> pour redémarrer sans passer par le BIOS et configurent <strong>la récupération automatique</strong> après panique du noyau. Les six sont enregistrées et réversibles depuis le menu de désinstallation."
|
||||
},
|
||||
"journald": {
|
||||
"heading": "Optimiser journald",
|
||||
"intro": "Réécrit <code>/etc/systemd/journald.conf</code> avec des valeurs raisonnables pour éviter que le journal systemd remplisse progressivement la partition racine, puis redémarre <code>systemd-journald</code> et purge les anciens journaux.",
|
||||
"keyTitle": "Valeurs clés",
|
||||
"keyItems": [
|
||||
"<code>Storage=persistent</code> — tenir des journaux sur le disque à travers les reboots.",
|
||||
"<code>SystemMaxUse=64M</code> / <code>RuntimeMaxUse=60M</code> — plafonds d’utilisation du disque et de la mémoire par le journal.",
|
||||
"<code>Compress=yes</code>, <code>Seal=no</code> — compresser les journaux, désactiver le scellement à sécurité persistante (économise du CPU).",
|
||||
"<code>MaxLevelStore=info</code> — conserver les niveaux info et supérieurs, nécessaires au lecteur de journaux ProxMenux Monitor et à la détection des échecs d’authentification SSH/Proxmox par Fail2Ban dans le journal.",
|
||||
"Limite de débit : <code>1000 events / 30 s</code> pour éviter un afflux excessif de journaux.",
|
||||
"<code>ForwardToSyslog=no</code>, <code>ForwardToWall=no</code> — ne dupliquez pas les messages au syslog ou ne les diffusez pas sur des consoles."
|
||||
],
|
||||
"tipTitle": "Pourquoi MaxLevelStore=info compte",
|
||||
"tipBody": "Un seuil plus strict comme <code>warning</code> fait afficher presque les mêmes entrées à ProxMenux Monitor sur toutes les périodes, car la plupart des activités sont de niveau info, et empêche Fail2Ban de voir les échecs de connexion. Réduisez plutôt le volume avec <code>SystemMaxUse</code> et <code>RateLimitBurst</code> sans restreindre les niveaux conservés."
|
||||
},
|
||||
"logrotate": {
|
||||
"heading": "Optimiser logrotate",
|
||||
"intro": "Réécrit <code>/etc/logrotate.conf</code> avec des réglages globaux quotidiens et de taille, 7 rotations conservées, compression et <code>copytruncate</code> pour que les services continuent d’écrire sans rouvrir les fichiers. Le critère de taille, placé après le critère quotidien, prévaut sauf règle propre au journal. Le <code>logrotate.conf</code> original est sauvegardé en <code>.bak</code> à la première application.",
|
||||
"tipTitle": "Compatible avec Log2RAM",
|
||||
"tipBody": "La directive <code>size 10M</code> prévaut sur le réglage quotidien précédent ; elle ne signifie <em>pas</em> le premier des deux critères. Logrotate vérifie le seuil à son exécution, et les règles propres aux journaux peuvent remplacer les valeurs globales. Pour <code>/var/log</code> en RAM avec Log2RAM, vérifiez les règles et la fréquence du minuteur afin de contrôler l’espace."
|
||||
},
|
||||
"limits": {
|
||||
"heading": "Augmenter diverses limites du système",
|
||||
"intro": "Relève des limites du noyau, de systemd et de PAM dont les valeurs par défaut peuvent être trop faibles pour un hôte exécutant de nombreuses VM, conteneurs et services réseau.",
|
||||
"headerFile": "Fichier",
|
||||
"headerSets": "Ce qu'il définit",
|
||||
"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> et <code>nproc</code> à 1 048 576 (illimités pour root)"
|
||||
},
|
||||
{
|
||||
"file": "/etc/systemd/system.conf + user.conf",
|
||||
"sets": "<code>DefaultLimitNOFILE=1048576</code> pour les services systemd"
|
||||
},
|
||||
{
|
||||
"file": "/etc/pam.d/common-session + runuser-l",
|
||||
"sets": "<code>session required pam_limits.so</code> donc ce qui précède s'applique aux shells de connexion"
|
||||
},
|
||||
{
|
||||
"file": "/root/.profile",
|
||||
"sets": "<code>ulimit -n 1048576</code> pour le shell root"
|
||||
}
|
||||
],
|
||||
"tipTitle": "Pourquoi inotify est important",
|
||||
"tipBody": "Docker, Syncthing, les surveillances de fichiers Node.js et les analyses Plex peuvent épuiser <code>max_user_watches</code>. La valeur par défaut dépend du noyau et de la mémoire ; elle n’est pas toujours 8192. Un plafond de 1M autorise davantage de surveillances sans les préallouer. Les surveillances actives consomment de la mémoire du noyau : vérifiez l’usage si la RAM est limitée."
|
||||
},
|
||||
"memory": {
|
||||
"heading": "Optimiser les paramètres de la mémoire",
|
||||
"intro": "Écrit un profil de sysctl équilibré à <code>/etc/sysctl.d/99-memory.conf</code>. Conçu pour un hôte hyperviseur — préfère garder les ensembles de travail VM dans RAM et libère les pages de manière proactive afin que les éclats d'allocation ne s'arrêtent pas.",
|
||||
"warnTitle": "swappiness=10 sur les hôtes avec peu de mémoire",
|
||||
"warnBody": "Sur un hôte de 16 Go de RAM exécutant de nombreuses VM, réduire swappiness peut conduire le noyau à tuer des processus par manque de mémoire plutôt qu’à utiliser le swap. Si les événements OOM sont fréquents, remontez swappiness à 30–60 dans <code>/etc/sysctl.d/99-memory.conf</code> après le script."
|
||||
},
|
||||
"kexec": {
|
||||
"heading": "Activer les redémarrages rapides (kexec)",
|
||||
"intro": "Installe <code>kexec-tools</code> et le branche pour que vous puissiez redémarrer l'hôte directement dans un nouveau noyau <em> sans passer par BIOS/UEFI firmware</em>. Sur les grands serveurs où POST prend 45 – 90 secondes, cela transforme un redémarrage d'une pause café en quelques secondes d'arrêt.",
|
||||
"installsTitle": "Ce que ProxMenux installe",
|
||||
"installsItems": [
|
||||
"Paquet <code>kexec-tools</code> (debconf pré-réponse avec <code>kexec-tools/load_kexec boolean false</code> donc apt n'invite pas et le chargement automatique à l'arrêt reste désactivé).",
|
||||
"Unité systemd <code>/etc/systemd/system/kexec-pve.service</code> — charge le noyau Proxmox et initrd en mémoire au démarrage en réutilisant la ligne de commande actuelle du noyau.",
|
||||
"Un alias dans <code>/root/.bash_profile</code>: <code>reboot-quick</code> → <code>systemctl kexec</code>."
|
||||
],
|
||||
"usageIntro": "Utilisation après le prochain redémarrage (ou manuel <code>systemctl start kexec-pve</code>):",
|
||||
"warnTitle": "Quand ne pas utiliser kexec",
|
||||
"warnBody": "kexec saute l’initialisation du firmware. Si vous dépendez de BIOS/UEFI pour réinitialiser le matériel, par exemple un GPU en passthrough nécessitant un POST complet ou un firmware HBA problématique, ces redémarrages peuvent laisser les appareils partiellement initialisés. Utilisez un <code>reboot</code> normal après une mise à niveau du noyau ou pour appliquer des changements BIOS/UEFI. <code>reboot-quick</code> sert aux redémarrages courants."
|
||||
},
|
||||
"panic": {
|
||||
"heading": "Activer le redémarrage en cas de panique du noyau",
|
||||
"intro": "Fait <strong>redémarrer automatiquement</strong> le noyau au lieu de rester bloqué sur l’écran de panique. Essentiel pour les hôtes Proxmox distants ou sans console locale : un noyau bloqué arrête toutes les VM jusqu’à ce que vous puissiez couper puis rétablir l’alimentation.",
|
||||
"tipTitle": "Combinez ceci avec l'accès à la console à distance",
|
||||
"tipBody": "Le redémarrage automatique sert à récupérer le système, pas à le déboguer. Pour <em>analyser</em> une panique plutôt que simplement redémarrer, utilisez <link>l’option kexec</link> ci-dessus avec kdump du noyau, non configuré par ProxMenux, ou enregistrez une console série sur un autre hôte avant d’activer le redémarrage automatique."
|
||||
},
|
||||
"verify": {
|
||||
"heading": "Vérification",
|
||||
"intro": "Après l'application des optimisations système:",
|
||||
"tipTitle": "Restauration et limites",
|
||||
"tipBody": "Les six options figurent dans <code>installed_tools.json</code> et <link>Désinstaller les optimisations</link>. La restauration retire les fichiers de configuration, l’unité et l’alias kexec, réécrit journald.conf avec les valeurs par défaut de systemd et rétablit logrotate.conf depuis sa sauvegarde. Certaines limites actives nécessitent une nouvelle session ou un redémarrage."
|
||||
},
|
||||
"related": {
|
||||
"heading": "Voir aussi",
|
||||
"items": [
|
||||
{
|
||||
"label": "Commandes système utiles",
|
||||
"href": "/docs/help-info/system-commands",
|
||||
"tail": " — vérifier les modifications (free -h, journalctl, ulimit -a)."
|
||||
},
|
||||
{
|
||||
"label": "Performances",
|
||||
"href": "/docs/post-install/performance",
|
||||
"tail": "— réglage supplémentaire au niveau du système (pigz)."
|
||||
},
|
||||
{
|
||||
"label": "Désinstaller les optimisations",
|
||||
"href": "/docs/post-install/uninstall",
|
||||
"tail": "— revenir à l'un de ces changements."
|
||||
},
|
||||
{
|
||||
"label": "Post-installation personnalisable",
|
||||
"href": "/docs/post-install/customizable",
|
||||
"tail": "— retour au menu parent."
|
||||
}
|
||||
]
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,271 @@
|
||||
{
|
||||
"meta": {
|
||||
"title": "Désinstaller les optimisations | Documentation ProxMenux",
|
||||
"description": "Restaurer les modifications de configuration réversibles après l'installation appliquées par ProxMenux. Les outils enregistrés utilisent des désinstallateurs dédiés qui préservent l'état d'hôte préexistant lorsque c'est possible."
|
||||
},
|
||||
"header": {
|
||||
"title": "Désinstaller les optimisations",
|
||||
"description": "Restaurer les modifications réversibles apportées par les scripts de post-installation automatisés ou personnalisables. ProxMenux enregistre chaque optimisation supportée avec sa fonction de restauration dédiée; les mises à jour de paquets sont intentionnellement exclues.",
|
||||
"section": "Paramètres post-installation de Proxmox"
|
||||
},
|
||||
"intro": {
|
||||
"title": "Pourquoi cela existe",
|
||||
"body": "Chaque réglage réversible pris en charge est <strong>enregistré</strong> dans <code>/usr/local/share/proxmenux/installed_tools.json</code>. Ce registre liste les optimisations actives et appelle la fonction de restauration correspondante. Les actions sans retour arrière sûr, comme une mise à niveau complète des paquets, ne sont pas ajoutées."
|
||||
},
|
||||
"openMenu": {
|
||||
"heading": "Comment l'ouvrir",
|
||||
"body": "Depuis le menu principal, ouvrez <strong>Paramètres post-installation Proxmox → Désinstaller les optimisations</strong>. La liste propose les optimisations <em>actuellement appliquées</em> ; celles non appliquées n’apparaissent pas.",
|
||||
"imageAlt": "Liste de désinstallation montrant les optimisations actives sur l’hôte, avec cases de sélection pour les annuler"
|
||||
},
|
||||
"howWorks": {
|
||||
"heading": "Comment fonctionne le retour arrière",
|
||||
"steps": [
|
||||
{
|
||||
"title": "Registre et détection automatique",
|
||||
"body1": "Au premier passage, ProxMenux recherche des marqueurs sur l’hôte : <code>/etc/sysctl.d/99-memory.conf</code>, <code>/etc/apt/apt.conf.d/99-force-ipv4</code>, paquet <code>haveged</code> installé, service Log2RAM actif, etc. Les éléments reconnus sont enregistrés comme réversibles, même s’ils viennent d’une version antérieure au registre.",
|
||||
"body2": "Cette migration ne dure qu'une seule fois. Ensuite, chaque application/réversion met à jour le registre directement."
|
||||
},
|
||||
{
|
||||
"title": "Choisir les changements à annuler",
|
||||
"body1": "La liste de vérification présente une étiquette lisible par l'homme par article (p. ex. <em>Optimisation des paramètres de mémoire</em>, <em>IOMMU/VFIO PCI Passthrough</em>, <em>Log2RAM (SSD Protection)</em>). Cochez ceux que vous voulez inverser. Rien de ce que vous ne cochez ne sera touché."
|
||||
},
|
||||
{
|
||||
"title": "Exécution de la restauration",
|
||||
"body1": "Pour chaque élément sélectionné, ProxMenux appelle sa fonction de désinstallation correspondante. La plupart des renversements suivent l'un des trois modèles suivants :",
|
||||
"items": [
|
||||
"<strong>Basé sur la sauvegarde</strong> — restaurer un <code>.bak</code> capturé au moment de l'application (bashrc, logrotate.conf, journald.conf, GRUB/kernel cmdline).",
|
||||
"<strong>Suppression de configuration</strong> — retire les fichiers ProxMenux <code>/etc/sysctl.d/99-*.conf</code>, <code>/etc/apt/apt.conf.d/99-*</code> ou l’unité systemd, puis recharge.",
|
||||
"<strong>Réinstallation de paquets</strong> — pour les modifications d’interface comme l’avertissement d’abonnement, réinstalle les paquets originaux avec <code>--force-confnew</code> pour rétablir les réglages fournis."
|
||||
],
|
||||
"body2": "Chaque renversement enregistre ses progrès. Les éléments qui nécessitent un redémarrage (VFIO, noms d'interface persistants) définissent un drapeau qui déclenche l'invite de redémarrage à la fin."
|
||||
},
|
||||
{
|
||||
"title": "Demande de redémarrage à la fin",
|
||||
"body1": "Une fois l'inversion terminée, le menu affiche une invite de redémarrage. Les éléments qui ont modifié les paramètres du noyau, les modules du noyau ou le nom de réseau (VFIO, noms d'interface persistants) ont besoin du redémarrage pour prendre effet; d'autres éléments ne le font pas, et l'invite est une sécurité par défaut plutôt qu'une vérification par item."
|
||||
}
|
||||
]
|
||||
},
|
||||
"reversible": {
|
||||
"heading": "Ce qui est réversible",
|
||||
"intro": "Les optimisations réversibles enregistrées et leurs désinstallateurs correspondants sont regroupés ici par domaine:",
|
||||
"groups": [
|
||||
{
|
||||
"title": "Dépôts & APT",
|
||||
"items": [
|
||||
{
|
||||
"tool": "Suppression de la bannière d'abonnement",
|
||||
"restores": "D'abord essayer de restaurer les fichiers d'interface utilisateur à partir des sauvegardes de ProxMenux (/usr/local/share/proxmenux/backups/proxmoxlib.js.backup.* et, lorsque l'interface utilisateur mobile est patchée, index.html.tpl.backup.*). Seulement si une sauvegarde est manquante ou corrompue, revient à réinstaller pve-manager, proxmox-widget-toolkit, libjs-extjs et libpve-http-server-perl avec force-confnew. Efface également les copies en cache .js / .gz."
|
||||
},
|
||||
{
|
||||
"tool": "Ignorer les langues APT",
|
||||
"restores": "Supprime /etc/apt/apt.conf.d/99-disable-translations pour permettre les index de descriptions de paquets traduites selon les autres réglages linguistiques APT."
|
||||
},
|
||||
{
|
||||
"tool": "Forcer IPv4 pour APT",
|
||||
"restores": "Supprime /etc/apt/apt.conf.d/99-force-ipv4."
|
||||
},
|
||||
{
|
||||
"tool": "Utilitaires système",
|
||||
"restores": "Purge seulement les paquets utilitaires sélectionnés que ProxMenux enregistré comme nouvellement installé. Les paquets déjà présents avant l'action ne sont jamais ajoutés à cette liste et restent intacts."
|
||||
}
|
||||
]
|
||||
},
|
||||
{
|
||||
"title": "Limites du noyau, de la mémoire et du système",
|
||||
"items": [
|
||||
{
|
||||
"tool": "Paramètres de la mémoire",
|
||||
"restores": "Supprime /etc/sysctl.d/99-memory.conf et recharge sysctl."
|
||||
},
|
||||
{
|
||||
"tool": "Configuration de la panique du noyau",
|
||||
"restores": "Supprime /etc/sysctl.d/99-kernelpanic.conf."
|
||||
},
|
||||
{
|
||||
"tool": "Augmentation des limites du système",
|
||||
"restores": "Supprime /etc/sysctl.d/99-maxwatches.conf, 99-maxkeys.conf, 99-swap.conf, 99-fs.conf et /etc/security/limits.d/99-limits.conf. Rétablit les limites PAM et DefaultLimitNOFILE systemd. Dans /root/.profile, seul l’ancien ulimit -n 256000 est retiré ; ulimit -n 1048576 de l’installateur actuel peut rester et nécessiter une suppression manuelle."
|
||||
},
|
||||
{
|
||||
"tool": "Profil d'échange ZRAM",
|
||||
"restores": "Désactive le swap /dev/zram0, arrête dev-zram0.swap et supprime /etc/systemd/zram-generator.conf.d/90-proxmenux.conf. Le paquet systemd-zram-generator n’est purgé que si ProxMenux l’a installé et qu’aucune autre configuration ZRAM n’existe. Si les pages ne peuvent pas être évacuées, le profil reste actif et rien n’est supprimé."
|
||||
}
|
||||
]
|
||||
},
|
||||
{
|
||||
"title": "Réseautage",
|
||||
"items": [
|
||||
{
|
||||
"tool": "Optimisations du réseau",
|
||||
"restores": "Supprime /etc/sysctl.d/99-network.conf, 97-proxmenux-fwbr.conf et 98-proxmenux-rpf.conf, l’unité proxmenux-fwbr-tune.service, le script /usr/local/sbin/proxmenux-fwbr-tune et la règle udev /etc/udev/rules.d/99-zz-proxmenux-fwbr-tune.rules. Retire aussi la ligne source /etc/network/interfaces.d/* de /etc/network/interfaces. Recharge sysctl, systemd et les règles udev."
|
||||
},
|
||||
{
|
||||
"tool": "Open vSwitch",
|
||||
"restores": "Exécute apt purge pour openvswitch-switch et openvswitch-common. Migrez les ponts OVS vers Linux avant la désinstallation, sinon leurs VM perdront le réseau au prochain démarrage."
|
||||
},
|
||||
{
|
||||
"tool": "TCP BBR + TCP Fast Open",
|
||||
"restores": "Supprime /etc/sysctl.d/99-kernel-bbr.conf et 99-tcp-fastopen.conf, puis recharge le reste de sysctl. Supprimer les fichiers ne réinitialise pas les valeurs actives ; les valeurs par défaut comme cubic et tcp_fastopen=1 reviennent au redémarrage sauf autre configuration."
|
||||
},
|
||||
{
|
||||
"tool": "Noms d'interface persistants",
|
||||
"restores": "Supprime uniquement les fichiers 10-proxmenux-*.link contenant l'en-tête ProxMenux de /etc/systemd/network/. Tout fichier .link fourni par un autre paquet ou écrit par l'utilisateur est laissé en place. Les noms d'interface retournent au comportement par défaut de systemd lors du prochain redémarrage."
|
||||
}
|
||||
]
|
||||
},
|
||||
{
|
||||
"title": "Journalisation",
|
||||
"items": [
|
||||
{
|
||||
"tool": "Optimisation de journald",
|
||||
"restores": "Réécrit /etc/systemd/journald.conf par défaut et redémarre systemd-journald."
|
||||
},
|
||||
{
|
||||
"tool": "Optimisation du logrotate",
|
||||
"restores": "Restaurer /etc/logrotate.conf à partir du fichier .bak capturé avant le changement."
|
||||
},
|
||||
{
|
||||
"tool": "Log2RAM",
|
||||
"restores": "Arrête et désactive le service et le minuteur. Supprime tâches cron, unités systemd, binaires, configuration et /var/log.hdd. Désinstalle aussi le paquet apt si cette méthode a été utilisée."
|
||||
},
|
||||
{
|
||||
"tool": "TRIM automatique ZFS",
|
||||
"restores": "Lit /usr/local/share/proxmenux/zfs_autotrim_pools, la liste des pools réellement modifiés, et lance zpool set autotrim=off sur chacun. Les pools activés manuellement avant ProxMenux restent intacts."
|
||||
}
|
||||
]
|
||||
},
|
||||
{
|
||||
"title": "Shell & apparence",
|
||||
"items": [
|
||||
{
|
||||
"tool": "Personnalisation de Bashrc",
|
||||
"restores": "Restaurer /root/.bashrc à partir de la sauvegarde .bak. Si aucune sauvegarde n'existe, supprime le bloc PMX_CORE_BASHRC par des marqueurs."
|
||||
},
|
||||
{
|
||||
"tool": "Bannière MOTD personnalisée",
|
||||
"restores": "Restaurer le contenu original exact /etc/motd conservé sous /usr/local/share/proxmenux, supprime le fichier lorsqu'il n'existait pas avant, ou supprime en toute sécurité le marqueur existant lors de la migration d'une ancienne installation."
|
||||
},
|
||||
{
|
||||
"tool": "Fastfetch",
|
||||
"restores": "Supprime le binaire, le répertoire de configuration, le hook update-motd et le bloc délimité BEGIN FASTFETCH / END FASTFETCH de /root/.bashrc, ~/.profile, /etc/profile et /etc/profile.d/fastfetch.sh. Purge le paquet apt s’il est installé."
|
||||
},
|
||||
{
|
||||
"tool": "Figurine",
|
||||
"restores": "Supprime le binaire, l’entrée profile.d et le bloc d’alias de bashrc/profile."
|
||||
}
|
||||
]
|
||||
},
|
||||
{
|
||||
"title": "Matériel & virtualisation",
|
||||
"items": [
|
||||
{
|
||||
"tool": "IOMMU / VFIO",
|
||||
"restores": "Supprime les modules vfio de /etc/modules, les entrées de blocage nouveau / radeon / nvidia et les paramètres intel_iommu=on / amd_iommu=on / iommu=pt / pcie_acs_override de /etc/kernel/cmdline (ZFS) ou GRUB. Reconstruit initramfs."
|
||||
},
|
||||
{
|
||||
"tool": "Corrections AMD CPU (Ryzen/EPYC)",
|
||||
"restores": "Supprime idle=nomwait de la ligne de commande du noyau (ZFS) ou GRUB, et les options ignore_msrs / report_ignored_msrs de /etc/modprobe.d/kvm.conf."
|
||||
},
|
||||
{
|
||||
"tool": "Agent invité pour un hôte Proxmox virtualisé",
|
||||
"restores": "Lit /usr/local/share/proxmenux/guest_agent.pkg et purge le paquet hôte enregistré. L’installateur choisit qemu-guest-agent, open-vm-tools ou virtualbox-guest-utils selon l’hyperviseur. Sans enregistrement, la désinstallation essaie ces trois paquets. Cela agit sur l’hôte Proxmox imbriqué, pas sur les modèles invités."
|
||||
}
|
||||
]
|
||||
},
|
||||
{
|
||||
"title": "Stockage",
|
||||
"items": [
|
||||
{
|
||||
"tool": "Dimensionnement de l'ARC ZFS",
|
||||
"restores": "Supprime /etc/modprobe.d/99-zfsarc.conf, restaure les *.conf externes en conflit sauvegardés dans /usr/local/share/proxmenux/backups/zfs_arc/, reconstruit initramfs et lance proxmox-boot-tool refresh sur les hôtes systemd-boot."
|
||||
},
|
||||
{
|
||||
"tool": "Instantanés automatiques ZFS",
|
||||
"restores": "Supprime les tâches cron écrites par le script et propose apt purge zfs-auto-snapshot. Les instantanés existants sur les pools restent intacts ; supprimez-les séparément si nécessaire."
|
||||
},
|
||||
{
|
||||
"tool": "Limites de vitesse vzdump",
|
||||
"restores": "Restaure /etc/vzdump.conf depuis le .bak créé à l’installation pour rétablir bwlimit et ionice à leurs valeurs avant ProxMenux."
|
||||
}
|
||||
]
|
||||
},
|
||||
{
|
||||
"title": "Services et suppléments",
|
||||
"items": [
|
||||
{
|
||||
"tool": "Synchronisation du temps",
|
||||
"restores": "Rétablit le fuseau UTC, valeur par défaut sûre, via timedatectl."
|
||||
},
|
||||
{
|
||||
"tool": "Génération d’entropie (haveged)",
|
||||
"restores": "Arrête, désactive et purge le paquet haveged."
|
||||
},
|
||||
{
|
||||
"tool": "kexec (redémarrages rapides)",
|
||||
"restores": "Désactive kexec-pve.service, supprime l’unité et l’alias reboot-quick de /root/.bash_profile, puis purge kexec-tools."
|
||||
},
|
||||
{
|
||||
"tool": "RPC / rpcbind Désactiver",
|
||||
"restores": "Rétablit séparément rpcbind.service et rpcbind.socket dans leurs états activé/désactivé et actif/inactif enregistrés avant ProxMenux."
|
||||
},
|
||||
{
|
||||
"tool": "pigz (parallèle gzip)",
|
||||
"restores": "Rétablit le vrai gzip depuis gzip.distrib, supprime le détournement dpkg et /bin/pigzwrapper, commente la ligne pigz de /etc/vzdump.conf puis lance apt purge pigz après vérification de gzip."
|
||||
},
|
||||
{
|
||||
"tool": "Services à haute disponibilité",
|
||||
"restores": "Arrête et désactive pve-ha-lrm, pve-ha-crm et corosync. Les groupes HA existants et les définitions de ressources ne sont pas supprimés — les supprimer de l'interface utilisateur Web si vous n'en avez plus besoin."
|
||||
},
|
||||
{
|
||||
"tool": "Dépôt Ceph",
|
||||
"restores": "Purge les paquets Ceph installés par cette option, supprime le deb822 /etc/apt/sources.list.d/ceph.sources sur PVE 9 (ou la liste de Ceph sur PVE 8), et rafraîchit le cache APT."
|
||||
},
|
||||
{
|
||||
"tool": "OVH RTM (surveillance)",
|
||||
"restores": "Purge les paquets correspondant à ovh-rtm*, rtm et rtm-*, supprime /etc/rtm et retire l’entrée RTM du registre. Les restes Puppet dans /etc/puppet/ peuvent nécessiter une vérification et un nettoyage manuels ; le répertoire n’est pas supprimé. Hors OVH, l’installateur ne change normalement rien."
|
||||
}
|
||||
]
|
||||
}
|
||||
]
|
||||
},
|
||||
"edge": {
|
||||
"heading": "Cas particuliers et précautions",
|
||||
"packageTitle": "La réinstallation touche des paquets Proxmox en cours d’utilisation",
|
||||
"packageBody": "Si les sauvegardes ProxMenux ne peuvent pas annuler <strong>Suppression de l’avertissement d’abonnement</strong>, la solution de repli réinstalle <code>pve-manager</code>, <code>proxmox-widget-toolkit</code>, <code>libjs-extjs</code> et <code>libpve-http-server-perl</code> avec <code>--force-confnew</code>. Cela touche l’interface active : actualisez le navigateur et attendez la reconnexion. Évitez les migrations et clonages en cours.",
|
||||
"rebootTitle": "Les noms persistants et VFIO ont besoin d'un redémarrage",
|
||||
"rebootBody": "Suppression ProxMenux's <code>10-proxmenux-*.link</code> fichiers (<em>Noms d'interface persistants</em>) et retour <em>IOMMU/VFIO</em> n'affectent pas le système d'exécution — ils ne comptent qu'après un redémarrage. ProxMenux définit le drapeau de redémarrage automatiquement pour ceux-ci.",
|
||||
"perItemTitle": "Vous pouvez annuler une modification et garder les autres",
|
||||
"perItemBody": "Le désinstallateur fonctionne par élément. Si vous voulez seulement supprimer Log2RAM mais garder le réglage réseau et les changements de bashrc, cochez uniquement <em>Log2RAM</em>. Rien d'autre n'est touché et le registre est mis à jour en conséquence."
|
||||
},
|
||||
"inspect": {
|
||||
"heading": "Inspection manuelle du registre",
|
||||
"intro": "Si vous voulez voir ce qui est suivi sans ouvrir le menu:",
|
||||
"outro": "Chaque entrée <code>\"tool\": true</code> correspond à quelque chose de ProxMenux appliqué et peut inverser. L'élimination manuelle d'une entrée n'est pas recommandée — utilisez toujours le menu, qui exécute également la fonction d'inversion au lieu de simplement oublier le changement.",
|
||||
"reinstallTitle": "Réinstaller après désinstallation",
|
||||
"reinstallBody": "La réversion d'une optimisation ne vous empêche pas de la réappliquer plus tard. Ouvrez <link>le menu Post-Installer</link> à nouveau et exécutez soit Automatique ou Personnalisable — le registre suivra le nouvel état."
|
||||
},
|
||||
"related": {
|
||||
"heading": "Voir aussi",
|
||||
"items": [
|
||||
{
|
||||
"label": "Système automatisé de post-installation",
|
||||
"href": "/docs/post-install/automated",
|
||||
"tail": "— réappliquer le niveau de référence par défaut."
|
||||
},
|
||||
{
|
||||
"label": "Post-installation personnalisable",
|
||||
"href": "/docs/post-install/customizable",
|
||||
"tail": "— choisir un sous-ensemble différent."
|
||||
},
|
||||
{
|
||||
"label": "Désinstaller ProxMenux",
|
||||
"href": "/docs/settings/uninstall-proxmenux",
|
||||
"tail": "— fonctionnement différent: supprime ProxMenux lui-même, et non ses optimisations appliquées."
|
||||
},
|
||||
{
|
||||
"label": "Aperçu après l'installation",
|
||||
"href": "/docs/post-install",
|
||||
"tail": "."
|
||||
}
|
||||
]
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,112 @@
|
||||
{
|
||||
"meta": {
|
||||
"title": "Appliquer les mises à jour disponibles — Optimisations post-installation | Documentation ProxMenux",
|
||||
"description": "Comment ProxMenux détecte lorsqu'une optimisation post-installation (Log2Ram, Paramètres de mémoire, Limites du système, Logrotate, réglage réseau...) a été mise à jour en amont, et comment appliquer la nouvelle version — depuis le menu Post-Install ou depuis le tableau de bord de Monitor."
|
||||
},
|
||||
"header": {
|
||||
"title": "Appliquer les mises à jour disponibles",
|
||||
"description": "Si une optimisation post-installation (Log2Ram, paramètres de mémoire, limites système, Logrotate…) a une version sur disque plus récente que celle enregistrée sur l’hôte, ProxMenux la signale comme mise à jour disponible. Vous pouvez l’appliquer depuis le menu post-installation des scripts ou le tableau de bord Monitor. Les deux relancent la même fonction et actualisent le registre.",
|
||||
"section": "Paramètres post-installation de Proxmox"
|
||||
},
|
||||
"intro": {
|
||||
"title": "Ce que c'est",
|
||||
"body": "Les optimisations post-installation ProxMenux ont des versions, par exemple <code>Log2ram SSD Protection v1.2</code>. L’hôte enregistre les optimisations actives et leurs versions dans <code>/usr/local/share/proxmenux/installed_tools.json</code>. Lorsqu’une version ProxMenux fournit une optimisation plus récente, l’écart est détecté et seule celle-ci est proposée à la réapplication, sans relancer toute la post-installation."
|
||||
},
|
||||
"why": {
|
||||
"heading": "Pourquoi cela existe",
|
||||
"body": "Les optimisations après installation peuvent être améliorées : meilleur réglage sysctl, limite Logrotate plus stricte, nouvelle méthode de dimensionnement de Log2RAM ou correction d’un cas particulier signalé par un testeur. Sans mécanisme de mise à jour, il fallait relancer manuellement le script après installation, qui réapplique <em>toutes</em> les optimisations, ou renoncer à l’amélioration. Appliquer les mises à jour disponibles permet de relancer volontairement chaque optimisation dont la version a changé."
|
||||
},
|
||||
"detection": {
|
||||
"heading": "Comment les mises à jour sont détectées",
|
||||
"steps": [
|
||||
{
|
||||
"title": "Scripts versionnés sur disque",
|
||||
"body": "Chaque fonction post-installation déclare sa version dans le script (<code>scripts/post_install/auto_post_install.sh</code> et <code>scripts/post_install/customizable_post_install.sh</code>). Un scanner extrait ces versions de la source sur le disque."
|
||||
},
|
||||
{
|
||||
"title": "Registre des versions sur l’hôte",
|
||||
"body": "Lorsque l'opérateur a appliqué chaque optimisation, l'appel <code>register_tool</code> correspondant a écrit la version active dans <code>/usr/local/share/proxmenux/installed_tools.json</code>. Ce fichier est la source de la vérité pour \"ce qui est actif sur cet hôte en ce moment\"."
|
||||
},
|
||||
{
|
||||
"title": "Monitor compare les deux versions",
|
||||
"body": "Au démarrage et toutes les 24 h, Monitor compare les versions sur disque aux versions enregistrées. Chaque écart crée une entrée dans <code>/usr/local/share/proxmenux/updates_available.json</code>. Ce fichier alimente l’entrée du menu post-installation et la carte du tableau de bord Monitor."
|
||||
},
|
||||
{
|
||||
"title": "Une notification par nouvelle version",
|
||||
"body": "Dès qu’une optimisation a une mise à jour en attente, Monitor envoie une notification groupée, par exemple <em>« 4 mises à jour d’optimisations ProxMenux disponibles »</em>, avec une ligne par outil au format <code>name (vX → vY)</code>, comme pour les paquets Proxmox. Elle ne se répète pas chaque jour pour le même ensemble : seule une nouvelle version ou un nouvel outil dans la liste la déclenche à nouveau."
|
||||
}
|
||||
]
|
||||
},
|
||||
"pathA": {
|
||||
"heading": "Chemin A — À partir du menu Post-Installation",
|
||||
"intro": "À partir du menu principal de ProxMenux, ouvrez <strong>Paramètres après l'installation Proxmox</strong>. Lorsqu'il y a des mises à jour en attente, une nouvelle entrée <strong>Appliquer les mises à jour disponibles (N)</strong> apparaît juste au-dessus de <em>Désinstaller les optimisations</em>. Le nombre reflète combien d'optimisations ont une version plus récente sur disque que ce que l'hôte a actuellement enregistré. Lorsque tout est à jour, l'entrée n'apparaît tout simplement pas, donc le menu reste propre.",
|
||||
"menuAlt": "Menu des scripts post-installation montrant Appliquer les mises à jour disponibles (N) au-dessus de Désinstaller les optimisations ; le compteur indique les optimisations dont une version plus récente est sur disque",
|
||||
"menuCaption": "<em>Appliquer les mises à jour disponibles (N)</em> apparaît seulement si une optimisation a une mise à jour en attente ; l’entrée est masquée quand l’hôte est à jour.",
|
||||
"checklistBody": "Sélectionner l'entrée ouvre une liste de contrôle avec chaque mise à jour en attente, chaque ligne formatée en <code>name (vX → vY)</code>. Toutes les lignes sont pré-cochées par défaut; décochez toutes les lignes que vous ne voulez pas appliquer ce tour.",
|
||||
"checklistAlt": "Sélecteur Appliquer les mises à jour disponibles avec une ligne par optimisation en attente, son nom et le changement de version (actuelle → disponible). Toutes les lignes sont cochées.",
|
||||
"checklistCaption": "Sélection individuelle des optimisations à mettre à jour. Le même moteur qu’Automatisé et Personnalisable réapplique chaque fonction en arrière-plan et actualise sa version enregistrée."
|
||||
},
|
||||
"pathB": {
|
||||
"heading": "Voie B — Depuis le tableau de bord Monitor",
|
||||
"intro": "Les mêmes mises à jour apparaissent dans Monitor sous <link>Paramètres → Optimisations ProxMenux</link>. La carte affiche un <strong>compteur des mises à jour</strong> en attente qui ouvre le sélecteur par optimisation. Chaque outil propose aussi sa propre action de mise à jour.",
|
||||
"imageAlt": "Carte Optimisations ProxMenux dans les paramètres Monitor avec un compteur ouvrant le sélecteur par optimisation et des actions de mise à jour par outil",
|
||||
"imageCaption": "La carte Optimisations de Monitor donne accès aux mises à jour via son compteur dès qu’une version plus récente est sur disque, sans accès au shell."
|
||||
},
|
||||
"applying": {
|
||||
"heading": "Ce qui se passe lors de l’application",
|
||||
"steps": [
|
||||
{
|
||||
"title": "Réexécute la fonction post-installation",
|
||||
"body": "La fonction de l’optimisation sélectionnée est réexécutée sur l’hôte. Comme chaque fonction après installation est <strong>idempotente</strong>, la relancer ne duplique pas la configuration : elle remplace la version précédente par la nouvelle, notamment les fichiers sysctl, les fichiers complémentaires et les unités de service."
|
||||
},
|
||||
{
|
||||
"title": "Actualise le registre",
|
||||
"body": "L'appel <code>register_tool</code> à l'intérieur de la fonction écrit la nouvelle version dans <code>installed_tools.json</code>. Le scan suivant ne voit plus d'inadéquation et l'entrée mise à jour disparaît du menu et de la carte Monitor."
|
||||
},
|
||||
{
|
||||
"title": "Pas de redémarrage sauf si la fonction le dit",
|
||||
"body": "La plupart des mises à jour prennent effet immédiatement. Les mises à jour qui touchent les modules du noyau, les noms d'interface persistants ou VFIO affichent la même invitation de redémarrage qu'une nouvelle installation."
|
||||
},
|
||||
{
|
||||
"title": "Mise à jour du registre envoyée au moniteur",
|
||||
"body": "Après le lot, le menu envoie une requête POST à <code>http://127.0.0.1:8008/api/updates/post-install/scan</code> pour reconstruire <code>/usr/local/share/proxmenux/updates_available.json</code>. Une fois toutes les mises à jour appliquées, leur compteur et l’entrée conditionnelle du menu shell disparaissent sans attendre le prochain scan. La carte Optimisations reste disponible."
|
||||
}
|
||||
],
|
||||
"jqTitle": "jq est nécessaire",
|
||||
"jqBody": "La liste de contrôle Path A repose sur <code>jq</code> pour analyser les mises à jour en attente JSON. Si le <code>jq</code> manque, le flux s'éteint silencieusement — vous verrez l'entrée du menu avec un nombre mais rien ne se produirait après avoir sélectionné les lignes. Sur n'importe quelle installation Proxmox moderne <code>jq</code> est présente; si dans le doute exécuter <code>apt install -y jq</code>."
|
||||
},
|
||||
"differs": {
|
||||
"heading": "Comment il diffère des autres chemins",
|
||||
"headerPath": "Path",
|
||||
"headerScope": "Portée",
|
||||
"headerWhen": "Quand ça a du sens",
|
||||
"rows": [
|
||||
{
|
||||
"pathLabel": "Automatisé",
|
||||
"pathHref": "/docs/post-install/automated",
|
||||
"scope": "Ré-applique <em> chaque optimisation </em> dans le paquet.",
|
||||
"when": "Hôte neuf ou réapplication complète de la configuration de base d’un nœud entièrement géré."
|
||||
},
|
||||
{
|
||||
"pathLabel": "Personnalisable",
|
||||
"pathHref": "/docs/post-install/customizable",
|
||||
"scope": "Choisissez parmi le catalogue complet.",
|
||||
"when": "Choisir précisément les optimisations actives sur l’hôte."
|
||||
},
|
||||
{
|
||||
"pathLabel": "appliquer les mises à jour disponibles",
|
||||
"pathHref": null,
|
||||
"scope": "Uniquement les optimisations dont la version sur disque a augmenté.",
|
||||
"when": "Garder les optimisations installées à jour sans toucher au reste."
|
||||
},
|
||||
{
|
||||
"pathLabel": "Désinstaller les optimisations",
|
||||
"pathHref": "/docs/post-install/uninstall",
|
||||
"scope": "Inverser l'optimisation et supprimer son entrée de registre.",
|
||||
"when": "Annuler une modification précise."
|
||||
}
|
||||
]
|
||||
},
|
||||
"notifTitle": "Contrôle de la notification",
|
||||
"notifBody": "L’événement <em>Mises à jour d’optimisations ProxMenux disponibles</em> annonce les mises à jour en attente. Activé par défaut sur chaque canal, il peut être désactivé par canal dans <link>Paramètres → Notifications</link>. Il ne se déclenche qu’une fois par ensemble distinct de mises à jour, pas à chaque scan de 24 h."
|
||||
}
|
||||
@@ -0,0 +1,116 @@
|
||||
{
|
||||
"meta": {
|
||||
"title": "Post-installation : Virtualisation | Documentation ProxMenux",
|
||||
"description": "Options de virtualisation dans le script post-installation personnalisable ProxMenux : installer automatiquement le bon agent invité si Proxmox fonctionne à l'intérieur d'un VM, et activer IOMMU / VFIO afin que vous puissiez passer les périphériques PCI (GPU, NIC, HBAs) à vos propres VM."
|
||||
},
|
||||
"header": {
|
||||
"title": "Post-Installation : Virtualisation",
|
||||
"section": "Paramètres post-installation de Proxmox"
|
||||
},
|
||||
"intro": {
|
||||
"title": "Ce que cette catégorie couvre",
|
||||
"body": "Deux options indépendantes. <strong>Installer l’agent invité adapté</strong> aide lorsque Proxmox fonctionne lui-même dans un autre hyperviseur. <strong>Activer la prise en charge de VFIO IOMMU</strong> intéresse la plupart des utilisateurs : active les fonctions du noyau pour attribuer directement un GPU, HBA ou une carte réseau à une VM avec des performances quasi natives."
|
||||
},
|
||||
"guestAgent": {
|
||||
"heading": "installer l'agent invité approprié",
|
||||
"intro": "Détecte l'environnement de virtualisation sur lequel s'exécute l'hôte Proxmox (en utilisant <code>systemd-detect-virt</code> et <code>dmidecode</code>) et installe le paquet d'outils invités correspondant afin que l'hyperviseur externe puisse communiquer avec Proxmox de manière propre (arrêt progressif, synchronisation d'horloge, reportage IP, etc.).",
|
||||
"headerDetected": "Hôte détecté",
|
||||
"headerPackage": "Paquet installé",
|
||||
"rows": [
|
||||
{
|
||||
"detected": "QEMU / KVM",
|
||||
"package": "qemu-guest-agent"
|
||||
},
|
||||
{
|
||||
"detected": "VMware (ESXi, Workstation)",
|
||||
"package": "open-vm-tools"
|
||||
},
|
||||
{
|
||||
"detected": "VirtualBox",
|
||||
"package": "virtualbox-guest-utils"
|
||||
},
|
||||
{
|
||||
"detected": "Matériel physique (aucun)",
|
||||
"package": "— non-op, rien installé"
|
||||
}
|
||||
],
|
||||
"skipTitle": "Ignorez cette option si Proxmox fonctionne sur du matériel physique",
|
||||
"skipBody": "Si Proxmox fonctionne directement sur le matériel, le cas habituel, cocher cette option ne change rien : le détecteur retourne <code>none</code> et le script quitte sans modification. L’option concerne seulement les installations où Proxmox fonctionne <em>en tant qu’invité</em> pour des tests ou des laboratoires."
|
||||
},
|
||||
"vfio": {
|
||||
"heading": "Activer la prise en charge de VFIO IOMMU",
|
||||
"intro": "Active IOMMU sur l’hôte et charge les modules permettant l’accès direct PCI (<code>vfio</code>, <code>vfio_iommu_type1</code>, <code>vfio_pci</code>). Vous pouvez alors attribuer un périphérique physique à une VM, qui y accède directement avec des performances proches du matériel natif.",
|
||||
"whoTitle": "Qui en a besoin ?",
|
||||
"whoItems": [
|
||||
"Vous voulez attribuer directement un GPU à une VM Windows de jeu ou à une VM macOS.",
|
||||
"Vous avez un 10G NIC dédié pour un pare-feu/routeur VM (OPNsense, pfSense).",
|
||||
"Vous souhaitez passer un HBA directement à un TrueNAS/Unraid VM pour ZFS sur disques nus.",
|
||||
"Vous prévoyez utiliser <em>Coral TPU</em>, une carte de capture, ou un dongle SDR dans un VM."
|
||||
],
|
||||
"whoOutro": "Si aucun de ces éléments ne s'applique, vous pouvez ignorer cette option en toute sécurité. Pour le relais vers un <strong>LXC</strong> (et non un VM), IOMMU n'est <em>pas</em> requis.",
|
||||
"doesTitle": "Ce que fait ProxMenux",
|
||||
"doesIntro": "La fonction tient compte du chargeur de démarrage : elle détecte ZFS (systemd-boot) ou LVM/ext4 (GRUB) et écrit dans le bon fichier. Elle est idempotente : les paramètres déjà présents ne sont pas ajoutés une seconde fois.",
|
||||
"headerBoot": "Type de démarrage",
|
||||
"headerFile": "Fichier touché",
|
||||
"headerPost": "Étape postérieure à la mise à jour",
|
||||
"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": "Paramètres du noyau ajoutés:",
|
||||
"modulesIntro": "Modules de noyau ajoutés au <code>/etc/modules</code>:",
|
||||
"blacklistIntro": "Pilotes en conflit bloqués dans <code>/etc/modprobe.d/blacklist.conf</code> :",
|
||||
"blacklistTitle": "Bloquer les pilotes GPU empêche l’utilisation du GPU par l’hôte",
|
||||
"blacklistBody": "La liste de blocage empêche le noyau hôte de lier <em>tout</em> pilote GPU, pour que VFIO puisse prendre le contrôle du GPU. C’est souhaitable pour l’attribution directe à une VM, mais c’est l’<strong>opposé</strong> de ce qu’il faut pour <link>installer les pilotes NVIDIA sur l’hôte</link>, par exemple pour le transcodage LXC. Choisissez une voie par GPU :",
|
||||
"pathItems": [
|
||||
"<strong>GPU → VM:</strong> activez VFIO/IOMMU ici, laissez les pilotes GPU sur la liste noire.",
|
||||
"<strong>GPU → LXC (ou hôte) :</strong> ignorez cette option, utilisez l’installation NVIDIA sur l’hôte et ne bloquez pas nvidia/nouveau.",
|
||||
"<strong>Deux GPU :</strong> l’un peut aller à une VM, l’autre à un LXC, mais une configuration plus précise est nécessaire : lier une seule carte à <code>vfio-pci</code> par son identifiant PCI. La liste de blocage par défaut est trop large ; modifiez ensuite <code>blacklist.conf</code>."
|
||||
],
|
||||
"acsTitle": "À propos de pcie_acs_override — comprenez ce que vous activez",
|
||||
"acsBody": "<code>pcie_acs_override=downstream,multifunction</code> assouplit la vérification PCIe Access Control Services. Le noyau peut alors séparer des groupes IOMMU signalés comme indivisibles par le firmware, parfois seul moyen d’attribuer un périphérique sans tout le groupe. En contrepartie, <strong>l’isolation entre périphériques est réduite</strong> : une VM malveillante ou compromise avec accès direct dispose d’une plus grande surface d’attaque via DMA. Acceptable en laboratoire domestique, à bien évaluer pour des charges non fiables. Si inutile, retirez le paramètre de <code>/etc/kernel/cmdline</code> ou <code>/etc/default/grub</code> après le script et relancez la mise à jour du chargeur de démarrage.",
|
||||
"rebootTitle": "Redémarrage nécessaire",
|
||||
"rebootBody": "IOMMU, les modules VFIO et la liste de blocage prennent effet après régénération d’initramfs et redémarrage. Le script exécute <code>update-initramfs -u -k all</code>, actualise le chargeur de démarrage et indique qu’un redémarrage est nécessaire pour que Personnalisable le propose à la fin.",
|
||||
"verifyTitle": "Vérification après redémarrage",
|
||||
"revertTitle": "Réversible depuis le menu Désinstaller",
|
||||
"revertBody": "<link>Désinstaller les optimisations</link> annule toutes les modifications : retire les paramètres IOMMU de <code>/etc/kernel/cmdline</code> ou GRUB, les modules VFIO de <code>/etc/modules</code> et les entrées de blocage des pilotes, puis reconstruit initramfs. Un redémarrage applique le retour en arrière."
|
||||
},
|
||||
"related": {
|
||||
"heading": "Voir aussi",
|
||||
"items": [
|
||||
{
|
||||
"label": "Ajouter GPU à VM (Passthrough)",
|
||||
"href": "/docs/hardware/gpu-vm-passthrough",
|
||||
"tail": "— l'étape suivante naturelle une fois IOMMU + VFIO activé."
|
||||
},
|
||||
{
|
||||
"label": "Ajouter le contrôleur ou NVMe au VM",
|
||||
"href": "/docs/disk-manager/add-controller-nvme-vm",
|
||||
"tail": "— la même infrastructure de transmission pour les contrôleurs de stockage."
|
||||
},
|
||||
{
|
||||
"label": "commandes GPU Passthrough",
|
||||
"href": "/docs/help-info/gpu-commands",
|
||||
"tail": "— Référence de vérification IOMMU."
|
||||
},
|
||||
{
|
||||
"label": "Désinstaller les optimisations",
|
||||
"href": "/docs/post-install/uninstall",
|
||||
"tail": " — annuler proprement IOMMU / VFIO."
|
||||
},
|
||||
{
|
||||
"label": "Post-installation personnalisable",
|
||||
"href": "/docs/post-install/customizable",
|
||||
"tail": "— retour au menu parent."
|
||||
}
|
||||
]
|
||||
}
|
||||
}
|
||||
@@ -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 l’aggiornamento del sistema, la rimozione dell’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 scrive file <code>.link</code> per le schede fisiche, incluse le porte dei bond, con il MAC riportato da sysfs in quel momento; per le porte di un bond può essere il MAC condiviso del bond, quindi controllane i nomi dopo un riavvio. 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é una scheda già fissata che viene ricollegata o rilevata di nuovo applichi la sua regola 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 esplicitamente la stessa regola (RAM/10, massimo 16 GiB, minimo 64 MiB) in un proprio file, coprendo anche host precedenti o aggiornati. 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> e ne rimuove i valori <code>zfs_arc_min</code> / <code>zfs_arc_max</code> in conflitto (le altre opzioni di quelle righe restano), così solo il file ARC ProxMenux imposta il limite. 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 i file di configurazione, l’unità e l’alias kexec, riscrive journald.conf con i valori predefiniti di systemd e ripristina logrotate.conf dal backup. Alcuni limiti attivi richiedono una nuova sessione o un riavvio."
|
||||
},
|
||||
"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."
|
||||
}
|
||||
]
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,172 @@
|
||||
{
|
||||
"meta": {
|
||||
"title": "Script pós-instalação automatizado | Documentação ProxMenux",
|
||||
"description": "O script pós-instalação automatizado ProxMenux executa 14 otimizações predefinidas adaptadas ao hardware num host Proxmox VE novo. Não tem lista de funções para selecionar, mas pode pedir confirmação para a atualização do sistema, para ocultar o aviso de subscrição, instalar Log2RAM em certos casos e reiniciar. As alterações reversíveis ficam registadas.",
|
||||
"ogTitle": "Script pós-instalação automatizado | Documentação ProxMenux",
|
||||
"ogDescription": "14 otimizações predefinidas adaptadas ao hardware para um host Proxmox VE novo, com confirmações para algumas ações e registo de alterações reversíveis."
|
||||
},
|
||||
"header": {
|
||||
"title": "Script pós-instalação automatizado",
|
||||
"description": "O ProxMenux executa 14 otimizações de base predefinidas sem lista de funções para selecionar. Algumas ações pedem confirmação. As alterações reversíveis ficam registadas em Desinstalar otimizações; as atualizações de pacotes não são descritas como reversíveis.",
|
||||
"section": "Pós-instalação · Automatizada"
|
||||
},
|
||||
"intro": {
|
||||
"title": "Quando escolher Automatizado",
|
||||
"body": "Execute isso em um host Proxmox recém-instalado quando desejar uma linha de base sensata sem tomar decisões. O script é idempotente – executá-lo duas vezes é seguro, basta reaplicar as mesmas configurações. Recursos opcionais (Fastfetch, IOMMU, repositório Ceph, HA, correções AMD…) intencionalmente <strong>não</strong> fazem parte deste caminho; escolha-os em <link>Personalizáveis</link> se precisar deles."
|
||||
},
|
||||
"applies": {
|
||||
"heading": "O que o script aplica",
|
||||
"intro": "As otimizações são aplicadas nesta ordem exata. A coluna <em>Categoria</em> liga à documentação detalhada de cada alteração na referência personalizável.",
|
||||
"headerNum": "#",
|
||||
"headerTool": "Ferramenta",
|
||||
"headerWhat": "O que ele faz",
|
||||
"headerCategory": "Categoria"
|
||||
},
|
||||
"optimizations": [
|
||||
{
|
||||
"tool": "Repositórios APT + atualização completa",
|
||||
"what": "Desativa as fontes Enterprise pve-enterprise.sources e ceph.sources, cria uma fonte no-subscription para o nome de código Debian do host e executa apt update && apt full-upgrade -y (comando oficial de atualização Proxmox).",
|
||||
"category": "Configurações básicas",
|
||||
"categorySlug": "basic-settings"
|
||||
},
|
||||
{
|
||||
"tool": "Remoção de banner de assinatura",
|
||||
"what": "Aplica patches na interface web para ocultar o banner 'Sem assinatura válida'. Pede confirmação antes de aplicar; reversível de Desinstalar Otimizações.",
|
||||
"category": "Personalização",
|
||||
"categorySlug": "customization"
|
||||
},
|
||||
{
|
||||
"tool": "Forçar IPv4",
|
||||
"what": "Escreve /etc/apt/apt.conf.d/99-force-ipv4 para o apt usar apenas IPv4, contornando ligações IPv6 instáveis aos espelhos.",
|
||||
"category": "Rede",
|
||||
"categorySlug": "network"
|
||||
},
|
||||
{
|
||||
"tool": "Ignorar pacotes de idioma",
|
||||
"what": "Escreve /etc/apt/apt.conf.d/99-disable-translations para deixar de transferir índices de descrições traduzidas de pacotes, reduzindo os dados das atualizações apt.",
|
||||
"category": "Configurações básicas",
|
||||
"categorySlug": "basic-settings"
|
||||
},
|
||||
{
|
||||
"tool": "Aumentar os limites do sistema",
|
||||
"what": "Aumenta as monitorizações inotify, os limites nofile/nproc, os limites do chaveiro do kernel e fs.file-max através de sysctl.d, limits.d, pam e systemd, para hosts com muitos contentores.",
|
||||
"category": "Sistema",
|
||||
"categorySlug": "system"
|
||||
},
|
||||
{
|
||||
"tool": "Ajuste de memória",
|
||||
"what": "Define vm.swappiness=10, proporções equilibradas de páginas modificadas ainda não gravadas, vm.max_map_count=262144 e compactação proativa quando suportada. A política de sobrealocação de memória do kernel mantém a predefinição Proxmox.",
|
||||
"category": "Sistema",
|
||||
"categorySlug": "system"
|
||||
},
|
||||
{
|
||||
"tool": "Comportamento de pânico no Kernel",
|
||||
"what": "Configura o host para reiniciar 10 segundos após um pânico / oops / hardlockup em vez de congelar indefinidamente.",
|
||||
"category": "Sistema",
|
||||
"categorySlug": "system"
|
||||
},
|
||||
{
|
||||
"tool": "Ajuste de pilha de rede",
|
||||
"what": "Dimensionamento dos buffers TCP, reforço IPv4 (redirecionamentos desligados, rp_filter=2, registo martian desligado), portas locais 1024-65535, deteção MTU TCP, RFC 1337 e script /usr/local/sbin/proxmenux-fwbr-tune ligado a uma unidade systemd de execução única e regra udev. Assim, rp_filter=0 / log_martians=0 são reaplicados às interfaces fwbr*/fwln*/fwpr*/tap* sempre que Proxmox as recria ao iniciar/parar VMs, reiniciar ou migrar em funcionamento.",
|
||||
"category": "Rede",
|
||||
"categorySlug": "network"
|
||||
},
|
||||
{
|
||||
"tool": "Personalização de bashrc (root)",
|
||||
"what": "PS1 colorido, aliases comuns (l/la/ll/ls/grep), histórico com datas e horas e carregamento de bash-completion, num bloco delimitado PMX_CORE_BASHRC fácil de remover.",
|
||||
"category": "Personalização",
|
||||
"categorySlug": "customization"
|
||||
},
|
||||
{
|
||||
"tool": "Log2RAM (adaptado a SSD, automático)",
|
||||
"what": "Reduz o desgaste SSD/NVMe movendo /var/log para um ramdisk tmpfs com sincronização periódica para disco. Instalação a partir do projeto original quando o disco raiz é SSD ou NVMe. Dimensiona pela RAM do host (128M / 256M / 512M), agenda sincronização periódica e proteção automática que limpa journals antigos aos 80% e trunca registos muito ativos aos 92% antes de gravar. Ajusta limites journald ao ramdisk. Detalhes em <link>Log2RAM</link>.",
|
||||
"category": "Armazenamento",
|
||||
"categorySlug": "storage"
|
||||
},
|
||||
{
|
||||
"tool": "Autotrim ZFS (apenas SSD)",
|
||||
"what": "Ativa zpool autotrim=on em cada pool ZFS cujos vdevs sejam todos SSD/NVMe com TRIM (verifica /sys/block/[dev]/queue/rotational e discard_granularity). Ignora automaticamente pools com HDDs. Só regista para desinstalação os pools realmente alterados pelo ProxMenux; autotrim ativado manualmente é preservado.",
|
||||
"category": "Armazenamento",
|
||||
"categorySlug": "storage"
|
||||
},
|
||||
{
|
||||
"tool": "Limites de tamanho do journald",
|
||||
"what": "Força armazenamento persistente, limita SystemMaxUse=64M / RuntimeMaxUse=60M e ativa compressão e registos de nível info necessários ao Monitor. É ignorado se Log2RAM estiver ativo, pois faz o seu próprio ajuste.",
|
||||
"category": "Sistema",
|
||||
"categorySlug": "system"
|
||||
},
|
||||
{
|
||||
"tool": "Ajuste de logrotate",
|
||||
"what": "Define globalmente daily e depois size 10M, retém 7 rotações e ativa compressão e copytruncate. O critério de tamanho posterior prevalece; regras específicas podem substituí-lo. Adequado ao Log2RAM, mas a frequência depende das regras e do temporizador.",
|
||||
"category": "Sistema",
|
||||
"categorySlug": "system"
|
||||
},
|
||||
{
|
||||
"tool": "Nomes de interface persistentes",
|
||||
"what": "Escreve um ficheiro <code>/etc/systemd/network/10-proxmenux-<iface>.link</code> por placa física, com cabeçalho «Managed by ProxMenux», associando o MAC ao nome atual. Os nomes <code>eth0</code> / <code>enp…</code> ficam estáveis após reinícios e adição de placas.",
|
||||
"category": "Rede",
|
||||
"categorySlug": "network"
|
||||
}
|
||||
],
|
||||
"hardwareTitle": "Predefinições adaptadas ao hardware",
|
||||
"hardwareBody": "O script lê o hardware do host antes de aplicar as configurações. Log2RAM é instalado apenas em discos raiz SSD / NVMe por padrão (ele avisa se a detecção indicar o contrário). O tamanho do ramdisk Log2RAM é escolhido do total RAM (<code>≤ 8 GB → 128M</code>, <code>≤ 16 GB → 256M</code>, <code>'>' 16 GB → 512M</code>). Os limites journald correspondem ao tamanho do disco RAM quando Log2RAM está ativo, para evitar preenchê-lo.",
|
||||
"upgrade": {
|
||||
"heading": "Atualizar listas de pacotes e sistema",
|
||||
"intro": "O primeiro passo do percurso automatizado é atualizar o Proxmox. Para um host em funcionamento dentro da mesma versão principal, o Proxmox recomenda:",
|
||||
"after": "Esta linha é o comando oficial das versões atuais do Proxmox. O script automatizado executa <strong>exatamente</strong> isso e acrescenta a limpeza dos repositórios e as tarefas após atualização recomendadas pelo guia — como o utilitário independente <link>Atualização do sistema Proxmox</link>:",
|
||||
"items": [
|
||||
"Desativa as fontes Enterprise <code>pve-enterprise.sources</code> / <code>ceph.sources</code>, remove ficheiros antigos de repositórios e cria uma fonte no-subscription para o nome de código do host.",
|
||||
"Executa a atualização não-interativa com <code>DEBIAN_FRONTEND=noninteractive</code> e <code>--force-confdef --force-confold</code> — os arquivos de configuração que você personalizou permanecem seus quando o upstream também os alterou.",
|
||||
"Instala pacotes essenciais do Proxmox em falta (<code>zfsutils-linux</code>, <code>proxmox-backup-restore-image</code>, <code>chrony</code>).",
|
||||
"Verificação de sanidade de metadados LVM, <code>apt-get autoremove -y</code> + <code>apt-get autoclean -y</code>, e um prompt de reinicialização apenas se o kernel realmente mudou."
|
||||
],
|
||||
"sameTitle": "Mesmo atualizador, dois pontos de entrada",
|
||||
"sameBody": "O pacote automatizado e o utilitário independente <link>Proxmox System Update</link> compartilham os mesmos scripts subjacentes (<code>update-pve8.sh</code> / <code>update-pve9_2.sh</code>). Use o utilitário por conta própria quando você só quiser atualizar o host sem aplicar o resto das otimizações."
|
||||
},
|
||||
"endResult": {
|
||||
"heading": "Resultado final esperado",
|
||||
"body": "No fim, verá uma mensagem de sucesso com a saída de cada passo e uma pergunta de reinício, necessário para algumas definições do kernel. Pode adiá-lo; as definições aplicam-se no próximo arranque.",
|
||||
"imageAlt": "Programa pós-instalação automatizado — saída final do terminal mostrando cada otimização aplicada com sucesso"
|
||||
},
|
||||
"notDoes": {
|
||||
"heading": "O que este script NÃO faz",
|
||||
"items": [
|
||||
"Deteção automática do fuso horário (comentada no código original; use Personalizável se precisar).",
|
||||
"Desativar portmapper / rpcbind (ver <secLink>Segurança</secLink>).",
|
||||
"Activar IOMMU / VFIO (ver <virtLink>Virtualização</virtLink>).",
|
||||
"Instalar Fastfetch / Figurine / repositório Ceph / HA / correções de CPU AMD (ver <optLink>Opcionais</optLink>).",
|
||||
"Instalar pigz ou ajustar ZFS ARC (ver <perfLink>Desempenho</perfLink> / <storLink>Armazenamento</storLink>)."
|
||||
]
|
||||
},
|
||||
"xshokTitle": "detecção xshok-proxmox",
|
||||
"xshokBody": "Se o host tiver executado anteriormente o script <code>xshok-proxmox</code>, ProxMenux detecta o arquivo marcador e avisa você antes de continuar. Alguns ajustes podem se sobrepor. O script companheiro está desatualizado — se você decidir continuar de qualquer forma, reveja <link>a visão geral</link> para o contexto.",
|
||||
"revert": {
|
||||
"heading": "Revertendo",
|
||||
"body": "Cada ferramenta da tabela fica registada em <code>/usr/local/share/proxmenux/installed_tools.json</code>. Abra <link>Desinstalar otimizações</link> para escolher os itens a reverter. As cópias dos ficheiros modificados ficam junto dos originais com sufixo <code>.bak</code>."
|
||||
},
|
||||
"related": {
|
||||
"heading": "Relacionado",
|
||||
"items": [
|
||||
{
|
||||
"label": "Pós-instalação personalizável",
|
||||
"href": "/docs/post-install/customizable",
|
||||
"tail": " — escolher exactamente o que pretende do mesmo catálogo."
|
||||
},
|
||||
{
|
||||
"label": "Desinstalar otimizações",
|
||||
"href": "/docs/post-install/uninstall",
|
||||
"tail": " — reverter qualquer subconjunto do que foi aqui aplicado."
|
||||
},
|
||||
{
|
||||
"label": "Comandos úteis do sistema",
|
||||
"href": "/docs/help-info/system-commands",
|
||||
"tail": " — verificar as alterações (uptime, free, journalctl, etc.)."
|
||||
},
|
||||
{
|
||||
"label": "Visão geral da pós-instalação",
|
||||
"href": "/docs/post-install",
|
||||
"tail": "."
|
||||
}
|
||||
]
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,240 @@
|
||||
{
|
||||
"meta": {
|
||||
"title": "Pós-instalação: Configurações básicas | Documentação ProxMenux",
|
||||
"description": "Opções de pós-instalação fundamentais: mude para repositórios gratuitos do Proxmox e atualize, detecte automaticamente o fuso horário e habilite o NTP, pule downloads de linguagem APT e escolha os utilitários comuns do sistema 25 para instalar."
|
||||
},
|
||||
"header": {
|
||||
"title": "Pós-instalação: Configurações básicas",
|
||||
"section": "Configurações pós-instalação do Proxmox"
|
||||
},
|
||||
"intro": {
|
||||
"title": "O que esta categoria abrange",
|
||||
"body": "Cinco opções de base para um host Proxmox novo: usar repositórios comunitários sem subscrição, atualizar todo o sistema, configurar automaticamente o fuso horário e NTP, desativar traduções APT para poupar largura de banda e espaço e escolher entre 25 utilitários comuns."
|
||||
},
|
||||
"upgrade": {
|
||||
"heading": "Atualizar listas de pacotes e sistema",
|
||||
"intro": "Reconfigura o APT para usar o repositório <em>pve-no-subscription</em> gratuito (em vez do repositório corporativo que requer uma assinatura) e executa uma atualização completa do sistema. Os passos exatos dependem da versão principal do Proxmox VE: ProxMenux detecta e envia para o script certo.",
|
||||
"headerVersion": "Versão PVE",
|
||||
"headerScript": "Script de seleção por versão",
|
||||
"headerCodename": "Nome de código Debian",
|
||||
"rows": [
|
||||
{
|
||||
"version": "9.x",
|
||||
"script": "update-pve9_2.sh",
|
||||
"codename": "trixie"
|
||||
},
|
||||
{
|
||||
"version": "8.x",
|
||||
"script": "update-pve8.sh",
|
||||
"codename": "bookworm"
|
||||
}
|
||||
],
|
||||
"officialTitle": "A recomendação oficial da Proxmox",
|
||||
"officialBody": "A própria orientação de atualização da Proxmox é executar, nesta ordem exata:",
|
||||
"officialOutro": "É o comando habitual para atualizações dentro da versão principal instalada do Proxmox VE. Verifique os repositórios e as alterações propostas aos pacotes <em>antes</em> de continuar. A mudança de versão principal exige o procedimento oficial de migração.",
|
||||
"doesTitle": "O que a opção ProxMenux faz — verificado contra o script",
|
||||
"doesIntro": "A atualização ProxMenux executa os comandos apt acima e acrescenta passos prévios e posteriores que teria de gerir manualmente. Cada item abaixo corresponde ao script de seleção; consulte <link>Atualização do sistema Proxmox</link> para o detalhe completo.",
|
||||
"doesItems": [
|
||||
"<strong>Primeiro, organizar os repositórios.</strong> Desativa as fontes Enterprise <code>pve-enterprise.sources</code> / <code>ceph.sources</code>, remove ficheiros antigos de versões PVE anteriores e cria um <code>proxmox.sources</code> limpo para o canal gratuito <em>pve-no-subscription</em>, conforme o nome de código Debian: trixie para PVE 9, bookworm para PVE 8.",
|
||||
"<strong>Reescreve os repositórios Debian</strong> com main / updates / security e <code>non-free-firmware</code>, para eliminar o aviso de firmware durante a atualização.",
|
||||
"<strong>Executa a atualização oficial.</strong> <code>apt-get update</code> seguido por <code>apt full-upgrade -y</code> (PVE 9) ou <code>apt dist-upgrade -y</code> (PVE 8), ambos lançados não-interactivamente com <code>--force-confdef --force-confold</code> para que quaisquer arquivos de configuração que você personalizou permaneçam seus.",
|
||||
"<strong>Instala pacotes essenciais</strong> se estiverem faltando: <code>zfsutils-linux</code>, <code>proxmox-backup-restore-image</code>, <code>chrony</code>.",
|
||||
"<strong>Verifica os metadados LVM.</strong> Procura VMs com passthrough de discos que possam ter deixado cabeçalhos antigos de volumes físicos nos discos em bruto. Avisa sobre anomalias sem as corrigir automaticamente.",
|
||||
"<strong>Limpa depois:</strong> <code>apt-get autoremove -y</code> + <code>apt-get autoclean -y</code>, então pede uma reinicialização se o kernel foi atualizado ou <code>/var/run/reboot-required</code> está presente."
|
||||
],
|
||||
"shortTitle": "Em suma",
|
||||
"shortBody": "A opção executa o comando recomendado <code>apt update && apt full-upgrade -y</code>, com a organização dos repositórios e a limpeza final indicadas no guia oficial, e pede reinício no fim. Consulte <link>Atualização do sistema Proxmox</link> para o diagrama completo; o mesmo atualizador está disponível separadamente no menu principal.",
|
||||
"subTitle": "Não aplicar a um host com subscrição",
|
||||
"subBody": "Se você realmente tiver uma assinatura Proxmox e quiser continuar usando os repositórios empresariais, pule esta opção. Executando-o desabilita o repositório corporativo e encaminha o host para o canal comunitário. A atualização do pacote e reescrita do repositório não são apresentadas como reversíveis em Desinstalar Otimizações; restaure sua configuração do repositório deliberadamente se você precisar mudar de canal mais tarde.",
|
||||
"safetyTitle": "Controlo de segurança pós-atualização",
|
||||
"safetyBody": "Após a atualização, o script procura metadados antigos de volumes físicos (PV) nos discos. Pode acontecer quando uma VM com passthrough escreve cabeçalhos LVM num disco em bruto. Se detetar algo suspeito, avisa e sugere <code>pvs</code> para inspeção. Não altera nada automaticamente."
|
||||
},
|
||||
"time": {
|
||||
"heading": "Sincronizar a hora automaticamente",
|
||||
"intro": "Detecta o IP público do servidor via <code>dig myip.opendns.com @resolver1.opendns.com</code>, em seguida, consulta o <code>ipapi.co/'{'ip'}'/timezone</code> para procurar o fuso horário IANA correspondente, e aplica-o com o <code>timedatectl set-timezone</code>. Finalmente permite NTP com <code>timedatectl set-ntp true</code>.",
|
||||
"depTitle": "Depende de dois serviços externos",
|
||||
"depBody": "A pesquisa depende de OpenDNS e <code>ipapi.co</code> serem alcançáveis, e de suas respostas serem corretas. Se você executar o Proxmox atrás de uma VPN ou em um VLAN que sai de uma região diferente, o fuso horário detectado automaticamente pode estar errado. Nesse caso, ignore esta opção e defina o fuso- horário à mão:",
|
||||
"revertTitle": "Reversível do menu Desinstalar",
|
||||
"revertBody": "<link>Desinstalar otimizações</link> repõe o fuso horário em UTC, um valor seguro. NTP continua ativo: o relógio sincroniza e mostra UTC até definir outro fuso manualmente."
|
||||
},
|
||||
"languages": {
|
||||
"heading": "ignorar o download de idiomas adicionais",
|
||||
"intro": "Durante <code>apt update</code>, o APT pode transferir descrições de pacotes traduzidas além dos metadados principais. A opção desativa-as para poupar largura de banda e espaço. Antes, o ProxMenux <strong>confirma que as definições regionais do host foram geradas</strong>: lê <code>/etc/default/locale</code> ou <code>/etc/environment</code>, acrescenta a <code>/etc/locale.gen</code> se faltar e executa <code>locale-gen</code>. Assim mantém as definições regionais da shell.",
|
||||
"writtenTitle": "O que é escrito",
|
||||
"revertTitle": "Reversível do menu Desinstalar",
|
||||
"revertBody": "Excluindo <code>/etc/apt/apt.conf.d/99-disable-translations</code> (quer manualmente ou a partir do menu Desinstalar) restaura o comportamento padrão e APT baixa arquivos de idioma novamente."
|
||||
},
|
||||
"utilities": {
|
||||
"heading": "Instale utilitários comuns do sistema",
|
||||
"intro": "Abre uma lista de <strong>25 utilitários selecionados</strong> por grupos. Escolha e confirme; o ProxMenux instala-os pelo <code>apt</code>, verifica o resultado e mostra um resumo final.",
|
||||
"imageAlt": "Seletor de utilitários ProxMenux: Espaço para selecionar, Enter para confirmar",
|
||||
"reuseTitle": "A mesma lista é reutilizada em outro lugar",
|
||||
"reuseBody": "O catálogo dos 25 utilitários tem uma única definição: <code>PROXMENUX_UTILS</code> em <code>scripts/global/utils-install-functions.sh</code>. O menu <em>Utilitários e ferramentas → Utilitários do sistema</em> oferece a mesma lista para instalar mais tarde sem repetir a pós-instalação.",
|
||||
"listTitle": "O que está na lista",
|
||||
"groups": [
|
||||
{
|
||||
"group": "Monitores de sistemas",
|
||||
"items": [
|
||||
{
|
||||
"pkg": "htop",
|
||||
"desc": "Visualizador interativo de processos"
|
||||
},
|
||||
{
|
||||
"pkg": "btop",
|
||||
"desc": "Monitor moderno de recursos (CPU, RAM, discos, rede, processos)"
|
||||
},
|
||||
{
|
||||
"pkg": "s-tui",
|
||||
"desc": "Interface de terminal para testes de esforço e monitorização da CPU"
|
||||
},
|
||||
{
|
||||
"pkg": "iftop",
|
||||
"desc": "Utilização de largura de banda ao vivo por ligação"
|
||||
},
|
||||
{
|
||||
"pkg": "iotop",
|
||||
"desc": "I/O do disco por processo"
|
||||
},
|
||||
{
|
||||
"pkg": "iptraf-ng",
|
||||
"desc": "Monitor Interativo IP LAN"
|
||||
}
|
||||
]
|
||||
},
|
||||
{
|
||||
"group": "Rede",
|
||||
"items": [
|
||||
{
|
||||
"pkg": "iperf3",
|
||||
"desc": "Medir largura de banda máxima alcançável entre máquinas"
|
||||
},
|
||||
{
|
||||
"pkg": "net-tools",
|
||||
"desc": "Ferramentas antigas (ifconfig, netstat, route). Ainda úteis para verificações rápidas"
|
||||
},
|
||||
{
|
||||
"pkg": "ipset",
|
||||
"desc": "Gerencie grandes conjuntos de IP no kernel — úteis com regras iptables/nftables."
|
||||
}
|
||||
]
|
||||
},
|
||||
{
|
||||
"group": "Transferências e arquivos",
|
||||
"items": [
|
||||
{
|
||||
"pkg": "axel",
|
||||
"desc": "Acelerador de transferência paralelo leve"
|
||||
},
|
||||
{
|
||||
"pkg": "aria2",
|
||||
"desc": "Downloader multi-fonte / multi-protocolo (HTTP, FTP, BitTorrent, Metalink)"
|
||||
},
|
||||
{
|
||||
"pkg": "unzip",
|
||||
"desc": "Extrair arquivos ZIP"
|
||||
},
|
||||
{
|
||||
"pkg": "zip",
|
||||
"desc": "Criar arquivos ZIP"
|
||||
},
|
||||
{
|
||||
"pkg": "cabextract",
|
||||
"desc": "Extrair arquivos Microsoft CAB (útil com ISOs do Windows)"
|
||||
},
|
||||
{
|
||||
"pkg": "wimtools",
|
||||
"desc": "Manipular imagens WIM do Windows (extrair, dividir, montar, aplicar)"
|
||||
},
|
||||
{
|
||||
"pkg": "genisoimage",
|
||||
"desc": "Compila imagens ISO 9660 de uma árvore de diretórios"
|
||||
}
|
||||
]
|
||||
},
|
||||
{
|
||||
"group": "Texto e ficheiros",
|
||||
"items": [
|
||||
{
|
||||
"pkg": "dos2unix",
|
||||
"desc": "Converter final de linha CRLF (Windows) para LF (Unix)"
|
||||
},
|
||||
{
|
||||
"pkg": "grc",
|
||||
"desc": "Colorização genérica: aplica realce de sintaxe às saídas de ping, traceroute, dig, tail e outros comandos"
|
||||
},
|
||||
{
|
||||
"pkg": "plocate",
|
||||
"desc": "Pesquisa rápida de arquivos (indexado). Executar `updatedb` após instalar para construir o índice."
|
||||
}
|
||||
]
|
||||
},
|
||||
{
|
||||
"group": "Remoto e sessões",
|
||||
"items": [
|
||||
{
|
||||
"pkg": "sshpass",
|
||||
"desc": "Autenticação de senha SSH não interativa — útil para scripts, não para uso diário"
|
||||
},
|
||||
{
|
||||
"pkg": "tmux",
|
||||
"desc": "Multiplexador de terminal — desacoplar sessões, dividir painéis, sobreviver a desconexão"
|
||||
}
|
||||
]
|
||||
},
|
||||
{
|
||||
"group": "Hardware e baixo nível",
|
||||
"items": [
|
||||
{
|
||||
"pkg": "msr-tools",
|
||||
"desc": "Ler/escrever registos específicos do modelo de CPU (rdmsr, wrmsr)"
|
||||
},
|
||||
{
|
||||
"pkg": "intel-gpu-tools",
|
||||
"desc": "Utilitários de diagnóstico Intel GPU incluindo `intel_gpu_top`"
|
||||
}
|
||||
]
|
||||
},
|
||||
{
|
||||
"group": "Virtualização",
|
||||
"items": [
|
||||
{
|
||||
"pkg": "libguestfs-tools",
|
||||
"desc": "Inspecionar e modificar imagens de disco VM (virt-ls, virt-cat, guestmount...)"
|
||||
},
|
||||
{
|
||||
"pkg": "chntpw",
|
||||
"desc": "Editar Windows SAM — útil para recuperação de senha em Windows VMs você herda"
|
||||
}
|
||||
]
|
||||
}
|
||||
],
|
||||
"actionTitle": "Alguns deles em acção",
|
||||
"noBulkTitle": "Apenas os utilitários instalados pelo ProxMenux são removidos",
|
||||
"noBulkBody": "ProxMenux registra apenas os pacotes utilitários selecionados que ainda não estavam instalados antes desta ação. Desinstalar Otimizações pode purgar esses pacotes mais tarde, enquanto utilitários que já estavam presentes no host são deixados intocados. A atualização geral do sistema APT não é intencionalmente rastreada como reversível porque os pacotes atualizados não têm retorno atômico seguro."
|
||||
},
|
||||
"related": {
|
||||
"heading": "Relacionado",
|
||||
"items": [
|
||||
{
|
||||
"label": "Atualização do sistema Proxmox",
|
||||
"href": "/docs/utils/system-update",
|
||||
"tail": " — reexecuta o ciclo apt update + dist-upgrade a pedido."
|
||||
},
|
||||
{
|
||||
"label": "Instalador de utilitários de sistema",
|
||||
"href": "/docs/utils/system-utils",
|
||||
"tail": " — instalar (ou reinstalar) utilitários individualmente após a pós-instalação."
|
||||
},
|
||||
{
|
||||
"label": "Comandos de atualizações e pacotes",
|
||||
"href": "/docs/help-info/update-commands",
|
||||
"tail": " — Referência apt para a shell."
|
||||
},
|
||||
{
|
||||
"label": "Pós-instalação personalizável",
|
||||
"href": "/docs/post-install/customizable",
|
||||
"tail": " — voltar ao menu superior."
|
||||
}
|
||||
]
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,106 @@
|
||||
{
|
||||
"meta": {
|
||||
"title": "Script pós-instalação personalizável | Documentação ProxMenux",
|
||||
"description": "Escolha exatamente que otimizações aplicar a um host Proxmox VE com ProxMenux. 10 categorias, cerca de 35 ferramentas e uma interface com caixas de seleção. Inclui tudo do script Automatizado, mais opções de ativação explícita (IOMMU, Fastfetch, Figurine, Ceph, HA, correções AMD…).",
|
||||
"ogTitle": "Script pós-instalação personalizável | Documentação ProxMenux",
|
||||
"ogDescription": "10 categorias, cerca de 35 otimizações individuais. Escolha exatamente o que pretende num host Proxmox VE. As alterações reversíveis são registadas."
|
||||
},
|
||||
"header": {
|
||||
"title": "Script pós-instalação personalizável",
|
||||
"description": "Escolha exatamente que otimizações aplicar a um host Proxmox VE. O ProxMenux agrupa cerca de 35 ferramentas em 10 categorias numa única janela com caixas de seleção. O mesmo motor de Automatizado, com controlo total sobre o que é aplicado.",
|
||||
"section": "Pós-instalação · Personalizável"
|
||||
},
|
||||
"intro": {
|
||||
"title": "Quando escolher Personalizável",
|
||||
"body": "Escolha esta opção se já souber os ajustes que quer ou não quer no host. Uma lista com caixas agrupadas por categoria permite selecionar, desmarcar e combinar otimizações. Pode voltar a aplicá-las mais tarde; as alterações reversíveis são registadas para <link>Desinstalar otimizações</link>. As atualizações de pacotes não são apresentadas como reversíveis."
|
||||
},
|
||||
"compare": {
|
||||
"heading": "Comparação com Automatizado",
|
||||
"body": "Personalizável inclui todo o <link>script Automatizado</link>: as mesmas 14 otimizações de base e várias opções deliberadamente omitidas por Automatizado, úteis em hardware específico (correções AMD), alojamento específico (OVH RTM) ou cargas particulares (IOMMU/VFIO, repositório Ceph, alta disponibilidade, Fastfetch, Figurine, ajuste do ARC ZFS, pigz, instantâneos ZFS automáticos, limites de velocidade vzdump, Open vSwitch, TCP BBR…)."
|
||||
},
|
||||
"categoriesSection": {
|
||||
"heading": "As 10 categorias",
|
||||
"body": "O script Personalizável agrupa as otimizações em 10 categorias numa única janela com caixas de seleção. Cada categoria tem a sua página de documentação: abra um cartão para consultar a justificação, os valores predefinidos e as verificações de cada opção."
|
||||
},
|
||||
"categories": [
|
||||
{
|
||||
"name": "Configurações básicas",
|
||||
"description": "Limpa as fontes APT, executa a atualização oficial Proxmox e define o fuso horário, as definições regionais e utilitários comuns. A base de todas as outras categorias."
|
||||
},
|
||||
{
|
||||
"name": "Sistema",
|
||||
"description": "Ajusta os registos e os limites do kernel para um host com muitas VMs e contentores. Abrange journald, logrotate, sysctl (memória, limites de ficheiros), comportamento em caso de kernel panic e reinícios rápidos."
|
||||
},
|
||||
{
|
||||
"name": "Virtualização",
|
||||
"description": "Prepara o host para virtualização avançada. Instala o agente convidado adequado quando o próprio Proxmox corre numa VM suportada e ativa IOMMU/VFIO para passthrough PCI de GPUs, controladores e TPUs."
|
||||
},
|
||||
{
|
||||
"name": "Rede",
|
||||
"description": "Proteja e ajuste a pilha de rede do host. Força o APT sobre IPv4, aplica proteção sysctl + TCP ajuste de buffer, oferece Open vSwitch, TCP BBR + TCP Fast Open e fixa nomes de interface persistentes por MAC."
|
||||
},
|
||||
{
|
||||
"name": "Armazenamento",
|
||||
"description": "Configure os subsistemas comuns de armazenamento do Proxmox: ZFS Dimensionamento do ARC, ZFS auto-snapshot, ZFS Autotrim para SSD/NVMe pools, e vzdump limites de velocidade para evitar saturar o disco durante backups."
|
||||
},
|
||||
{
|
||||
"name": "Segurança",
|
||||
"description": "Reduz a superfície de ataque exposta por predefinição. Desativa os serviços RPC portmapper/rpcbind de que o Proxmox não precisa mas que deixa à escuta."
|
||||
},
|
||||
{
|
||||
"name": "Personalização",
|
||||
"description": "Altera a aparência e a experiência da shell do host: cores e aliases no bashrc, faixa MOTD e remoção do aviso de subscrição na interface web."
|
||||
},
|
||||
{
|
||||
"name": "Monitoramento",
|
||||
"description": "Integra o host com OVH Real-Time Monitoring. Só instala RTM se o ProxMenux detetar um servidor OVH; nos outros hosts não faz alterações."
|
||||
},
|
||||
{
|
||||
"name": "Desempenho",
|
||||
"description": "Acelerar as operações de compressão (backups, transferências) substituindo o gzip por seu equivalente paralelo pigz."
|
||||
},
|
||||
{
|
||||
"name": "Opcional",
|
||||
"description": "Opções especializadas de que nem todos os hosts precisam: correções CPU AMD, faixa Fastfetch, nome 3D com Figurine, atualização do índice PVE Appliance Manager, repositório Ceph, serviços de alta disponibilidade, Log2RAM para reduzir o desgaste dos SSD e perfil swap ZRAM."
|
||||
}
|
||||
],
|
||||
"mixTip": {
|
||||
"title": "Misturar automatizado e personalizável",
|
||||
"body": "Um uso comum: execute primeiro <strong>Automatizado</strong> para estabelecer uma base sensata, abra depois <strong>Personalizável</strong> e escolha apenas as opções úteis, como IOMMU para passthrough de GPU. As alterações são registadas separadamente; Desinstalar mostra tudo o que foi aplicado, independentemente da opção usada."
|
||||
},
|
||||
"related": {
|
||||
"heading": "Relacionado",
|
||||
"items": [
|
||||
{
|
||||
"label": "Pós-instalação automatizada",
|
||||
"href": "/docs/post-install/automated",
|
||||
"tail": " — valores predefinidos sensatos aplicados sem perguntas."
|
||||
},
|
||||
{
|
||||
"label": "Desinstalar otimizações",
|
||||
"href": "/docs/post-install/uninstall",
|
||||
"tail": " — reverter de forma limpa as opções selecionadas."
|
||||
},
|
||||
{
|
||||
"label": "Configurações básicas",
|
||||
"href": "/docs/post-install/basic-settings",
|
||||
"tail": " — repositórios, hora, idioma e utilitários."
|
||||
},
|
||||
{
|
||||
"label": "Virtualização",
|
||||
"href": "/docs/post-install/virtualization",
|
||||
"tail": " — IOMMU + VFIO para passagem."
|
||||
},
|
||||
{
|
||||
"label": "Segurança",
|
||||
"href": "/docs/post-install/security",
|
||||
"tailRich": " · <storageLink>Armazenamento</storageLink> · <networkLink>Rede</networkLink> · <customLink>Personalização</customLink> — outras categorias."
|
||||
},
|
||||
{
|
||||
"label": "Visão geral pós-instalação",
|
||||
"href": "/docs/post-install",
|
||||
"tail": "."
|
||||
}
|
||||
]
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,74 @@
|
||||
{
|
||||
"meta": {
|
||||
"title": "Pós-instalação: Personalização | Documentação ProxMenux",
|
||||
"description": "Opções de personalização no script pós-instalação personalizável do ProxMenux: prompt bash colorido com aliases úteis, faixa ProxMenux no MOTD e remoção do aviso de subscrição da interface web Proxmox."
|
||||
},
|
||||
"header": {
|
||||
"title": "Após a instalação: personalização",
|
||||
"description": "Ajustes visuais e de utilização do host Proxmox. Melhoram a shell e ocultam o aviso de subscrição na interface web. Bashrc, MOTD e a faixa de subscrição são registados e reversíveis pelo menu Desinstalar.",
|
||||
"section": "Configurações pós-instalação do Proxmox"
|
||||
},
|
||||
"intro": {
|
||||
"title": "O que esta categoria abrange",
|
||||
"body": "Três opções pequenas e independentes: um <strong>prompt bash colorido com aliases</strong> para a shell root, uma <strong>faixa MOTD</strong> de uma linha no acesso SSH e remoção da <strong>janela «Sem subscrição válida»</strong> apresentada a cada acesso à interface web Proxmox."
|
||||
},
|
||||
"bashrc": {
|
||||
"heading": "Personalizar bashrc",
|
||||
"intro": "Insere em <code>/root/.bashrc</code> um bloco com prompt colorido, histórico com data e hora, aliases comuns de <code>ls</code> / <code>grep</code> e um <code>source</code> para o preenchimento automático bash. Torna o trabalho por SSH mais agradável e identifica claramente o host quando tem muitos separadores abertos.",
|
||||
"writesTitle": "O que o ProxMenux adiciona ao .bashrc",
|
||||
"writesOutro": "O bloco é delimitado pelos marcadores <code>PMX_CORE_BASHRC</code>. Voltar a executar o script substitui o bloco anterior sem o duplicar. O <code>.bashrc</code> original é guardado uma vez em <code>/root/.bashrc.bak</code> e acrescenta-se a linha <code>source /root/.bashrc</code> a <code>/root/.bash_profile</code> para aplicar o prompt também nas shells de login, por exemplo após <code>su -</code>.",
|
||||
"rootTitle": "Aplica-se apenas ao root",
|
||||
"rootBody": "A personalização visa o shell da conta root. Outros usuários que você cria no host mantêm seus próprios padrões. Se você administrar o Proxmox exclusivamente na interface web e nunca usar o shell, esta opção é estética pura e você pode pular."
|
||||
},
|
||||
"motd": {
|
||||
"heading": "configurar banner MOTD personalizado",
|
||||
"intro": "Acrescenta <em>\"This system is optimised by: ProxMenux\"</em> ao início de <code>/etc/motd</code>, a mensagem após um acesso SSH bem-sucedido, acima do prompt e antes dos scripts <code>update-motd</code>. Inofensivo e apenas informativo: confirma visualmente que o ProxMenux foi aplicado no host.",
|
||||
"writesTitle": "O que o ProxMenux escreve",
|
||||
"writesOutro": "Em primeiro lugar, ProxMenux registra se <code>/etc/motd</code> existia e armazena seu conteúdo original sob <code>/usr/local/share/proxmenux</code>. A operação é idempotente: se a linha do marcador já está presente, nada é adicionado. Instalações antigas com <code>/etc/motd.bak</code> existentes são migradas para o mesmo estado reversível."
|
||||
},
|
||||
"banner": {
|
||||
"heading": "Remover banner de assinatura",
|
||||
"intro": "Remove o <em>\"Você não tem uma assinatura válida para este servidor\"</em> modal que aparece toda vez que alguém entra na interface web do Proxmox sem uma assinatura corporativa. O patch tem conhecimento de versão: diferentes versões principais do Proxmox têm diferentes pacotes de UI, então o ProxMenux envia para o script certo.",
|
||||
"versionTitle": "Escolha do script conforme a versão",
|
||||
"versionItems": [
|
||||
"<strong>PVE 9.x</strong> → executa <code>remove-banner-pve-v3.sh</code>, que altera <code>proxmoxlib.js</code> para desktop e a nova interface móvel baseada em Yew.",
|
||||
"<strong>PVE 8.x</strong> → executa <code>remove-banner-pve8.sh</code> (somente desktop)."
|
||||
],
|
||||
"versionOutro": "Antes do patch, o ProxMenux faz backup dos arquivos originais JS/template para <code>/usr/local/share/proxmenux/backups/</code> com um timestamp. O fluxo de desinstalação usa esses backups para restaurar os arquivos originais, e cai de volta para reinstalar os pacotes de UI Proxmox se o backup estiver faltando ou corrompido.",
|
||||
"breakTitle": "Pode quebrar após as atualizações do Proxmox",
|
||||
"breakBody": "As atualizações da interface Proxmox substituem regularmente <code>proxmoxlib.js</code> e podem fazer regressar o aviso. Pode voltar a aplicar a opção para alterar o ficheiro ou aceitar o aviso até lá. O ProxMenux também instala um hook APT que reaplica a alteração após atualizações de pacotes; consulte <link>Desinstalar otimizações</link> para o remover.",
|
||||
"legalTitle": "Nota legal (sempre vale a pena repetir)",
|
||||
"legalBody": "Esta opção só oculta o aviso da interface. <strong>Não</strong> dá suporte Enterprise nem acesso ao repositório Enterprise e não altera a licença do software. O Proxmox VE é distribuído sob GNU AGPLv3. Uma subscrição apoia o projeto e dá acesso ao canal de atualizações Enterprise; escolha o suporte adequado ao seu ambiente."
|
||||
},
|
||||
"verify": {
|
||||
"heading": "Verificação",
|
||||
"intro": "Após a aplicação dos três:",
|
||||
"reversibleTitle": "Todas as três alterações de personalização são monitoradas",
|
||||
"reversibleBody": "<link>Desinstalar otimizações</link> repõe <code>/root/.bashrc</code>, devolve ao MOTD o conteúdo exato anterior ao ProxMenux ou remove o ficheiro se antes não existia e restaura os ficheiros de interface alterados a partir das cópias ou reinstala os pacotes necessários."
|
||||
},
|
||||
"related": {
|
||||
"heading": "Relacionado",
|
||||
"items": [
|
||||
{
|
||||
"label": "Opcional",
|
||||
"href": "/docs/post-install/optional",
|
||||
"tail": " — Fastfetch e Figurine (outras personalizações visuais)."
|
||||
},
|
||||
{
|
||||
"label": "Mostrar informações da versão",
|
||||
"href": "/docs/settings/show-version-information",
|
||||
"tail": " — confirma que as personalizações são seguidas como instaladas."
|
||||
},
|
||||
{
|
||||
"label": "Desinstalar otimizações",
|
||||
"href": "/docs/post-install/uninstall",
|
||||
"tail": " — reverter bashrc, motd e o aviso de subscrição."
|
||||
},
|
||||
{
|
||||
"label": "Pós-instalação personalizável",
|
||||
"href": "/docs/post-install/customizable",
|
||||
"tail": " — voltar ao menu superior."
|
||||
}
|
||||
]
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,106 @@
|
||||
{
|
||||
"meta": {
|
||||
"title": "Script pós-instalação Proxmox VE — Automatizado e personalizável | ProxMenux",
|
||||
"description": "Visão geral dos scripts pós-instalação ProxMenux para Proxmox VE. Automatizado aplica valores predefinidos sensatos sem perguntas; Personalizável permite escolher exatamente o que pretende em 10 categorias; Desinstalar otimizações repõe as alterações reversíveis suportadas.",
|
||||
"ogTitle": "Script pós-instalação Proxmox VE — Automatizado e personalizável",
|
||||
"ogDescription": "Aplique otimizações comuns após a instalação do Proxmox VE em 10 categorias, automaticamente ou à escolha, com opções reversíveis.",
|
||||
"twitterTitle": "Script pós-instalação Proxmox VE | ProxMenux",
|
||||
"twitterDescription": "Otimizações pós-instalação automatizadas e personalizáveis para Proxmox VE — com opções reversíveis."
|
||||
},
|
||||
"header": {
|
||||
"title": "Scripts pós-instalação",
|
||||
"description": "Configure um host Proxmox VE recém-instalado com as otimizações pós-instalação do ProxMenux. Aplique automaticamente a configuração de base, escolha opções individuais, atualize funções instaladas ou reponha as alterações reversíveis suportadas. As atualizações de pacotes não são apresentadas como reversíveis.",
|
||||
"section": "Configurações pós-instalação do Proxmox"
|
||||
},
|
||||
"intro": {
|
||||
"title": "Para que serve este menu",
|
||||
"body": "Após instalar o Proxmox VE, dezenas de pequenas alterações tornam o host mais rápido e fácil de manter: repositórios sem subscrição, limites sensatos para journald, buffers TCP adequados, armazenamento de registos que protege os SSD, melhorias no bashrc e mais. O ProxMenux automatiza-as e acompanha as alterações de configuração reversíveis suportadas."
|
||||
},
|
||||
"openingMenu": {
|
||||
"heading": "Abrir o menu",
|
||||
"body": "No menu principal do ProxMenux, selecione <strong>Configurações pós-instalação Proxmox</strong>. Você verá isto:",
|
||||
"imageAlt": "Menu de Scripts pós-instalação — Automatizado, Personalizável, o condicional Aplicar Atualizações Disponíveis (somente quando as atualizações estão pendentes) e Desinstalar, seguido da seção de scripts comunitários"
|
||||
},
|
||||
"threeWays": {
|
||||
"heading": "Quatro maneiras de aplicar otimizações",
|
||||
"body": "As quatro entradas ProxMenux compartilham o mesmo código subjacente e o mesmo registro de ferramentas instaladas — elas apenas lhe dão diferentes níveis de controle. A entrada <em>Aplicar atualizações disponíveis</em> só mostra quando pelo menos uma otimização instalada tem uma versão mais recente no disco do que o registrado; em um host recém-aplicado ele permanece oculto."
|
||||
},
|
||||
"routes": [
|
||||
{
|
||||
"title": "Automatizado",
|
||||
"description": "Um conjunto curado de 14 otimizações seguras e sempre úteis aplicadas em sequência com zero prompts. Bom padrão para a maioria dos usuários.",
|
||||
"bullets": [
|
||||
"Repositórios sem subscrição + atualização do sistema",
|
||||
"Memória, kernel, ajuste de rede",
|
||||
"Log2RAM (detectado automaticamente em SSD/NVMe)",
|
||||
"Limites de tamanho para journald + logrotate",
|
||||
"Nomes de interface persistentes"
|
||||
]
|
||||
},
|
||||
{
|
||||
"title": "Personalizável",
|
||||
"description": "Cerca de 35 otimizações individuais em 10 categorias. Escolhe exatamente quais aplicar. O mesmo motor de Automatizado, com controlo total.",
|
||||
"bullets": [
|
||||
"Interface com caixas de seleção por categoria",
|
||||
"Inclui tudo o que Automatizado faz, mais opções de ativação explícita (IOMMU, Fastfetch, Figurine, Ceph, HA, correções AMD…)",
|
||||
"Executar quantas vezes quiser — as alterações são idempotentes"
|
||||
]
|
||||
},
|
||||
{
|
||||
"title": "Aplicar atualizações disponíveis",
|
||||
"description": "Quando uma otimização pós-instalação (Log2Ram, definições de memória, Logrotate…) tem uma versão no disco mais recente do que a registada no host, esta entrada mostra apenas as que mudaram. Volta a executar a função correspondente e atualiza o registo, sem tocar em mais nada.",
|
||||
"bullets": [
|
||||
"Aceitação por otimização, apenas as que mudaram",
|
||||
"O mesmo seletor disponível no painel do Monitor",
|
||||
"Uma única notificação agrupada quando chegam novas atualizações"
|
||||
]
|
||||
},
|
||||
{
|
||||
"title": "Desinstalar otimizações",
|
||||
"description": "Alterações reversíveis suportadas são monitoradas em um registro JSON e emparelhadas com uma função de restauração. Ações sem um retorno seguro, como uma atualização completa do pacote, são intencionalmente excluídas.",
|
||||
"bullets": [
|
||||
"Detecta otimizações aplicadas anteriormente automaticamente",
|
||||
"Escolhe a reversão adequada a cada item: repõe a cópia .bak, se existir, elimina o fragmento de configuração sysctl.d se nada precisava de cópia ou reinstala o pacote original com --force-confnew (por exemplo para o aviso de subscrição)",
|
||||
"Pedido de reinício se necessário (VFIO, nomes persistentes, etc.)"
|
||||
]
|
||||
}
|
||||
],
|
||||
"whichTitle": "Qual deve escolher?",
|
||||
"whichBody": "Para uma instalação nova do Proxmox com uma base sensata sem decisões: <autoLink><strong>Automatizado</strong></autoLink>. Se já souber os ajustes que quer ou não quer: <customLink><strong>Personalizável</strong></customLink>. Para atualizar apenas uma otimização já aplicada com versão mais recente no disco: <updatesLink><strong>Aplicar atualizações disponíveis</strong></updatesLink>. Para anular alterações anteriores de forma limpa: <uninstallLink><strong>Desinstalar otimizações</strong></uninstallLink>. Pode combiná-los: comece por Automatizado, adicione opções como Fastfetch ou IOMMU com Personalizável e reverta itens individuais mais tarde.",
|
||||
"mixing": {
|
||||
"heading": "Combinar com outros scripts pós-instalação",
|
||||
"stackTitle": "Não empilhar vários scripts pós-instalação",
|
||||
"stackBody": "Executar vários scripts pós-instalação no mesmo host pode causar arquivos de configuração duplicados, entradas de sysctl conflitantes, ou pior — rede quebrada após reinicialização. Se você já aplicou o <strong>Helper-Scripts Post Install</strong>, algumas otimizações ProxMenux podem se sobrepor ao que ele já configurou. Atenha-se a uma ferramenta pós-instalação por máquina.",
|
||||
"xshokTitle": "xshok-proxmox: desactualizado",
|
||||
"xshokBody": "As versões anteriores do ProxMenux indicavam <a>xshok-proxmox</a> como ferramenta pós-instalação complementar. O projeto está obsoleto e já não é oferecido no ProxMenux. Se uma execução antiga tiver deixado marcadores no host, o ProxMenux continua a detetá-los e avisa. Hoje não é uma ferramenta que deva instalar em conjunto com o ProxMenux."
|
||||
},
|
||||
"community": {
|
||||
"heading": "Scripts da comunidade",
|
||||
"body": "O menu também oferece dois scripts de terceiros do projeto <a>community-scripts</a>: <em>Proxmox VE Post Install</em> e <em>Proxmox VE Microcode</em>. São invólucros que transferem e executam os scripts originais através de <code>wget | bash</code>. Não são mantidos pelo ProxMenux. Consulte <link>Repositórios externos</link> para detalhes e questões de confiança antes de os executar."
|
||||
},
|
||||
"related": {
|
||||
"heading": "Relacionado",
|
||||
"items": [
|
||||
{
|
||||
"label": "Atualização do sistema Proxmox",
|
||||
"href": "/docs/utils/system-update",
|
||||
"tail": " — mantém o host atualizado depois de instalado."
|
||||
},
|
||||
{
|
||||
"label": "Segurança",
|
||||
"href": "/docs/security",
|
||||
"tail": " — Fail2Ban + Lynis além do reforço de segurança pós-instalação."
|
||||
},
|
||||
{
|
||||
"label": "Mostrar informações da versão",
|
||||
"href": "/docs/settings/show-version-information",
|
||||
"tail": " — ver que componentes pós-instalação são rastreados como instalados."
|
||||
},
|
||||
{
|
||||
"label": "Comandos de atualizações e pacotes",
|
||||
"href": "/docs/help-info/update-commands",
|
||||
"tail": " — referência para o apt/pveupgrade."
|
||||
}
|
||||
]
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,56 @@
|
||||
{
|
||||
"meta": {
|
||||
"title": "Pós-instalação: Monitorização | Documentação ProxMenux",
|
||||
"description": "Opções de monitoramento no script de pós-instalação personalizável ProxMenux. Atualmente uma única opção: instalar OVH Real-Time Monitoring (RTM), que só se ativa se o host for detectado como um servidor OVH."
|
||||
},
|
||||
"header": {
|
||||
"title": "Após a instalação: monitorização",
|
||||
"description": "Opções de monitoramento dentro do script pós-instalação personalizável. Esta categoria é pequena e específica do provedor — instala o agente OVH Real-Time Monitoring em servidores OVH dedicados e não faz nada em nenhum outro lugar.",
|
||||
"section": "Configurações pós-instalação do Proxmox"
|
||||
},
|
||||
"intro": {
|
||||
"title": "Âmbito intencionalmente limitado",
|
||||
"body": "A monitorização pós-instalação limita-se a <strong>um agente específico de um fornecedor</strong>. Ferramentas gerais (Prometheus, Grafana, node_exporter) ficam fora deste âmbito, pois exigem decisões de arquitetura — host separado, retenção de dados e destinos de alertas — que não cabem num passo com um clique. O ProxMenux Monitor, incluído no ProxMenux, cobre grande parte dessa função sem agentes externos."
|
||||
},
|
||||
"ovh": {
|
||||
"heading": "Instalar o Monitoramento em Tempo Real OVH (RTM)",
|
||||
"intro": "Se o host Proxmox for um servidor dedicado alugado à <a>OVHcloud</a>, pode ativar o RTM para apresentar telemetria de hardware (temperatura da CPU, estado da fonte de alimentação, SMART dos discos, estado do controlador RAID, etc.) no painel de controlo OVH. É o mesmo agente usado pela OVH na função «Server Monitoring».",
|
||||
"decisionsTitle": "Como ProxMenux decide",
|
||||
"decisionsItems": [
|
||||
"Obtém o IP público do host via <code>curl ipinfo.io/ip</code>.",
|
||||
"Procura o ISP proprietário com uma consulta <code>whois</code> para <code>v4.whois.cymru.com</code>.",
|
||||
"Se o resultado mencionar OVH, transfere <code>last-public-ovh-infra-yak.snap.mirrors.ovh.net/yak/archives/apply.sh</code> e passa-o para <code>bash</code> com o manifesto Puppet do RTM v2.",
|
||||
"Se o resultado <em>não</em> mencionar OVH, nada é instalado. A opção não faz alterações."
|
||||
],
|
||||
"remoteTitle": "Script remoto passado para bash através de um pipe",
|
||||
"remoteBody": "A instalação executa <code>wget -qO - https://…apply.sh | bash</code>. Se o espelho OVH for comprometido, o script corre como root no host. Antes de ativar a opção, pondere a confiança na cadeia de espelhos OVH face ao benefício da monitorização. Para a maioria dos utilizadores domésticos ou fora da OVH, a opção deve ficar desativada.",
|
||||
"noOpTitle": "Só activar se a máquina estiver em OVH",
|
||||
"noOpBody": "A opção não altera servidores fora da OVH, pelo que selecioná-la num Proxmox doméstico não causa problemas. Num host não OVH, o script mostra <em>«Não é um servidor OVH, a instalação RTM será ignorada»</em> e termina sem instalar pacotes.",
|
||||
"runsTitle": "O que o ProxMenux executa",
|
||||
"verifyTitle": "Verificação",
|
||||
"verifyBody": "Em um host OVH real, após uma reinicialização você deve ver o painel <a>RTM</a> em seu OVH Manager povoado com dados ao vivo para o host. No lado Proxmox, o coletor RTM é um serviço systemd — verifique-o diretamente:",
|
||||
"troubleTitle": "Resolução de Problemas",
|
||||
"revertTitle": "Remover RTM pelo menu Desinstalar",
|
||||
"revertBody": "Quando RTM está registado como instalado, Desinstalar otimizações oferece uma entrada OVH Real-Time Monitoring. Executa <code>apt-get purge -y ''ovh-rtm*'' ''rtm'' ''rtm-*''</code>, remove /etc/rtm e marca RTM como desinstalado. Os artefactos Puppet podem precisar de limpeza manual; reveja os manifestos específicos do RTM em <code>/etc/puppet/</code>. Num host fora da OVH não foram instalados pacotes RTM, pelo que nada há a remover."
|
||||
},
|
||||
"related": {
|
||||
"heading": "Relacionado",
|
||||
"items": [
|
||||
{
|
||||
"label": "ProxMenux Monitor",
|
||||
"href": "/docs/settings/proxmenux-monitor",
|
||||
"tail": " — painel web local para o host (funciona em qualquer fornecedor, não apenas OVH)."
|
||||
},
|
||||
{
|
||||
"label": "Comandos úteis do sistema",
|
||||
"href": "/docs/help-info/system-commands",
|
||||
"tail": " — referência de monitorização do host local."
|
||||
},
|
||||
{
|
||||
"label": "Pós-instalação personalizável",
|
||||
"href": "/docs/post-install/customizable",
|
||||
"tail": " — voltar ao menu superior."
|
||||
}
|
||||
]
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,128 @@
|
||||
{
|
||||
"meta": {
|
||||
"title": "Pós-instalação: Rede | Documentação ProxMenux",
|
||||
"description": "Opções de rede do script de pós-instalação personalizável ProxMenux: forçar APT por IPv4, aplicar um perfil sysctl selecionado, instalar Open vSwitch, ativar TCP BBR + Fast Open e associar os nomes das interfaces aos seus endereços MAC."
|
||||
},
|
||||
"header": {
|
||||
"title": "Pós-instalação: Rede",
|
||||
"section": "Configurações pós-instalação do Proxmox"
|
||||
},
|
||||
"intro": {
|
||||
"title": "O que esta categoria abrange",
|
||||
"body": "Cinco opções de rede independentes. Duas são simples (<strong>APT por IPv4</strong>, <strong>instalação do Open vSwitch</strong>), duas ajustam o comportamento TCP (<strong>perfil sysctl de rede</strong>, <strong>BBR + Fast Open</strong>) e uma resolve um problema comum: <strong>fixar os nomes das interfaces</strong> para que uma nova placa de rede ou atualização do BIOS não mude <code>enp3s0</code> para <code>enp4s0</code> e interrompa as pontes."
|
||||
},
|
||||
"ipv4": {
|
||||
"heading": "Forçar o APT a usar IPv4",
|
||||
"intro": "Escreve <code>Acquire::ForceIPv4 \"true\";</code> para <code>/etc/apt/apt.conf.d/99-force-ipv4</code>. APT então se recusa a usar IPv6 para downloads de pacotes, mesmo que o host tenha conectividade IPv6.",
|
||||
"tipTitle": "Quem beneficia",
|
||||
"tipBody": "Útil se a ligação IPv6 for instável, mais lenta que IPv4 ou se o espelho Debian/Proxmox falhar ocasionalmente por IPv6. Não causa problemas em hosts sem IPv6. Numa rede de pilha dupla funcional, torna o comportamento previsível: apt não o surpreende com um tempo limite de IPv6."
|
||||
},
|
||||
"sysctl": {
|
||||
"heading": "Aplicar otimizações de rede",
|
||||
"intro": "Escreve um perfil sysctl selecionado em <code>/etc/sysctl.d/99-network.conf</code>: buffers de sockets do kernel, reforço do ICMP, proteção básica contra falsificação de endereços e tamanhos de buffers TCP adequados a um hipervisor com muitos fluxos simultâneos.",
|
||||
"tunedTitle": "O que é ajustado",
|
||||
"headerArea": "Área",
|
||||
"headerSettings": "Principais definições",
|
||||
"rows": [
|
||||
{
|
||||
"area": "Buffers de sockets do kernel",
|
||||
"settings": "<code>netdev_max_backlog=8192</code>, <code>rmem_max=16M</code>, <code>wmem_max=16M</code>, <code>somaxconn=8192</code>"
|
||||
},
|
||||
{
|
||||
"area": "Endurecimento do ICMP",
|
||||
"settings": "<code>icmp_echo_ignore_broadcasts=1</code>, <code>icmp_ignore_bogus_error_responses=1</code>"
|
||||
},
|
||||
{
|
||||
"area": "Segurança de roteamento",
|
||||
"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 de caminho inverso",
|
||||
"settings": "<code>rp_filter=2</code> (modo solto, ver nota abaixo)"
|
||||
},
|
||||
{
|
||||
"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": "Portas",
|
||||
"settings": "<code>ip_local_port_range=1024 65535</code> (conjunto de portas efémeras)"
|
||||
},
|
||||
{
|
||||
"area": "Soquetes Unix",
|
||||
"settings": "<code>net.unix.max_dgram_qlen=4096</code>"
|
||||
}
|
||||
],
|
||||
"sourceOutro": "Ele também adiciona <code>source /etc/network/interfaces.d/*</code> ao <code>/etc/network/interfaces</code> se ainda não estiver presente — prática padrão para que você possa soltar trechos de interface modular sem editar o arquivo principal.",
|
||||
"fwbrTitle": "Ajuste automático de pontes de firewall virtuais",
|
||||
"fwbrBody": "Além do perfil sysctl, o ProxMenux instala o script auxiliar <code>/usr/local/sbin/proxmenux-fwbr-tune</code>, que aplica <code>rp_filter=0</code> e <code>log_martians=0</code> às interfaces <code>fwbr*</code> / <code>fwln*</code> / <code>fwpr*</code> / <code>tap*</code> criadas pelo Proxmox para VMs e contentores. A unidade de execução única <code>proxmenux-fwbr-tune.service</code> chama-o no arranque, e a regra <code>/etc/udev/rules.d/99-zz-proxmenux-fwbr-tune.rules</code> a cada evento <code>net add</code> com esses prefixos. Abrange assim interfaces recriadas ao iniciar/parar VMs, reiniciar e migrar em funcionamento. O script também processa as interfaces já presentes imediatamente após a instalação.",
|
||||
"rpFilterTitle": "Porquê rp_filter=2 (permissivo) em vez de 1 (estrito)",
|
||||
"rpFilterBody": "A filtragem estrita do caminho inverso descarta pacotes cuja origem seria alcançada por uma interface <em>diferente</em>. É uma predefinição adequada a clientes, mas problemática num host Proxmox onde o tráfego das VMs chega frequentemente por uma ponte e sai por um uplink com rotas assimétricas. <code>rp_filter=2</code> (permissivo) só descarta pacotes com origens realmente inalcançáveis pelo encaminhamento. É um compromisso: reduz ligeiramente a deteção de falsificação de IP local para preservar a rede das VMs."
|
||||
},
|
||||
"ovs": {
|
||||
"heading": "Instalar Open vSwitch",
|
||||
"intro": "Instala <code>openvswitch-switch</code> + <code>openvswitch-common</code>. Os pacotes acrescentam OVS como alternativa às pontes Linux predefinidas do Proxmox. A instalação por si só não altera a rede: as pontes <code>vmbrX</code> existentes continuam a funcionar. Ao <em>criar</em> uma nova ponte na interface Proxmox, pode escolher OVS na lista de tipos.",
|
||||
"tipTitle": "Quando a OVS faz sentido",
|
||||
"tipBody": "Considere OVS se precisar de <strong>trunks VLAN com IDs não contíguos</strong>, <strong>LACP com LLDP em modos específicos</strong>, <strong>programação detalhada de fluxos</strong> (OpenFlow) ou interoperabilidade com controladores SDN. Num laboratório doméstico com poucas VLANs e um único uplink LACP, pontes Linux + <code>vmbrX.VID</code> são mais simples e adequadas.",
|
||||
"revertTitle": "Reversível do menu Desinstalar",
|
||||
"revertBody": "OVS fica registado. <link>Desinstalar otimizações</link> executa <code>apt purge</code> em <code>openvswitch-switch</code> e <code>openvswitch-common</code>. Migre as pontes OVS para pontes Linux <em>antes</em> de desinstalar; caso contrário, as VMs nessas pontes perderão a rede no próximo arranque. Equivalente manual:"
|
||||
},
|
||||
"bbr": {
|
||||
"heading": "Ativar TCP BBR + TCP Fast Open",
|
||||
"intro": "Escreve dois ficheiros sysctl e recarrega-os. BBR substitui CUBIC pelo algoritmo de congestionamento da Google baseado em largura de banda, que lida melhor com ligações de alta capacidade e latência ou com perdas. TCP Fast Open (TFO) elimina uma ida e volta nas ligações TCP repetidas enviando dados no SYN.",
|
||||
"verifyTitle": "Verificação",
|
||||
"impactTitle": "O impacto depende da carga de trabalho",
|
||||
"impactBody": "BBR destaca-se em ligações de alta latência ou com perdas (replicação intercontinental, túneis VPN, clientes móveis). Numa LAN entre duas máquinas no mesmo switch, a diferença costuma ficar nas variações de medição. TFO ajuda sobretudo em ligações HTTP curtas e repetidas.",
|
||||
"revertTitle": "Reversível do menu Desinstalar",
|
||||
"revertBody": "BBR/TFO ficam registados. <link>Desinstalar otimizações</link> remove os dois ficheiros sysctl (<code>/etc/sysctl.d/99-kernel-bbr.conf</code> e <code>99-tcp-fastopen.conf</code>) e recarrega a configuração restante. Eliminar um ficheiro não repõe os valores ativos do kernel. As predefinições como <code>cubic</code> e <code>tcp_fastopen=1</code> regressam após reiniciar, salvo se outra configuração as substituir. Equivalente manual:"
|
||||
},
|
||||
"names": {
|
||||
"heading": "Nomes de interfaces persistentes",
|
||||
"intro": "Percorre as placas de rede físicas do host, excluindo loopback, veths Docker, pontes, dispositivos TAP, bonds, Cilium, ZeroTier e WireGuard. Escreve um ficheiro systemd <code>.link</code> que associa o nome atual ao endereço MAC atual. A associação MAC passa a prevalecer sobre a lógica de nomes do kernel.",
|
||||
"whyTitle": "Por que isso importa?",
|
||||
"whyItems": [
|
||||
"Adicionar ou remover dispositivos PCIe pode mudar a numeração do barramento, transformando <code>enp3s0</code> em <code>enp4s0</code>. Se <code>/etc/network/interfaces</code> mencionar o nome antigo, a ponte desaparece ao reiniciar.",
|
||||
"As atualizações de BIOS / firmware às vezes alteram como os dispositivos enumeram, com o mesmo efeito.",
|
||||
"O script escreve ficheiros <code>.link</code> para as placas físicas, incluindo as portas dos bonds, com o MAC indicado pelo sysfs nesse momento; nas portas de um bond pode ser o MAC partilhado do bond, por isso verifique os nomes após reiniciar. Ignora interfaces virtuais, como veths LXC e os próprios dispositivos bond; não corrige condições de corrida nos nomes de placas virtuais <code>hotplug</code>."
|
||||
],
|
||||
"writtenTitle": "O que é escrito",
|
||||
"writtenIntro": "Um ficheiro por NIC físico, em <code>/etc/systemd/network/10-proxmenux-<iface>.link</code>. Cada arquivo começa com o cabeçalho <code># Managed by ProxMenux — do not edit</code> para que ProxMenux possa distinguir seus próprios arquivos de arquivos <code>.link</code> fornecidos pelo usuário ou pacote.",
|
||||
"writtenOutro": "Os ficheiros <code>.link</code> de outros pacotes ou escritos pelo utilizador são preservados; só os que têm o cabeçalho ProxMenux são geridos. Em cada nova execução, a função verifica os seus ficheiros: relê <code>MACAddress=</code> de cada <code>10-proxmenux-*.link</code> e remove os que têm uma MAC ausente de <code>/sys/class/net/</code>. Os ficheiros de versões anteriores no formato <code>10-<iface>.link</code> são migrados automaticamente na primeira execução.",
|
||||
"pveTitle": "PVE 9 vs PVE 8",
|
||||
"pveBody": "O script usa ficheiros systemd <code>.link</code> para os nomes persistentes. No Proxmox VE 9 também recarrega as regras udev após os escrever, para que uma placa já fixada que volte a ser ligada ou detetada aplique a sua regra sem reiniciar. Verifique as interfaces existentes após reiniciar tanto no PVE 8 como no PVE 9. Isto não substitui <code>ifupdown2</code> no host. Em ambos os casos, o script assinala a necessidade de reinício na pós-instalação personalizável.",
|
||||
"reviewTitle": "Reveja primeiro o /etc/network/interfaces existente",
|
||||
"reviewBody": "Se a configuração antiga em <code>/etc/network/interfaces</code> usa nomes de placas gerados pelo kernel, fixar os nomes <em>atuais</em> é o resultado pretendido. Se já adaptou manualmente a configuração a nomes específicos, confirme antes de reiniciar que os nomes fixados correspondem ao ficheiro interfaces.",
|
||||
"revertTitle": "Reversível do menu Desinstalar",
|
||||
"revertBody": "<link>Desinstalar otimizações</link> elimina apenas os ficheiros <code>10-proxmenux-*.link</code> com cabeçalho ProxMenux de <code>/etc/systemd/network/</code>. Preserva todos os ficheiros <code>.link</code> do utilizador ou de outros pacotes. No próximo reinício regressa o comportamento de nomes predefinido do systemd."
|
||||
},
|
||||
"related": {
|
||||
"heading": "Relacionado",
|
||||
"items": [
|
||||
{
|
||||
"label": "Gerenciamento de rede",
|
||||
"href": "/docs/network",
|
||||
"tail": " — diagnóstico, análise da ponte, reparação guiada."
|
||||
},
|
||||
{
|
||||
"label": "Nomes de interface persistentes",
|
||||
"href": "/docs/network/persistent-names",
|
||||
"tail": " — a mesma função num menu próprio para mais tarde; use uma das opções, não ambas."
|
||||
},
|
||||
{
|
||||
"label": "Referência de comandos de rede",
|
||||
"href": "/docs/help-info/network-commands",
|
||||
"tail": " — ip, ss, ethtool, sysctl."
|
||||
},
|
||||
{
|
||||
"label": "Desinstalar otimizações",
|
||||
"href": "/docs/post-install/uninstall",
|
||||
"tail": " — reverte qualquer uma destas alterações de rede."
|
||||
},
|
||||
{
|
||||
"label": "Pós-instalação personalizável",
|
||||
"href": "/docs/post-install/customizable",
|
||||
"tail": " — voltar ao menu superior."
|
||||
}
|
||||
]
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,177 @@
|
||||
{
|
||||
"meta": {
|
||||
"title": "Pós-instalação ProxMenux: Configurações opcionais",
|
||||
"description": "Guia de configurações opcionais no script pós-instalação ProxMenux para recursos e otimizações adicionais Proxmox VE.",
|
||||
"ogTitle": "Pós-instalação ProxMenux: Configurações opcionais",
|
||||
"ogDescription": "Guia de configurações opcionais no script pós-instalação ProxMenux para recursos e otimizações adicionais Proxmox VE.",
|
||||
"ogImageAlt": "Configurações opcionais da pós-instalação ProxMenux"
|
||||
},
|
||||
"title": "Configurações Opcionais",
|
||||
"intro": "A categoria <strong>Configurações opcionais</strong> oferece funções e otimizações adicionais para Proxmox VE. Não são essenciais, mas podem melhorar as capacidades do sistema em situações específicas.",
|
||||
"available": "Funções opcionais disponíveis",
|
||||
"stepLabel": "Etapa",
|
||||
"ceph": {
|
||||
"title": "Adicionar suporte mais recente ao Ceph",
|
||||
"intro": "Esta opção instala o mais recente suporte ao sistema de armazenamento Ceph para Proxmox VE. O Ceph é um sistema de armazenamento distribuído que oferece alto desempenho, confiabilidade e escalabilidade.",
|
||||
"doesIntro": "O que faz:",
|
||||
"doesItems": [
|
||||
"Adiciona o repositório Ceph ao seu sistema",
|
||||
"Atualiza as listas de pacotes",
|
||||
"Instala pacotes Ceph usando o comando 'pveceph install'",
|
||||
"Verifica a instalação"
|
||||
],
|
||||
"howUse": "Como usar: Após a instalação, você pode configurar e gerenciar o armazenamento Ceph usando a interface web Proxmox VE ou ferramentas de linha de comando.",
|
||||
"automates": "Este ajuste automatiza os seguintes comandos:"
|
||||
},
|
||||
"amd": {
|
||||
"title": "Aplicar correções AMD CPU",
|
||||
"intro": "Esta opção aplica correções específicas para CPUs AMD EPYC e Ryzen para melhorar a estabilidade e compatibilidade.",
|
||||
"doesIntro": "O que faz:",
|
||||
"doesItems": [
|
||||
"Detecta se está presente um AMD EPYC ou Ryzen CPU",
|
||||
"Aplica o parâmetro 'idle=nomwait' para evitar falhas aleatórias (via /etc/kernel/cmdline em máquinas systemd-boot, ou /etc/default/grub em máquinas GRUB — com um .bak do original)",
|
||||
"Configura o KVM para ignorar certos MSRs (registos específicos do modelo) e melhorar a compatibilidade com máquinas virtuais Windows."
|
||||
],
|
||||
"howUse": "Como usar: Estas correções são aplicadas automaticamente e requerem uma reinicialização do sistema para fazer efeito.",
|
||||
"automates": "Este ajuste automatiza os seguintes comandos:"
|
||||
},
|
||||
"ha": {
|
||||
"title": "Habilitar serviços de alta disponibilidade",
|
||||
"intro": "Esta opção permite serviços de Alta Disponibilidade (HA) em Proxmox VE, permitindo failover automático de VMs e contêineres em caso de falha de nó.",
|
||||
"doesIntro": "O que faz:",
|
||||
"doesItems": [
|
||||
"Activa e inicia o serviço pve-ha-lrm (Local Resource Manager)",
|
||||
"Activa e inicia o serviço pve-ha-crm (Cluster Resource Manager)",
|
||||
"Activa e inicia o serviço corosync para comunicação de clusters"
|
||||
],
|
||||
"howUse": "Como usar: Depois de ativar esses serviços, você pode configurar grupos e recursos HA na interface web Proxmox VE.",
|
||||
"automates": "Este ajuste automatiza os seguintes comandos:"
|
||||
},
|
||||
"pveam": {
|
||||
"title": "Atualizar Proxmox VE Appliance Manager",
|
||||
"intro": "Atualiza o índice local dos modelos de contentores apresentado pelo <code>pveam</code> no Proxmox, para que a lista de modelos de software esteja atualizada ao criar o próximo LXC.",
|
||||
"doesIntro": "O que faz:",
|
||||
"doesItems": [
|
||||
"Executa <code>pveam update</code> nos espelhos Proxmox para obter o catálogo atual de modelos de software",
|
||||
"Preenche a lista de modelos de software apresentada ao criar um contentor"
|
||||
],
|
||||
"howUse": "Utilização: execute se a lista de modelos na interface parecer desatualizada ou após mudar de espelho. Transfere apenas o índice do catálogo, não os próprios modelos.",
|
||||
"automates": "Este ajuste automatiza o seguinte comando:"
|
||||
},
|
||||
"fastfetch": {
|
||||
"title": "Instalar e Configurar o Fastfetch",
|
||||
"intro": "Esta opção instala silenciosamente e configura Fastfetch, uma ferramenta de informação do sistema que exibe especificações do sistema e um logotipo personalizado no login.",
|
||||
"doesLabel": "O que faz:",
|
||||
"doesItems": [
|
||||
"Silenciosamente baixa e instala a versão mais recente do Fastfetch",
|
||||
"Permite-lhe escolher um logotipo personalizado (<strong>ProxMenux, Proxmox, Helper-Scripts, Home-Labs-Club, Proxmology</strong>, ou um personalizado)",
|
||||
"Configura Fastfetch para exibir <em>\"Sistema otimizado por ProxMenux\"</em>",
|
||||
"Configura o Fastfetch para executar automaticamente no login do console"
|
||||
],
|
||||
"importantLabel": "Importante:",
|
||||
"importantBody": "Se você se conectar ao Proxmox via SSH, você deve selecionar o logotipo <strong>Proxmox</strong> ou criar um personalizado usando <code>jp2a</code> ou <code>img2txt</code>. Os outros logotipos são gerados usando <code>chafa</code> e podem não exibir corretamente em uma sessão padrão SSH.",
|
||||
"customLabel": "Logótipos personalizados:",
|
||||
"customBody1": "Para usar um logotipo personalizado, coloque seu arquivo de texto de arte ASCII em: <code>/usr/local/share/fastfetch/logos/</code>",
|
||||
"customBody2": "Você pode criar logotipos personalizados usando ferramentas como <code>chafa</code>, <code>jp2a</code>, ou <code>img2txt</code>.",
|
||||
"customBody3": "Para melhores resultados:",
|
||||
"customItems": [
|
||||
"Limite a altura do logótipo a 35 linhas para manter as proporções e caber no terminal",
|
||||
"Use <code>chafa</code> para logotipos de cores (pode não exibir corretamente em sessões de SSH)",
|
||||
"Use <code>jp2a</code> ou <code>img2txt</code> para logotipos compatíveis com SSH"
|
||||
],
|
||||
"examplesLabel": "Logotipos de Exemplo:",
|
||||
"logos": [
|
||||
{
|
||||
"name": "ProxMenux",
|
||||
"alt": "Logótipo do ProxMenux",
|
||||
"src": "https://macrimi.github.io/ProxMenux/fastfetch/proxmenux.png"
|
||||
},
|
||||
{
|
||||
"name": "Proxmox",
|
||||
"alt": "Logótipo do Proxmox",
|
||||
"src": "https://macrimi.github.io/ProxMenux/fastfetch/proxmox.png"
|
||||
},
|
||||
{
|
||||
"name": "JC Channel",
|
||||
"alt": "Logótipo do JC Channel",
|
||||
"src": "/fastfetch/jc-channel.png"
|
||||
},
|
||||
{
|
||||
"name": "Helper-Scripts",
|
||||
"alt": "Logótipo do Helper-Scripts",
|
||||
"src": "https://macrimi.github.io/ProxMenux/fastfetch/helper-scripts.png"
|
||||
},
|
||||
{
|
||||
"name": "Home-Labs-Club",
|
||||
"alt": "Logótipo do Home-Labs-Club",
|
||||
"src": "https://macrimi.github.io/ProxMenux/fastfetch/home-labs-club.png"
|
||||
},
|
||||
{
|
||||
"name": "Proxmology",
|
||||
"alt": "Logótipo Proxmology",
|
||||
"src": "https://macrimi.github.io/ProxMenux/fastfetch/proxmology.png"
|
||||
}
|
||||
],
|
||||
"automates": "Este ajuste automatiza os seguintes comandos:"
|
||||
},
|
||||
"figurine": {
|
||||
"title": "Instalar e Configurar Figurine",
|
||||
"intro": "Esta opção instala e configura o Figurine, uma ferramenta que cria banners de texto elegantes ASCII para o seu terminal, exibindo o seu nome de máquina em um formato 3D visualmente atraente.",
|
||||
"doesLabel": "O que faz:",
|
||||
"doesItems": [
|
||||
"Descarrega e instala o Figurine v2.1.1 a partir do GitHub para a arquitetura do host (AMD64, ARM64 ou ARMv7)",
|
||||
"Cria uma mensagem de boas- vindas que mostra o seu nome de máquina na arte ASCII 3D quando você entra",
|
||||
"Atualiza o binário existente do Figurine após concluir a transferência e a extração com sucesso",
|
||||
"Configura a mensagem de boas- vindas a executar automaticamente na autenticação"
|
||||
],
|
||||
"practicalLabel": "Uso prático:",
|
||||
"practicalBody": "Ao gerenciar vários nós Proxmox em um cluster, o Figurine fornece uma indicação visual imediata de qual nó você está conectado atualmente. Isso ajuda a prevenir comandos acidentais no nó errado e melhora seu fluxo de trabalho ao gerenciar vários servidores.",
|
||||
"exampleLabel": "Resultado do Exemplo:",
|
||||
"imageAlt": "Saída de Exemplo Figurine",
|
||||
"automates": "Este ajuste automatiza o seguinte processo:",
|
||||
"outro": "Após a instalação, você verá seu hostname exibido na arte ASCII 3D cada vez que você entrar, deixando imediatamente claro em que nó Proxmox você está trabalhando."
|
||||
},
|
||||
"log2ram": {
|
||||
"title": "Instalar Log2RAM (redução do desgaste de SSD/NVMe)",
|
||||
"intro": "Log2RAM monta <code>/var/log</code> num ramdisk tmpfs e sincroniza-o periodicamente para disco. Guardar temporariamente na RAM as escritas frequentes do journald pode reduzir desgaste SSD e E/S. A sincronização e o encerramento normal guardam os registos; um corte abrupto pode perder entradas desde a última sincronização.",
|
||||
"upstreamLabel": "Projeto a montante:",
|
||||
"upstreamUrl": "https://github.com/azlux/log2ram",
|
||||
"upstreamLinkLabel": "azlux/log2ram em GitHub",
|
||||
"doesLabel": "O que o ProxMenux faz:",
|
||||
"doesItems": [
|
||||
"Detecta se o disco raiz é SSD/NVMe lendo <code>/sys/block/<dev>/queue/rotational</code>. Em um disco rotacional o fluxo automatizado pede primeiro antes de instalar.",
|
||||
"Clona o repositório original (<code>azlux/log2ram</code>) para <code>/tmp/log2ram</code> e modifica <code>install.sh</code>, substituindo <code>rsync -aAXv</code> por <code>rsync -aXv --no-acls</code>. Evita o erro <em>set_acl: Operation not supported</em> com código de saída 23, gerado pelo script original ao mover /var/log em sistemas sem ACL. A unidade systemd <code>log2ram</code> é ativada após instalação.",
|
||||
"Dimensiona o ramdisk pela RAM do host: <code>≤ 8 GB → 128M</code>, <code>≤ 16 GB → 256M</code>, <code>> 16 GB → 512M</code>. Escreve o valor em <code>SIZE=</code> de <code>/etc/log2ram.conf</code>.",
|
||||
"Agenda uma sincronização periódica do disco via <code>/etc/cron.d/log2ram</code>: a cada 1h / 3h / 6h de acordo com o mesmo nível RAM.",
|
||||
"Instala <code>/usr/local/bin/log2ram-check.sh</code>, executado a cada 10 minutos por <code>/etc/cron.d/log2ram-auto-sync</code>. Quando <code>/var/log</code> chega a 80% do ramdisk, limpa journals antigos. Aos 92%, executa primeiro <code>logrotate -f /etc/logrotate.d/proxmox-backup-api</code> se o ficheiro existir: os registos API PBS costumam ocupar mais espaço num host PBS. Depois trunca <code>pveproxy access/error</code> e <code>pveam.log</code> antes de sincronizar. <code>log2ram write</code> apenas copia tmpfs para disco, sem o reduzir. A proteção ajuda a evitar falhas PVE com <em>No space left on device</em> por crescimento descontrolado dos registos.",
|
||||
"Deteta o serviço <code>proxmox-backup-server</code> no host. Se existir, cria <code>/etc/logrotate.d/proxmox-backup-api</code> (20 MB × 3 rotações) e <code>/etc/cron.hourly/proxmox-backup-logrotate</code> para limitar os registos API PBS, fonte habitual de crescimento, mesmo entre sincronizações Log2RAM. Sem PBS não altera nada.",
|
||||
"Ajusta os limites systemd-journald (<code>SystemMaxUse</code>, <code>RuntimeMaxUse</code>) ao ramdisk para que uma rajada de registos não o encha.",
|
||||
"Fica registado em <code>installed_tools.json</code> para poder ser revertido em Desinstalar otimizações."
|
||||
],
|
||||
"howUseLabel": "Como utilizar:",
|
||||
"howUseBody": "O percurso automatizado instala Log2RAM sem intervenção se detetar disco raiz SSD/NVMe. O personalizável pergunta tamanho, intervalo e ativação da proteção. A pergunta indica 90%, mas o script gerado usa os limiares de limpeza de 80% e intensiva de 92% descritos acima.",
|
||||
"verifyLabel": "Verificar e gerenciar a partir da 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": "Habilitar perfil de troca ZRAM",
|
||||
"intro": "Cria um dispositivo swap comprimido em RAM, <code>/dev/zram0</code>, com <code>systemd-zram-generator</code>. As páginas movidas pelo kernel para swap são comprimidas com zstd e mantidas em memória antes de usar swap em disco.",
|
||||
"doesLabel": "O que faz:",
|
||||
"doesItems": [
|
||||
"Instala <code>systemd-zram-generator</code> se estiver faltando, e registra se ProxMenux o instalou.",
|
||||
"Escreve <code>/etc/systemd/zram-generator.conf.d/90-proxmenux.conf</code>: um dispositivo <code>zram0</code> de um décimo da RAM do host, compressão zstd (<code>zstd(level=9)</code> com systemd-zram-generator 1.2.0 ou posterior) e prioridade swap 32767.",
|
||||
"Com essa prioridade, o kernel preenche primeiro o ZRAM. Uma troca existente no disco mantém sua própria prioridade e leva as páginas que já não se encaixam no ZRAM.",
|
||||
"Antes de mudar qualquer coisa, procura outra configuração ZRAM: uma troca zram ativa, uma linha zram em <code>/etc/fstab</code>, uma unidade systemd ou outro arquivo gerador. Se encontrar uma, a opção pára e deixa essa configuração como está.",
|
||||
"Inicia o <code>dev-zram0.swap</code> e verifica se o dispositivo ativo corresponde ao perfil. Caso contrário, o estado anterior é restaurado.",
|
||||
"Fica registado em <code>installed_tools.json</code> para poder ser revertido em Desinstalar otimizações."
|
||||
],
|
||||
"howUseLabel": "Como utilizar:",
|
||||
"howUseBody": "A opção só existe no percurso personalizável, não no automatizado. O dispositivo é recriado em cada arranque. Enquanto estiver ativo, o painel Memória do ProxMenux Monitor mostra capacidade, swap utilizado, algoritmo, relação de compressão e memória física ocupada.",
|
||||
"verifyLabel": "Verificar a partir do 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": "Aplicação automática",
|
||||
"body": "No percurso personalizável, selecione as funções conforme as necessidades. Log2RAM também integra o automatizado com deteção de hardware; ZRAM é exclusivo do personalizável. Consulte cada secção para confirmações e requisitos."
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,61 @@
|
||||
{
|
||||
"meta": {
|
||||
"title": "Pós-instalação: Desempenho | Documentação ProxMenux",
|
||||
"description": "Opções de desempenho no script pós-instalação personalizável do ProxMenux. Substitui o gzip de uma só thread pelo pigz (gzip paralelo) para acelerar cópias de segurança e compressão em hosts com vários núcleos."
|
||||
},
|
||||
"header": {
|
||||
"title": "Após a instalação: desempenho",
|
||||
"description": "Opções de desempenho do script pós-instalação Personalizável. Esta categoria contém uma só otimização: substituir gzip por pigz para que as cópias de segurança e a compressão usem todos os núcleos da CPU em vez de um.",
|
||||
"section": "Configurações pós-instalação do Proxmox"
|
||||
},
|
||||
"intro": {
|
||||
"title": "O que esta categoria abrange",
|
||||
"body": "A única opção de desempenho aqui redireciona o gzip para uma implementação paralela. Os outros ajustes de desempenho (memória, escalonamento de E/S, tamanho do ARC ZFS, limites do kernel) ficam nas respetivas categorias (<em>Sistema</em>, <em>Armazenamento</em>), pois afetam subsistemas diferentes."
|
||||
},
|
||||
"pigz": {
|
||||
"heading": "Use pigz para compactação gzip mais rápida",
|
||||
"intro": "O <code>gzip</code> normal comprime usando <strong>um só núcleo da CPU</strong>. Nos hosts Proxmox modernos com 8, 16 ou 32 núcleos, isto limita muito as cópias VM/CT com <code>vzdump</code>, a rotação de registos e tudo o que passa pelo <code>gzip</code>. O <a>pigz</a> é um substituto paralelo diretamente compatível: produz o mesmo formato gzip, mas distribui o trabalho por todos os núcleos.",
|
||||
"doesTitle": "O que o ProxMenux faz",
|
||||
"doesIntro": "Cinco passos, todos idempotentes:",
|
||||
"doesItems": [
|
||||
"Define <code>pigz: 1</code> em <code>/etc/vzdump.conf</code> para que a ferramenta de backup do Proxmox use pigz nativamente.",
|
||||
"Instala o pacote apt <code>pigz</code> se ainda não estiver presente.",
|
||||
"Cria um script wrapper em <code>/bin/pigzwrapper</code> que encaminha todos os argumentos para <code>/usr/bin/pigz</code>.",
|
||||
"Registra um desvio de dpkg para o binário <code>gzip</code> do sistema (<code>/usr/bin/gzip</code> em Proxmox VE 9, <code>/bin/gzip</code> em Proxmox VE 8): o binário real é mantido ao lado dele como <code>gzip.distrib</code> e o invólucro toma o seu lugar. A partir de agora, <em> qualquer coisa</em> que chama <code>gzip</code> — logrotate, <code>tar czf</code>, scripts, vzdump — usa pigz de forma transparente.",
|
||||
"Verifica que o arquivo mantido como <code>gzip.distrib</code> é um gzip funcional antes da embalagem ser colocada no lugar, e reinstala o pacote <code>gzip</code> primeiro quando não estiver. Uma máquina que ainda tenha o swap <code>/bin/gzip.original</code> anterior é movida para o desvio quando a opção é aplicada novamente."
|
||||
],
|
||||
"replacesTitle": "Substitui um binário do sistema",
|
||||
"replacesBody": "Colocar um wrapper no lugar do <code>gzip</code> é invulgar. É seguro porque produz saída compatível com gzip, mas scripts com caminhos fixos, executados em chroots restritivos ou que verificam hashes dos binários podem comportar-se de forma diferente. O binário original fica em <code>gzip.distrib</code>. Graças ao desvio dpkg, uma atualização do pacote <code>gzip</code> ou a passagem do Proxmox VE 8 para 9 atualiza esse ficheiro e mantém o wrapper.",
|
||||
"revertTitle": "Reversível do menu Desinstalar",
|
||||
"revertBody": "Esta otimização é registada. <link>Desinstalar otimizações</link> copia o binário original de <code>gzip.distrib</code> para o lugar do wrapper, remove o desvio e <code>pigzwrapper</code>, comenta a linha <code>pigz</code> em <code>/etc/vzdump.conf</code> e executa <code>apt purge pigz</code> após confirmar que o gzip funciona. Equivalente manual no Proxmox VE 9:",
|
||||
"verifyTitle": "Verificação",
|
||||
"verifyBody": "Após a aplicação, <code>gzip --version</code> deve mencionar pigz. Um benchmark rápido também mostra a diferença de velocidade em um host multi-core:",
|
||||
"whenTitle": "Quando isto é mais importante",
|
||||
"whenBody": "O benefício aumenta com o <strong>número de núcleos do host</strong> e a <strong>frequência das cópias de segurança</strong>. Num servidor doméstico de 2 núcleos com um vzdump diário, o ganho é marginal. Num host de produção com 16 núcleos que guarda uma dúzia de VMs todas as noites, o pigz pode reduzir a janela de cópia a uma fração do tempo do gzip de uma thread."
|
||||
},
|
||||
"related": {
|
||||
"heading": "Relacionado",
|
||||
"items": [
|
||||
{
|
||||
"label": "Comandos de backup e restauração",
|
||||
"href": "/docs/help-info/backup-commands",
|
||||
"tailRich": " — vzdump CLI, incluindo a opção de threads <code>--pigz</code>."
|
||||
},
|
||||
{
|
||||
"label": "Armazenamento",
|
||||
"href": "/docs/post-install/storage",
|
||||
"tail": " — limites de velocidade vzdump e afinação ZFS ARC."
|
||||
},
|
||||
{
|
||||
"label": "Sistema",
|
||||
"href": "/docs/post-install/system",
|
||||
"tail": " — ajuste de descritores de ficheiros e memória."
|
||||
},
|
||||
{
|
||||
"label": "Pós-instalação personalizável",
|
||||
"href": "/docs/post-install/customizable",
|
||||
"tail": " — voltar ao menu superior."
|
||||
}
|
||||
]
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,57 @@
|
||||
{
|
||||
"meta": {
|
||||
"title": "Pós-instalação: Segurança | Documentação ProxMenux",
|
||||
"description": "Opções de segurança disponíveis no script pós-instalação personalizável ProxMenux. Atualmente uma única opção: desabilitar o serviço portmapper/rpcbind para reduzir a superfície de ataque do host."
|
||||
},
|
||||
"header": {
|
||||
"title": "Pós-instalação: Segurança",
|
||||
"section": "Configurações pós-instalação do Proxmox"
|
||||
},
|
||||
"intro": {
|
||||
"title": "O que esta categoria abrange",
|
||||
"body": "A segurança pós-instalação limita-se ao <strong>reforço do host que pode ser aplicado em segurança sem supervisão</strong>: desativar serviços raramente necessários, com reversão pelo menu Desinstalar. As ferramentas ativas (Fail2Ban para prevenção de intrusões e Lynis para auditoria) ficam em <em>Segurança</em> no menu principal do ProxMenux, fora da pós-instalação."
|
||||
},
|
||||
"rpcbind": {
|
||||
"heading": "Desactivar o portmapper / rpcbind",
|
||||
"intro": "<code>rpcbind</code> (anteriormente <code>portmap</code>) é um serviço que mapeia números de programas RPC para portas de rede. É uma dependência para NFS e algumas ferramentas baseadas em RPC. Em um host típico do Proxmox que não está atuando como um servidor NFS, o <strong>nada o usa</strong> — e deixando-o habilitado mantém a porta <code>111/tcp</code> ouvindo em cada interface.",
|
||||
"whyTitle": "Porque vale a pena desactivar",
|
||||
"whyItems": [
|
||||
"Reduz a superfície do ataque do hospedeiro — um serviço de escuta a menos para se preocupar.",
|
||||
"Historicamente abusado como vetor de reflexão/amplificação em ataques de DDoS. Desativar o <code>rpcbind</code> remove esse fator de amplificação para o seu host.",
|
||||
"Remove o ruído que gera em logs e saída <code>netstat</code> / <code>ss</code>, tornando a atividade real mais fácil de detectar."
|
||||
],
|
||||
"nfsTitle": "Não desactivar isto se usar o NFS",
|
||||
"nfsBody": "O servidor NFS <strong>e</strong> o cliente NFS dependem do <code>rpcbind</code> para negociar as portas usadas por <code>mountd</code>, <code>statd</code>, <code>lockd</code>, etc. Se o host Proxmox <em>exportar</em> partilhas NFS para outras máquinas ou <em>montar</em> partilhas NFS de um NAS, não aplique esta opção. As montagens falharão com <code>mount.nfs: rpc.statd is not running</code> ou semelhante.",
|
||||
"runsTitle": "O que o ProxMenux executa",
|
||||
"runsOutro": "O pacote permanece instalado. O ProxMenux regista os estados originais de ativação e execução de rpcbind.service e rpcbind.socket, depois desativa e para ambas as unidades para impedir a reativação do serviço pelo socket.",
|
||||
"verifyTitle": "Verificação",
|
||||
"verifyBody": "Após a aplicação, confirme que o <code>rpcbind</code> está desligado e nada está ouvindo na porta 111:",
|
||||
"reversibleTitle": "Restaura o estado de serviço original",
|
||||
"reversibleBody": "A alteração é registada em <code>installed_tools.json</code>. <link>Desinstalar otimizações</link> repõe cada unidade rpcbind nos estados de ativação e execução registados antes da alteração pelo ProxMenux; não pressupõe que o rpcbind estivesse ativado em todos os hosts."
|
||||
},
|
||||
"related": {
|
||||
"heading": "Relacionado",
|
||||
"items": [
|
||||
{
|
||||
"label": "Menu de segurança",
|
||||
"href": "/docs/security",
|
||||
"tail": " — ferramentas mais completas: Fail2Ban (prevenção de intrusões) e Lynis (auditoria)."
|
||||
},
|
||||
{
|
||||
"label": "Lynis",
|
||||
"href": "/docs/security/lynis",
|
||||
"tail": "— audite o host para encontrar mais oportunidades de proteção."
|
||||
},
|
||||
{
|
||||
"label": "Comandos úteis do sistema",
|
||||
"href": "/docs/help-info/system-commands",
|
||||
"tail": " — estado dos serviços e referência para journalctl e lynis audit."
|
||||
},
|
||||
{
|
||||
"label": "Pós-instalação personalizável",
|
||||
"href": "/docs/post-install/customizable",
|
||||
"tail": " — voltar ao menu superior."
|
||||
}
|
||||
]
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,167 @@
|
||||
{
|
||||
"meta": {
|
||||
"title": "Pós-instalação: Armazenamento | Documentação ProxMenux",
|
||||
"description": "Otimizações de armazenamento do script pós-instalação personalizável ProxMenux: dimensão ZFS ARC pela RAM do host, instantâneos periódicos com zfs-auto-snapshot e remoção dos limites de velocidade dos backups vzdump."
|
||||
},
|
||||
"header": {
|
||||
"title": "Pós-instalação: Armazenamento",
|
||||
"section": "Configurações pós-instalação do Proxmox"
|
||||
},
|
||||
"intro": {
|
||||
"title": "O que esta categoria abrange",
|
||||
"body": "Quatro otimizações de armazenamento: ajustar <strong>ZFS ARC</strong> a uma fração adequada da RAM, instalar e agendar <strong>instantâneos ZFS automáticos</strong>, ativar <strong>ZFS autotrim</strong> em pools SSD/NVMe e retirar limitações de <strong>vzdump</strong> para acelerar backups. Escolha cada opção independente conforme o sistema. Uma quinta, <link>Log2RAM</link>, reduz desgaste SSD/NVMe movendo <code>/var/log</code> para ramdisk. Está em Opcionais porque o menu personalizável a agrupa aí."
|
||||
},
|
||||
"trackedTitle": "Todos os quatro são rastreados no menu Desinstalar",
|
||||
"trackedBody": "Cada uma dessas opções registra uma ferramenta em <code>installed_tools.json</code>, então eles aparecem em <link>Otimizações de Uninstall</link>. Reverter o <code>zfs_arc</code> remove o <code>/etc/modprobe.d/99-zfsarc.conf</code> e reconstrói o initramfs; o <code>zfs_auto_snapshot</code> reverte o cronograma do cron e oferece purgar o pacote; o <code>zfs_autotrim</code> configura o <code>autotrim=off</code> nos pools que ele ativou; o <code>vzdump_speed</code> restaura o <code>/etc/vzdump.conf</code> do <code>.bak</code> a instalação criada.",
|
||||
"arc": {
|
||||
"heading": "Otimizar o tamanho do ZFS ARC",
|
||||
"intro": "A <strong>Adaptive Replacement Cache (ARC)</strong> é a cache de leitura ZFS em RAM. Instalações Proxmox VE desde 8.1 limitam a 10% da RAM, máximo 16 GiB; hosts antigos ou atualizados podem diferir. Esta opção escreve explicitamente essa mesma regra (RAM/10, máximo de 16 GiB, mínimo de 64 MiB) num ficheiro próprio, o que cobre também hosts antigos ou atualizados. Verifique definições e carga: uma cache menor nem sempre é mais rápida.",
|
||||
"sizingTitle": "Regras de dimensionamento",
|
||||
"headerRam": "RAM do host",
|
||||
"headerMax": "Limite ARC",
|
||||
"rows": [
|
||||
{
|
||||
"ram": "Fórmula",
|
||||
"max": "RAM / 10, máximo 16 GiB e mínimo 64 MiB"
|
||||
},
|
||||
{
|
||||
"ram": "Máquina 8 GB",
|
||||
"max": "≈ 819 MiB (RAM/10)"
|
||||
},
|
||||
{
|
||||
"ram": "Máquina 16 GB",
|
||||
"max": "≈ 1.6 GiB (RAM/10)"
|
||||
},
|
||||
{
|
||||
"ram": "Máquina 64 GB",
|
||||
"max": "≈ 6.4 GiB (RAM/10)"
|
||||
},
|
||||
{
|
||||
"ram": "≥ Máquina 160 GB",
|
||||
"max": "16 GiB (limite)"
|
||||
}
|
||||
],
|
||||
"after": "O ficheiro <code>/etc/modprobe.d/99-zfsarc.conf</code> contém apenas <code>options zfs zfs_arc_max=…</code>. Os outros parâmetros ZFS (<code>zfs_arc_min</code>, pré-leitura/limite de escritas L2ARC, tempo limite TXG) não são ajustados. Antes, procura outros <code>*.conf</code> em <code>/etc/modprobe.d/</code> com <code>zfs_arc_min</code> / <code>zfs_arc_max</code>, copia-os com manifesto para <code>/usr/local/share/proxmenux/backups/zfs_arc/</code> e remove deles os valores <code>zfs_arc_min</code> / <code>zfs_arc_max</code> em conflito (as outras opções dessas linhas mantêm-se), para que só o ficheiro ARC ProxMenux defina o limite. Depois, <code>update-initramfs -u -k all</code> e, quando aplicável, <code>proxmox-boot-tool refresh</code> integram o limite no initramfs dos sistemas com raiz ZFS.",
|
||||
"rebootTitle": "Requer uma reinicialização para fazer efeito",
|
||||
"rebootBody": "As definições ARC são lidas ao carregar o módulo <code>zfs</code>. Para hosts com raiz ZFS, ProxMenux regenera initramfs com <code>update-initramfs -u -k all</code> e atualiza o carregador quando necessário com <code>proxmox-boot-tool refresh</code>. O novo parâmetro continua a exigir reinício, assinalado automaticamente.",
|
||||
"safeTitle": "Seguro em hosts não-ZFS",
|
||||
"safeBody": "A função só escreve a configuração quando <code>zpool list</code> relata pelo menos um pool de ZFS. No ext4 / LVM- only Proxmox hosts, ou em máquinas com as ferramentas ZFS instaladas, mas sem pool importado, assinalar esta opção é um no-op - nada é escrito.",
|
||||
"verifyTitle": "Verificação e retrocesso manual"
|
||||
},
|
||||
"autoSnap": {
|
||||
"heading": "Instale o instantâneo automático do ZFS",
|
||||
"intro": "Instala o pacote <a>zfs-auto-snapshot</a> e reescreve seus agendamentos cron para que instantâneos sejam tomados automaticamente em vários intervalos. Uma grande rede de segurança sem esforço em cima de seus backups regulares vzdump.",
|
||||
"cadenceTitle": "Frequência dos instantâneos configurada pelo ProxMenux",
|
||||
"headerLabel": "Rótulo",
|
||||
"headerRuns": "Execução",
|
||||
"headerKept": "Instantâneos retidos",
|
||||
"rows": [
|
||||
{
|
||||
"label": "frequentes",
|
||||
"runs": "cada 15 min",
|
||||
"kept": "4"
|
||||
},
|
||||
{
|
||||
"label": "horário",
|
||||
"runs": "a cada hora",
|
||||
"kept": "1"
|
||||
},
|
||||
{
|
||||
"label": "diariamente",
|
||||
"runs": "uma vez por dia",
|
||||
"kept": "1"
|
||||
},
|
||||
{
|
||||
"label": "semanalmente",
|
||||
"runs": "uma vez por semana",
|
||||
"kept": "1"
|
||||
},
|
||||
{
|
||||
"label": "mensal",
|
||||
"runs": "uma vez por mês",
|
||||
"kept": "1"
|
||||
}
|
||||
],
|
||||
"conservativeTitle": "Retenção limitada",
|
||||
"conservativeBody": "ProxMenux usa retenção limitada: 4 instantâneos frequentes e 1 por cada intervalo mais longo, para conter a ocupação ZFS. Para reter mais, altere os números em <code>/etc/cron.d/zfs-auto-snapshot</code>, <code>/etc/cron.hourly/zfs-auto-snapshot</code> etc. após o script.",
|
||||
"onlyZfsTitle": "Útil apenas em pools ZFS",
|
||||
"onlyZfsBody": "Instalar o pacote num host apenas ext4 é inofensivo mas inútil: não há datasets ZFS para criar instantâneos. Ignore a opção se não usa ZFS.",
|
||||
"verifyTitle": "Verificação e retrocesso manual"
|
||||
},
|
||||
"autotrim": {
|
||||
"heading": "Ativar ZFS autotrim (pools SSD/NVMe)",
|
||||
"intro": "Ativa <code>autotrim</code> em pools ZFS só com SSD ou NVMe compatíveis com TRIM. Por precaução, ignora pools com dispositivos rotacionais. Os pools já com <code>autotrim=on</code> ficam inalterados.",
|
||||
"trimTitle": "O que TRIM faz, e por que importa em ZFS",
|
||||
"trimBody1": "SSD e NVMe usam blocos internos de apagamento maiores que os setores lógicos do sistema de ficheiros. Quando um ficheiro é apagado, a unidade ainda não sabe que os setores estão livres e a limpeza interna pode continuar a mover dados obsoletos para libertar blocos. <strong>TRIM</strong> indica os setores livres para permitir o seu apagamento antecipado.",
|
||||
"trimBody2": "Sem TRIM, o desempenho do SSD degrada-se ao longo do tempo, pois a unidade fica sem blocos pré-apagados e tem que fazer apagar-em-escrever, e aumentar a amplificação de gravação — tanto encurtando a vida útil da unidade. Com TRIM ativado, a unidade pode manter um saudável pool de blocos vazios prontos para escrever.",
|
||||
"trimBody3": "Com <code>autotrim=on</code>, ZFS aplica TRIM em segundo plano ao espaço recém-libertado, agrupando intervalos. Um <code>zpool trim <pool></code> periódico é alternativa. Autotrim evita agendamento separado, mas o impacto depende dos dispositivos; TRIM manual periódico pode ser melhor em algumas unidades modestas.",
|
||||
"practicalTitle": "Por que isso é prático para habilitar?",
|
||||
"practicalItems": [
|
||||
"<strong>Desempenho de escrita sustentado.</strong> TRIM pode ajudar a recuperar blocos sem uso. Benefícios e impacto na latência dependem do dispositivo e da carga.",
|
||||
"<strong>Vida útil da unidade.</strong> Evitar cópias internas desnecessárias pode reduzir amplificação de escrita e desgaste NAND, sem garantir uma duração adicional específica.",
|
||||
"<strong>Sem tarefa cron para agendar.</strong> Ao contrário de um <code>zpool trim</code> periódico, autotrim é gerido automaticamente pelo pool."
|
||||
],
|
||||
"whenTitle": "Quando é que isto é necessário?",
|
||||
"whenIntro1": "<strong>Considere ativá-lo</strong> em pools ZFS só com SSD/NVMe compatíveis com TRIM. Verifique comportamento e latência; TRIM manual agendado pode ser preferível.",
|
||||
"whenIntro2": "<strong>O programa ignora- o automaticamente</strong> em:",
|
||||
"whenSkipItems": [
|
||||
"Pools com vdev HDD rotacional: filtro conservador de hardware deste script.",
|
||||
"Unidades sem <code>discard_granularity</code> expostas em sysfs — geralmente SSDs antigos sem TRIM, ou caminhos de passagem onde o SO não pode ver o dispositivo subjacente.",
|
||||
"Pools em que ZFS ela mesma relata a propriedade não suportada (raro; muito antigo pools).",
|
||||
"Pools já definidos para <code>autotrim=on</code> (no-op)."
|
||||
],
|
||||
"whenIntro3": "<strong>Não relevante em hosts somente ext4</strong> — não há nada para ZFS cortar. A função termina com uma mensagem amigável nesse caso.",
|
||||
"recordedTitle": "Por que apenas os pools ProxMenux alterados são registrados",
|
||||
"recordedBody": "A função só escreve um pool para o seu arquivo de estado interno (<code>/usr/local/share/proxmenux/zfs_autotrim_pools</code>) quando ele ativamente virou esse pool de <code>off</code> para <code>on</code>. Pools que você tinha no autotrim antes de executar o script são deixados de fora da lista, então um futuro Desinstalar não desliga as configurações que você mesmo configurou — apenas as próprias alterações do ProxMenux são revertidas.",
|
||||
"manualTitle": "Equivalente manual (executado no seu servidor)",
|
||||
"manualIntro": "A sequência completa que o script executa contra cada pool é replicável à mão. Isto é o que você digitaria se você quisesse fazer a mesma coisa em um único pool sem ProxMenux:",
|
||||
"verifyTitle": "Verificação e retrocesso manual",
|
||||
"oneShotTitle": "Prefere TRIM pontual em vez de contínuo?",
|
||||
"oneShotBody": "Alguns administradores preferem TRIM manual nas horas de menor carga. Desative autotrim e agende uma tarefa cron com <code>zpool trim <pool></code>: mesmo objetivo, frequência diferente."
|
||||
},
|
||||
"vzdump": {
|
||||
"heading": "Aumentar a velocidade de backup do vzdump",
|
||||
"intro": "Escreve bwlimit: 0 e ionice: 5 na configuração global vzdump. Proxmox já não limita a banda por predefinição: só remove um limite configurado. Face a ionice: 7, o valor 5 aumenta a prioridade E/S best-effort se o escalonador a respeitar. Pode afetar os convidados e não garante backups mais rápidos.",
|
||||
"changedTitle": "O que é alterado em /etc/vzdump.conf",
|
||||
"backupTitle": "Primeira execução cria um .bak de vzdump.conf",
|
||||
"backupBody": "Na primeira execução, ProxMenux copia <code>/etc/vzdump.conf</code> para <code>/etc/vzdump.conf.bak</code> antes de alterar. As seguintes preservam essa cópia para recuperar a configuração anterior. <code>bwlimit</code> e <code>ionice</code> são alterados com <code>sed</code>; outras opções como compress, pigz, tmpdir e exclude-path são preservadas.",
|
||||
"skipTitle": "Quando saltar isto",
|
||||
"skipBody": "Num host com armazenamento local lento e VMs sensíveis à latência, retirar o limite de banda pode causar lentidão durante backups. Se definiu <code>bwlimit</code> por esse motivo, mantenha-o e ignore a opção.",
|
||||
"verifyTitle": "Verificação e retrocesso manual"
|
||||
},
|
||||
"related": {
|
||||
"heading": "Relacionado",
|
||||
"items": [
|
||||
{
|
||||
"label": "Comandos de gerenciamento ZFS",
|
||||
"href": "/docs/help-info/zfs-commands",
|
||||
"tail": " — referência zpool / zfs para ARC, instantâneos e scrub."
|
||||
},
|
||||
{
|
||||
"label": "Comandos de armazenamento e discos",
|
||||
"href": "/docs/help-info/storage-commands",
|
||||
"tail": " — referência de dispositivos de blocos e armazenamento Proxmox."
|
||||
},
|
||||
{
|
||||
"label": "Comandos de backup e restauração",
|
||||
"href": "/docs/help-info/backup-commands",
|
||||
"tail": " — referência CLI vzdump para banda e prioridade E/S."
|
||||
},
|
||||
{
|
||||
"label": "Desinstalar otimizações",
|
||||
"href": "/docs/post-install/uninstall",
|
||||
"tail": " — reverter as alterações ARC / vzdump."
|
||||
},
|
||||
{
|
||||
"label": "Log2RAM",
|
||||
"href": "/docs/post-install/optional#log2ram",
|
||||
"tail": " — reduz o desgaste SSD/NVMe por /var/log ramdisk backing; documentado sob opcional."
|
||||
},
|
||||
{
|
||||
"label": "Pós-instalação personalizável",
|
||||
"href": "/docs/post-install/customizable",
|
||||
"tail": " — voltar ao menu superior."
|
||||
}
|
||||
]
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,133 @@
|
||||
{
|
||||
"meta": {
|
||||
"title": "Pós-instalação: Sistema | Documentação ProxMenux",
|
||||
"description": "Otimizações em nível de sistema no ProxMenux Script pós-instalação personalizável: journald e limites de tamanho de rotação de log, limites mais altos de kernel e descritor de arquivo, ajuste de memória balanceado, kexec para reinicializações rápidas e recuperação de kernel panic."
|
||||
},
|
||||
"header": {
|
||||
"title": "Após a instalação: sistema",
|
||||
"section": "Configurações pós-instalação do Proxmox"
|
||||
},
|
||||
"intro": {
|
||||
"title": "O que esta categoria abrange",
|
||||
"body": "Seis otimizações de sistema independentes. Ajustam <strong>journald</strong> e <strong>logrotate</strong> para os registos não encherem o disco, aumentam <strong>os limites do kernel e dos descritores de ficheiros</strong> para aplicações com muitos ficheiros abertos, <strong>equilibram a memória</strong> num host de virtualização, acrescentam <strong>kexec</strong> para reinícios sem BIOS e configuram <strong>a recuperação automática</strong> de kernel panic. As seis ficam registadas e são reversíveis no menu Desinstalar."
|
||||
},
|
||||
"journald": {
|
||||
"heading": "Otimizar journald",
|
||||
"intro": "Reescreve <code>/etc/systemd/journald.conf</code> com valores adequados para o journal systemd não encher gradualmente a partição raiz; depois reinicia <code>systemd-journald</code> e limpa registos antigos.",
|
||||
"keyTitle": "Valores-chave",
|
||||
"keyItems": [
|
||||
"<code>Storage=persistent</code> — manter registros no disco através de reinicialização.",
|
||||
"<code>SystemMaxUse=64M</code> / <code>RuntimeMaxUse=60M</code> — limites de utilização de disco e memória do journal.",
|
||||
"<code>Compress=yes</code>, <code>Seal=no</code> — comprime registos e desativa a selagem com segurança futura (poupa CPU).",
|
||||
"<code>MaxLevelStore=info</code> — guarda nível info e superiores, necessários ao visualizador de registos ProxMenux Monitor e à deteção de falhas de autenticação SSH/Proxmox pelo Fail2Ban no journal.",
|
||||
"Limite de frequência: <code>1000 events / 30 s</code> para evitar um excesso de registos.",
|
||||
"<code>ForwardToSyslog=no</code>, <code>ForwardToWall=no</code> — não duplicar mensagens para syslog ou transmitir para consoles."
|
||||
],
|
||||
"tipTitle": "Por que o MaxLevelStore=info importa",
|
||||
"tipBody": "Um limiar mais rigoroso como <code>warning</code> faz ProxMenux Monitor mostrar entradas quase iguais em todos os períodos, pois a maioria da atividade é de nível info, e impede Fail2Ban de ver acessos falhados. Reduza o volume com <code>SystemMaxUse</code> e <code>RateLimitBurst</code> sem restringir os níveis guardados."
|
||||
},
|
||||
"logrotate": {
|
||||
"heading": "Otimizar logrotate",
|
||||
"intro": "Reescreve <code>/etc/logrotate.conf</code> com definições globais diárias e de tamanho, 7 rotações retidas, compressão e <code>copytruncate</code>, para os serviços continuarem a escrever sem reabrir os registos. O tamanho aparece após a frequência diária e prevalece, salvo regras específicas de cada registo. O <code>logrotate.conf</code> original é copiado para <code>.bak</code> na primeira aplicação.",
|
||||
"tipTitle": "Compatível com Log2RAM",
|
||||
"tipBody": "A diretiva <code>size 10M</code> prevalece sobre a definição diária anterior; <em>não</em> significa o primeiro dos dois critérios. Logrotate verifica o limiar quando é executado, e regras específicas podem substituir as globais. Com <code>/var/log</code> na RAM do Log2RAM, verifique as regras e a frequência do temporizador para controlar o espaço."
|
||||
},
|
||||
"limits": {
|
||||
"heading": "Aumentar vários limites do sistema",
|
||||
"intro": "Aumenta limites do kernel, systemd e PAM cujas predefinições podem ser baixas para um host com muitas VMs, contentores e serviços de rede.",
|
||||
"headerFile": "Arquivo",
|
||||
"headerSets": "O que define",
|
||||
"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 (ilimitados para root)"
|
||||
},
|
||||
{
|
||||
"file": "/etc/systemd/system.conf + user.conf",
|
||||
"sets": "<code>DefaultLimitNOFILE=1048576</code> para serviços systemd"
|
||||
},
|
||||
{
|
||||
"file": "/etc/pam.d/common-session + runuser-l",
|
||||
"sets": "<code>session required pam_limits.so</code> então o acima se aplica às shells de login"
|
||||
},
|
||||
{
|
||||
"file": "/root/.profile",
|
||||
"sets": "<code>ulimit -n 1048576</code> para a shell root"
|
||||
}
|
||||
],
|
||||
"tipTitle": "Por que inotify é importante",
|
||||
"tipBody": "Docker, Syncthing, as monitorizações de ficheiros Node.js e análises Plex podem esgotar <code>max_user_watches</code>. A predefinição depende do kernel e da memória; nem sempre é 8192. O limite de 1M permite mais monitorizações sem as pré-alocar. As ativas consomem memória do kernel: controle a utilização nos hosts com pouca RAM."
|
||||
},
|
||||
"memory": {
|
||||
"heading": "Otimizar as configurações de memória",
|
||||
"intro": "Escreve um perfil sysctl equilibrado para <code>/etc/sysctl.d/99-memory.conf</code>. Projetado para um host de hipervisor — prefere manter conjuntos de trabalho VM em RAM e libera páginas proativamente para que as rajadas de alocação não parem.",
|
||||
"warnTitle": "swappiness=10 em hosts com pouca memória",
|
||||
"warnBody": "Num host com 16 GB de RAM e muitas VMs, reduzir swappiness pode levar o kernel a terminar processos por falta de memória em vez de usar swap. Se os eventos OOM forem frequentes, aumente swappiness para 30–60 em <code>/etc/sysctl.d/99-memory.conf</code> após executar o script."
|
||||
},
|
||||
"kexec": {
|
||||
"heading": "Activar reinicialização rápida (kexec)",
|
||||
"intro": "Instala o <code>kexec-tools</code> e o liga para que você possa reiniciar o host diretamente em um novo kernel <em>sem passar pelo firmware BIOS/UEFI</em>. Em grandes servidores onde POST leva 45 – 90 segundos, isso transforma uma reinicialização de uma pausa de café em alguns segundos de parada.",
|
||||
"installsTitle": "O que o ProxMenux instala",
|
||||
"installsItems": [
|
||||
"Pacote <code>kexec-tools</code> (debconf pré-configurado com <code>kexec-tools/load_kexec boolean false</code> para o apt não pedir confirmação e manter desativado o carregamento automático ao desligar).",
|
||||
"Unidade systemd <code>/etc/systemd/system/kexec-pve.service</code> — carrega o kernel Proxmox e initrd em memória no arranque, reutilizando a linha de comandos atual do kernel.",
|
||||
"Um apelido em <code>/root/.bash_profile</code>: <code>reboot-quick</code> → <code>systemctl kexec</code>."
|
||||
],
|
||||
"usageIntro": "Uso após a próxima reinicialização (ou manual <code>systemctl start kexec-pve</code>):",
|
||||
"warnTitle": "Quando não usar o kexec",
|
||||
"warnBody": "O kexec ignora o nível de firmware init. Se você confiar em BIOS/UEFI para redefinir o estado de hardware — por exemplo, um GPU fazendo a passagem que só repõe de forma limpa no POST completo, ou um firmware HBA problemático — o reboots do kexec pode deixar esses dispositivos em um estado semi-inicializado. Use um <code>reboot</code> normal após atualizações do kernel ou quando você precisar de alterações BIOS/UEFI para fazer efeito. <code>reboot-quick</code> é para reinícios diários."
|
||||
},
|
||||
"panic": {
|
||||
"heading": "Habilite a reinicialização no kernel panic",
|
||||
"intro": "Faz o kernel <strong>reiniciar automaticamente</strong> em vez de ficar bloqueado no ecrã de panic. Essencial em hosts Proxmox remotos ou sem consola local: um kernel bloqueado para todas as VMs até poder desligar e voltar a ligar a alimentação.",
|
||||
"tipTitle": "Emparelha isto com o acesso remoto à consola",
|
||||
"tipBody": "Auto-reboot é um mecanismo de recuperação, não uma ferramenta de depuração. Se você quiser <em>investigar</em> um pânico em vez de apenas voltar, use <link>a opção kexec</link> acima com o suporte kdump do kernel (não configurado pelo ProxMenux) ou capture um console serial para outro host antes de habilitar o reinício automático."
|
||||
},
|
||||
"verify": {
|
||||
"heading": "Verificação",
|
||||
"intro": "Após a aplicação das otimizações do sistema:",
|
||||
"tipTitle": "Restauro e limitações",
|
||||
"tipBody": "As seis opções ficam em <code>installed_tools.json</code> e <link>Desinstalar otimizações</link>. O restauro remove os ficheiros de configuração, a unidade e o alias kexec, reescreve journald.conf com os valores predefinidos do systemd e repõe logrotate.conf a partir da cópia de segurança. Alguns limites ativos precisam de nova sessão ou reinício."
|
||||
},
|
||||
"related": {
|
||||
"heading": "Relacionado",
|
||||
"items": [
|
||||
{
|
||||
"label": "Comandos úteis do sistema",
|
||||
"href": "/docs/help-info/system-commands",
|
||||
"tail": " — verificar as alterações (free -h, journalctl, ulimit -a)."
|
||||
},
|
||||
{
|
||||
"label": "Desempenho",
|
||||
"href": "/docs/post-install/performance",
|
||||
"tail": " — afinação adicional do nível do sistema (pigz)."
|
||||
},
|
||||
{
|
||||
"label": "Desinstalar otimizações",
|
||||
"href": "/docs/post-install/uninstall",
|
||||
"tail": " — reverter qualquer uma destas alterações."
|
||||
},
|
||||
{
|
||||
"label": "Pós-instalação personalizável",
|
||||
"href": "/docs/post-install/customizable",
|
||||
"tail": " — voltar ao menu superior."
|
||||
}
|
||||
]
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,271 @@
|
||||
{
|
||||
"meta": {
|
||||
"title": "Desinstalar otimizações | Documentação ProxMenux",
|
||||
"description": "Restaurar as alterações reversíveis de configuração pós-instalação aplicadas pelo ProxMenux. Ferramentas registradas usam desinstaladores dedicados que preservam o estado de host pré-existente sempre que possível."
|
||||
},
|
||||
"header": {
|
||||
"title": "Desinstalar otimizações",
|
||||
"description": "Restaurar as alterações reversíveis feitas pelos scripts pós-instalação automatizados ou personalizáveis. ProxMenux registra cada otimização suportada com sua função de restauração dedicada; upgrades de pacotes são intencionalmente excluídos.",
|
||||
"section": "Configurações pós-instalação do Proxmox"
|
||||
},
|
||||
"intro": {
|
||||
"title": "Por que isto existe",
|
||||
"body": "Cada ajuste reversível suportado fica <strong>registado</strong> em <code>/usr/local/share/proxmenux/installed_tools.json</code>. O registo lista otimizações ativas e chama a função de restauro correspondente. Ações sem reversão segura, como uma atualização completa de pacotes, não são acrescentadas."
|
||||
},
|
||||
"openMenu": {
|
||||
"heading": "Como abri-lo",
|
||||
"body": "Do menu principal do ProxMenux, <strong>Configurações pós-instalação Proxmox → Desinstalar otimizações</strong>. Você verá uma lista de verificação das otimizações <em>aplicadas atualmente</em> — itens que você não tenha aplicado não aparecem.",
|
||||
"imageAlt": "Desinstalar Lista de verificação de Otimizações mostrando itens atualmente aplicados no host, com caixas de seleção para selecionar quais reverter"
|
||||
},
|
||||
"howWorks": {
|
||||
"heading": "Como funciona a inversão",
|
||||
"steps": [
|
||||
{
|
||||
"title": "Registro e autodetecção",
|
||||
"body1": "Na primeira execução, ProxMenux procura indicadores no host: <code>/etc/sysctl.d/99-memory.conf</code>, <code>/etc/apt/apt.conf.d/99-force-ipv4</code>, pacote <code>haveged</code> instalado, serviço Log2RAM ativo, etc. Os elementos reconhecidos são registados como reversíveis mesmo se aplicados por uma versão anterior ao registo.",
|
||||
"body2": "Esta migração só funciona uma vez. Depois disso, cada aplicação/reversão atualiza diretamente o registro."
|
||||
},
|
||||
{
|
||||
"title": "Escolha o que reverter",
|
||||
"body1": "A lista de verificação mostra um rótulo legível pelo homem por item (por exemplo, <em>Otimização da Configuração da Memória</em>, <em>IOMMU/VFIO PCI Passthrough</em>, <em>Log2RAM (Proteção SSD)</em>). Assinale os que quiser reverter. Nada que não tiquetes será tocado."
|
||||
},
|
||||
{
|
||||
"title": "Execução da reversão",
|
||||
"body1": "Para cada item selecionado, ProxMenux chama sua função de desinstalação correspondente. A maioria das reversões segue um dos três padrões:",
|
||||
"items": [
|
||||
"<strong>A partir de cópia</strong> — restaura um <code>.bak</code> criado ao aplicar a alteração (bashrc, logrotate.conf, journald.conf, linha de comandos GRUB/kernel).",
|
||||
"<strong>Remoção da configuração</strong> — remove os ficheiros ProxMenux <code>/etc/sysctl.d/99-*.conf</code>, <code>/etc/apt/apt.conf.d/99-*</code> ou a unidade systemd e recarrega.",
|
||||
"<strong>Reinstale o pacote</strong> — para alterações de UI como o banner de assinatura, reinstale os pacotes upstream com <code>--force-confnew</code> para restaurar a configuração enviada."
|
||||
],
|
||||
"body2": "Cada inversão regista o seu progresso. Itens que requerem uma reinicialização (VFIO, nomes de interface persistentes) definem uma bandeira que ativa o prompt de reinicialização no final."
|
||||
},
|
||||
{
|
||||
"title": "Pedido de reinício no fim",
|
||||
"body1": "Após a reversão terminar, o menu mostra um prompt de reinicialização. Itens que mudaram os parâmetros do kernel, módulos do kernel ou nomes de rede (VFIO, nomes de interface persistentes) precisam da reinicialização para fazer efeito; outros itens não, e o prompt é um padrão de segurança em vez de uma verificação por item."
|
||||
}
|
||||
]
|
||||
},
|
||||
"reversible": {
|
||||
"heading": "O que é reversível",
|
||||
"intro": "As otimizações reversíveis registradas e seus desinstaladores correspondentes são agrupados aqui por área:",
|
||||
"groups": [
|
||||
{
|
||||
"title": "Repositórios & APT",
|
||||
"items": [
|
||||
{
|
||||
"tool": "Remoção da Banner de Assinatura",
|
||||
"restores": "Primeiro tenta restaurar os ficheiros da interface a partir das cópias ProxMenux (/usr/local/share/proxmenux/backups/proxmoxlib.js.backup.* e index.html.tpl.backup.* se a interface móvel foi modificada). Só quando a cópia falta ou está danificada reinstala pve-manager, proxmox-widget-toolkit, libjs-extjs e libpve-http-server-perl com force-confnew. Também limpa cópias .js / .gz em cache."
|
||||
},
|
||||
{
|
||||
"tool": "Ignorar idiomas do APT",
|
||||
"restores": "Remove /etc/apt/apt.conf.d/99-disable-translations, permitindo os índices de descrições traduzidas segundo as restantes definições de idioma APT."
|
||||
},
|
||||
{
|
||||
"tool": "Forçar IPv4 no APT",
|
||||
"restores": "Remove /etc/apt/apt.conf.d/99-force-ipv4."
|
||||
},
|
||||
{
|
||||
"tool": "Utilitários de Sistema",
|
||||
"restores": "Purga apenas os pacotes utilitários selecionados que o ProxMenux gravou como recém-instalado. Pacotes já presentes antes da ação nunca são adicionados a esta lista e ficam intocados."
|
||||
}
|
||||
]
|
||||
},
|
||||
{
|
||||
"title": "Limites de Kernel, memória e sistema",
|
||||
"items": [
|
||||
{
|
||||
"tool": "Configuração da Memória",
|
||||
"restores": "Remove o /etc/sysctl.d/99-memory.conf e recarrega o sysctl."
|
||||
},
|
||||
{
|
||||
"tool": "Configuração do Pânico do Kernel",
|
||||
"restores": "Remove /etc/sysctl.d/99-kernelpanic.conf."
|
||||
},
|
||||
{
|
||||
"tool": "Aumento dos limites do sistema",
|
||||
"restores": "Remove /etc/sysctl.d/99-maxwatches.conf, 99-maxkeys.conf, 99-swap.conf, 99-fs.conf e /etc/security/limits.d/99-limits.conf. Repõe limites PAM e DefaultLimitNOFILE systemd. Em /root/.profile só remove o antigo ulimit -n 256000; ulimit -n 1048576 do instalador atual pode permanecer e exigir remoção manual."
|
||||
},
|
||||
{
|
||||
"tool": "Perfil de troca ZRAM",
|
||||
"restores": "Desativa o swap /dev/zram0, para dev-zram0.swap e remove /etc/systemd/zram-generator.conf.d/90-proxmenux.conf. Só purga systemd-zram-generator se instalado pelo ProxMenux e sem outra configuração ZRAM. Se não conseguir evacuar as páginas, o perfil mantém-se ativo e nada é removido."
|
||||
}
|
||||
]
|
||||
},
|
||||
{
|
||||
"title": "Rede",
|
||||
"items": [
|
||||
{
|
||||
"tool": "Otimizações de Rede",
|
||||
"restores": "Remove /etc/sysctl.d/99-network.conf, 97-proxmenux-fwbr.conf e 98-proxmenux-rpf.conf, a unidade proxmenux-fwbr-tune.service, o script /usr/local/sbin/proxmenux-fwbr-tune e a regra udev /etc/udev/rules.d/99-zz-proxmenux-fwbr-tune.rules. Retira também source /etc/network/interfaces.d/* de /etc/network/interfaces. Recarrega sysctl, systemd e regras udev."
|
||||
},
|
||||
{
|
||||
"tool": "Open vSwitch",
|
||||
"restores": "Executa apt purge para openvswitch-switch e openvswitch-common. Migre antes as pontes OVS para Linux; caso contrário, as VMs nessas pontes perdem a rede no próximo arranque."
|
||||
},
|
||||
{
|
||||
"tool": "TCP BBR + TCP Fast Open",
|
||||
"restores": "Remove /etc/sysctl.d/99-kernel-bbr.conf e 99-tcp-fastopen.conf e recarrega o restante sysctl. Eliminar ficheiros não repõe valores ativos; predefinições como cubic e tcp_fastopen=1 voltam após reiniciar, salvo outra configuração."
|
||||
},
|
||||
{
|
||||
"tool": "Nomes de Interface Persistentes",
|
||||
"restores": "Remove apenas os arquivos 10-proxmenux-*.link carregando o cabeçalho ProxMenux do /etc/systemd/network/. Qualquer arquivo .link fornecido por outro pacote ou escrito pelo usuário é deixado no lugar. Os nomes da interface retornam ao comportamento padrão do systemd na próxima reinicialização."
|
||||
}
|
||||
]
|
||||
},
|
||||
{
|
||||
"title": "Registo",
|
||||
"items": [
|
||||
{
|
||||
"tool": "Otimização do journald",
|
||||
"restores": "Reescreve /etc/systemd/journald.conf com predefinições originais e reinicia systemd-journald."
|
||||
},
|
||||
{
|
||||
"tool": "Otimização do Logrotate",
|
||||
"restores": "Restaura /etc/logrotate.conf do arquivo .bak capturado antes da mudança."
|
||||
},
|
||||
{
|
||||
"tool": "Log2RAM",
|
||||
"restores": "Para e desativa o serviço e o timer. Purga trabalhos de cron, unidades systemd, binários, arquivos de configuração e o diretório /var/log.hdd. Também desinstala o pacote apt se ele foi instalado dessa forma."
|
||||
},
|
||||
{
|
||||
"tool": "TRIM automático do ZFS",
|
||||
"restores": "Lê /usr/local/share/proxmenux/zfs_autotrim_pools, a lista dos pools realmente alterados, e executa zpool set autotrim=off em cada um. Preserva autotrim ativado manualmente antes do ProxMenux."
|
||||
}
|
||||
]
|
||||
},
|
||||
{
|
||||
"title": "Shell & aparência",
|
||||
"items": [
|
||||
{
|
||||
"tool": "Personalização do Bashrc",
|
||||
"restores": "Restaura /root/.bashrc do backup .bak. Se não existir backup, remove o bloco PMX_CORE_BASHRC por marcadores."
|
||||
},
|
||||
{
|
||||
"tool": "Banner MOTD personalizado",
|
||||
"restores": "Restaura o conteúdo original exato /etc/motd mantido sob /usr/local/share/proxmenux, remove o arquivo quando ele não existia antes, ou remove com segurança o marcador legado ao migrar uma instalação mais antiga."
|
||||
},
|
||||
{
|
||||
"tool": "Fastfetch",
|
||||
"restores": "Remove binário, diretório de configuração, integração update-motd e bloco delimitado BEGIN FASTFETCH / END FASTFETCH de /root/.bashrc, ~/.profile, /etc/profile e /etc/profile.d/fastfetch.sh. Purga o pacote apt se instalado."
|
||||
},
|
||||
{
|
||||
"tool": "Figurine",
|
||||
"restores": "Remove o binário, a entrada profile.d e o bloco de aliases em bashrc/profile."
|
||||
}
|
||||
]
|
||||
},
|
||||
{
|
||||
"title": "Hardware e virtualização",
|
||||
"items": [
|
||||
{
|
||||
"tool": "IOMMU / VFIO",
|
||||
"restores": "Remove os módulos vfio de /etc/modules, as entradas de bloqueio dos controladores nouveau / radeon / nvidia e os parâmetros intel_iommu=on / amd_iommu=on / iommu=pt / pcie_acs_override de /etc/kernel/cmdline (ZFS) ou do GRUB. Reconstrói initramfs."
|
||||
},
|
||||
{
|
||||
"tool": "Correcções AMD CPU (Ryzen/EPYC)",
|
||||
"restores": "Remove idle=nomwait da linha de comandos do kernel (ZFS) ou GRUB e as opções ignore_msrs / report_ignored_msrs de /etc/modprobe.d/kvm.conf."
|
||||
},
|
||||
{
|
||||
"tool": "Agente convidado para host Proxmox virtualizado",
|
||||
"restores": "Lê /usr/local/share/proxmenux/guest_agent.pkg e purga o pacote registado do host. O instalador escolhe qemu-guest-agent, open-vm-tools ou virtualbox-guest-utils pelo hipervisor. Sem registo, tenta esses três pacotes. Atua no host Proxmox aninhado, não em modelos de convidados."
|
||||
}
|
||||
]
|
||||
},
|
||||
{
|
||||
"title": "Armazenamento",
|
||||
"items": [
|
||||
{
|
||||
"tool": "Dimensionamento do ARC do ZFS",
|
||||
"restores": "Remove /etc/modprobe.d/99-zfsarc.conf, restaura *.conf externos em conflito guardados em /usr/local/share/proxmenux/backups/zfs_arc/, reconstrói initramfs e executa proxmox-boot-tool refresh em hosts systemd-boot."
|
||||
},
|
||||
{
|
||||
"tool": "Snapshots automáticos do ZFS",
|
||||
"restores": "Remove as entradas cron escritas pelo script e oferece apt purge zfs-auto-snapshot. Os instantâneos existentes nos pools são preservados; remova-os separadamente se necessário."
|
||||
},
|
||||
{
|
||||
"tool": "Limites de velocidade do vzdump",
|
||||
"restores": "Restaura /etc/vzdump.conf do .bak a instalação criada, trazendo de volta bwlimit e ionice para seus valores pré-ProxMenux."
|
||||
}
|
||||
]
|
||||
},
|
||||
{
|
||||
"title": "Serviços & extras",
|
||||
"items": [
|
||||
{
|
||||
"tool": "Sincronização do Tempo",
|
||||
"restores": "Define o fuso- horário de volta para UTC (padrão seguro) via timedatectl."
|
||||
},
|
||||
{
|
||||
"tool": "Geração de entropia (haveged)",
|
||||
"restores": "Para, desativa e purga o pacote haveged."
|
||||
},
|
||||
{
|
||||
"tool": "kexec (reiniciações rápidas)",
|
||||
"restores": "Desativa kexec-pve.service, remove o ficheiro da unidade e o alias reboot-quick de /root/.bash_profile e purga kexec-tools."
|
||||
},
|
||||
{
|
||||
"tool": "RPC / rpcbind Desabilitar",
|
||||
"restores": "Restaura rpcbind.service e rpcbind.socket independentemente para os estados ativados/desativados e ativos/inativos registrados antes de ProxMenux os alterar."
|
||||
},
|
||||
{
|
||||
"tool": "pigz (paralelo gzip)",
|
||||
"restores": "Restaura o gzip original de gzip.distrib, remove o desvio dpkg e /bin/pigzwrapper, comenta a linha pigz em /etc/vzdump.conf e executa apt purge pigz após verificar gzip."
|
||||
},
|
||||
{
|
||||
"tool": "Serviços de alta disponibilidade",
|
||||
"restores": "Para e desactiva pve-ha-lrm, pve-ha-crm e corosync. Grupos HA existentes e definições de recursos não são excluídos — remova-os da interface web se você não precisar mais deles."
|
||||
},
|
||||
{
|
||||
"tool": "repositório Ceph",
|
||||
"restores": "Purga os pacotes Ceph instalados por esta opção, remove o deb822 /etc/apt/sources.list.d/ceph.sources no PVE 9 (ou a lista de Ceph no PVE 8) e atualiza o cache APT."
|
||||
},
|
||||
{
|
||||
"tool": "OVH RTM (monitorização)",
|
||||
"restores": "Purga pacotes correspondentes a ovh-rtm*, rtm e rtm-*, remove /etc/rtm e a entrada RTM do registo. Restos Puppet em /etc/puppet/ podem exigir inspeção e limpeza manual; o diretório não é eliminado. Fora da OVH, o instalador normalmente não altera nada."
|
||||
}
|
||||
]
|
||||
}
|
||||
]
|
||||
},
|
||||
"edge": {
|
||||
"heading": "Casos particulares e limitações",
|
||||
"packageTitle": "A reinstalação afeta pacotes Proxmox em utilização",
|
||||
"packageBody": "Se as cópias ProxMenux não conseguirem reverter <strong>Remoção do aviso de subscrição</strong>, a alternativa reinstala <code>pve-manager</code>, <code>proxmox-widget-toolkit</code>, <code>libjs-extjs</code> e <code>libpve-http-server-perl</code> com <code>--force-confnew</code>. Afeta a interface em uso: atualize o navegador e aguarde alguns segundos pela reconexão. Evite fazê-lo durante migrações ou clonagens.",
|
||||
"rebootTitle": "Nomes persistentes e VFIO precisam de uma reinicialização",
|
||||
"rebootBody": "Removendo ProxMenux's <code>10-proxmenux-*.link</code> ficheiros (<em>Nomes de Interface Persistentes</em>) e reversão <em>IOMMU/VFIO</em> não afetam o sistema de execução — eles só importam após uma reinicialização. ProxMenux define a bandeira de reinicialização automaticamente para estes.",
|
||||
"perItemTitle": "Podes reverter uma coisa e ficar com o resto.",
|
||||
"perItemBody": "O desinstalador opera por item. Se você só quiser remover Log2RAM, mas manter o ajuste de rede e mudanças bashrc, marque apenas <em>Log2RAM</em>. Nada mais é tocado, e o registro é atualizado em conformidade."
|
||||
},
|
||||
"inspect": {
|
||||
"heading": "Inspecionar o registro manualmente",
|
||||
"intro": "Se você quiser ver o que é rastreado sem abrir o menu:",
|
||||
"outro": "Cada entrada <code>\"tool\": true</code> corresponde a algo ProxMenux aplicado e pode reverter. Remover uma entrada manualmente não é recomendado — use sempre o menu, que também executa a função reversão em vez de apenas esquecer a mudança.",
|
||||
"reinstallTitle": "Reinstalar após desinstalar",
|
||||
"reinstallBody": "Reverter uma otimização não impede que você a aplique mais tarde. Abra <link>o menu Post-Install</link> novamente e execute Automatizado ou Personalizável – o registro irá rastrear o novo estado."
|
||||
},
|
||||
"related": {
|
||||
"heading": "Relacionado",
|
||||
"items": [
|
||||
{
|
||||
"label": "Pós- instalação automatizada",
|
||||
"href": "/docs/post-install/automated",
|
||||
"tail": " — reaplicar a configuração de base recomendada."
|
||||
},
|
||||
{
|
||||
"label": "Pós-instalação personalizável",
|
||||
"href": "/docs/post-install/customizable",
|
||||
"tail": " — escolher um subconjunto diferente."
|
||||
},
|
||||
{
|
||||
"label": "Desinstalar ProxMenux",
|
||||
"href": "/docs/settings/uninstall-proxmenux",
|
||||
"tail": " — operação diferente: remove o ProxMenux em si, não as suas otimizações aplicadas."
|
||||
},
|
||||
{
|
||||
"label": "Visão geral da pós-instalação",
|
||||
"href": "/docs/post-install",
|
||||
"tail": "."
|
||||
}
|
||||
]
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,112 @@
|
||||
{
|
||||
"meta": {
|
||||
"title": "Aplicar atualizações disponíveis — Otimizações pós-instalação | Documentação ProxMenux",
|
||||
"description": "Como o ProxMenux detecta quando uma otimização pós-instalação (Log2Ram, Configurações de Memória, Limites de Sistema, Logrotate, Ajuste de Rede...) foi atualizada a montante, e como aplicar a nova versão — do menu Post-Install ou do painel Monitor."
|
||||
},
|
||||
"header": {
|
||||
"title": "Aplicar atualizações disponíveis",
|
||||
"description": "Quando uma otimização pós-instalação (Log2Ram, definições de memória, limites do sistema, Logrotate…) tem uma versão no disco mais recente que a registada no host, o ProxMenux apresenta-a como atualização disponível. Pode aplicá-la pelo menu pós-instalação dos scripts ou pelo painel Monitor. Ambos executam novamente a mesma função e atualizam o registo.",
|
||||
"section": "Configurações pós-instalação do Proxmox"
|
||||
},
|
||||
"intro": {
|
||||
"title": "O que é isto?",
|
||||
"body": "As otimizações pós-instalação ProxMenux têm versões, por exemplo <code>Log2ram SSD Protection v1.2</code>. O host regista as otimizações ativas e as suas versões em <code>/usr/local/share/proxmenux/installed_tools.json</code>. Quando uma nova versão ProxMenux atualiza uma otimização, deteta a diferença e propõe reaplicar só essa, sem repetir toda a pós-instalação."
|
||||
},
|
||||
"why": {
|
||||
"heading": "Por que isto existe",
|
||||
"body": "As otimizações pós-instalação recebem melhorias: ajustes sysctl, limites Logrotate mais rigorosos, novas regras de dimensão Log2RAM ou correções de casos extremos. Sem esta via, era necessário repetir o script, que reaplica <em>todas</em> as otimizações, ou abdicar da melhoria. Aplicar atualizações disponíveis permite escolher individualmente só as que mudaram de versão."
|
||||
},
|
||||
"detection": {
|
||||
"heading": "Como as atualizações são detectadas",
|
||||
"steps": [
|
||||
{
|
||||
"title": "Scripts com versão no disco",
|
||||
"body": "Cada função pós-instalação declara sua versão dentro do script (<code>scripts/post_install/auto_post_install.sh</code> e <code>scripts/post_install/customizable_post_install.sh</code>). Um scanner extrai estas versões da fonte no disco."
|
||||
},
|
||||
{
|
||||
"title": "Registo versionado na máquina",
|
||||
"body": "Quando o operador aplicou cada otimização, a chamada <code>register_tool</code> correspondente escreveu a versão ativa em <code>/usr/local/share/proxmenux/installed_tools.json</code>. Esse arquivo é a fonte da verdade para \"o que está ativo neste host agora\"."
|
||||
},
|
||||
{
|
||||
"title": "Monitor compara ambos os lados",
|
||||
"body": "Na inicialização e a cada 24h, o Monitor compara versões de disco com versões de registro. Qualquer incompatibilidade produz uma entrada em <code>/usr/local/share/proxmenux/updates_available.json</code>. Esse arquivo dirige tanto a entrada de menu Post-Install quanto o cartão de painel Monitor."
|
||||
},
|
||||
{
|
||||
"title": "Uma notificação por nova versão",
|
||||
"body": "Se houver pelo menos uma atualização pendente, Monitor envia uma única notificação agrupada, por exemplo <em>«4 atualizações de otimizações ProxMenux disponíveis»</em>, com uma linha por ferramenta no formato <code>name (vX → vY)</code>, como nos pacotes Proxmox. Não a repete diariamente para o mesmo conjunto: só uma nova versão ou nova ferramenta na lista volta a ativá-la."
|
||||
}
|
||||
]
|
||||
},
|
||||
"pathA": {
|
||||
"heading": "Caminho A — Do menu pós- instalação",
|
||||
"intro": "No menu principal ProxMenux, abra <strong>Configurações pós-instalação do Proxmox</strong>. Havendo atualizações pendentes, surge <strong>Aplicar atualizações disponíveis (N)</strong> acima de <em>Desinstalar otimizações</em>. O número indica quantas têm versão no disco mais recente que a registada. Se tudo estiver atualizado, a entrada fica oculta.",
|
||||
"menuAlt": "Post-Install Scripts menu mostrando a entrada condicional 'Aplicar atualizações disponíveis (N)' posicionado logo acima 'Desinstalar otimizações', com o crachá de contagem indicando quantas otimizações têm uma versão mais recente no disco",
|
||||
"menuCaption": "A entrada <em>Aplicar atualizações disponíveis (N)</em> só renderiza quando pelo menos uma otimização tem uma atualização pendente — ela esconde quando o host está atual.",
|
||||
"checklistBody": "Abre uma lista com todas as atualizações pendentes no formato <code>name (vX → vY)</code>. Estão todas selecionadas por predefinição; desmarque as que não pretende aplicar agora.",
|
||||
"checklistAlt": "Janela Aplicar atualizações disponíveis com uma linha por otimização pendente, nome e mudança de versão (atual → disponível). Todas as linhas estão selecionadas.",
|
||||
"checklistCaption": "Escolha individualmente as otimizações a atualizar. O mesmo motor de Automatizado e Personalizável reaplica cada função em segundo plano e atualiza a versão registada."
|
||||
},
|
||||
"pathB": {
|
||||
"heading": "Caminho B — Do painel do monitor",
|
||||
"intro": "As mesmas atualizações aparecem em Monitor, em <link>Configurações → Otimizações ProxMenux</link>. A ficha mostra um <strong>contador de atualizações</strong> pendentes que abre o seletor por otimização. Cada ferramenta também tem a sua ação de atualização.",
|
||||
"imageAlt": "Ficha Otimizações ProxMenux nas configurações Monitor com contador de atualizações pendentes que abre o seletor e ações de atualização por ferramenta",
|
||||
"imageCaption": "A ficha Otimizações de Monitor permite aceder às atualizações pelo contador quando existe uma versão mais recente no disco, sem acesso à shell."
|
||||
},
|
||||
"applying": {
|
||||
"heading": "O que acontece ao aplicar",
|
||||
"steps": [
|
||||
{
|
||||
"title": "Repetir a função pós-instalação",
|
||||
"body": "A função escolhida volta a ser executada no host. Como é <strong>idempotente</strong>, não duplica a configuração: substitui a versão anterior pela nova, incluindo ficheiros sysctl, configurações adicionais e unidades de serviços."
|
||||
},
|
||||
{
|
||||
"title": "Atualiza o registro",
|
||||
"body": "A chamada <code>register_tool</code> dentro da função escreve a nova versão em <code>installed_tools.json</code>. A próxima varredura não vê mais um descompasso e a entrada de atualização desaparece tanto do menu quanto do cartão Monitor."
|
||||
},
|
||||
{
|
||||
"title": "Sem reiniciar, a menos que a função o diga",
|
||||
"body": "A maioria das actualizações produz efeitos imediatamente. Atualizações que tocam módulos do kernel, nomes de interface persistentes ou VFIO mostram o mesmo prompt de reinicialização que uma nova instalação seria."
|
||||
},
|
||||
{
|
||||
"title": "Actualizar o registo enviado para o Monitor",
|
||||
"body": "No fim do lote, o menu envia um pedido POST a <code>http://127.0.0.1:8008/api/updates/post-install/scan</code> para reconstruir <code>/usr/local/share/proxmenux/updates_available.json</code>. Após aplicar todas as atualizações, desaparecem o contador da ficha Otimizações e a entrada condicional da shell, sem esperar pelo próximo scan. A ficha continua disponível."
|
||||
}
|
||||
],
|
||||
"jqTitle": "jq é necessário",
|
||||
"jqBody": "A lista de verificação Caminho A baseia-se em <code>jq</code> para processar as atualizações pendentes JSON. Se o <code>jq</code> estiver faltando, o fluxo sai silenciosamente — você verá a entrada do menu com uma contagem, mas nada aconteceria depois de escolher linhas. Em qualquer instalação moderna Proxmox <code>jq</code> está presente; se em dúvida executar <code>apt install -y jq</code>."
|
||||
},
|
||||
"differs": {
|
||||
"heading": "Como difere dos outros caminhos",
|
||||
"headerPath": "Path",
|
||||
"headerScope": "Escopo",
|
||||
"headerWhen": "Quando faz sentido",
|
||||
"rows": [
|
||||
{
|
||||
"pathLabel": "Automatizado",
|
||||
"pathHref": "/docs/post-install/automated",
|
||||
"scope": "Reaplica <em>todas</em> as otimizações do conjunto.",
|
||||
"when": "Host novo ou reaplicação completa da base de um nó totalmente gerido."
|
||||
},
|
||||
{
|
||||
"pathLabel": "Personalizável",
|
||||
"pathHref": "/docs/post-install/customizable",
|
||||
"scope": "Escolha no catálogo completo.",
|
||||
"when": "Escolher exatamente as otimizações ativas no host."
|
||||
},
|
||||
{
|
||||
"pathLabel": "Aplicar atualizações disponíveis",
|
||||
"pathHref": null,
|
||||
"scope": "Só as otimizações com versão mais recente no disco.",
|
||||
"when": "Mantenha as otimizações já instaladas atuais sem tocar no resto."
|
||||
},
|
||||
{
|
||||
"pathLabel": "Desinstalar otimizações",
|
||||
"pathHref": "/docs/post-install/uninstall",
|
||||
"scope": "Inverta a otimização e remova sua entrada de registro.",
|
||||
"when": "Retroceda uma mudança específica."
|
||||
}
|
||||
]
|
||||
},
|
||||
"notifTitle": "Controlo da notificação",
|
||||
"notifBody": "O evento <em>Atualizações de otimizações ProxMenux disponíveis</em> anuncia as atualizações pendentes. Está ativo por predefinição em cada canal e pode ser silenciado por canal em <link>Configurações → Notificações</link>. Só dispara uma vez por conjunto diferente de atualizações, não em cada scan de 24 horas."
|
||||
}
|
||||
@@ -0,0 +1,116 @@
|
||||
{
|
||||
"meta": {
|
||||
"title": "Pós-instalação: Virtualização | Documentação ProxMenux",
|
||||
"description": "Opções de virtualização no script pós-instalação personalizável ProxMenux: auto-instale o agente convidado certo se o Proxmox correr dentro de um VM, e habilite o IOMMU / VFIO para que você possa passar dispositivos PCI (GPUs, NICs, HBAS) através de suas próprias VMs."
|
||||
},
|
||||
"header": {
|
||||
"title": "Post-Install: Virtualização",
|
||||
"section": "Configurações pós-instalação do Proxmox"
|
||||
},
|
||||
"intro": {
|
||||
"title": "O que esta categoria abrange",
|
||||
"body": "Duas opções independentes. <strong>Instalar o agente convidado adequado</strong> ajuda quando o próprio Proxmox corre dentro de outro hipervisor. <strong>Ativar suporte VFIO IOMMU</strong> interessa à maioria dos utilizadores: ativa as funções do kernel para atribuir diretamente uma GPU, HBA ou placa de rede a uma VM com desempenho quase nativo."
|
||||
},
|
||||
"guestAgent": {
|
||||
"heading": "Instale o agente convidado relevante",
|
||||
"intro": "Deteta o ambiente de virtualização do host Proxmox através de <code>systemd-detect-virt</code> e <code>dmidecode</code> e instala as ferramentas de convidado adequadas para comunicar com o hipervisor externo: encerramento ordenado, sincronização do relógio, informação de IP, etc.",
|
||||
"headerDetected": "Máquina detectada",
|
||||
"headerPackage": "Pacote instalado",
|
||||
"rows": [
|
||||
{
|
||||
"detected": "QEMU / KVM",
|
||||
"package": "qemu-guest-agent"
|
||||
},
|
||||
{
|
||||
"detected": "VMware (ESXi, Workstation)",
|
||||
"package": "open-vm-tools"
|
||||
},
|
||||
{
|
||||
"detected": "VirtualBox",
|
||||
"package": "virtualbox-guest-utils"
|
||||
},
|
||||
{
|
||||
"detected": "Hardware físico (nenhum)",
|
||||
"package": "— no-op, nada instalado"
|
||||
}
|
||||
],
|
||||
"skipTitle": "Ignore esta opção se o Proxmox correr diretamente no hardware",
|
||||
"skipBody": "Se o Proxmox for executado diretamente no hardware (o caso comum), assinalar esta opção é um no-op — o detector devolve <code>none</code> e o script sai sem alterações. A opção só importa para a minoria de configurações que executam Proxmox <em> como um guest</em> para testes ou laboratórios."
|
||||
},
|
||||
"vfio": {
|
||||
"heading": "Habilitar suporte VFIO IOMMU",
|
||||
"intro": "Ativa IOMMU no host e carrega os módulos para passthrough PCI (<code>vfio</code>, <code>vfio_iommu_type1</code>, <code>vfio_pci</code>). Pode então atribuir um dispositivo físico a uma VM, que terá acesso direto com desempenho quase nativo.",
|
||||
"whoTitle": "Quem precisa disto?",
|
||||
"whoItems": [
|
||||
"Quer atribuir uma GPU a uma VM Windows para jogos ou a uma VM macOS.",
|
||||
"Você tem um NIC de 10G dedicado para um firewall/roteador VM (OPNsense, pfSense).",
|
||||
"Você quer passar um HBA diretamente para um TrueNAS / Unraid VM para ZFS em discos nus.",
|
||||
"Você está planejando usar <em>Coral TPU</em>, uma placa de captura, ou um dongle SDR em um VM."
|
||||
],
|
||||
"whoOutro": "Se nada disso se aplicar, você pode ignorar esta opção com segurança. Para passagem para um <strong>LXC</strong> (não um VM), o IOMMU <em>não</em> é necessário.",
|
||||
"doesTitle": "O que o ProxMenux faz",
|
||||
"doesIntro": "A função está ciente de boot-loader: detecta se Proxmox está em ZFS (systemd-boot) ou LVM/ext4 (GRUB) e escreve para o arquivo direito. Também é idempotente — se os parâmetros já estão presentes, nada é adicionado.",
|
||||
"headerBoot": "Tipo de arranque",
|
||||
"headerFile": "Ficheiro alterado",
|
||||
"headerPost": "Passo de pós- atualização",
|
||||
"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": "Parâmetros do kernel adicionados:",
|
||||
"modulesIntro": "Módulos de kernel adicionados ao <code>/etc/modules</code>:",
|
||||
"blacklistIntro": "Conflitantes drivers na lista negra em <code>/etc/modprobe.d/blacklist.conf</code>:",
|
||||
"blacklistTitle": "A lista negra de drivers GPU entra em conflito com o uso do GPU no lado do host",
|
||||
"blacklistBody": "A lista de bloqueio impede o kernel do host de associar <em>qualquer</em> controlador GPU, permitindo ao VFIO assumir a GPU. É o pretendido para passthrough a uma VM, mas é o <strong>oposto</strong> do necessário para <link>instalar controladores NVIDIA no host</link>, por exemplo para transcodificação LXC. Escolha um caminho por GPU:",
|
||||
"pathItems": [
|
||||
"<strong>GPU → VM:</strong> habilite VFIO/IOMMU aqui, deixe os drivers GPU na lista negra.",
|
||||
"<strong>GPU → LXC (ou host):</strong> ignore esta opção, use a instalação NVIDIA no host e não bloqueie nvidia/nouveau.",
|
||||
"<strong>Dois GPUs:</strong> um pode ir para um VM e o outro para um LXC, mas você precisará de uma configuração mais fina (ligar apenas um cartão para <code>vfio-pci</code> por ID PCI). A lista negra padrão é muito ampla para este caso — edite <code>blacklist.conf</code> depois."
|
||||
],
|
||||
"acsTitle": "Sobre o pcie_acs_override — saiba o que está habilitando",
|
||||
"acsBody": "<code>pcie_acs_override=downstream,multifunction</code> relaxa a verificação dos Serviços de Controle de Acesso PCIe. Ele permite que o kernel divida grupos IOMMU que o firmware reporta como monolítico, que às vezes é a única maneira de passar através de um dispositivo de um grupo sem arrastar o resto. O trade-off é o isolamento reduzido <strong> entre dispositivos</strong>: um VM malicioso ou comprometido com passagem tem uma superfície de ataque maior via DMA. Tudo bem para um laboratório doméstico; pense duas vezes antes de habilitar um host que executa cargas de trabalho não confiáveis. Se você não precisar, remova esse token do <code>/etc/kernel/cmdline</code> ou <code>/etc/default/grub</code> após o script correr e execute novamente a etapa de atualização do carregador de inicialização.",
|
||||
"rebootTitle": "Reinício necessário",
|
||||
"rebootBody": "IOMMU, módulos VFIO e lista de bloqueio entram em vigor após regenerar initramfs e reiniciar. O script executa <code>update-initramfs -u -k all</code>, atualiza o carregador de arranque e indica «reinício necessário» para que Personalizável o proponha no fim.",
|
||||
"verifyTitle": "Verificação após reiniciar",
|
||||
"revertTitle": "Reversível do menu Desinstalar",
|
||||
"revertBody": "<link>Desinstalar otimizações</link> reverte todas as alterações: remove os parâmetros IOMMU de <code>/etc/kernel/cmdline</code> ou GRUB, os módulos VFIO de <code>/etc/modules</code> e as entradas de bloqueio dos controladores, depois reconstrói initramfs. É necessário reiniciar para aplicar a reversão."
|
||||
},
|
||||
"related": {
|
||||
"heading": "Relacionado",
|
||||
"items": [
|
||||
{
|
||||
"label": "Adicionar GPU à VM (passthrough)",
|
||||
"href": "/docs/hardware/gpu-vm-passthrough",
|
||||
"tail": " — passo seguinte natural uma vez activado o IOMMU + VFIO."
|
||||
},
|
||||
{
|
||||
"label": "Adicionar Controlador ou NVMe ao VM",
|
||||
"href": "/docs/disk-manager/add-controller-nvme-vm",
|
||||
"tail": " — a mesma infra-estrutura de passagem para os controladores de armazenamento."
|
||||
},
|
||||
{
|
||||
"label": "Comandos de passagem GPU",
|
||||
"href": "/docs/help-info/gpu-commands",
|
||||
"tail": " — Referência da verificação IOMMU."
|
||||
},
|
||||
{
|
||||
"label": "Desinstalar otimizações",
|
||||
"href": "/docs/post-install/uninstall",
|
||||
"tail": " — reverter IOMMU / VFIO de forma limpa."
|
||||
},
|
||||
{
|
||||
"label": "Pós-instalação personalizável",
|
||||
"href": "/docs/post-install/customizable",
|
||||
"tail": " — voltar ao menu superior."
|
||||
}
|
||||
]
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,172 @@
|
||||
{
|
||||
"meta": {
|
||||
"title": "Automatický skript po inštalácii | Dokumentácia ProxMenux",
|
||||
"description": "Automatický skript ProxMenux po inštalácii vykoná na novom hostiteľovi Proxmox VE 14 vopred určených optimalizácií podľa hardvéru. Nemá zoznam funkcií na výber, no môže žiadať potvrdenie aktualizácie systému, odstránenia upozornenia na predplatné, niektorých inštalácií Log2RAM a reštartu. Vratné zmeny sa zaznamenajú na neskoršiu obnovu.",
|
||||
"ogTitle": "Automatický skript po inštalácii | Dokumentácia ProxMenux",
|
||||
"ogDescription": "14 vopred určených optimalizácií podľa hardvéru pre nový hostiteľ Proxmox VE, s potvrdením niektorých krokov a záznamom vratných zmien."
|
||||
},
|
||||
"header": {
|
||||
"title": "Automatický skript po inštalácii",
|
||||
"description": "ProxMenux vykoná 14 vopred určených základných optimalizácií bez zoznamu funkcií na výber. Niektoré kroky žiadajú potvrdenie. Vratné zmeny sa zaznamenajú pre Odinštalovať optimalizácie; aktualizácie balíkov sa neoznačujú za vratné.",
|
||||
"section": "Po inštalácii · Automatizovaná"
|
||||
},
|
||||
"intro": {
|
||||
"title": "Kedy vybrať automatizované",
|
||||
"body": "Spustite ho na čerstvo nainštalovanom hostiteľovi Proxmox, ak chcete rozumné základné nastavenie bez výberu každej funkcie. Skript je idempotentný: opakované spustenie znovu použije rovnakú konfiguráciu. Voliteľné funkcie (Fastfetch, IOMMU, repozitár Ceph, HA, opravy AMD…) zámerne <strong>nie sú</strong> súčasťou tohto postupu; v prípade potreby ich vyberte v <link>Prispôsobiteľné</link>."
|
||||
},
|
||||
"applies": {
|
||||
"heading": "Čo skript nastaví",
|
||||
"intro": "Optimalizácia sa uplatňuje v tomto presnom poradí. Stĺpec <em>Kategória</em> odkazuje na podrobnú dokumentáciu každej zmeny v prispôsobiteľnom odkaze.",
|
||||
"headerNum": "#",
|
||||
"headerTool": "Nástroj",
|
||||
"headerWhat": "Čo to robí?",
|
||||
"headerCategory": "Kategória"
|
||||
},
|
||||
"optimizations": [
|
||||
{
|
||||
"tool": "Repozitáre APT + úplná aktualizácia",
|
||||
"what": "Zakáže podnikové zdroje pve-enterprise.sources a ceph.sources, vytvorí čistý zdroj no-subscription pre kódový názov Debianu na hostiteľovi a spustí apt update && apt full-upgrade -y, čo je oficiálny príkaz Proxmoxu na aktualizáciu.",
|
||||
"category": "Základné nastavenia",
|
||||
"categorySlug": "basic-settings"
|
||||
},
|
||||
{
|
||||
"tool": "Odstránenie upozornenia na predplatné",
|
||||
"what": "Upraví webové rozhranie, aby skrylo upozornenie „Žiadne platné predplatné“. Pred použitím žiada potvrdenie; zmenu možno vrátiť cez Odinštalovať optimalizácie.",
|
||||
"category": "Prispôsobenie",
|
||||
"categorySlug": "customization"
|
||||
},
|
||||
{
|
||||
"tool": "Vynútiť IPv4",
|
||||
"what": "Zapíše /etc/apt/apt.conf.d/99-force-ipv4, aby apt používal iba IPv4 a obišiel nestabilné IPv6 spojenia so zrkadlami.",
|
||||
"category": "Sieť",
|
||||
"categorySlug": "network"
|
||||
},
|
||||
{
|
||||
"tool": "Preskočiť jazykové balíky",
|
||||
"what": "Zapíše /etc/apt/apt.conf.d/99-disable-translations, aby sa nesťahovali indexy preložených opisov balíkov a znížil sa objem dát pri aktualizáciách apt.",
|
||||
"category": "Základné nastavenia",
|
||||
"categorySlug": "basic-settings"
|
||||
},
|
||||
{
|
||||
"tool": "Zvýšiť systémové limity",
|
||||
"what": "Zvýši počet sledovaní inotify, limity nofile/nproc, limity zväzku kľúčov jadra a fs.file-max cez sysctl.d, limits.d, pam a systemd na hodnoty vhodné pre hostiteľov s mnohými kontajnermi.",
|
||||
"category": "Systém",
|
||||
"categorySlug": "system"
|
||||
},
|
||||
{
|
||||
"tool": "Ladenie pamäte",
|
||||
"what": "Nastaví vm.swappiness=10, vyvážené podiely zmenených nezapísaných stránok, vm.max_map_count=262144 a proaktívnu kompaktáciu, ak je podporovaná. Politika prideľovania pamäte nad dostupnú kapacitu zostáva na predvolenej hodnote Proxmoxu.",
|
||||
"category": "Systém",
|
||||
"categorySlug": "system"
|
||||
},
|
||||
{
|
||||
"tool": "Správanie pri panike jadra",
|
||||
"what": "Nastaví reštart hostiteľa 10 sekúnd po panic / oops / hardlockup namiesto neobmedzeného zamrznutia.",
|
||||
"category": "Systém",
|
||||
"categorySlug": "system"
|
||||
},
|
||||
{
|
||||
"tool": "Ladenie sieťového zásobníka",
|
||||
"what": "Veľkosti vyrovnávacích pamätí TCP, posilnenie IPv4 (vypnuté presmerovania, rp_filter=2, vypnuté logovanie martian), lokálne porty 1024-65535, zisťovanie MTU TCP, RFC 1337 a skript /usr/local/sbin/proxmenux-fwbr-tune spúšťaný jednorazovou jednotkou systemd a pravidlom udev. Tým sa rp_filter=0 / log_martians=0 opätovne nastavia na fwbr*/fwln*/fwpr*/tap* vždy, keď ich Proxmox znovu vytvorí pri štarte/zastavení VM, reštarte alebo živej migrácii.",
|
||||
"category": "Sieť",
|
||||
"categorySlug": "network"
|
||||
},
|
||||
{
|
||||
"tool": "Prispôsobenie bashrc (root)",
|
||||
"what": "Farebné PS1, bežné aliasy (l/la/ll/ls/grep), história s časovými značkami a načítanie bash-completion, všetko v ohraničenom bloku PMX_CORE_BASHRC na jednoduché odstránenie.",
|
||||
"category": "Prispôsobenie",
|
||||
"categorySlug": "customization"
|
||||
},
|
||||
{
|
||||
"tool": "Log2RAM (prispôsobené pre SSD, automatické)",
|
||||
"what": "Znižuje opotrebenie SSD/NVMe presunom /var/log na ramdisk tmpfs s pravidelnou synchronizáciou na disk. Inštalácia z pôvodného projektu pri koreňovom disku SSD alebo NVMe. Veľkosť podľa RAM hostiteľa (128M / 256M / 512M), pravidelná synchronizácia a ochrana, ktorá pri 80% zaplnení vyčistí staré žurnály a pri 92% skráti rýchlo rastúce logy pred zápisom. Limity journald prispôsobí ramdisku. Podrobnosti v <link>Log2RAM</link>.",
|
||||
"category": "Úložisko",
|
||||
"categorySlug": "storage"
|
||||
},
|
||||
{
|
||||
"tool": "Autotrim ZFS (iba SSD)",
|
||||
"what": "Zapne zpool autotrim=on v každom poole ZFS, ktorého všetky vdev sú SSD/NVMe s podporou TRIM (kontroluje /sys/block/[dev]/queue/rotational a discard_granularity). Pooly s HDD automaticky vynechá. Na odinštalovanie zaznamená iba pooly skutočne zmenené cez ProxMenux; ručne zapnutý autotrim ponechá.",
|
||||
"category": "Úložisko",
|
||||
"categorySlug": "storage"
|
||||
},
|
||||
{
|
||||
"tool": "Limity veľkosti journald",
|
||||
"what": "Vynúti trvalé ukladanie, obmedzí SystemMaxUse=64M / RuntimeMaxUse=60M, zapne kompresiu a logovanie úrovne info potrebné pre Monitor. Pri aktívnom Log2RAM sa vynechá, pretože ten vykonáva vlastné úpravy.",
|
||||
"category": "Systém",
|
||||
"categorySlug": "system"
|
||||
},
|
||||
{
|
||||
"tool": "Ladenie logrotate",
|
||||
"what": "Globálne nastaví daily a potom size 10M, uchová 7 rotácií a zapne kompresiu aj copytruncate. Neskoršie veľkostné kritérium má prednosť; pravidlá konkrétnych logov ho môžu prepísať. Vhodné pre Log2RAM, no frekvencia závisí od pravidiel a časovača.",
|
||||
"category": "Systém",
|
||||
"categorySlug": "system"
|
||||
},
|
||||
{
|
||||
"tool": "Trvalé názvy rozhraní",
|
||||
"what": "Pre každú fyzickú sieťovú kartu zapíše <code>/etc/systemd/network/10-proxmenux-<iface>.link</code> s hlavičkou „Managed by ProxMenux“, ktorý priradí MAC k aktuálnemu názvu. Názvy <code>eth0</code> / <code>enp…</code> zostanú stabilné po reštarte aj pridaní kariet.",
|
||||
"category": "Sieť",
|
||||
"categorySlug": "network"
|
||||
}
|
||||
],
|
||||
"hardwareTitle": "Predvolené hodnoty podľa hardvéru",
|
||||
"hardwareBody": "Skript pred nastavením preskúma hardvér hostiteľa. Log2RAM sa predvolene inštaluje iba pri koreňovom disku SSD alebo NVMe; pri inej detekcii žiada potvrdenie. Veľkosť ramdisku sa vyberá podľa celkovej RAM (<code>≤ 8 GB → 128M</code>, <code>≤ 16 GB → 256M</code>, <code>'>' 16 GB → 512M</code>). Pri aktívnom Log2RAM sa limity journald prispôsobia ramdisku, aby sa nezaplnil.",
|
||||
"upgrade": {
|
||||
"heading": "Aktualizovať systém",
|
||||
"intro": "Prvým krokom automatického postupu je aktualizácia Proxmoxu. Oficiálny návod pre bežiaci hostiteľ v rámci rovnakej hlavnej verzie odporúča spustiť:",
|
||||
"after": "Tento riadok je oficiálny príkaz pre aktuálne verzie Proxmoxu. Automatický skript vykoná <strong>presne</strong> tento príkaz a pridá čistenie repozitárov a kroky po aktualizácii podľa oficiálneho návodu — rovnako ako samostatný nástroj <link>Aktualizácia systému Proxmox</link>:",
|
||||
"items": [
|
||||
"Zakáže podnikové zdroje <code>pve-enterprise.sources</code> / <code>ceph.sources</code>, odstráni staré súbory repozitárov a zapíše čistý zdroj bez predplatného pre kódový názov distribúcie hostiteľa.",
|
||||
"Spustí inováciu neinteraktívne pomocou <code>DEBIAN_FRONTEND=noninteractive</code> a <code>--force-confdef --force-confold</code> – konfiguračné súbory, ktoré ste si prispôsobili, zostanú vaše, aj keď ich upstream zmení.",
|
||||
"Nainštaluje základné balíky Proxmox, ak chýbajú (<code>zfsutils-linux</code>, <code>proxmox-backup-restore-image</code>, <code>chrony</code>).",
|
||||
"Kontrola konzistentnosti metadát LVM, <code>apt-get autoremove -y</code> + <code>apt-get autoclean -y</code> a výzva na reštart iba pri zmene jadra."
|
||||
],
|
||||
"sameTitle": "Rovnaká aktualizácia, dva vstupné body",
|
||||
"sameBody": "Automatický postup a samostatný nástroj <link>Aktualizácia systému Proxmox</link> používajú rovnaké skripty (<code>update-pve8.sh</code> / <code>update-pve9_2.sh</code>). Samostatný nástroj použite, ak chcete iba aktualizovať hostiteľa bez ostatných optimalizácií."
|
||||
},
|
||||
"endResult": {
|
||||
"heading": "Očakávaný konečný výsledok",
|
||||
"body": "Po skončení uvidíte správu o úspechu s výstupmi jednotlivých krokov a výzvu na reštart, ktorý vyžadujú niektoré nastavenia jadra. Reštart môžete odložiť; nastavenia sa prejavia pri ďalšom štarte.",
|
||||
"imageAlt": "Automatický skript po inštalácii – konečný výstup terminálu zobrazujúci každú úspešne aplikovanú optimalizáciu"
|
||||
},
|
||||
"notDoes": {
|
||||
"heading": "Čo tento skript nerobí",
|
||||
"items": [
|
||||
"Automatické zistenie časového pásma (v pôvodnom skripte je zakomentované; v prípade potreby použite Prispôsobiteľné).",
|
||||
"Zakázať portmapper / rpcbind (pozri <secLink>Zabezpečenie</secLink>).",
|
||||
"Povoliť IOMMU / VFIO (pozri <virtLink>Virtualizácia</virtLink>).",
|
||||
"Nainštalovať Fastfetch / Figurine / repozitár Ceph / HA / opravy CPU AMD (pozri <optLink>Voliteľné</optLink>).",
|
||||
"Nainštalovať pigz alebo naladiť ZFS ARC (pozri <perfLink>Výkon</perfLink> / <storLink>Úložisko</storLink>)."
|
||||
]
|
||||
},
|
||||
"xshokTitle": "Detekcia xshok-proxmox",
|
||||
"xshokBody": "Ak hostiteľ už spustil skript <code>xshok-proxmox</code>, ProxMenux rozpozná súbor označenia a pred pokračovaním vás upozorní. Niektoré úpravy sa môžu prekrývať. Doplnkový skript je zastaraný; ak napriek tomu pokračujete, prečítajte si <link>prehľad</link> so súvislosťami.",
|
||||
"revert": {
|
||||
"heading": "Vrátenie",
|
||||
"body": "Každý nástroj v tabuľke sa zaznamená v <code>/usr/local/share/proxmenux/installed_tools.json</code>. Otvorte <link>Odinštalovať optimalizácie</link> a vyberte položky na obnovu. Zálohy zmenených súborov sú vedľa originálov s príponou <code>.bak</code>."
|
||||
},
|
||||
"related": {
|
||||
"heading": "Súvisiace",
|
||||
"items": [
|
||||
{
|
||||
"label": "Prispôsobiteľné nastavenia po inštalácii",
|
||||
"href": "/docs/post-install/customizable",
|
||||
"tail": " — Vyberte si presne to, čo chcete z rovnakého katalógu."
|
||||
},
|
||||
{
|
||||
"label": "Odinštalovať optimalizácie",
|
||||
"href": "/docs/post-install/uninstall",
|
||||
"tail": " — vráťte vybrané zmeny z tohto postupu späť."
|
||||
},
|
||||
{
|
||||
"label": "Užitočné systémové príkazy",
|
||||
"href": "/docs/help-info/system-commands",
|
||||
"tail": " — overte zmeny (uptime, free, journalctl atď.)."
|
||||
},
|
||||
{
|
||||
"label": "Prehľad po inštalácii",
|
||||
"href": "/docs/post-install",
|
||||
"tail": "."
|
||||
}
|
||||
]
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,240 @@
|
||||
{
|
||||
"meta": {
|
||||
"title": "Po inštalácii: Základné nastavenia | Dokumentácia ProxMenux",
|
||||
"description": "Základné možnosti po inštalácii: prechod na repozitáre Proxmox bez predplatného a aktualizácia systému, zistenie časového pásma a zapnutie NTP, vynechanie prekladov APT a výber z 25 bežných systémových nástrojov na inštaláciu."
|
||||
},
|
||||
"header": {
|
||||
"title": "Po inštalácii: Základné nastavenia",
|
||||
"section": "Nastavenie Proxmoxu po inštalácii"
|
||||
},
|
||||
"intro": {
|
||||
"title": "Čo táto kategória zahŕňa",
|
||||
"body": "Päť základných možností pre nový hostiteľ Proxmox: prejsť na komunitné repozitáre bez predplatného, plne aktualizovať systém, automaticky nastaviť časové pásmo a NTP, vypnúť preklady APT na úsporu šírky pásma a disku a vybrať z 25 bežných nástrojov."
|
||||
},
|
||||
"upgrade": {
|
||||
"heading": "Aktualizovať systém",
|
||||
"intro": "Nastaví APT na bezplatný repozitár <em>pve-no-subscription</em> namiesto repozitára Enterprise s predplatným a plne aktualizuje systém. Presné kroky závisia od hlavnej verzie Proxmox VE; ProxMenux ju zistí a spustí správny skript.",
|
||||
"headerVersion": "PVE verzia",
|
||||
"headerScript": "Skript výberu podľa verzie",
|
||||
"headerCodename": "Kódové meno Debianu",
|
||||
"rows": [
|
||||
{
|
||||
"version": "9.x",
|
||||
"script": "update-pve9_2.sh",
|
||||
"codename": "trixie"
|
||||
},
|
||||
{
|
||||
"version": "8.x",
|
||||
"script": "update-pve8.sh",
|
||||
"codename": "bookworm"
|
||||
}
|
||||
],
|
||||
"officialTitle": "Oficiálne odporúčanie pre Proxmox",
|
||||
"officialBody": "Oficiálny návod Proxmox odporúča tieto príkazy v presnom poradí:",
|
||||
"officialOutro": "Toto je bežný príkaz pre aktualizácie v rámci nainštalovanej hlavnej verzie Proxmox VE. Skontrolujte repozitáre a navrhované zmeny balíkov <em>pred</em> pokračovaním. Prechod na inú hlavnú verziu vyžaduje oficiálny migračný postup.",
|
||||
"doesTitle": "Čo robí možnosť ProxMenux — overené podľa skriptu",
|
||||
"doesIntro": "Aktualizácia ProxMenux vykoná uvedené príkazy apt a pridá prípravné aj záverečné kroky, na ktoré by ste inak museli myslieť sami. Nasledujúce položky zodpovedajú výberovému skriptu; podrobnosti sú v <link>Aktualizácia systému Proxmox</link>.",
|
||||
"doesItems": [
|
||||
"<strong>Najprv poriadok v repozitároch.</strong> Zakáže podnikové zdroje <code>pve-enterprise.sources</code> / <code>ceph.sources</code>, odstráni staré súbory repozitárov z predchádzajúcich verzií PVE a vytvorí čistý <code>proxmox.sources</code> s bezplatným kanálom <em>pve-no-subscription</em> podľa kódového názvu Debianu na hostiteľovi: trixie pre PVE 9, bookworm pre PVE 8.",
|
||||
"<strong>Prepíše repozitáre Debian</strong> s main / updates / security a <code>non-free-firmware</code>, aby počas aktualizácie zmizlo upozornenie na firmvér.",
|
||||
"<strong>Spustí oficiálnu aktualizáciu.</strong> <code>apt-get update</code> a potom <code>apt full-upgrade -y</code> (PVE 9) alebo <code>apt dist-upgrade -y</code> (PVE 8), neinteraktívne s <code>--force-confdef --force-confold</code> na zachovanie upravených konfiguračných súborov.",
|
||||
"<strong>Nainštaluje základné balíky</strong>, ak chýbajú: <code>zfsutils-linux</code>, <code>proxmox-backup-restore-image</code>, <code>chrony</code>.",
|
||||
"<strong>Skontroluje metadáta LVM.</strong> Hľadá VM s priamo priradenými diskami, ktoré mohli na surové disky zapísať staré hlavičky fyzických zväzkov. Upozorní na nezrovnalosti bez automatickej opravy.",
|
||||
"<strong>Potom vyčistí:</strong> <code>apt-get autoremove -y</code> + <code>apt-get autoclean -y</code>, potom vyzve na reštart, ak jadro bolo aktualizované alebo <code>/var/run/reboot-required</code> je prítomný."
|
||||
],
|
||||
"shortTitle": "Stručne povedané",
|
||||
"shortBody": "Možnosť spustí odporúčaný príkaz <code>apt update && apt full-upgrade -y</code>, doplní úpravu repozitárov a záverečné čistenie uvedené v oficiálnom návode a ponúkne reštart. Pozrite <link>Aktualizácia systému Proxmox</link> s celým diagramom; rovnaký aktualizátor je samostatne dostupný v hlavnom menu.",
|
||||
"subTitle": "Nepoužívajte na hostiteľovi s predplatným",
|
||||
"subBody": "Ak máte predplatné Proxmox a chcete ponechať repozitáre Enterprise, túto možnosť vynechajte. Zakáže Enterprise a prepne hostiteľa na komunitný kanál. Aktualizácia balíkov ani prepísanie repozitárov sa nedajú vrátiť cez Odinštalovať optimalizácie. Neskoršiu zmenu kanála musíte vykonať úpravou konfigurácie repozitárov.",
|
||||
"safetyTitle": "Bezpečnostná kontrola po aktualizácii",
|
||||
"safetyBody": "Po aktualizácii skript hľadá staré metadáta fyzických zväzkov (PV) na diskoch. Môže k tomu dôjsť, keď VM s priamo priradeným diskom zapíše hlavičky LVM na surový disk. Pri podozrivom náleze zobrazí upozornenie a navrhne kontrolu cez <code>pvs</code>. Automaticky nič nemení."
|
||||
},
|
||||
"time": {
|
||||
"heading": "Automaticky synchronizovať čas",
|
||||
"intro": "Zistí verejnú IP adresu servera cez <code>dig myip.opendns.com @resolver1.opendns.com</code>, potom z <code>ipapi.co/'{'ip'}'/timezone</code> získa zodpovedajúce časové pásmo IANA a nastaví ho cez <code>timedatectl set-timezone</code>. Nakoniec zapne NTP cez <code>timedatectl set-ntp true</code>.",
|
||||
"depTitle": "Závisí od dvoch externých služieb",
|
||||
"depBody": "Vyhľadávanie závisí od dostupnosti OpenDNS a <code>ipapi.co</code> a od správnosti ich odpovedí. Ak spustíte Proxmox za VPN alebo na VLAN, ktorá vychádza z iného regiónu, automaticky zistené časové pásmo môže byť nesprávne. V takom prípade preskočte túto možnosť a nastavte časové pásmo ručne:",
|
||||
"revertTitle": "Reverzibilné z menu Odinštalovať",
|
||||
"revertBody": "<link>Odinštalovanie optimalizácií</link> obnoví časové pásmo na UTC (bezpečné predvolené nastavenie). Nezakáže NTP – vaše hodiny sa neustále synchronizujú, len sú ukotvené na UTC, kým manuálne nenastavíte nové časové pásmo."
|
||||
},
|
||||
"languages": {
|
||||
"heading": "Nesťahovať ďalšie jazyky",
|
||||
"intro": "Počas <code>apt update</code> môže APT okrem hlavných metadát sťahovať aj preklady opisov balíkov. Možnosť ich vypne na úsporu šírky pásma a miesta. Predtým ProxMenux <strong>overí, že miestne nastavenie hostiteľa je vygenerované</strong>: prečíta <code>/etc/default/locale</code> alebo <code>/etc/environment</code>, podľa potreby doplní <code>/etc/locale.gen</code> a spustí <code>locale-gen</code>. Miestne nastavenie shellu sa tak zachová.",
|
||||
"writtenTitle": "Čo sa napíše",
|
||||
"revertTitle": "Reverzibilné z menu Odinštalovať",
|
||||
"revertBody": "Odstraňovanie <code>/etc/apt/apt.conf.d/99-disable-translations</code> (buď manuálne, alebo z menu Odinštalovať) obnoví štandardné správanie a APT znovu stiahne jazykové súbory."
|
||||
},
|
||||
"utilities": {
|
||||
"heading": "Nainštalovať bežné systémové nástroje",
|
||||
"intro": "Otvorí zoznam <strong>25 vybraných nástrojov</strong> rozdelených do skupín. Vyberiete požadované nástroje a potvrdíte výber. ProxMenux ich nainštaluje cez <code>apt</code>, overí fungovanie balíkov a na konci zobrazí súhrn.",
|
||||
"imageAlt": "Výber systémových nástrojov ProxMenux: medzerník vyberá, Enter potvrdzuje",
|
||||
"reuseTitle": "Rovnaký zoznam je opätovne použitý inde",
|
||||
"reuseBody": "Katalóg 25 nástrojov má jedinú definíciu: <code>PROXMENUX_UTILS</code> v <code>scripts/global/utils-install-functions.sh</code>. Menu <em>Pomôcky a nástroje → Systémové nástroje</em> ponúka rovnaký zoznam na neskoršie inštalácie bez opakovania nastavení po inštalácii.",
|
||||
"listTitle": "Čo je v zozname?",
|
||||
"groups": [
|
||||
{
|
||||
"group": "Monitory systému",
|
||||
"items": [
|
||||
{
|
||||
"pkg": "htop",
|
||||
"desc": "Interaktívny prehliadač procesov"
|
||||
},
|
||||
{
|
||||
"pkg": "btop",
|
||||
"desc": "Moderný monitor zdrojov (CPU, RAM, disky, sieť, procesy)"
|
||||
},
|
||||
{
|
||||
"pkg": "s-tui",
|
||||
"desc": "Terminálové rozhranie na záťažové testy a sledovanie CPU"
|
||||
},
|
||||
{
|
||||
"pkg": "iftop",
|
||||
"desc": "Využitie šírky pásma pre každé spojenie v reálnom čase"
|
||||
},
|
||||
{
|
||||
"pkg": "iotop",
|
||||
"desc": "Diskové I/O podľa procesu"
|
||||
},
|
||||
{
|
||||
"pkg": "iptraf-ng",
|
||||
"desc": "Interaktívny monitor IP LAN"
|
||||
}
|
||||
]
|
||||
},
|
||||
{
|
||||
"group": "Sieť",
|
||||
"items": [
|
||||
{
|
||||
"pkg": "iperf3",
|
||||
"desc": "Meranie maximálnej dosiahnuteľnej šírky pásma medzi hostiteľmi"
|
||||
},
|
||||
{
|
||||
"pkg": "net-tools",
|
||||
"desc": "Staršie nástroje (ifconfig, netstat, route). Stále užitočné na rýchle kontroly"
|
||||
},
|
||||
{
|
||||
"pkg": "ipset",
|
||||
"desc": "Spravuje veľké množiny IP adries v jadre — užitočné pre pravidlá iptables/nftables"
|
||||
}
|
||||
]
|
||||
},
|
||||
{
|
||||
"group": "Sťahovanie a archívy",
|
||||
"items": [
|
||||
{
|
||||
"pkg": "axel",
|
||||
"desc": "Nenáročný akcelerátor paralelného sťahovania"
|
||||
},
|
||||
{
|
||||
"pkg": "aria2",
|
||||
"desc": "Sťahovanie z viacerých zdrojov a cez viac protokolov (HTTP, FTP, BitTorrent, Metalink)"
|
||||
},
|
||||
{
|
||||
"pkg": "unzip",
|
||||
"desc": "Rozbaliť archívy ZIP"
|
||||
},
|
||||
{
|
||||
"pkg": "zip",
|
||||
"desc": "Vytvoriť ZIP archívy"
|
||||
},
|
||||
{
|
||||
"pkg": "cabextract",
|
||||
"desc": "Rozbaliť archívy Microsoft CAB (užitočné pri súboroch ISO systému Windows)"
|
||||
},
|
||||
{
|
||||
"pkg": "wimtools",
|
||||
"desc": "Manipulovať obrazy Windows WIM (extrahovať, rozdeliť, pripojiť, použiť)"
|
||||
},
|
||||
{
|
||||
"pkg": "genisoimage",
|
||||
"desc": "Vytvárať obrazy ISO 9660 z adresára"
|
||||
}
|
||||
]
|
||||
},
|
||||
{
|
||||
"group": "Text a súbory",
|
||||
"items": [
|
||||
{
|
||||
"pkg": "dos2unix",
|
||||
"desc": "Previesť koncovky riadkov CRLF (Windows) na LF (Unix)"
|
||||
},
|
||||
{
|
||||
"pkg": "grc",
|
||||
"desc": "Univerzálne farebné zvýraznenie výstupu príkazov ping, traceroute, dig, tail a ďalších"
|
||||
},
|
||||
{
|
||||
"pkg": "plocate",
|
||||
"desc": "Rýchle indexované vyhľadávanie súborov. Po inštalácii spustite updatedb na vytvorenie indexu"
|
||||
}
|
||||
]
|
||||
},
|
||||
{
|
||||
"group": "Vzdialený prístup a relácie",
|
||||
"items": [
|
||||
{
|
||||
"pkg": "sshpass",
|
||||
"desc": "Neinteraktívne overenie SSH heslom (užitočné pre skripty, nie na každodenné používanie)"
|
||||
},
|
||||
{
|
||||
"pkg": "tmux",
|
||||
"desc": "Terminálový multiplexer: odpojenie relácií, rozdelenie panelov a zachovanie relácií pri strate spojenia"
|
||||
}
|
||||
]
|
||||
},
|
||||
{
|
||||
"group": "Hardvér a nízkoúrovňové nástroje",
|
||||
"items": [
|
||||
{
|
||||
"pkg": "msr-tools",
|
||||
"desc": "Čítať a zapisovať registre špecifické pre model CPU (rdmsr, wrmsr)"
|
||||
},
|
||||
{
|
||||
"pkg": "intel-gpu-tools",
|
||||
"desc": "Intel GPU diagnostické pomôcky vrátane `intel_gpu_top`"
|
||||
}
|
||||
]
|
||||
},
|
||||
{
|
||||
"group": "Virtualizácia",
|
||||
"items": [
|
||||
{
|
||||
"pkg": "libguestfs-tools",
|
||||
"desc": "Kontrolovať a upravovať obrazy diskov VM (virt-ls, virt-cat, guestmount…)"
|
||||
},
|
||||
{
|
||||
"pkg": "chntpw",
|
||||
"desc": "Upravovať Windows SAM (užitočné na obnovenie hesiel v prevzatých Windows VM)"
|
||||
}
|
||||
]
|
||||
}
|
||||
],
|
||||
"actionTitle": "Niekoľko z nich v akcii",
|
||||
"noBulkTitle": "Odstránia sa iba nástroje nainštalované cez ProxMenux",
|
||||
"noBulkBody": "ProxMenux zaznamenáva iba vybrané balíky, ktoré ešte neboli nainštalované. Voľba Odinštalovať optimalizácie ich úplne odstráni a ponechá pôvodné balíky. Aktualizácie APT nemajú bezpečný atómový návrat späť: odinštalovanie nástrojov nevráti aktualizáciu systému."
|
||||
},
|
||||
"related": {
|
||||
"heading": "Súvisiace",
|
||||
"items": [
|
||||
{
|
||||
"label": "Aktualizácia systému Proxmox",
|
||||
"href": "/docs/utils/system-update",
|
||||
"tail": " — Na požiadanie zopakuje cyklus apt update + dist-upgrade."
|
||||
},
|
||||
{
|
||||
"label": "Inštalátor systémových nástrojov",
|
||||
"href": "/docs/utils/system-utils",
|
||||
"tail": " — Nainštalovať alebo preinštalovať jednotlivé nástroje aj po nastavení po inštalácii."
|
||||
},
|
||||
{
|
||||
"label": "Príkazy na aktualizácie a balíky",
|
||||
"href": "/docs/help-info/update-commands",
|
||||
"tail": " — Prehľad apt pre shell."
|
||||
},
|
||||
{
|
||||
"label": "Prispôsobiteľné nastavenia po inštalácii",
|
||||
"href": "/docs/post-install/customizable",
|
||||
"tail": " — späť do nadradeného menu."
|
||||
}
|
||||
]
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,106 @@
|
||||
{
|
||||
"meta": {
|
||||
"title": "Prispôsobiteľný skript po inštalácii | Dokumentácia ProxMenux",
|
||||
"description": "Vyberte presne tie optimalizácie, ktoré má ProxMenux použiť na hostiteľovi Proxmox VE. 10 kategórií, približne 35 nástrojov a výber pomocou zaškrtávacích políčok. Obsahuje všetko z automatizovaného skriptu aj voliteľné funkcie (IOMMU, Fastfetch, Figurine, Ceph, HA, opravy AMD…).",
|
||||
"ogTitle": "Prispôsobiteľný skript po inštalácii | Dokumentácia ProxMenux",
|
||||
"ogDescription": "10 kategórií, približne 35 jednotlivých optimalizácií. Vyberte presne to, čo chcete na hostiteľovi Proxmox VE. Vratné zmeny sa zaznamenávajú."
|
||||
},
|
||||
"header": {
|
||||
"title": "Prispôsobiteľný post-inštalačný skript",
|
||||
"description": "Vyberte presne tie optimalizácie, ktoré chcete použiť na hostiteľovi Proxmox VE. ProxMenux zoskupuje približne 35 nástrojov do 10 kategórií v jednom výberovom dialógu. Rovnaký základ ako Automatizované, ale s úplnou kontrolou nad použitými zmenami.",
|
||||
"section": "Po inštalácii · Prispôsobiteľné"
|
||||
},
|
||||
"intro": {
|
||||
"title": "Kedy vybrať prispôsobiteľné",
|
||||
"body": "Vyberte túto cestu, ak už poznáte požadované alebo nechcené úpravy hostiteľa. Výberový zoznam zoskupený podľa kategórií umožňuje vopred vyberať, rušiť výber a kombinovať optimalizácie. Položky možno neskôr použiť znovu a vratné zmeny sa zaznamenávajú pre <link>Odinštalovať optimalizácie</link>. Aktualizácie balíkov sa neuvádzajú ako vratné."
|
||||
},
|
||||
"compare": {
|
||||
"heading": "Ako sa porovnáva s Automatizovaným",
|
||||
"body": "Prispôsobiteľné obsahuje celý <link>automatizovaný skript</link>: rovnakých 14 základných optimalizácií a množstvo voliteľných položiek, ktoré Automatizované zámerne vynecháva. Sú užitočné pre konkrétny hardvér (opravy AMD), hosting (OVH RTM) alebo záťaže (IOMMU/VFIO, repozitár Ceph, vysoká dostupnosť, Fastfetch, Figurine, ladenie ARC ZFS, pigz, automatické snímky ZFS, rýchlostné limity vzdump, Open vSwitch, TCP BBR…)."
|
||||
},
|
||||
"categoriesSection": {
|
||||
"heading": "10 kategórií",
|
||||
"body": "Prispôsobiteľný skript zoskupuje optimalizácie do 10 kategórií v jednom výberovom dialógu. Každá kategória má vlastnú stránku dokumentácie — otvorte kartu nižšie pre zdôvodnenie, predvolené hodnoty a overovacie kroky jednotlivých možností."
|
||||
},
|
||||
"categories": [
|
||||
{
|
||||
"name": "Základné nastavenia",
|
||||
"description": "Vyčistí zdroje APT, spustí oficiálnu aktualizáciu Proxmox a nastaví časové pásmo, miestne nastavenia a bežné nástroje. Základ všetkých ostatných skupín."
|
||||
},
|
||||
{
|
||||
"name": "Systém",
|
||||
"description": "Vyladí záznamový subsystém a limity jadra pre hostiteľa s mnohými VM a kontajnermi. Zahŕňa journald, logrotate, sysctl (pamäť, limity súborov), správanie pri kernel panic a rýchle reštarty."
|
||||
},
|
||||
{
|
||||
"name": "Virtualizácia",
|
||||
"description": "Pripraví hostiteľa na pokročilú virtualizáciu. Nainštaluje zodpovedajúceho hosťovského agenta, ak samotný Proxmox beží v podporovanej VM, a povolí IOMMU/VFIO na priame priradenie PCI zariadení GPU, radičov a TPU."
|
||||
},
|
||||
{
|
||||
"name": "Sieť",
|
||||
"description": "Posilní a vyladí sieťový stack hostiteľa. Vynúti IPv4 pre APT, použije bezpečnostné nastavenia sysctl a ladenie vyrovnávacích pamätí TCP, ponúkne Open vSwitch, TCP BBR a TCP Fast Open a priradí trvalé názvy rozhraní k MAC adresám."
|
||||
},
|
||||
{
|
||||
"name": "Úložisko",
|
||||
"description": "Nastaví bežné úložné subsystémy Proxmox: veľkosť ARC ZFS, automatické snímky ZFS, autotrim ZFS pre pooly SSD/NVMe a rýchlostné limity vzdump proti vyťaženiu diskov pri zálohovaní."
|
||||
},
|
||||
{
|
||||
"name": "Zabezpečenie",
|
||||
"description": "Zmenší predvolene vystavenú útočnú plochu. Vypne služby RPC portmapper/rpcbind, ktoré Proxmox nepotrebuje, ale ponecháva načúvať."
|
||||
},
|
||||
{
|
||||
"name": "Prispôsobenie",
|
||||
"description": "Zmení vzhľad a prostredie shellu hostiteľa: farby a aliasy v bashrc, banner MOTD a odstránenie upozornenia na predplatné vo webovom rozhraní."
|
||||
},
|
||||
{
|
||||
"name": "Monitorovanie",
|
||||
"description": "Integruje hostiteľa s OVH Real-Time Monitoring. RTM sa nainštaluje iba pri zistení servera OVH; na iných hostiteľoch možnosť nič nemení."
|
||||
},
|
||||
{
|
||||
"name": "Výkon",
|
||||
"description": "Zrýchli kompresiu pri zálohách a prenosoch nahradením gzip jeho paralelnou alternatívou pigz."
|
||||
},
|
||||
{
|
||||
"name": "Voliteľné",
|
||||
"description": "Špecializované možnosti, ktoré nepotrebuje každý hostiteľ: opravy CPU AMD, banner Fastfetch, 3D názov hostiteľa Figurine, aktualizácia indexu PVE Appliance Manager, repozitár Ceph, služby vysokej dostupnosti, Log2RAM na zníženie opotrebenia SSD a swapový profil ZRAM."
|
||||
}
|
||||
],
|
||||
"mixTip": {
|
||||
"title": "Kombinujte Automatizované a Prispôsobiteľné",
|
||||
"body": "Bežný postup: najprv spustite <strong>Automatizované</strong> pre rozumné základné nastavenia, potom otvorte <strong>Prispôsobiteľné</strong> a vyberte iba potrebné voliteľné nástroje, napríklad IOMMU pre priame priradenie GPU. Zmeny sa sledujú nezávisle; menu Odinštalovať zobrazí všetko použité bez ohľadu na zvolenú cestu."
|
||||
},
|
||||
"related": {
|
||||
"heading": "Súvisiace",
|
||||
"items": [
|
||||
{
|
||||
"label": "Automatizované nastavenia po inštalácii",
|
||||
"href": "/docs/post-install/automated",
|
||||
"tail": " — rozumné predvolené nastavenia použité bez otázok."
|
||||
},
|
||||
{
|
||||
"label": "Odinštalovať optimalizácie",
|
||||
"href": "/docs/post-install/uninstall",
|
||||
"tail": " — čisto vrátiť vybrané zmeny."
|
||||
},
|
||||
{
|
||||
"label": "Základné nastavenia",
|
||||
"href": "/docs/post-install/basic-settings",
|
||||
"tail": " — repozitáre, čas, jazyk a nástroje."
|
||||
},
|
||||
{
|
||||
"label": "Virtualizácia",
|
||||
"href": "/docs/post-install/virtualization",
|
||||
"tail": " — IOMMU + VFIO na priame priradenie zariadení."
|
||||
},
|
||||
{
|
||||
"label": "Zabezpečenie",
|
||||
"href": "/docs/post-install/security",
|
||||
"tailRich": " · <storageLink>Úložisko</storageLink> · <networkLink>Sieť</networkLink> · <customLink>Prispôsobenie</customLink> — ďalšie kategórie."
|
||||
},
|
||||
{
|
||||
"label": "Prehľad po inštalácii",
|
||||
"href": "/docs/post-install",
|
||||
"tail": "."
|
||||
}
|
||||
]
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,74 @@
|
||||
{
|
||||
"meta": {
|
||||
"title": "Po inštalácii: Prispôsobenie | Dokumentácia ProxMenux",
|
||||
"description": "Možnosti prispôsobenia v prispôsobiteľnom skripte ProxMenux po inštalácii: farebný prompt bash s užitočnými aliasmi, banner ProxMenux v MOTD a odstránenie upozornenia na predplatné z webového rozhrania Proxmox."
|
||||
},
|
||||
"header": {
|
||||
"title": "Po inštalácii: prispôsobenie",
|
||||
"description": "Vizuálne a praktické úpravy hostiteľa Proxmox. Spríjemnia používanie shellu a skryjú upozornenie na predplatné vo webovom rozhraní. Bashrc, MOTD aj banner predplatného sa zaznamenávajú a dajú sa obnoviť cez Odinštalovať.",
|
||||
"section": "Nastavenie Proxmoxu po inštalácii"
|
||||
},
|
||||
"intro": {
|
||||
"title": "Čo táto kategória zahŕňa",
|
||||
"body": "Tri malé nezávislé možnosti: <strong>farebný prompt bash s aliasmi</strong> pre shell root, jednoriadkový <strong>banner MOTD</strong> pri prihlásení cez SSH a odstránenie <strong>okna „Žiadne platné predplatné“</strong>, ktoré Proxmox zobrazuje pri každom prihlásení do webového rozhrania."
|
||||
},
|
||||
"bashrc": {
|
||||
"heading": "Prispôsobiť bashrc",
|
||||
"intro": "Vloží do <code>/root/.bashrc</code> pripravený blok s farebným promptom, históriou s časovými pečiatkami, bežnými aliasmi <code>ls</code> / <code>grep</code> a príkazom <code>source</code> na dopĺňanie bash. Spríjemní prácu cez SSH a pri viacerých otvorených kartách jasne ukáže aktuálneho hostiteľa.",
|
||||
"writesTitle": "Čo ProxMenux pridáva do .bashrc",
|
||||
"writesOutro": "Blok je ohraničený značkami <code>PMX_CORE_BASHRC</code>. Opätovné spustenie nahradí predchádzajúci blok bez duplikovania. Pôvodný <code>.bashrc</code> sa raz zálohuje do <code>/root/.bashrc.bak</code> a do <code>/root/.bash_profile</code> sa pridá riadok <code>source /root/.bashrc</code>, aby sa prompt použil aj v prihlasovacích shelloch, napríklad po <code>su -</code>.",
|
||||
"rootTitle": "Platí iba pre root",
|
||||
"rootBody": "Prispôsobenie sa týka shellu účtu root. Ostatní používatelia hostiteľa si ponechajú svoje predvolené nastavenia. Ak spravujete Proxmox výhradne cez webové rozhranie a shell nepoužívate, túto čisto estetickú možnosť môžete vynechať."
|
||||
},
|
||||
"motd": {
|
||||
"heading": "Nastaviť vlastnú MOTD správu",
|
||||
"intro": "Pridá <em>\"This system is optimised by: ProxMenux\"</em> na začiatok <code>/etc/motd</code>, správy po úspešnom prihlásení cez SSH, nad promptom a pred skriptmi <code>update-motd</code>. Neškodné a čisto informatívne — rýchle vizuálne potvrdenie použitia ProxMenux na hostiteľovi.",
|
||||
"writesTitle": "Čo píše ProxMenux",
|
||||
"writesOutro": "Pri prvom použití ProxMenux zaznamená, či <code>/etc/motd</code> existoval, a uloží pôvodný obsah pod <code>/usr/local/share/proxmenux</code>. Operácia je idempotentná: ak riadok so značkou už existuje, nič sa nepridá. Staršie inštalácie s <code>/etc/motd.bak</code> sa prevedú do rovnakého vratného stavu."
|
||||
},
|
||||
"banner": {
|
||||
"heading": "Odstrániť hlásenie o predplatnom",
|
||||
"intro": "Odstráni okno <em>„Nemáte platné predplatné pre tento server“</em>, ktoré sa zobrazuje pri každom prihlásení do webového rozhrania Proxmox bez predplatného Enterprise. ProxMenux zohľadňuje verziu a spustí správny skript pre odlišné balíky rozhrania hlavných verzií.",
|
||||
"versionTitle": "Výber skriptu podľa verzie",
|
||||
"versionItems": [
|
||||
"<strong>PVE 9.x</strong> → spúšťa <code>remove-banner-pve-v3.sh</code> (opravuje desktop <code>proxmoxlib.js</code> aj nový mobilný UI založený na Yew).",
|
||||
"<strong>PVE 8.x</strong> → spustí <code>remove-banner-pve8.sh</code> (iba pre počítač)."
|
||||
],
|
||||
"versionOutro": "Pred úpravou ProxMenux zálohuje pôvodné súbory JS/šablón do <code>/usr/local/share/proxmenux/backups/</code> s časovou pečiatkou. Odinštalovanie ich obnoví zo záloh; ak záloha chýba alebo je poškodená, preinštaluje balíky rozhrania Proxmox.",
|
||||
"breakTitle": "Môže sa zlomiť po aktualizáciách Proxmoxu",
|
||||
"breakBody": "Aktualizácie rozhrania Proxmox pravidelne prepisujú <code>proxmoxlib.js</code>, takže upozornenie sa môže vrátiť. Túto možnosť môžete použiť znovu na opätovnú úpravu súboru alebo dovtedy ponechať upozornenie. ProxMenux inštaluje aj hook APT na automatické opakovanie úpravy po aktualizácii balíkov — jeho odstránenie opisuje <link>Odinštalovať optimalizácie</link>.",
|
||||
"legalTitle": "Právne upozornenie (vždy stojí za to zopakovať)",
|
||||
"legalBody": "Táto možnosť iba skryje upozornenie rozhrania. <strong>Neposkytuje</strong> podporu Enterprise ani prístup k repozitáru Enterprise a nemení licenciu softvéru. Proxmox VE sa vydáva pod GNU AGPLv3. Predplatné podporuje projekt a umožňuje prístup ku kanálu aktualizácií Enterprise; vyberte si podporu vhodnú pre svoje prostredie."
|
||||
},
|
||||
"verify": {
|
||||
"heading": "Overenie",
|
||||
"intro": "Po uplatnení všetkých troch:",
|
||||
"reversibleTitle": "Všetky tri zmeny prispôsobenia sú sledované",
|
||||
"reversibleBody": "<link>Odinštalovať optimalizácie</link> obnoví <code>/root/.bashrc</code>, vráti presný obsah MOTD spred ProxMenux alebo súbor odstráni, ak predtým neexistoval, a obnoví upravené súbory rozhrania zo zálohy alebo podľa potreby preinštaluje príslušné balíky Proxmox."
|
||||
},
|
||||
"related": {
|
||||
"heading": "Súvisiace",
|
||||
"items": [
|
||||
{
|
||||
"label": "Voliteľné",
|
||||
"href": "/docs/post-install/optional",
|
||||
"tail": " — Fastfetch a Figurine, ďalšie vizuálne úpravy."
|
||||
},
|
||||
{
|
||||
"label": "Zobraziť informácie o verzii",
|
||||
"href": "/docs/settings/show-version-information",
|
||||
"tail": " — potvrdí, že prispôsobenia sú registrované ako nainštalované."
|
||||
},
|
||||
{
|
||||
"label": "Odinštalovať optimalizácie",
|
||||
"href": "/docs/post-install/uninstall",
|
||||
"tail": " — obnoviť bashrc, motd a upozornenie na predplatné."
|
||||
},
|
||||
{
|
||||
"label": "Prispôsobiteľné nastavenia po inštalácii",
|
||||
"href": "/docs/post-install/customizable",
|
||||
"tail": " — späť do nadradeného menu."
|
||||
}
|
||||
]
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,106 @@
|
||||
{
|
||||
"meta": {
|
||||
"title": "Skript po inštalácii Proxmox VE — Automatizovaný a prispôsobiteľný | ProxMenux",
|
||||
"description": "Prehľad skriptov ProxMenux po inštalácii Proxmox VE. Automatizovaný skript použije rozumné predvolené nastavenia bez otázok. Prispôsobiteľný skript umožní presný výber z 10 kategórií. Odinštalovať optimalizácie obnoví podporované vratné zmeny.",
|
||||
"ogTitle": "Skript po inštalácii Proxmox VE — Automatizovaný a prispôsobiteľný",
|
||||
"ogDescription": "Použite bežné optimalizácie po inštalácii Proxmox VE v 10 kategóriách — automaticky alebo podľa výberu, s vratnými možnosťami.",
|
||||
"twitterTitle": "Skript po inštalácii Proxmox VE | ProxMenux",
|
||||
"twitterDescription": "Automatizované a prispôsobiteľné optimalizácie po inštalácii Proxmox VE s vratnými možnosťami."
|
||||
},
|
||||
"header": {
|
||||
"title": "Skripty po inštalácii",
|
||||
"description": "Nakonfigurujte čerstvo nainštalovaný hostiteľ Proxmox VE pomocou optimalizácií ProxMenux. Automaticky použite základné nastavenia, vyberte jednotlivé možnosti, aktualizujte nainštalované funkcie alebo obnovte podporované vratné zmeny. Aktualizácie balíkov sa neuvádzajú ako vratné.",
|
||||
"section": "Nastavenie Proxmoxu po inštalácii"
|
||||
},
|
||||
"intro": {
|
||||
"title": "Na čo je toto menu",
|
||||
"body": "Hneď po inštalácii Proxmox VE môžu desiatky drobných zmien zrýchliť hostiteľa a zjednodušiť jeho údržbu: repozitáre bez predplatného, rozumné limity journald a vyrovnávacie pamäte TCP, ukladanie záznamov šetrné k SSD, vylepšenia bashrc a ďalšie. ProxMenux ich automatizuje a sleduje podporované vratné zmeny konfigurácie."
|
||||
},
|
||||
"openingMenu": {
|
||||
"heading": "Otvorenie menu",
|
||||
"body": "V hlavnom menu ProxMenux vyberte <strong>Nastavenie Proxmoxu po inštalácii</strong>. Zobrazí sa toto:",
|
||||
"imageAlt": "Ponuka Skripty po inštalácii – Automatizované, Prispôsobiteľné, podmienené Použiť dostupné aktualizácie (iba keď čakajú aktualizácie) a Odinštalovať, po ktorej nasleduje sekcia Komunitné skripty"
|
||||
},
|
||||
"threeWays": {
|
||||
"heading": "Štyri spôsoby, ako uplatniť optimalizáciu",
|
||||
"body": "Štyri položky ProxMenux používajú rovnaký kód aj register nainštalovaných nástrojov, ale poskytujú rôznu mieru ovládania. <em>Aplikovať dostupné aktualizácie</em> sa zobrazí iba vtedy, keď má aspoň jedna nainštalovaná optimalizácia na disku novšiu verziu než registrovanú. Na čerstvo nakonfigurovanom hostiteľovi zostáva skrytá."
|
||||
},
|
||||
"routes": [
|
||||
{
|
||||
"title": "Automatizované",
|
||||
"description": "Starostlivo vybraných 14 bezpečných a vždy užitočných optimalizácií, ktoré sa použijú postupne bez otázok. Dobrá predvolená voľba pre väčšinu používateľov.",
|
||||
"bullets": [
|
||||
"Repozitáre bez predplatného + aktualizácia systému",
|
||||
"Pamäť, jadro, sieťové ladenie",
|
||||
"Log2RAM (automatické zistenie SSD/NVMe)",
|
||||
"Journald + limity veľkosti logrotate",
|
||||
"Trvalé názvy rozhraní"
|
||||
]
|
||||
},
|
||||
{
|
||||
"title": "Prispôsobiteľné",
|
||||
"description": "Približne 35 jednotlivých optimalizácií v 10 kategóriách. Presne si vyberiete, ktoré sa použijú. Rovnaký základ ako Automatizované, ale s úplnou kontrolou.",
|
||||
"bullets": [
|
||||
"Výberový zoznam so zaškrtávacími políčkami pre každú kategóriu",
|
||||
"Obsahuje všetko z Automatizované a navyše výslovne voliteľné položky (IOMMU, Fastfetch, Figurine, Ceph, HA, opravy AMD…)",
|
||||
"Spustite ho ľubovoľne veľakrát — zmeny sú idempotentné"
|
||||
]
|
||||
},
|
||||
{
|
||||
"title": "Aplikovať dostupné aktualizácie",
|
||||
"description": "Keď má optimalizácia po inštalácii (Log2Ram, nastavenia pamäte, Logrotate…) na disku novšiu verziu než tú registrovanú na hostiteľovi, položka zobrazí iba zmenené optimalizácie. Znovu spustí príslušnú funkciu a aktualizuje register — ničoho iného sa nedotkne.",
|
||||
"bullets": [
|
||||
"Výslovný výber každej optimalizácie, iba zmenených",
|
||||
"Rovnaký výber je dostupný z prehľadu Monitor",
|
||||
"Jedno súhrnné oznámenie pri dostupnosti nových aktualizácií"
|
||||
]
|
||||
},
|
||||
{
|
||||
"title": "Odinštalovať optimalizácie",
|
||||
"description": "Podporované vratné zmeny sa sledujú v registri JSON a majú priradenú funkciu obnovy. Akcie bez bezpečného vrátenia, napríklad úplná aktualizácia balíkov, sú zámerne vylúčené.",
|
||||
"bullets": [
|
||||
"Odhaľuje predtým aplikovanú optimalizáciu automaticky",
|
||||
"Pre každú položku vyberie správny postup obnovy: obnoví zálohu .bak, ak bola vytvorená, odstráni konfiguračný úryvok sysctl.d, ak nebolo čo zálohovať, alebo znovu nainštaluje pôvodný balík s --force-confnew (napríklad pri upozornení na predplatné)",
|
||||
"Výzva na reštart podľa potreby (VFIO, trvalé názvy atď.)"
|
||||
]
|
||||
}
|
||||
],
|
||||
"whichTitle": "Ktorý by si si mal vybrať?",
|
||||
"whichBody": "Pri novej inštalácii Proxmox s rozumnými základnými nastaveniami bez rozhodovania vyberte <autoLink><strong>Automatizované</strong></autoLink>. Ak už poznáte požadované alebo nechcené úpravy: <customLink><strong>Prispôsobiteľné</strong></customLink>. Na aktualizáciu iba už použitej optimalizácie s novšou verziou na disku: <updatesLink><strong>Aplikovať dostupné aktualizácie</strong></updatesLink>. Na čisté vrátenie predchádzajúcich zmien: <uninstallLink><strong>Odinštalovať optimalizácie</strong></uninstallLink>. Možnosti možno kombinovať: najprv Automatizované, potom pridať Fastfetch či IOMMU cez Prispôsobiteľné a neskôr vrátiť jednotlivé položky.",
|
||||
"mixing": {
|
||||
"heading": "Miešanie s inými postinštalačnými skriptmi",
|
||||
"stackTitle": "Nekombinujte viacero skriptov po inštalácii",
|
||||
"stackBody": "Spustenie viacerých skriptov po inštalácii na rovnakom hostiteľovi môže vytvoriť duplicitné konfiguračné súbory, konfliktné položky sysctl alebo dokonca nefunkčnú sieť po reštarte. Ak ste už použili <strong>Helper-Scripts Post Install</strong>, niektoré optimalizácie ProxMenux sa môžu prekrývať s jeho konfiguráciou. Používajte jeden nástroj po inštalácii na hostiteľa.",
|
||||
"xshokTitle": "xshok-proxmox: deprekovaný",
|
||||
"xshokBody": "Staršie verzie ProxMenux uvádzali <a>xshok-proxmox</a> ako doplnkový nástroj po inštalácii. Projekt je už zastaraný a ProxMenux ho neponúka. Ak predchádzajúce spustenie zanechalo značky na hostiteľovi, ProxMenux ich stále zistí a upozorní vás. Dnes ho však nemáte inštalovať popri ProxMenux."
|
||||
},
|
||||
"community": {
|
||||
"heading": "Komunitné skripty",
|
||||
"body": "Menu ponúka aj dva skripty tretích strán z projektu <a>community-scripts</a>: <em>Proxmox VE Post Install</em> a <em>Proxmox VE Microcode</em>. Ide o obaly, ktoré stiahnu a spustia pôvodné autorské skripty cez <code>wget | bash</code>. ProxMenux ich neudržiava. Pred spustením si pozrite podrobnosti a otázky dôvery v časti <link>Externé repozitáre</link>."
|
||||
},
|
||||
"related": {
|
||||
"heading": "Súvisiace",
|
||||
"items": [
|
||||
{
|
||||
"label": "Aktualizácia systému Proxmox",
|
||||
"href": "/docs/utils/system-update",
|
||||
"tail": " — udržiava hostiteľa aktuálneho po nastavení po inštalácii."
|
||||
},
|
||||
{
|
||||
"label": "Zabezpečenie",
|
||||
"href": "/docs/security",
|
||||
"tail": " — Fail2Ban + Lynis navyše k posilneniu zabezpečenia po inštalácii."
|
||||
},
|
||||
{
|
||||
"label": "Zobraziť informácie o verzii",
|
||||
"href": "/docs/settings/show-version-information",
|
||||
"tail": " — Pozrite sa, ktoré komponenty po inštalácii sú sledované ako nainštalované."
|
||||
},
|
||||
{
|
||||
"label": "Príkazy na aktualizácie a balíky",
|
||||
"href": "/docs/help-info/update-commands",
|
||||
"tail": " — Referencie pre apt / pveupgrade."
|
||||
}
|
||||
]
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,56 @@
|
||||
{
|
||||
"meta": {
|
||||
"title": "Po inštalácii: Sledovanie | Dokumentácia ProxMenux",
|
||||
"description": "Možnosti sledovania v prispôsobiteľnom skripte ProxMenux po inštalácii. Zatiaľ jediná možnosť: inštalácia OVH Real-Time Monitoring (RTM), ktorá sa vykoná iba po zistení, že hostiteľ je serverom OVH."
|
||||
},
|
||||
"header": {
|
||||
"title": "Po inštalácii: monitorovanie",
|
||||
"description": "Možnosti sledovania v prispôsobiteľnom skripte po inštalácii. Táto malá kategória je špecifická pre poskytovateľa: nainštaluje agenta OVH Real-Time Monitoring na dedikovaných serveroch OVH a inde nič nevykoná.",
|
||||
"section": "Nastavenie Proxmoxu po inštalácii"
|
||||
},
|
||||
"intro": {
|
||||
"title": "Zámerne úzky rozsah",
|
||||
"body": "Sledovanie po inštalácii sa obmedzuje na <strong>jedného agenta konkrétneho poskytovateľa</strong>. Všeobecné nástroje (Prometheus, Grafana, node_exporter) sem nepatria, pretože vyžadujú architektonické rozhodnutia o samostatnom hostiteľovi, uchovávaní údajov a cieľoch upozornení, ktoré sa nehodia do kroku na jedno kliknutie. ProxMenux Monitor, dodávaný s ProxMenux, pokrýva väčšinu tejto úlohy bez externého agenta."
|
||||
},
|
||||
"ovh": {
|
||||
"heading": "Inštalovať OVH monitorovanie v reálnom čase (RTM)",
|
||||
"intro": "Ak je hostiteľ Proxmox dedikovaný server prenajatý od <a>OVHcloud</a>, môžete povoliť RTM a sprístupniť hardvérovú telemetriu (teplota CPU, stav zdroja, SMART diskov, stav radiča RAID atď.) v ovládacom paneli OVH. Ide o rovnakého agenta, akého OVH používa pre funkciu „Server Monitoring“.",
|
||||
"decisionsTitle": "Ako sa rozhoduje ProxMenux",
|
||||
"decisionsItems": [
|
||||
"Získa verejnú IP adresu hostiteľa cez <code>curl ipinfo.io/ip</code>.",
|
||||
"Zistí vlastníckeho poskytovateľa pomocou dotazu <code>whois</code> na <code>v4.whois.cymru.com</code>.",
|
||||
"Ak výsledok uvádza OVH, stiahne <code>last-public-ovh-infra-yak.snap.mirrors.ovh.net/yak/archives/apply.sh</code> a cez rúru ho odovzdá <code>bash</code> s manifestom Puppet pre RTM v2.",
|
||||
"Ak výsledok <em>neuvádza</em> OVH, nič sa nenainštaluje. Možnosť nevykoná žiadne zmeny."
|
||||
],
|
||||
"remoteTitle": "Vzdialený skript odovzdaný cez rúru do bash",
|
||||
"remoteBody": "Inštalácia spustí <code>wget -qO - https://…apply.sh | bash</code>. Ak dôjde ku kompromitovaniu zrkadla OVH, skript sa na hostiteľovi vykoná ako root. Pred povolením zvážte dôveru v reťazec zrkadiel OVH oproti prínosu sledovania. Pre väčšinu domácich laboratórií a používateľov mimo OVH má možnosť zostať vypnutá.",
|
||||
"noOpTitle": "Povoliť iba vtedy, ak je hostiteľ skutočne na OVH",
|
||||
"noOpBody": "Na serveroch mimo OVH možnosť nič nemení, takže jej zaškrtnutie na domácom Proxmox nič nepokazí. Skript vypíše <em>„Nie je to server OVH, inštalácia RTM sa preskočí“</em> a ukončí sa bez inštalácie balíkov.",
|
||||
"runsTitle": "Čo ProxMenux spúšťa",
|
||||
"verifyTitle": "Overenie",
|
||||
"verifyBody": "Na skutočnom hostiteľovi OVH by sa po reštarte mal v OVH Manager zobraziť <a>prehľad RTM</a> s aktuálnymi údajmi hostiteľa. Na strane Proxmox je zberač RTM službou systemd — overte ju priamo:",
|
||||
"troubleTitle": "Riešenie problémov",
|
||||
"revertTitle": "Odstrániť RTM cez menu Odinštalovať",
|
||||
"revertBody": "Ak je RTM registrovaný ako nainštalovaný, Odinštalovať optimalizácie ponúkne položku OVH Real-Time Monitoring. Spustí <code>apt-get purge -y ''ovh-rtm*'' ''rtm'' ''rtm-*''</code>, odstráni /etc/rtm a označí RTM za odinštalovaný. Zvyšky Puppet môžu vyžadovať ručné čistenie; skontrolujte manifesty RTM v <code>/etc/puppet/</code>. Na hostiteľovi mimo OVH sa balíky RTM nenainštalovali, takže nie je čo odstrániť."
|
||||
},
|
||||
"related": {
|
||||
"heading": "Súvisiace",
|
||||
"items": [
|
||||
{
|
||||
"label": "ProxMenux Monitor",
|
||||
"href": "/docs/settings/proxmenux-monitor",
|
||||
"tail": " — lokálny webový prehľad hostiteľa, ktorý funguje u každého poskytovateľa, nielen OVH."
|
||||
},
|
||||
{
|
||||
"label": "Užitočné systémové príkazy",
|
||||
"href": "/docs/help-info/system-commands",
|
||||
"tail": " — referencia pre sledovanie lokálneho hostiteľa."
|
||||
},
|
||||
{
|
||||
"label": "Prispôsobiteľné nastavenia po inštalácii",
|
||||
"href": "/docs/post-install/customizable",
|
||||
"tail": " — späť do nadradeného menu."
|
||||
}
|
||||
]
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,128 @@
|
||||
{
|
||||
"meta": {
|
||||
"title": "Po inštalácii: Sieť | Dokumentácia ProxMenux",
|
||||
"description": "Sieťové možnosti prispôsobiteľného skriptu ProxMenux po inštalácii: vynútiť APT cez IPv4, použiť vybraný profil sysctl, nainštalovať Open vSwitch, zapnúť TCP BBR + Fast Open a priradiť názvy rozhraní k ich MAC adresám."
|
||||
},
|
||||
"header": {
|
||||
"title": "Po inštalácii: Sieť",
|
||||
"section": "Nastavenie Proxmoxu po inštalácii"
|
||||
},
|
||||
"intro": {
|
||||
"title": "Čo táto kategória zahŕňa",
|
||||
"body": "Päť nezávislých sieťových možností. Dve sú jednoduché (<strong>APT cez IPv4</strong>, <strong>inštalácia Open vSwitch</strong>), dve upravujú správanie TCP (<strong>sieťový profil sysctl</strong>, <strong>BBR + Fast Open</strong>) a jedna rieši častý prevádzkový problém: <strong>pevné priradenie názvov rozhraní</strong>, aby nová sieťová karta alebo aktualizácia BIOSu nepremenovala <code>enp3s0</code> na <code>enp4s0</code> a nenarušila mosty."
|
||||
},
|
||||
"ipv4": {
|
||||
"heading": "Prinútiť APT používať IPv4",
|
||||
"intro": "Píše <code>Acquire::ForceIPv4 \"true\";</code> na <code>/etc/apt/apt.conf.d/99-force-ipv4</code>. APT potom odmieta používať IPv6 na sťahovanie balíkov, aj keď má hostiteľ IPv6 pripojenie.",
|
||||
"tipTitle": "Kto má prospech",
|
||||
"tipBody": "Užitočné pri nestabilnom IPv6, pri nižšej rýchlosti oproti IPv4 alebo ak zrkadlo Debian/Proxmox občas cez IPv6 nefunguje. Hostiteľom bez IPv6 neprekáža. Vo funkčnej sieti s oboma protokolmi zaistí predvídateľné správanie: apt vás neprekvapí prekročením časového limitu IPv6."
|
||||
},
|
||||
"sysctl": {
|
||||
"heading": "Použiť sieťové optimalizácie",
|
||||
"intro": "Zapíše vybraný profil sysctl do <code>/etc/sysctl.d/99-network.conf</code>. Zahŕňa vyrovnávacie pamäte socketov jadra, posilnenie ICMP, základnú ochranu pred falšovaním adries a veľkosti vyrovnávacích pamätí TCP vhodné pre hypervízor s mnohými súbežnými tokmi.",
|
||||
"tunedTitle": "Čo sa upraví",
|
||||
"headerArea": "Oblasť",
|
||||
"headerSettings": "Kľúčové nastavenia",
|
||||
"rows": [
|
||||
{
|
||||
"area": "Vyrovnávacie pamäte socketov jadra",
|
||||
"settings": "<code>netdev_max_backlog=8192</code>, <code>rmem_max=16M</code>, <code>wmem_max=16M</code>, <code>somaxconn=8192</code>"
|
||||
},
|
||||
{
|
||||
"area": "Posilnenie ICMP",
|
||||
"settings": "<code>icmp_echo_ignore_broadcasts=1</code>, <code>icmp_ignore_bogus_error_responses=1</code>"
|
||||
},
|
||||
{
|
||||
"area": "Bezpečnosť smerovania",
|
||||
"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": "Filter spätnej cesty",
|
||||
"settings": "<code>rp_filter=2</code> (voľný režim, pozri poznámku nižšie)"
|
||||
},
|
||||
{
|
||||
"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": "Porty",
|
||||
"settings": "<code>ip_local_port_range=1024 65535</code> (rozsah dočasných portov)"
|
||||
},
|
||||
{
|
||||
"area": "Unixové sockety",
|
||||
"settings": "<code>net.unix.max_dgram_qlen=4096</code>"
|
||||
}
|
||||
],
|
||||
"sourceOutro": "Pridá tiež <code>source /etc/network/interfaces.d/*</code> do <code>/etc/network/interfaces</code>, ak tam ešte nie je. Ide o bežný postup umožňujúci pridávať samostatné konfiguračné súbory rozhraní bez úpravy hlavného súboru.",
|
||||
"fwbrTitle": "Automatické ladenie virtuálnych mostov firewallu",
|
||||
"fwbrBody": "Spolu s profilom sysctl ProxMenux nainštaluje pomocný skript <code>/usr/local/sbin/proxmenux-fwbr-tune</code>. Nastaví <code>rp_filter=0</code> a <code>log_martians=0</code> na rozhraniach <code>fwbr*</code> / <code>fwln*</code> / <code>fwpr*</code> / <code>tap*</code>, ktoré Proxmox vytvára pre VM a kontajnery. Jednorazová jednotka <code>proxmenux-fwbr-tune.service</code> ho spustí pri štarte a pravidlo <code>/etc/udev/rules.d/99-zz-proxmenux-fwbr-tune.rules</code> pri každej udalosti <code>net add</code> s týmito predponami. Zahŕňa aj rozhrania znovu vytvorené pri spustení/zastavení VM, reštarte a živej migrácii. Skript sa spustí aj hneď po inštalácii a spracuje už existujúce rozhrania.",
|
||||
"rpFilterTitle": "Prečo rp_filter=2 (voľný) namiesto 1 (prísny)",
|
||||
"rpFilterBody": "Prísny filter spätnej cesty zahadzuje pakety, ktorých zdroj by bol dostupný cez <em>iné</em> rozhranie. Je to vhodné predvolené nastavenie klienta, ale na hostiteľovi Proxmox môže narušiť sieť: prevádzka VM často prichádza cez most a odchádza cez uplink s asymetrickými trasami. <code>rp_filter=2</code> (voľný) zahadzuje iba pakety so skutočne nesmerovateľnými zdrojmi. Ide o kompromis: mierne nižšia detekcia falšovania lokálnej IP adresy výmenou za funkčnú sieť VM."
|
||||
},
|
||||
"ovs": {
|
||||
"heading": "Nainštalovať Open vSwitch",
|
||||
"intro": "Nainštaluje <code>openvswitch-switch</code> + <code>openvswitch-common</code>. Balíky pridajú OVS ako alternatívu k predvoleným linuxovým mostom Proxmoxu. Samotná inštalácia nemení sieť: existujúce mosty <code>vmbrX</code> fungujú ďalej. Pri <em>vytváraní</em> nového mosta v rozhraní Proxmox si môžete vybrať OVS zo zoznamu typov.",
|
||||
"tipTitle": "Keď OVS dáva zmysel",
|
||||
"tipBody": "Zvážte OVS, ak potrebujete <strong>VLAN trunking s nesúvislými VLAN ID</strong>, <strong>LACP s LLDP v špecifických režimoch</strong>, <strong>jemnozrnné programovanie toku</strong> (OpenFlow), alebo súčinnosť s radičmi SDN. Pre domáce laboratórium s niekoľkými sieťami VLAN a jedným uplinkom LACP, štandardné linuxové mosty + <code>vmbrX.VID</code> sú jednoduchšie a úplne v poriadku.",
|
||||
"revertTitle": "Reverzibilné z menu Odinštalovať",
|
||||
"revertBody": "OVS je zaznamenaný. <link>Odinštalovať optimalizácie</link> spustí <code>apt purge</code> pre <code>openvswitch-switch</code> a <code>openvswitch-common</code>. Mosty OVS migrujte späť na linuxové mosty <em>pred</em> odinštaláciou, inak ich VM pri ďalšom štarte stratia sieť. Ručný ekvivalent:"
|
||||
},
|
||||
"bbr": {
|
||||
"heading": "Povoliť TCP BBR + TCP Fast Open",
|
||||
"intro": "Zapíše dva súbory sysctl a znovu ich načíta. BBR nahradí CUBIC algoritmom riadenia preťaženia od Googlu založeným na šírke pásma, ktorý lepšie zvláda vysokokapacitné spoje s veľkou latenciou aj stratové spoje. TCP Fast Open (TFO) ušetrí jeden obojsmerný prenos pri opakovaných spojeniach TCP tým, že odošle dáta už v SYN.",
|
||||
"verifyTitle": "Overenie",
|
||||
"impactTitle": "Vplyv závisí od pracovného zaťaženia",
|
||||
"impactBody": "BBR vyniká na spojoch s vysokou latenciou alebo stratami paketov (medzikontinentálna replikácia, tunely VPN, mobilní klienti). V LAN medzi dvoma počítačmi na rovnakom prepínači býva rozdiel v rámci šumu merania. TFO najviac pomáha krátkym opakovaným spojeniam HTTP.",
|
||||
"revertTitle": "Reverzibilné z menu Odinštalovať",
|
||||
"revertBody": "BBR/TFO sú zaznamenané. <link>Odinštalovať optimalizácie</link> odstráni dva súbory sysctl (<code>/etc/sysctl.d/99-kernel-bbr.conf</code> a <code>99-tcp-fastopen.conf</code>) a znovu načíta zvyšnú konfiguráciu. Odstránenie súboru samo neobnoví aktívne hodnoty jadra. Predvolené hodnoty ako <code>cubic</code> a <code>tcp_fastopen=1</code> sa vrátia po reštarte, ak ich neprepíše iná konfigurácia. Ručný ekvivalent:"
|
||||
},
|
||||
"names": {
|
||||
"heading": "Trvalé názvy rozhraní",
|
||||
"intro": "Prejde fyzické sieťové karty hostiteľa. Vynechá loopback, Docker veth, mosty, zariadenia TAP, bondy, Cilium, ZeroTier a WireGuard. Zapíše súbor systemd <code>.link</code>, ktorý priradí aktuálny názov k aktuálnej MAC adrese. Priradenie podľa MAC tak dostane prednosť pred pravidlami pomenovania jadra.",
|
||||
"whyTitle": "Prečo na tom záleží",
|
||||
"whyItems": [
|
||||
"Pridanie alebo odstránenie zariadení PCIe môže zmeniť číslovanie zbernice a premenovať <code>enp3s0</code> na <code>enp4s0</code>. Ak <code>/etc/network/interfaces</code> odkazuje na starý názov, most po reštarte zmizne.",
|
||||
"BIOS / Aktualizácie firmvéru niekedy menia spôsob, akým zariadenia enumerujú, s rovnakým účinkom.",
|
||||
"Pomocný skript zapisuje súbory <code>.link</code> pre fyzické karty vrátane portov bondov, s MAC adresou, ktorú práve hlási sysfs; pri portoch bondu to môže byť spoločná MAC bondu, preto ich názvy po reštarte skontrolujte. Vynecháva virtuálne rozhrania, napríklad LXC veth a samotné bondy; nerieši súbehy pri pomenovaní virtuálnych kariet <code>hotplug</code>."
|
||||
],
|
||||
"writtenTitle": "Čo sa napíše",
|
||||
"writtenIntro": "Jeden súbor pre každú fyzickú kartu v <code>/etc/systemd/network/10-proxmenux-<iface>.link</code>. Začína hlavičkou <code># Managed by ProxMenux — do not edit</code>, aby ProxMenux rozlíšil vlastné súbory od súborov <code>.link</code> používateľa alebo iných balíkov.",
|
||||
"writtenOutro": "Súbory <code>.link</code> iných balíkov alebo používateľa zostávajú zachované; spravujú sa iba súbory s hlavičkou ProxMenux. Pri opakovanom spustení funkcia skontroluje svoje súbory: z každého <code>10-proxmenux-*.link</code> znovu načíta <code>MACAddress=</code> a odstráni tie, ktorých MAC sa už nenachádza v <code>/sys/class/net/</code>. Súbory starších verzií vo formáte <code>10-<iface>.link</code> sa pri prvom spustení automaticky migrujú.",
|
||||
"pveTitle": "PVE 9 vs PVE 8",
|
||||
"pveBody": "Skript používa súbory systemd <code>.link</code> pre trvalé názvy. V Proxmox VE 9 po ich zápise navyše načíta pravidlá udev, aby už pripnutá karta, ktorá sa znova pripojí alebo rozpozná, použila svoje pravidlo bez reštartu. Existujúce rozhrania skontrolujte po reštarte v PVE 8 aj PVE 9. Nemení sa tým používanie <code>ifupdown2</code> na hostiteľovi. Skript v oboch prípadoch nastaví príznak reštartu, aby sa naň prispôsobiteľné nastavenie opýtalo.",
|
||||
"reviewTitle": "Najprv skontrolujte existujúci /etc/network/interfaces",
|
||||
"reviewBody": "Ak staršia konfigurácia v <code>/etc/network/interfaces</code> odkazuje na názvy kariet vytvorené jadrom, pevné priradenie <em>aktuálnych</em> názvov je správny výsledok. Ak ste už konfiguráciu ručne prispôsobili konkrétnym názvom, pred reštartom overte, že pevné názvy zodpovedajú súboru interfaces.",
|
||||
"revertTitle": "Reverzibilné z menu Odinštalovať",
|
||||
"revertBody": "<link>Odinštalovať optimalizácie</link> odstráni iba súbory <code>10-proxmenux-*.link</code> s hlavičkou ProxMenux z <code>/etc/systemd/network/</code>. Zachová všetky súbory <code>.link</code> používateľa alebo iných balíkov. Po ďalšom reštarte sa obnoví predvolené pomenovanie systemd."
|
||||
},
|
||||
"related": {
|
||||
"heading": "Súvisiace",
|
||||
"items": [
|
||||
{
|
||||
"label": "Správa siete",
|
||||
"href": "/docs/network",
|
||||
"tail": " — diagnostika, analýza mostov a opravy so sprievodcom."
|
||||
},
|
||||
{
|
||||
"label": "Trvalé názvy rozhraní",
|
||||
"href": "/docs/network/persistent-names",
|
||||
"tail": " — rovnaká funkcia neskôr v samostatnom menu; použite jednu z možností, nie obe."
|
||||
},
|
||||
{
|
||||
"label": "Prehľad sieťových príkazov",
|
||||
"href": "/docs/help-info/network-commands",
|
||||
"tail": " — ip, ss, ethtool, sysctl."
|
||||
},
|
||||
{
|
||||
"label": "Odinštalovať optimalizácie",
|
||||
"href": "/docs/post-install/uninstall",
|
||||
"tail": " — vráti tieto zmeny siete späť."
|
||||
},
|
||||
{
|
||||
"label": "Prispôsobiteľné nastavenia po inštalácii",
|
||||
"href": "/docs/post-install/customizable",
|
||||
"tail": " — späť do nadradeného menu."
|
||||
}
|
||||
]
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,177 @@
|
||||
{
|
||||
"meta": {
|
||||
"title": "ProxMenux po inštalácii: Voliteľné nastavenia",
|
||||
"description": "Sprievodca voliteľnými nastaveniami skriptu ProxMenux po inštalácii pre ďalšie funkcie a optimalizácie Proxmox VE.",
|
||||
"ogTitle": "ProxMenux po inštalácii: Voliteľné nastavenia",
|
||||
"ogDescription": "Sprievodca voliteľnými nastaveniami skriptu ProxMenux po inštalácii pre ďalšie funkcie a optimalizácie Proxmox VE.",
|
||||
"ogImageAlt": "ProxMenux Nepovinné nastavenia po inštalácii"
|
||||
},
|
||||
"title": "Voliteľné nastavenia",
|
||||
"intro": "Kategória <strong>Voliteľné nastavenia</strong> ponúka ďalšie funkcie a optimalizácie pre inštaláciu Proxmox VE. Nie sú nevyhnutné, ale v konkrétnych situáciách môžu rozšíriť možnosti systému.",
|
||||
"available": "Dostupné voliteľné funkcie",
|
||||
"stepLabel": "Krok",
|
||||
"ceph": {
|
||||
"title": "Pridať najnovšiu podporu Ceph",
|
||||
"intro": "Táto možnosť nainštaluje najnovšiu podporu Ceph úložného systému pre Proxmox VE. Ceph je distribuovaný úložný systém, ktorý poskytuje vysoký výkon, spoľahlivosť a škálovateľnosť.",
|
||||
"doesIntro": "Čo robí:",
|
||||
"doesItems": [
|
||||
"Pridá repozitár Ceph do vášho systému",
|
||||
"Aktualizuje zoznamy balíkov",
|
||||
"Inštaluje balíky Ceph pomocou príkazu 'pveceph install'",
|
||||
"Overuje inštaláciu"
|
||||
],
|
||||
"howUse": "Použitie: Po inštalácii môžete nastaviť a spravovať úložisko Ceph cez webové rozhranie Proxmox VE alebo nástroje príkazového riadku.",
|
||||
"automates": "Táto úprava automatizuje nasledujúce príkazy:"
|
||||
},
|
||||
"amd": {
|
||||
"title": "Použiť opravy CPU AMD",
|
||||
"intro": "Táto možnosť použije konkrétne opravy procesorov AMD EPYC a Ryzen na zlepšenie stability a kompatibility.",
|
||||
"doesIntro": "Čo robí:",
|
||||
"doesItems": [
|
||||
"Odhaľuje, či je prítomný AMD EPYC alebo Ryzen CPU",
|
||||
"Použije parameter jadra idle=nomwait na predchádzanie náhodným pádom (cez /etc/kernel/cmdline na hostiteľoch so systemd-boot alebo /etc/default/grub pri GRUB, so zálohou originálu .bak).",
|
||||
"Nastaví KVM na ignorovanie určitých MSR (registrov špecifických pre model) pre lepšiu kompatibilitu hosťovských systémov Windows."
|
||||
],
|
||||
"howUse": "Použitie: Opravy sa použijú automaticky a prejavia sa po reštarte systému.",
|
||||
"automates": "Táto úprava automatizuje nasledujúce príkazy:"
|
||||
},
|
||||
"ha": {
|
||||
"title": "Zapnúť služby vysokej dostupnosti",
|
||||
"intro": "Táto možnosť zapne služby vysokej dostupnosti (HA) v Proxmox VE, ktoré umožňujú automatické prevzatie VM a kontajnerov iným uzlom pri poruche uzla.",
|
||||
"doesIntro": "Čo robí:",
|
||||
"doesItems": [
|
||||
"Zapne a spustí službu pve-ha-lrm (lokálny správca zdrojov)",
|
||||
"Zapne a spustí službu pve-ha-crm (správca zdrojov klastra)",
|
||||
"Zapne a spustí službu corosync na komunikáciu klastra"
|
||||
],
|
||||
"howUse": "Ako používať: Po umožnení týchto služieb môžete konfigurovať HA skupiny a zdroje vo webovom rozhraní Proxmox VE.",
|
||||
"automates": "Táto úprava automatizuje nasledujúce príkazy:"
|
||||
},
|
||||
"pveam": {
|
||||
"title": "Aktualizovať Proxmox VE Appliance Manager",
|
||||
"intro": "Obnoví lokálny index šablón kontajnerov, ktorý <code>pveam</code> sprístupňuje v rozhraní Proxmox. Zoznam dostupných softvérových šablón tak bude aktuálny pri ďalšom vytvorení LXC.",
|
||||
"doesIntro": "Čo robí:",
|
||||
"doesItems": [
|
||||
"Spustí <code>pveam update</code> voči zrkadlám Proxmox a získa aktuálny katalóg softvérových šablón",
|
||||
"Doplní zoznam softvérových šablón zobrazený pri vytváraní kontajnera"
|
||||
],
|
||||
"howUse": "Použitie: spustite ho, ak zoznam šablón v rozhraní vyzerá zastarano alebo po zmene zrkadiel. Stiahne iba index katalógu, nie samotné šablóny.",
|
||||
"automates": "Táto úprava automatizuje nasledujúci príkaz:"
|
||||
},
|
||||
"fastfetch": {
|
||||
"title": "Nainštalovať a nastaviť Fastfetch",
|
||||
"intro": "Táto možnosť ticho nainštaluje a konfiguruje nástroj Fastfetch, ktorý zobrazuje systémové špecifikácie a vlastné logo pri prihlásení.",
|
||||
"doesLabel": "Čo robí:",
|
||||
"doesItems": [
|
||||
"Ticho stiahne a nainštaluje najnovšiu verziu Fastfetch",
|
||||
"Umožňuje vám vybrať si vlastné logo (<strong>ProxMenux, Proxmox, Helper-Scripts, Home-Labs-Club, Proxmology</strong> alebo vlastné logo)",
|
||||
"Nastaví Fastfetch na zobrazenie <em>„Systém optimalizovaný cez ProxMenux“</em>",
|
||||
"Nastaví Fastfetch pre automatické spustenie pri prihlásení konzoly"
|
||||
],
|
||||
"importantLabel": "Dôležité:",
|
||||
"importantBody": "Ak sa pripájate k Proxmoxu cez SSH, vyberte logo <strong>Proxmox</strong> alebo vytvorte vlastné pomocou <code>jp2a</code> alebo <code>img2txt</code>. Ostatné logá vytvára <code>chafa</code> a v bežnej relácii SSH sa nemusia zobraziť správne.",
|
||||
"customLabel": "Vlastné logá:",
|
||||
"customBody1": "Vlastné logo použijete vložením textového súboru s ASCII grafikou do: <code>/usr/local/share/fastfetch/logos/</code>",
|
||||
"customBody2": "Môžete vytvoriť vlastné logá pomocou nástrojov ako <code>chafa</code>, <code>jp2a</code>, alebo <code>img2txt</code>.",
|
||||
"customBody3": "Pre dosiahnutie najlepších výsledkov:",
|
||||
"customItems": [
|
||||
"Obmedzte výšku loga na 35 riadkov, aby sa zachovali proporcie a zmestilo sa do terminálu",
|
||||
"Použite <code>chafa</code> pre farebné logá (v reláciách SSH sa nemusia zobraziť správne)",
|
||||
"Použiť <code>jp2a</code> alebo <code>img2txt</code> pre logá kompatibilné s SSH"
|
||||
],
|
||||
"examplesLabel": "Príkladové logá:",
|
||||
"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 JC Channel",
|
||||
"src": "/fastfetch/jc-channel.png"
|
||||
},
|
||||
{
|
||||
"name": "Helper-Scripts",
|
||||
"alt": "Logo Helper-Scripts",
|
||||
"src": "https://macrimi.github.io/ProxMenux/fastfetch/helper-scripts.png"
|
||||
},
|
||||
{
|
||||
"name": "Home-Labs-Club",
|
||||
"alt": "Logo 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": "Táto úprava automatizuje nasledujúce príkazy:"
|
||||
},
|
||||
"figurine": {
|
||||
"title": "Inštalovať a nastaviť Figurine",
|
||||
"intro": "Táto voľba nainštaluje a konfiguruje Figurine, nástroj, ktorý vytvára štýlové ASCII textové bannery pre váš terminál, zobrazujúci vaše meno hostiteľa vo vizuálne atraktívnom 3D formáte.",
|
||||
"doesLabel": "Čo robí:",
|
||||
"doesItems": [
|
||||
"Stiahne a nainštaluje Figurine v2.1.1 z GitHubu pre architektúru hostiteľa (AMD64, ARM64 alebo ARMv7)",
|
||||
"Vytvorí uvítaciu správu, ktorá zobrazí vaše meno hostiteľa v 3D ASCII umení pri prihlásení",
|
||||
"Aktualizuje existujúci binárny súbor Figurine až po úspešnom stiahnutí a rozbalení",
|
||||
"Nastaví uvítaciu správu pre automatické spustenie pri prihlásení"
|
||||
],
|
||||
"practicalLabel": "Praktické použitie:",
|
||||
"practicalBody": "Pri správe viacerých uzlov Proxmox v klastri Figurine hneď ukáže, do ktorého uzla ste prihlásený. Pomáha to predchádzať náhodným príkazom na nesprávnom uzle a zlepšuje prácu s viacerými servermi.",
|
||||
"exampleLabel": "Príklad výstupu:",
|
||||
"imageAlt": "Príklad výstupu Figurine",
|
||||
"automates": "Táto úprava automatizuje tento proces:",
|
||||
"outro": "Po inštalácii uvidíte vaše meno hostiteľa zobrazené v 3D ASCII umení zakaždým, keď sa prihlásite, aby bolo okamžite jasné, na ktorom uzol Proxmox pracujete."
|
||||
},
|
||||
"log2ram": {
|
||||
"title": "Nainštalovať Log2RAM (zníženie opotrebenia SSD/NVMe)",
|
||||
"intro": "Log2RAM pripojí <code>/var/log</code> ako ramdisk tmpfs a pravidelne ho synchronizuje na disk. Ukladanie častých zápisov journald do RAM môže znížiť opotrebenie SSD a diskové I/O. Synchronizácia a riadne vypnutie uložia logy na disk, ale náhly výpadok napájania môže stratiť záznamy od poslednej synchronizácie.",
|
||||
"upstreamLabel": "Pôvodný projekt:",
|
||||
"upstreamUrl": "https://github.com/azlux/log2ram",
|
||||
"upstreamLinkLabel": "azlux/log2ram na GitHub",
|
||||
"doesLabel": "Čo robí ProxMenux:",
|
||||
"doesItems": [
|
||||
"Čítaním <code>/sys/block/<dev>/queue/rotational</code> zistí, či je koreňový disk SSD/NVMe. Pri rotačnom disku sa automatický postup pred inštaláciou opýta.",
|
||||
"Naklonuje pôvodný repozitár (<code>azlux/log2ram</code>) do <code>/tmp/log2ram</code> a upraví <code>install.sh</code>: nahradí <code>rsync -aAXv</code> príkazom <code>rsync -aXv --no-acls</code>. Predíde tak chybe <em>set_acl: Operation not supported</em> s návratovým kódom 23 pri presune /var/log na súborovom systéme bez ACL. Jednotka systemd <code>log2ram</code> sa po inštalácii zapne.",
|
||||
"Nastaví veľkosť ramdisku podľa RAM hostiteľa: <code>≤ 8 GB → 128M</code>, <code>≤ 16 GB → 256M</code>, <code>> 16 GB → 512M</code>. Zapíše hodnotu do <code>SIZE=</code> v <code>/etc/log2ram.conf</code>.",
|
||||
"Plánuje periodickú synchronizáciu disku cez <code>/etc/cron.d/log2ram</code>: každý 1h / 3h / 6h podľa rovnakej úrovne RAM.",
|
||||
"Nainštaluje <code>/usr/local/bin/log2ram-check.sh</code>, spúšťaný cez <code>/etc/cron.d/log2ram-auto-sync</code> každých 10 minút. Keď <code>/var/log</code> dosiahne 80% ramdisku, vyčistí staré žurnály. Pri 92% najprv spustí <code>logrotate -f /etc/logrotate.d/proxmox-backup-api</code>, ak súbor existuje: logy API PBS bývajú najväčším spotrebiteľom miesta na hostiteľovi PBS. Potom skráti <code>pveproxy access/error</code> a <code>pveam.log</code> pred synchronizáciou. Samotný <code>log2ram write</code> skopíruje tmpfs na disk, ale nezmenší ho. Ochrana pomáha predchádzať pádom PVE s <em>No space left on device</em> pri nekontrolovanom raste logov.",
|
||||
"Zistí službu <code>proxmox-backup-server</code> na hostiteľovi. Ak existuje, vytvorí <code>/etc/logrotate.d/proxmox-backup-api</code> (20 MB × 3 rotácie) a <code>/etc/cron.hourly/proxmox-backup-logrotate</code>, aby obmedzil logy API PBS, častý zdroj rastu, aj medzi synchronizáciami Log2RAM. Bez PBS nič nezmení.",
|
||||
"Prispôsobí limity systemd-journald (<code>SystemMaxUse</code>, <code>RuntimeMaxUse</code>) ramdisku, aby ho nárazový príval záznamov nezaplnil.",
|
||||
"Zaznamená sa v <code>installed_tools.json</code>, aby sa dal vrátiť cez Odinštalovať optimalizácie."
|
||||
],
|
||||
"howUseLabel": "Ako používať:",
|
||||
"howUseBody": "Automatický postup nainštaluje Log2RAM bez zásahu pri zistení koreňového SSD/NVMe. Prispôsobiteľný postup sa pýta na veľkosť, interval a ochranu synchronizácie. Výzva uvádza 90%, no vytvorený skript používa vyššie opísané limity 80% na čistenie a 92% na intenzívne čistenie.",
|
||||
"verifyLabel": "Overiť a spravovať zo shellu:",
|
||||
"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": "Povoliť výmenný profil ZRAM",
|
||||
"intro": "Pomocou <code>/dev/zram0</code> vytvorí komprimované odkladacie zariadenie v RAM cez <code>systemd-zram-generator</code>. Stránky presunuté jadrom do swapu sa komprimujú cez zstd a zostanú v pamäti pred použitím swapu na disku.",
|
||||
"doesLabel": "Čo robí:",
|
||||
"doesItems": [
|
||||
"Nainštaluje <code>systemd-zram-generator</code>, ak chýba, a zaznamená, či ho nainštaloval ProxMenux.",
|
||||
"Zapíše <code>/etc/systemd/zram-generator.conf.d/90-proxmenux.conf</code>: zariadenie <code>zram0</code> s veľkosťou desatiny RAM hostiteľa, kompresiou zstd (<code>zstd(level=9)</code> pri systemd-zram-generator 1.2.0 alebo novšom) a prioritou swapu 32767.",
|
||||
"S touto prioritou jadro najprv zaplní ZRAM. Existujúci swap na disku si zachová svoju prioritu a prijme stránky, ktoré sa už do ZRAM nezmestia.",
|
||||
"Pred zmenou niečoho, hľadá ďalšie nastavenie ZRAM: aktívny zram swap, zram linka v <code>/etc/fstab</code>, systemd jednotka alebo iný súbor generátora. Ak ho nájde, možnosť sa zastaví a nechá nastavenie ako je.",
|
||||
"Spustí <code>dev-zram0.swap</code> a overí, či aktívne zariadenie zodpovedá profilu. Ak nie, obnoví predchádzajúci stav.",
|
||||
"Zaznamená sa v <code>installed_tools.json</code>, aby sa dal vrátiť cez Odinštalovať optimalizácie."
|
||||
],
|
||||
"howUseLabel": "Ako používať:",
|
||||
"howUseBody": "Možnosť je iba v prispôsobiteľnom postupe; automatický ju nepoužíva. Zariadenie sa pri každom štarte vytvorí znovu. Kým je aktívne, panel Pamäť v ProxMenux Monitor zobrazí kapacitu, využitý swap, algoritmus, kompresný pomer a obsadenú fyzickú pamäť.",
|
||||
"verifyLabel": "Overiť zo shellu:",
|
||||
"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": "Automatická aplikácia",
|
||||
"body": "V prispôsobiteľnom postupe vyberte funkcie podľa potreby. Log2RAM je aj súčasťou automatického postupu s detekciou hardvéru; ZRAM zostáva iba prispôsobiteľný. Jednotlivé časti opisujú výzvy a predpoklady."
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,61 @@
|
||||
{
|
||||
"meta": {
|
||||
"title": "Po inštalácii: Výkon | Dokumentácia ProxMenux",
|
||||
"description": "Možnosti výkonu v prispôsobiteľnom skripte ProxMenux po inštalácii. Nahrádza jednovláknový gzip programom pigz (paralelný gzip) na rýchlejšie zálohovanie a kompresiu na viacjadrových hostiteľoch."
|
||||
},
|
||||
"header": {
|
||||
"title": "Po inštalácii: výkon",
|
||||
"description": "Možnosti výkonu v prispôsobiteľnom skripte po inštalácii. Kategória obsahuje jednu optimalizáciu: nahradenie gzip programom pigz, aby zálohovanie a kompresia používali všetky jadrá CPU namiesto jedného.",
|
||||
"section": "Nastavenie Proxmoxu po inštalácii"
|
||||
},
|
||||
"intro": {
|
||||
"title": "Čo táto kategória zahŕňa",
|
||||
"body": "Jediná možnosť výkonu tu presmeruje systémový gzip na paralelnú implementáciu. Ostatné úpravy výkonu (pamäť, plánovanie I/O, veľkosť ARC ZFS, limity jadra) sú vo vlastných kategóriách (<em>Systém</em>, <em>Úložisko</em>), pretože ovplyvňujú iné subsystémy."
|
||||
},
|
||||
"pigz": {
|
||||
"heading": "Použiť pigz pre rýchlejšiu gzip kompresiu",
|
||||
"intro": "Štandardný <code>gzip</code> komprimuje údaje pomocou <strong>jediného jadra CPU</strong>. Na moderných hostiteľoch Proxmox s 8, 16 alebo 32 jadrami je to veľké úzke miesto pri zálohách VM/CT cez <code>vzdump</code>, rotácii záznamov a všetkom, čo prechádza cez <code>gzip</code>. <a>pigz</a> je priamo zameniteľná paralelná náhrada: rovnaký výstup kompatibilný s gzip, ale práca rozdelená medzi všetky jadrá.",
|
||||
"doesTitle": "Čo robí ProxMenux",
|
||||
"doesIntro": "Päť krokov, všetky idempotentné:",
|
||||
"doesItems": [
|
||||
"Nastaví <code>pigz: 1</code> v <code>/etc/vzdump.conf</code>, aby zálohovací nástroj Proxmox používal pigz natívne.",
|
||||
"Nainštaluje apt balíček <code>pigz</code>, ak už nie je prítomný.",
|
||||
"Napíše wrapper skript na <code>/bin/pigzwrapper</code>, ktorý posiela každý argument na <code>/usr/bin/pigz</code>.",
|
||||
"Zaregistruje presmerovanie dpkg pre systémový program <code>gzip</code> (<code>/usr/bin/gzip</code> v Proxmox VE 9, <code>/bin/gzip</code> v Proxmox VE 8). Pôvodný program zostane vedľa ako <code>gzip.distrib</code> a na jeho miesto príde wrapper. Odvtedy <em>všetko</em>, čo volá <code>gzip</code> — logrotate, <code>tar czf</code>, skripty aj vzdump — používa pigz transparentne.",
|
||||
"Pred umiestnením wrappera overí, že súbor <code>gzip.distrib</code> je funkčný gzip; ak nie, najprv preinštaluje balík <code>gzip</code>. Hostiteľ so staršou náhradou <code>/bin/gzip.original</code> pri opätovnom použití možnosti prejde na presmerovanie dpkg."
|
||||
],
|
||||
"replacesTitle": "Nahrádza systémový program",
|
||||
"replacesBody": "Umiestniť wrapper namiesto <code>gzip</code> je nezvyčajné. Je to bezpečné, pretože vytvára výstup kompatibilný s gzip, ale skripty s pevne zapísanými cestami, v obmedzených prostrediach chroot alebo overujúce hash programu sa môžu správať inak. Pôvodný program zostáva ako <code>gzip.distrib</code>. Vďaka presmerovaniu dpkg aktualizácia balíka <code>gzip</code> alebo prechod z Proxmox VE 8 na 9 aktualizuje tento súbor a ponechá wrapper na mieste.",
|
||||
"revertTitle": "Reverzibilné z menu Odinštalovať",
|
||||
"revertBody": "Táto optimalizácia sa sleduje. <link>Odinštalovať optimalizácie</link> skopíruje pôvodný program z <code>gzip.distrib</code> na miesto wrappera, odstráni presmerovanie aj <code>pigzwrapper</code>, zakomentuje riadok <code>pigz</code> v <code>/etc/vzdump.conf</code> a po overení funkčnosti gzip spustí <code>apt purge pigz</code>. Ručný ekvivalent pre Proxmox VE 9:",
|
||||
"verifyTitle": "Overenie",
|
||||
"verifyBody": "Po použití by mal <code>gzip --version</code> uviesť pigz. Rýchly test výkonu tiež ukáže rozdiel v rýchlosti na viacjadrovom hostiteľovi:",
|
||||
"whenTitle": "Keď na tom záleží najviac",
|
||||
"whenBody": "Prínos závisí od <strong>počtu jadier hostiteľa</strong> a <strong>frekvencie zálohovania</strong>. Na domácom serveri s 2 jadrami a jedným denným vzdump je malý. Na produkčnom hostiteľovi so 16 jadrami, ktorý každú noc zálohuje tucet VM, môže pigz skrátiť časové okno záloh na zlomok času jednovláknového gzip."
|
||||
},
|
||||
"related": {
|
||||
"heading": "Súvisiace",
|
||||
"items": [
|
||||
{
|
||||
"label": "Príkazy na zálohovanie a obnovu",
|
||||
"href": "/docs/help-info/backup-commands",
|
||||
"tailRich": " — referencia CLI vzdump vrátane voľby počtu vlákien <code>--pigz</code>."
|
||||
},
|
||||
{
|
||||
"label": "Úložisko",
|
||||
"href": "/docs/post-install/storage",
|
||||
"tail": " — Vzdump rýchlostné limity a ZFS ARC ladenie."
|
||||
},
|
||||
{
|
||||
"label": "Systém",
|
||||
"href": "/docs/post-install/system",
|
||||
"tail": " — ladenie deskriptorov súborov a pamäte."
|
||||
},
|
||||
{
|
||||
"label": "Prispôsobiteľné nastavenia po inštalácii",
|
||||
"href": "/docs/post-install/customizable",
|
||||
"tail": " — späť do nadradeného menu."
|
||||
}
|
||||
]
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,57 @@
|
||||
{
|
||||
"meta": {
|
||||
"title": "Po inštalácii: Zabezpečenie | Dokumentácia ProxMenux",
|
||||
"description": "Možnosti zabezpečenia v prispôsobiteľnom skripte ProxMenux po inštalácii. Zatiaľ jediná možnosť: zakázať službu portmapper/rpcbind na zmenšenie útočnej plochy hostiteľa."
|
||||
},
|
||||
"header": {
|
||||
"title": "Po inštalácii: Zabezpečenie",
|
||||
"section": "Nastavenie Proxmoxu po inštalácii"
|
||||
},
|
||||
"intro": {
|
||||
"title": "Čo táto kategória zahŕňa",
|
||||
"body": "Zabezpečenie po inštalácii zahŕňa iba <strong>posilnenie hostiteľa, ktoré sa dá bezpečne použiť bez dozoru</strong>: vypnutie služieb, ktoré takmer nikto nepotrebuje a ktoré možno obnoviť cez Odinštalovať. Aktívne bezpečnostné nástroje (Fail2Ban na prevenciu prienikov, Lynis na audit) nájdete pod položkou <em>Zabezpečenie</em> v hlavnom menu ProxMenux, mimo nastavení po inštalácii."
|
||||
},
|
||||
"rpcbind": {
|
||||
"heading": "Zakázať portmapper / rpcbind",
|
||||
"intro": "<code>rpcbind</code> (predtým <code>portmap</code>) mapuje čísla programov RPC na sieťové porty. NFS a niektoré staršie nástroje RPC ho potrebujú. Na typickom hostiteľovi Proxmox, ktorý nie je serverom NFS, ho <strong>nič nepoužíva</strong>; ak zostane zapnutý, port <code>111/tcp</code> načúva na každom rozhraní.",
|
||||
"whyTitle": "Prečo sa ho oplatí vypnúť",
|
||||
"whyItems": [
|
||||
"Zmenšuje útočnú plochu hostiteľa — o jednu načúvajúcu službu menej, o ktorú sa treba starať.",
|
||||
"V minulosti sa zneužíval ako vektor odrazu a zosilnenia pri útokoch DDoS. Vypnutím <code>rpcbind</code> sa tento faktor zosilnenia na hostiteľovi odstráni.",
|
||||
"Odstráni zbytočné hlásenia zo záznamov a výstupu <code>netstat</code> / <code>ss</code>, aby sa skutočná aktivita ľahšie rozpoznávala."
|
||||
],
|
||||
"nfsTitle": "Nevypnite to, ak používate NFS",
|
||||
"nfsBody": "Server NFS <strong>aj</strong> klient NFS používajú <code>rpcbind</code> na vyjednanie portov pre <code>mountd</code>, <code>statd</code>, <code>lockd</code> a ďalšie služby. Ak hostiteľ Proxmox <em>exportuje</em> zdieľania NFS iným počítačom alebo <em>pripája</em> zdieľania NFS z NAS, túto možnosť nepoužívajte. Pripájanie zlyhá s chybou <code>mount.nfs: rpc.statd is not running</code> alebo podobnou.",
|
||||
"runsTitle": "Čo ProxMenux spúšťa",
|
||||
"runsOutro": "Balík zostáva nainštalovaný. ProxMenux zaznamená pôvodný stav povolenia a aktivity rpcbind.service aj rpcbind.socket, potom obe jednotky zakáže a zastaví, aby aktivácia cez socket nemohla službu znovu spustiť.",
|
||||
"verifyTitle": "Overenie",
|
||||
"verifyBody": "Po použití overte, že <code>rpcbind</code> je vypnutý a na porte 111 nič nenačúva:",
|
||||
"reversibleTitle": "Obnovuje pôvodný stav služby",
|
||||
"reversibleBody": "Zmena sa zaznamená do <code>installed_tools.json</code>. <link>Odinštalovať optimalizácie</link> vráti každú jednotku rpcbind do povoleného/zakázaného a aktívneho/neaktívneho stavu zaznamenaného pred zmenou ProxMenux. Nepredpokladá, že rpcbind bol povolený na každom hostiteľovi."
|
||||
},
|
||||
"related": {
|
||||
"heading": "Súvisiace",
|
||||
"items": [
|
||||
{
|
||||
"label": "Bezpečnostné menu",
|
||||
"href": "/docs/security",
|
||||
"tail": " — pokročilejšie nástroje: Fail2Ban (prevencia prienikov) a Lynis (audit)."
|
||||
},
|
||||
{
|
||||
"label": "Lynis",
|
||||
"href": "/docs/security/lynis",
|
||||
"tail": " — audit hostiteľa na nájdenie ďalších možností posilnenia zabezpečenia."
|
||||
},
|
||||
{
|
||||
"label": "Užitočné systémové príkazy",
|
||||
"href": "/docs/help-info/system-commands",
|
||||
"tail": " — Stav služby, journalctl, referencia auditu lynis."
|
||||
},
|
||||
{
|
||||
"label": "Prispôsobiteľné nastavenia po inštalácii",
|
||||
"href": "/docs/post-install/customizable",
|
||||
"tail": " — späť do nadradeného menu."
|
||||
}
|
||||
]
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,167 @@
|
||||
{
|
||||
"meta": {
|
||||
"title": "Po inštalácii: Úložisko | Dokumentácia ProxMenux",
|
||||
"description": "Optimalizácie úložiska v prispôsobiteľnom skripte ProxMenux po inštalácii: veľkosť ZFS ARC podľa RAM, pravidelné snímky cez zfs-auto-snapshot a odstránenie rýchlostných limitov záloh vzdump."
|
||||
},
|
||||
"header": {
|
||||
"title": "Po inštalácii: Úložisko",
|
||||
"section": "Nastavenie Proxmoxu po inštalácii"
|
||||
},
|
||||
"intro": {
|
||||
"title": "Čo táto kategória zahŕňa",
|
||||
"body": "Štyri optimalizácie úložiska: nastaviť <strong>ZFS ARC</strong> na vhodný podiel RAM, nainštalovať a naplánovať <strong>automatické snímky ZFS</strong>, zapnúť <strong>ZFS autotrim</strong> v SSD/NVMe pooloch a odstrániť obmedzenia <strong>vzdump</strong>, aby sa zálohy mohli vytvárať plnou rýchlosťou. Možnosti sú nezávislé; vyberte podľa svojho systému. Piata, <link>Log2RAM</link>, znižuje opotrebenie SSD/NVMe presunom <code>/var/log</code> na ramdisk. Je na stránke Voliteľné podľa zaradenia v prispôsobiteľnom menu."
|
||||
},
|
||||
"trackedTitle": "Všetky štyri sú sledované v menu Odinštalovať",
|
||||
"trackedBody": "Každá z týchto možností zaregistruje nástroj v <code>installed_tools.json</code>, takže sa zobrazí v časti <link>Odstrániť optimalizácie</link>. Vrátenie <code>zfs_arc</code> odstráni <code>/etc/modprobe.d/99-zfsarc.conf</code> a znovu vytvorí initramfs. <code>zfs_auto_snapshot</code> zruší plán cron a ponúkne úplné odstránenie balíka; <code>zfs_autotrim</code> nastaví <code>autotrim=off</code> v pooloch, v ktorých ho zaplo; <code>vzdump_speed</code> obnoví <code>/etc/vzdump.conf</code> zo súboru <code>.bak</code> vytvoreného pri inštalácii.",
|
||||
"arc": {
|
||||
"heading": "Optimalizovať veľkosť ZFS ARC",
|
||||
"intro": "<strong>Adaptive Replacement Cache (ARC)</strong> je čítacia cache ZFS v RAM. Inštalácie Proxmox VE od 8.1 nastavujú 10% RAM, najviac 16 GiB; staršie alebo aktualizované hostitele sa môžu líšiť. Táto možnosť zapíše rovnaké pravidlo výslovne (RAM/10, najviac 16 GiB, najmenej 64 MiB) do vlastného súboru, čím pokryje aj staršie alebo aktualizované hostitele. Skontrolujte existujúce nastavenia a záťaž: menšia cache nie je vždy rýchlejšia.",
|
||||
"sizingTitle": "Pravidlá veľkosti",
|
||||
"headerRam": "RAM hostiteľa",
|
||||
"headerMax": "Limit ARC",
|
||||
"rows": [
|
||||
{
|
||||
"ram": "Vzorec",
|
||||
"max": "RAM / 10, najviac 16 GiB a najmenej 64 MiB"
|
||||
},
|
||||
{
|
||||
"ram": "8 GB hostiteľ",
|
||||
"max": "≈ 819 MiB (RAM/10)"
|
||||
},
|
||||
{
|
||||
"ram": "16 GB hostiteľ",
|
||||
"max": "≈ 1.6 GiB (RAM/10)"
|
||||
},
|
||||
{
|
||||
"ram": "64 GB hostiteľ",
|
||||
"max": "≈ 6.4 GiB (RAM/10)"
|
||||
},
|
||||
{
|
||||
"ram": "≥ 160 GB hostiteľ",
|
||||
"max": "16 GiB (limit)"
|
||||
}
|
||||
],
|
||||
"after": "Súbor <code>/etc/modprobe.d/99-zfsarc.conf</code> obsahuje iba <code>options zfs zfs_arc_max=…</code>. Ostatné parametre ZFS (<code>zfs_arc_min</code>, prednačítanie/obmedzenie zápisov L2ARC, časový limit TXG) sa neladia. Pred zápisom kontrola nájde iné <code>*.conf</code> v <code>/etc/modprobe.d/</code> s <code>zfs_arc_min</code> / <code>zfs_arc_max</code>, zálohuje ich s manifestom do <code>/usr/local/share/proxmenux/backups/zfs_arc/</code> a odstráni z nich konfliktné hodnoty <code>zfs_arc_min</code> / <code>zfs_arc_max</code> (ostatné voľby v týchto riadkoch zostanú), aby limit určoval iba súbor ARC ProxMenux. Potom <code>update-initramfs -u -k all</code> a podľa potreby <code>proxmox-boot-tool refresh</code> začlenia limit do initramfs systémov s koreňom na ZFS.",
|
||||
"rebootTitle": "Prejaví sa po reštarte",
|
||||
"rebootBody": "Nastavenia ARC sa čítajú pri načítaní modulu <code>zfs</code>. Pre hostiteľov s koreňom na ZFS ProxMenux znovu vytvorí initramfs cez <code>update-initramfs -u -k all</code> a podľa potreby obnoví zavádzač cez <code>proxmox-boot-tool refresh</code>. Nový parameter stále vyžaduje reštart; príznak potreby reštartu sa nastaví automaticky.",
|
||||
"safeTitle": "Bezpečné na hostiteľoch bez ZFS",
|
||||
"safeBody": "Funkcia zapíše konfiguráciu iba vtedy, ak <code>zpool list</code> ohlási aspoň jeden importovaný pool ZFS. Na hostiteľoch iba s ext4/LVM alebo s nástrojmi ZFS bez importovaného poolu voľba nič neurobí a nič nezapíše.",
|
||||
"verifyTitle": "Overenie a ručná obnova"
|
||||
},
|
||||
"autoSnap": {
|
||||
"heading": "Nainštalovať ZFS auto-snapshot",
|
||||
"intro": "Nainštaluje balík <a>zfs-auto-snapshot</a> a prepíše plány cron na automatické vytváranie snímok v niekoľkých intervaloch. Jednoduchá dodatočná ochrana popri pravidelných zálohách vzdump.",
|
||||
"cadenceTitle": "Intervaly snímok nastavené cez ProxMenux",
|
||||
"headerLabel": "Štítok",
|
||||
"headerRuns": "Beží",
|
||||
"headerKept": "Uchované snímky",
|
||||
"rows": [
|
||||
{
|
||||
"label": "časté",
|
||||
"runs": "každý 15 min.",
|
||||
"kept": "4"
|
||||
},
|
||||
{
|
||||
"label": "hodinová",
|
||||
"runs": "každú hodinu",
|
||||
"kept": "1"
|
||||
},
|
||||
{
|
||||
"label": "denne",
|
||||
"runs": "jedenkrát denne",
|
||||
"kept": "1"
|
||||
},
|
||||
{
|
||||
"label": "týždenne",
|
||||
"runs": "jedenkrát týždenne",
|
||||
"kept": "1"
|
||||
},
|
||||
{
|
||||
"label": "mesačne",
|
||||
"runs": "jedenkrát mesačne",
|
||||
"kept": "1"
|
||||
}
|
||||
],
|
||||
"conservativeTitle": "Obmedzené počty uchovaných snímok",
|
||||
"conservativeBody": "ProxMenux sa dodáva s konzervatívnym uchovávaním (len 4 často + 1 každého dlhšieho intervalu), takže ZFS snapshot úložisko nenarastá. Ak chcete dlhšie uchovávanie, po spustení skriptu upravte čísla v <code>/etc/cron.d/zfs-auto-snapshot</code>, <code>/etc/cron.hourly/zfs-auto-snapshot</code> atď.",
|
||||
"onlyZfsTitle": "Užitočné iba v pooloch ZFS",
|
||||
"onlyZfsBody": "Inštalácia balíka na hostiteľovi iba s ext4 je neškodná, ale zbytočná: neexistujú datasety ZFS na vytváranie snímok. Ak ZFS nepoužívate, možnosť vynechajte.",
|
||||
"verifyTitle": "Overenie a ručná obnova"
|
||||
},
|
||||
"autotrim": {
|
||||
"heading": "Zapnúť ZFS autotrim (SSD/NVMe pooly)",
|
||||
"intro": "Zapne <code>autotrim</code> v pooloch ZFS zložených iba z SSD alebo NVMe s TRIM. Z opatrnosti vynechá pooly s rotačným diskom. Pooly už nastavené na <code>autotrim=on</code> ponechá bez zmeny.",
|
||||
"trimTitle": "Čo TRIM robí, a prečo to záleží na ZFS",
|
||||
"trimBody1": "SSD a NVMe používajú interné mazacie bloky väčšie než logické sektory súborového systému. Po zmazaní súboru disk ešte nevie, že sektory sú voľné, a jeho interné čistenie môže pri uvoľňovaní ďalších blokov zbytočne presúvať staré dáta. <strong>TRIM</strong> oznámi disku voľné sektory, aby ich mohol vymazať vopred.",
|
||||
"trimBody2": "Bez TRIM sa výkon SSD časom znižuje, pretože na disku sa míňajú vopred vymazané bloky a musí vykonať vymazanie pri zápise a zvyšuje sa zosilnenie zápisu – oboje skracuje životnosť disku. So zapnutým TRIM môže disk udržiavať zdravé pool prázdnych blokov pripravených na zápis.",
|
||||
"trimBody3": "Pri <code>autotrim=on</code> ZFS na pozadí vykonáva TRIM nedávno uvoľneného miesta a zlučuje rozsahy. Alternatívou je pravidelný <code>zpool trim <pool></code>. Autotrim nepotrebuje samostatný plán, ale vplyv závisí od diskov; slabším zariadeniam môže viac vyhovovať pravidelný ručný TRIM.",
|
||||
"practicalTitle": "Prečo je to praktické?",
|
||||
"practicalItems": [
|
||||
"<strong>Trvalý výkon zápisu.</strong> TRIM môže pomôcť efektívne obnoviť nepoužité bloky. Prínos a vplyv na latenciu závisia od zariadenia a záťaže.",
|
||||
"<strong>Životnosť disku.</strong> Menej zbytočného interného kopírovania môže znížiť násobenie zápisov a opotrebenie NAND. Nezaručuje konkrétne predĺženie životnosti.",
|
||||
"<strong>Bez samostatnej úlohy cron.</strong> Na rozdiel od pravidelného <code>zpool trim</code> sa o autotrim stará samotný pool."
|
||||
],
|
||||
"whenTitle": "Kedy je to nutné?",
|
||||
"whenIntro1": "<strong>Zvážte zapnutie</strong> v pooloch ZFS iba s SSD/NVMe podporujúcimi TRIM. Overte správanie a latenciu; niektorému hardvéru viac vyhovuje plánovaný ručný TRIM.",
|
||||
"whenIntro2": "<strong>Skript ho automaticky preskočí</strong> na:",
|
||||
"whenSkipItems": [
|
||||
"Pooly s rotačným HDD vdev — opatrný hardvérový filter tohto skriptu.",
|
||||
"Disky bez <code>discard_granularity</code> vystavené v sysfs – zvyčajne staré SSD bez TRIM alebo priechodných ciest, kde OS nevidí základné zariadenie.",
|
||||
"Pools, kde ZFS sám uvádza, že vlastnosť nie je podporovaná (zriedkavé; veľmi staré pools).",
|
||||
"Pools už nastavený na <code>autotrim=on</code> (bez-op)."
|
||||
],
|
||||
"whenIntro3": "<strong>Nie je relevantné pre hostiteľov iba s ext4</strong> — ZFS nemá čo trimovať. Funkcia vtedy skončí s vysvetľujúcou správou.",
|
||||
"recordedTitle": "Prečo sa zaznamenávajú iba pooly zmenené cez ProxMenux",
|
||||
"recordedBody": "Funkcia zapíše pool do interného súboru stavu (<code>/usr/local/share/proxmenux/zfs_autotrim_pools</code>) iba pri zmene z <code>off</code> na <code>on</code>. Pooly s už aktívnym autotrimom vynechá. Neskoršie odinštalovanie tak vráti iba vlastné zmeny ProxMenuxu a nevypne vaše nastavenia.",
|
||||
"manualTitle": "Ručný ekvivalent (spustite na svojom serveri)",
|
||||
"manualIntro": "Úplná sekvencia skriptu spustená proti každému pool je replikovateľná ručne. Toto by ste napísali, ak by ste chceli urobiť to isté na jednom pool bez ProxMenux:",
|
||||
"verifyTitle": "Overenie a ručná obnova",
|
||||
"oneShotTitle": "Potrebujete jednorazový TRIM namiesto priebežného?",
|
||||
"oneShotBody": "Niektorí správcovia uprednostňujú ručný TRIM mimo špičky. Vypnite autotrim a naplánujte úlohu cron s <code>zpool trim <pool></code>: rovnaký cieľ, iný interval."
|
||||
},
|
||||
"vzdump": {
|
||||
"heading": "Zvýšiť rýchlosť záloh vzdump",
|
||||
"intro": "Zapíše bwlimit: 0 a ionice: 5 do globálnej konfigurácie vzdump. Proxmox už predvolene neobmedzuje šírku pásma; odstráni teda iba nastavený limit. Oproti ionice: 7 hodnota 5 zvýši prioritu I/O best-effort, ak ju plánovač rešpektuje. Môže ovplyvniť hostí a nezaručuje rýchlejšie zálohy.",
|
||||
"changedTitle": "Čo sa zmení v /etc/vzdump.conf",
|
||||
"backupTitle": "Prvý beh vytvára .bak vzdump.conf",
|
||||
"backupBody": "Pri prvom spustení ProxMenux pred úpravami skopíruje <code>/etc/vzdump.conf</code> do <code>/etc/vzdump.conf.bak</code>. Ďalšie spustenia zálohu neprepíšu, takže pôvodná ručne upravená konfigurácia zostane obnoviteľná. <code>bwlimit</code> a <code>ionice</code> zmení cez <code>sed</code>; ostatné možnosti ako compress, pigz, tmpdir a exclude-path ponechá.",
|
||||
"skipTitle": "Kedy to preskočiť",
|
||||
"skipBody": "Na hostiteľovi s pomalým úložiskom a VM citlivými na latenciu môže odstránenie limitu šírky pásma spomaliť prevádzku počas záloh. Ak ste preto nastavili <code>bwlimit</code>, ponechajte ho a túto možnosť vynechajte.",
|
||||
"verifyTitle": "Overenie a ručná obnova"
|
||||
},
|
||||
"related": {
|
||||
"heading": "Súvisiace",
|
||||
"items": [
|
||||
{
|
||||
"label": "Príkazy na správu ZFS",
|
||||
"href": "/docs/help-info/zfs-commands",
|
||||
"tail": " — prehľad zpool / zfs pre ARC, snímky a scrub."
|
||||
},
|
||||
{
|
||||
"label": "Príkazy pre úložiská a disky",
|
||||
"href": "/docs/help-info/storage-commands",
|
||||
"tail": " — všeobecná príručka blokových zariadení a úložísk Proxmox."
|
||||
},
|
||||
{
|
||||
"label": "Príkazy zálohovania a obnovy",
|
||||
"href": "/docs/help-info/backup-commands",
|
||||
"tail": " — prehľad CLI vzdump pre šírku pásma a prioritu I/O."
|
||||
},
|
||||
{
|
||||
"label": "Odinštalovať optimalizácie",
|
||||
"href": "/docs/post-install/uninstall",
|
||||
"tail": " — vráťte zmeny ARC / vzdump späť."
|
||||
},
|
||||
{
|
||||
"label": "Log2RAM",
|
||||
"href": "/docs/post-install/optional#log2ram",
|
||||
"tail": " - znižuje SSD/NVMe opotrebenie ramdiskom /var/log; zdokumentované podľa Voliteľné."
|
||||
},
|
||||
{
|
||||
"label": "Prispôsobiteľné nastavenia po inštalácii",
|
||||
"href": "/docs/post-install/customizable",
|
||||
"tail": " — späť do nadradeného menu."
|
||||
}
|
||||
]
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,133 @@
|
||||
{
|
||||
"meta": {
|
||||
"title": "Po inštalácii: Systém | Dokumentácia ProxMenux",
|
||||
"description": "Systémové optimalizácie prispôsobiteľného skriptu ProxMenux po inštalácii: limity veľkosti journald a logrotate, vyššie limity jadra a deskriptorov súborov, vyvážené ladenie pamäte, rýchle reštarty cez kexec a obnova po panike jadra."
|
||||
},
|
||||
"header": {
|
||||
"title": "Po inštalácii: systém",
|
||||
"section": "Nastavenie Proxmoxu po inštalácii"
|
||||
},
|
||||
"intro": {
|
||||
"title": "Čo táto kategória zahŕňa",
|
||||
"body": "Šesť nezávislých systémových optimalizácií. Upravujú <strong>journald</strong> a <strong>logrotate</strong>, aby logy nezaplnili disk, zvyšujú <strong>limity jadra a deskriptorov súborov</strong> pre aplikácie s mnohými otvorenými súbormi, <strong>vyvažujú využitie pamäte</strong> na virtualizačnom hostiteľovi, pridávajú <strong>kexec</strong> na reštart bez BIOSu a nastavujú <strong>automatickú obnovu</strong> pri panike jadra. Všetkých šesť je zaznamenaných a vratných z menu Odinštalovať."
|
||||
},
|
||||
"journald": {
|
||||
"heading": "Optimalizovať journald",
|
||||
"intro": "Prepíše <code>/etc/systemd/journald.conf</code> s rozumnými predvolenými hodnotami, aby žurnál systemd postupne nezaplnil koreňový oddiel. Potom reštartuje <code>systemd-journald</code> a vyčistí staré záznamy.",
|
||||
"keyTitle": "Kľúčové hodnoty",
|
||||
"keyItems": [
|
||||
"<code>Storage=persistent</code> — uchová záznamy na disku aj po reštarte.",
|
||||
"<code>SystemMaxUse=64M</code> / <code>RuntimeMaxUse=60M</code> — pevné limity využitia disku a pamäte systémovým denníkom.",
|
||||
"<code>Compress=yes</code>, <code>Seal=no</code> — komprimuje záznamy, vypne kryptografické pečatenie s doprednou bezpečnosťou (šetrí CPU).",
|
||||
"<code>MaxLevelStore=info</code> — ukladá úroveň info a vyššie, potrebné pre prehliadač logov ProxMenux Monitor aj pre detekciu neúspešných overení SSH/Proxmox cez Fail2Ban v žurnáli.",
|
||||
"Limit frekvencie: <code>1000 events / 30 s</code> proti zahlteniu logmi.",
|
||||
"<code>ForwardToSyslog=no</code>, <code>ForwardToWall=no</code> — neduplikovať hlásenia do syslogu ani ich nerozosielať na konzoly."
|
||||
],
|
||||
"tipTitle": "Prečo je MaxLevelStore=info dôležité",
|
||||
"tipBody": "Prísnejšia úroveň ako <code>warning</code> spôsobí, že ProxMenux Monitor ukáže takmer rovnaké záznamy vo všetkých obdobiach, pretože väčšina aktivity má úroveň info, a Fail2Ban neuvidí neúspešné prihlásenia. Objem obmedzte pomocou <code>SystemMaxUse</code> a <code>RateLimitBurst</code>, nie obmedzením ukladaných úrovní."
|
||||
},
|
||||
"logrotate": {
|
||||
"heading": "Optimalizovať logrotate",
|
||||
"intro": "Prepíše <code>/etc/logrotate.conf</code> s globálnym denným a veľkostným nastavením, uchovaním 7 rotácií, kompresiou a <code>copytruncate</code>, aby služby mohli písať bez opätovného otvorenia logov. Veľkostné kritérium je uvedené po dennom a má prednosť, ak ho neprepíše pravidlo konkrétneho logu. Pôvodný <code>logrotate.conf</code> sa pri prvom použití zálohuje do <code>.bak</code>.",
|
||||
"tipTitle": "Vhodné pre Log2RAM",
|
||||
"tipBody": "Direktíva <code>size 10M</code> má prednosť pred skorším denným nastavením; <em>neznamená</em> to prvé splnené kritérium. Logrotate kontroluje limit pri spustení a pravidlá konkrétnych logov môžu prepísať globálne hodnoty. Pri <code>/var/log</code> v RAM cez Log2RAM skontrolujte pravidlá aj frekvenciu časovača na riadenie využitia miesta."
|
||||
},
|
||||
"limits": {
|
||||
"heading": "Zvýšiť systémové limity",
|
||||
"intro": "Zvýši limity jadra, systemd a PAM, ktorých predvolené hodnoty môžu byť nízke pre hostiteľa s mnohými VM, kontajnermi a sieťovými službami.",
|
||||
"headerFile": "Súbor",
|
||||
"headerSets": "Čo nastavuje",
|
||||
"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> a <code>nproc</code> na 1,048,576 (pre root bez obmedzenia)"
|
||||
},
|
||||
{
|
||||
"file": "/etc/systemd/system.conf + user.conf",
|
||||
"sets": "<code>DefaultLimitNOFILE=1048576</code> pre služby systemd"
|
||||
},
|
||||
{
|
||||
"file": "/etc/pam.d/common-session + runuser-l",
|
||||
"sets": "<code>session required pam_limits.so</code>, aby sa uvedené limity uplatnili v prihlasovacích shelloch"
|
||||
},
|
||||
{
|
||||
"file": "/root/.profile",
|
||||
"sets": "<code>ulimit -n 1048576</code> pre shell používateľa root"
|
||||
}
|
||||
],
|
||||
"tipTitle": "Prečo je inotify dôležité",
|
||||
"tipBody": "Docker, Syncthing, sledovanie súborov Node.js a skenovanie knižníc Plex môžu vyčerpať <code>max_user_watches</code>. Predvolená hodnota závisí od jadra a pamäte; nie je vždy 8192. Limit 1M umožní viac sledovaní bez ich predbežného pridelenia. Aktívne sledovania spotrebúvajú pamäť jadra, preto pri nedostatku RAM kontrolujte využitie."
|
||||
},
|
||||
"memory": {
|
||||
"heading": "Optimalizácia nastavenia pamäte",
|
||||
"intro": "Zapíše vyvážený profil sysctl do <code>/etc/sysctl.d/99-memory.conf</code>. Je navrhnutý pre hostiteľa hypervízora: uprednostňuje ponechanie aktívnej pamäte VM v RAM a vopred uvoľňuje stránky, aby nárazové prideľovanie pamäte nespôsobovalo zdržanie.",
|
||||
"warnTitle": "swappiness=10 na hostiteľoch s nedostatkom pamäte",
|
||||
"warnBody": "Na hostiteľovi so 16 GB RAM a mnohými VM môže zníženie swappiness viesť k ukončovaniu procesov pre nedostatok pamäte namiesto použitia swapu. Pri častých udalostiach OOM po spustení skriptu zvýšte swappiness na 30–60 v <code>/etc/sysctl.d/99-memory.conf</code>."
|
||||
},
|
||||
"kexec": {
|
||||
"heading": "Povoliť rýchle reštarty (kexec)",
|
||||
"intro": "Nainštaluje <code>kexec-tools</code> a nastaví ich na priamy reštart hostiteľa do nového jadra <em>bez prechodu firmvérom BIOS/UEFI</em>. Na veľkých serveroch, kde POST trvá 45 – 90 sekúnd, sa tým reštart môže skrátiť z prestávky na kávu na niekoľko sekúnd výpadku.",
|
||||
"installsTitle": "Čo nainštaluje ProxMenux",
|
||||
"installsItems": [
|
||||
"Balík <code>kexec-tools</code> (debconf má vopred nastavené <code>kexec-tools/load_kexec boolean false</code>, aby sa apt nepýtal a automatické načítanie pri vypínaní zostalo vypnuté).",
|
||||
"Jednotka Systemd <code>/etc/systemd/system/kexec-pve.service</code> — načíta jadro Proxmox a initrd do pamäte pri zavádzaní, pričom opätovne použije aktuálny cmdline.",
|
||||
"Alias v <code>/root/.bash_profile</code>: <code>reboot-quick</code> → <code>systemctl kexec</code>."
|
||||
],
|
||||
"usageIntro": "Použitie po ďalšom reštarte (alebo manuálnom <code>systemctl start kexec-pve</code>):",
|
||||
"warnTitle": "Kedy nepoužívať kexec",
|
||||
"warnBody": "kexec vynechá inicializáciu firmvéru. Ak BIOS/UEFI musí obnoviť stav hardvéru, napríklad GPU s passthrough vyžadujúca úplný POST alebo problémový firmvér HBA, reštart cez kexec môže nechať zariadenia čiastočne inicializované. Po aktualizácii jadra alebo pre zmeny BIOS/UEFI použite bežný <code>reboot</code>. <code>reboot-quick</code> je na každodenné reštarty."
|
||||
},
|
||||
"panic": {
|
||||
"heading": "Zapnúť reštart pri kernel panic",
|
||||
"intro": "Zabezpečí <strong>automatický reštart</strong> jadra namiesto trvalého zamrznutia na obrazovke paniky. Dôležité pri vzdialených hostiteľoch Proxmox bez lokálnej konzoly: pri zaseknutom jadre sú všetky VM nedostupné, kým hostiteľa nevypnete a znovu nezapnete.",
|
||||
"tipTitle": "Skombinujte to s prístupom k vzdialenej konzole",
|
||||
"tipBody": "Automatický reštart je mechanizmus obnovy, nie nástroj na ladenie. Ak chcete paniku <em>preskúmať</em>, nielen znovu spustiť systém, použite <link>možnosť kexec</link> vyššie s podporou kdump jadra, ktorú ProxMenux nenastavuje, alebo pred zapnutím automatického reštartu zachytávajte sériovú konzolu na inom hostiteľovi."
|
||||
},
|
||||
"verify": {
|
||||
"heading": "Overenie",
|
||||
"intro": "Po uplatnení optimalizácie systému:",
|
||||
"tipTitle": "Obnova a obmedzenia",
|
||||
"tipBody": "Všetkých šesť možností je v <code>installed_tools.json</code> a <link>Odinštalovať optimalizácie</link>. Obnova odstráni konfiguračné súbory, jednotku a alias kexec, prepíše journald.conf predvolenými hodnotami systemd a obnoví logrotate.conf zo zálohy. Niektoré aktívne limity vyžadujú novú reláciu alebo reštart."
|
||||
},
|
||||
"related": {
|
||||
"heading": "Súvisiace",
|
||||
"items": [
|
||||
{
|
||||
"label": "Užitočné systémové príkazy",
|
||||
"href": "/docs/help-info/system-commands",
|
||||
"tail": " — overte zmeny (free -h, journalctl, ulimit -a)."
|
||||
},
|
||||
{
|
||||
"label": "Výkon",
|
||||
"href": "/docs/post-install/performance",
|
||||
"tail": " — ďalšie systémové ladenie (pigz)."
|
||||
},
|
||||
{
|
||||
"label": "Odinštalovať optimalizácie",
|
||||
"href": "/docs/post-install/uninstall",
|
||||
"tail": " — vráťte tieto zmeny späť."
|
||||
},
|
||||
{
|
||||
"label": "Prispôsobiteľné nastavenia po inštalácii",
|
||||
"href": "/docs/post-install/customizable",
|
||||
"tail": " — späť do nadradeného menu."
|
||||
}
|
||||
]
|
||||
}
|
||||
}
|
||||
Some files were not shown because too many files have changed in this diff Show More
Reference in New Issue
Block a user