mirror of
https://github.com/MacRimi/ProxMenux.git
synced 2026-11-04 20:02:07 +00:00
docs(web): apply review feedback on Monitor docs
This commit is contained in:
@@ -288,10 +288,10 @@
|
||||
"generateTitle": "Generieren Sie ein Token",
|
||||
"generateIntro": "Aus dem Dashboard:",
|
||||
"generateSteps": [
|
||||
"Unter <strong>Registerkarte Sicherheit → Abschnitt API-Tokens</strong> öffnen.",
|
||||
"Öffnen Sie <strong>Admin → Sicherheit → API-Tokens</strong> und klicken Sie auf <strong>Neues Token generieren</strong>.",
|
||||
"Beschreibenden Namen angeben, <em>z. B. „Home Assistant“</em>.",
|
||||
"Geben Sie Ihr Passwort erneut ein. Wenn 2FA eingeschaltet ist, auch der aktuelle 6-stellige Code.",
|
||||
"<strong>Neues Token erstellen</strong> wählen, danach <strong>Token erstellen</strong>. Es erscheint <strong>nur einmal</strong>; sofort kopieren."
|
||||
"Klicken Sie auf <strong>Token generieren</strong>. Das Token erscheint <strong>nur einmal</strong>: Kopieren Sie es sofort."
|
||||
],
|
||||
"generateCli": "Aus der Kommandozeile:",
|
||||
"useTitle": "Verwenden Sie ein Token",
|
||||
|
||||
@@ -165,7 +165,7 @@
|
||||
},
|
||||
"ollama": {
|
||||
"heading": "Ollama (lokal)",
|
||||
"tagline": "Nutzt Modelle auf Ihrem Ollama-Server. Vollständig lokal, privat und kostenlos im Betrieb.",
|
||||
"tagline": "Nutzt die Modelle Ihres konfigurierten Ollama-Servers. Lokale Modelle laufen dort; Ollama-Cloud-Modelle leiten Anfragen an einen Cloud-Anbieter weiter. Lokale Ausführung vermeidet gehostete API-Gebühren, verbraucht aber eigene Hardware und Strom.",
|
||||
"items": [
|
||||
"Kein API-Schlüssel. Setzen Sie das <em>Ollama URL</em>-Feld auf Ihren Server (Standard <code>http://localhost:11434</code> oder welcher Host Ihre Ollama-Instanz ausführt).",
|
||||
"Modelle: <strong>nicht gefiltert.</strong> Der Monitor liest die Modelle, die Sie auf der Ollama-Seite über <code>ollama pull <model></code> gezogen haben. Der Dropdown wird von <code>GET /api/tags</code> auf Ihrem Ollama-Server ausgefüllt.",
|
||||
|
||||
@@ -50,7 +50,7 @@
|
||||
},
|
||||
{
|
||||
"name": "Terminal",
|
||||
"owns": "Browser-Shell auf dem Proxmox-Host mit <code>xterm.js</code> über WebSockets. LXC-Konsolen öffnen sich im Tab VMs & LXCs."
|
||||
"owns": "Browser-Shell auf dem Proxmox-Host mit <code>xterm.js</code> über WebSockets. LXC-Konsolen öffnen sich im Tab VMs und LXCs."
|
||||
},
|
||||
{
|
||||
"name": "Sicherheit",
|
||||
|
||||
@@ -203,7 +203,7 @@
|
||||
"heading": "LXC-Update-Erkennung",
|
||||
"imageAlt": "LXC-Update-Erkennung mit Schalter zur Suche nach Paketupdates in laufenden Debian-, Ubuntu- und Alpine-Containern",
|
||||
"imageCaption": "Schalter für regelmäßige Prüfungen mit <code>apt list --upgradable</code> / <code>apk list -u</code> in laufenden CTs. Standardmäßig aktiviert. Der zugehörige Schalter unter Benachrichtigungen → Dienste erscheint bei aktiver Erkennung.",
|
||||
"intro": "Der Schalter zwischen Schwellen und Benachrichtigungen steuert den LXC-Scan. Aktiv fragt er Paketmanager laufender CTs ab; VMs & LXCs zeigt Ergebnisse und <code>lxc_updates_available</code> erhält sie. Deaktiviert stoppt er seine <code>pct exec</code>-Aufrufe und entfernt LXC-Einträge aus <code>managed_installs.json</code>; <code>/api/managed-installs</code> meldet den Status dann ohne 24-Stunden-Wartezeit nicht mehr.",
|
||||
"intro": "Der Schalter zwischen Schwellen und Benachrichtigungen steuert den LXC-Scan. Aktiv fragt er Paketmanager laufender CTs ab; VMs und LXCs zeigt Ergebnisse und <code>lxc_updates_available</code> erhält sie. Deaktiviert stoppt er seine <code>pct exec</code>-Aufrufe und entfernt LXC-Einträge aus <code>managed_installs.json</code>; <code>/api/managed-installs</code> meldet den Status dann ohne 24-Stunden-Wartezeit nicht mehr.",
|
||||
"whatRunsTitle": "Was die Prüfung ausführt",
|
||||
"whatRunsIntro": "Für jeden CT im Zustand <code>running</code> mit unterstütztem Paketmanager:",
|
||||
"whatRunsItems": [
|
||||
|
||||
@@ -52,7 +52,7 @@
|
||||
"backupsTitle": "Sicherungen",
|
||||
"backupsBody": "Die Backup-Archive auf jedem backupfähigen Speicher (dir, NFS, CIFS, PBS), gelesen mit <code>pvesh get /nodes/localhost/storage/<id>/content</code>. Karten oben zeigen die Anzahl der VMs und LXCs sowie die Gesamtgröße; darunter steht eine Zeile pro Archiv mit Typ, Speicher, Größe und Datum. Die Wiederherstellung erfolgt in der Proxmox-Weboberfläche.",
|
||||
"notificationsTitle": "Benachrichtigungen",
|
||||
"notificationsBody1": "Proxmox-Benachrichtigungsaktivität: Journalzeilen von Proxmox-Diensten, die Benachrichtigungen, E-Mail, Webhooks oder Alarme erwähnen, die Ziele in /etc/pve/notifications.cfg und Backup-Aufgaben aus der Cluster-Aufgabenliste. Bei Zeilen von Backup-Aufgaben kann das vollständige Aufgabenprotokoll heruntergeladen werden. Der Verlauf dessen, was der Monitor selbst versendet hat, befindet sich unter Settings → Notifications → Notification history.",
|
||||
"notificationsBody1": "Proxmox-Benachrichtigungsaktivität: Journalzeilen von Proxmox-Diensten, die Benachrichtigungen, E-Mail, Webhooks oder Alarme erwähnen, die Ziele in /etc/pve/notifications.cfg und Backup-Aufgaben aus der Cluster-Aufgabenliste. Bei Zeilen von Backup-Aufgaben kann das vollständige Aufgabenprotokoll heruntergeladen werden. Der Verlauf dessen, was der Monitor selbst versendet hat, befindet sich unter Einstellungen → Benachrichtigungen → Benachrichtigungsverlauf.",
|
||||
"notificationsBody2": "Hier prüfen Sie, was das eigene Benachrichtigungssystem von Proxmox tut. Die Kanäle des Monitors konfigurieren Sie auf der Detailseite <link>Benachrichtigungen</link>."
|
||||
},
|
||||
"dataCollected": {
|
||||
@@ -64,7 +64,7 @@
|
||||
{
|
||||
"subtab": "Protokolle (Live-Filter)",
|
||||
"endpoint": "/api/logs",
|
||||
"source": "<code>journalctl</code> mit serverseitig angewendeten Filtern für Priorität, Dienst und Tagesbereich; die Textsuche läuft im Browser."
|
||||
"source": "Der Tab ruft <code>/api/logs?since_days=N</code> ab; Stufe, Dienst und Textsuche werden im Browser gefiltert. Die API akzeptiert auch <code>priority</code> und <code>service</code>, die der Tab noch nicht nutzt."
|
||||
},
|
||||
{
|
||||
"subtab": "Herunterladen",
|
||||
|
||||
@@ -20,13 +20,13 @@
|
||||
"heading": "Authentifizierung: Das Einzige, was jedes Rezept braucht",
|
||||
"intro": "Die meisten von diesen Integrationen verwendeten Endpunkte werden authentifiziert. Sie haben zwei Möglichkeiten, diese Anforderung zu erfüllen.",
|
||||
"optAtitle": "Option A — API-Token (für Integrationen empfohlen)",
|
||||
"optAbody1": "Öffnen Sie <strong>Admin → Sicherheit → API-Token</strong>. Wählen Sie <em>Token erzeugen</em>, vergeben Sie einen Namen wie <em>homepage</em>, <em>home-assistant</em> oder <em>prometheus</em> und kopieren Sie das Token: Es erscheint <em>nur einmal</em>. Es läuft standardmäßig nach einem Jahr ab und ist einzeln widerrufbar. Nutzen Sie es für Clients außerhalb des Browsers.",
|
||||
"optAbody1": "Öffnen Sie <strong>Admin → Sicherheit → API-Tokens</strong>. Wählen Sie <em>Neues Token generieren</em>, vergeben Sie einen Namen wie <em>homepage</em>, <em>home-assistant</em> oder <em>prometheus</em>, geben Sie Ihr Passwort ein (und bei aktivierter 2FA den Code), klicken Sie dann auf <em>Token generieren</em> und kopieren Sie das Token: Es erscheint <em>nur einmal</em>. Es läuft standardmäßig nach einem Jahr ab und ist einzeln widerrufbar. Nutzen Sie es für Clients außerhalb des Browsers.",
|
||||
"optAbody2": "Ab diesem Zeitpunkt ist jede Anfrage nur noch:",
|
||||
"optBtitle": "Option B — Login-Flow (Benutzername + Passwort)",
|
||||
"optBbody": "Nützlich für Skripte, die sich als menschlicher Benutzer authentifizieren. Das zurückgegebene Token ist kurzlebig; die meisten Integrationen sollten Option A bevorzugen.",
|
||||
"outro": "Das TOTP-Feld ist nur bei aktivierter Zwei-Faktor-Authentifizierung nötig. Tokenwechsel, Widerruf, Passwortrichtlinien und Prüfprotokoll sind unter <link>Zugriff und Authentifizierung</link> beschrieben.",
|
||||
"httpsTitle": "Verwendung von HTTPS anstelle von HTTP",
|
||||
"httpsIntro": "Jedes Rezept unten verwendet <code>http://</code> in den URLs, um die Beispiele kurz zu halten. Wenn Sie TLS auf dem Monitor aktiviert haben (<strong>Admin → Security → SSL / HTTPS</strong>), tauschen Sie <code>http://</code> in jeder URL gegen <code>https://</code> aus – das ist die einzige Änderung. Zwei spezielle Anmerkungen zu bestimmten Werkzeugen:",
|
||||
"httpsIntro": "Jedes Rezept unten verwendet <code>http://</code> in den URLs, um die Beispiele kurz zu halten. Wenn Sie TLS auf dem Monitor aktiviert haben (<strong>Admin → Sicherheit → SSL / HTTPS</strong>), tauschen Sie <code>http://</code> in jeder URL gegen <code>https://</code> aus – das ist die einzige Änderung. Zwei spezielle Anmerkungen zu bestimmten Werkzeugen:",
|
||||
"httpsItems": [
|
||||
"<strong>Selbstsignierte Zertifikate.</strong> Die Home-Assistant-Integration <code>rest:</code> prüft TLS standardmäßig. Für ein selbstsigniertes Monitor-Zertifikat setzen Sie <code>verify_ssl: false</code> in jeden REST-Block neben <code>scan_interval:</code> oder nehmen die Monitor-CA in den Vertrauensspeicher auf. Entsprechendes gilt für andere Werkzeuge mit Zertifikatsprüfung.",
|
||||
"<strong>Prometheus</strong> enthält unten bereits <code>scheme: https</code>. Aktivieren oder behalten Sie <code>https</code>, wenn TLS im Monitor aktiv ist."
|
||||
@@ -43,7 +43,7 @@
|
||||
"basicTitle": "Grundlegendes Widget — keine Authentifizierung",
|
||||
"basicIntro": "Verwenden Sie dies, wenn sich ProxMenux Monitor in einem vertrauenswürdigen Netzwerk befindet und Sie die Authentifizierung auf der Monitorseite noch nicht aktiviert haben. Der einfachste mögliche <code>services.yaml</code>-Eintrag:",
|
||||
"authedTitle": "Authentifiziertes Widget",
|
||||
"authedIntro": "Generieren Sie ein API-Token in <strong>Admin → Security → API Tokens</strong> auf dem Monitor, kopieren Sie es und fügen Sie es in den <code>Authorization</code>-Header unten ein - ersetzen Sie das Beispiel-Token, das nach <code>Bearer</code> angezeigt wird, durch das, das Sie gerade kopiert haben:",
|
||||
"authedIntro": "Generieren Sie ein API-Token in <strong>Admin → Sicherheit → API-Tokens</strong> auf dem Monitor, kopieren Sie es und fügen Sie es in den <code>Authorization</code>-Header unten ein - ersetzen Sie das Beispiel-Token, das nach <code>Bearer</code> angezeigt wird, durch das, das Sie gerade kopiert haben:",
|
||||
"authedOutro": "Starten Sie die Homepage neu und die Karte leuchtet mit Live-Werten auf. Verwenden Sie das gleiche Token für alle Homepage-Widgets, die auf denselben ProxMenux Monitor-Host zeigen.",
|
||||
"multiTitle": "Einrichtung von Multiwidgets — System, Speicher, Netzwerk",
|
||||
"multiIntro": "Für mehr Details nutzen Sie drei Karten mit unterschiedlichen Endpunkten: Systemmetriken, Datenspeicher und Netzwerk. Für dieselbe Monitor-Instanz verwenden alle dasselbe Token.",
|
||||
|
||||
@@ -288,10 +288,10 @@
|
||||
"generateTitle": "Generate a token",
|
||||
"generateIntro": "From the dashboard:",
|
||||
"generateSteps": [
|
||||
"Navigate to <strong>the Security tab → API Tokens</strong> section.",
|
||||
"Open <strong>Admin → Security → API Tokens</strong> and click <strong>Generate new token</strong>.",
|
||||
"Type a descriptive name (<em>e.g. \"Home Assistant\"</em>).",
|
||||
"Re-enter your password. If 2FA is on, also the current 6-digit code.",
|
||||
"Click <strong>Generate new token</strong>, then <strong>Generate token</strong>. The token appears <strong>once</strong> — copy it immediately."
|
||||
"Click <strong>Generate token</strong>. The token appears <strong>once</strong>: copy it immediately."
|
||||
],
|
||||
"generateCli": "From the command line:",
|
||||
"useTitle": "Use a token",
|
||||
|
||||
@@ -165,7 +165,7 @@
|
||||
},
|
||||
"ollama": {
|
||||
"heading": "Ollama (Local)",
|
||||
"tagline": "Uses models on your Ollama server. Fully local, private and free to run.",
|
||||
"tagline": "Uses models exposed by your configured Ollama server. Local models execute there; Ollama cloud models forward requests to a cloud provider. Local execution avoids a hosted API charge but still uses your hardware and electricity.",
|
||||
"items": [
|
||||
"No API key. Set the <em>Ollama URL</em> field to your server (default <code>http://localhost:11434</code> or whatever host runs your Ollama instance).",
|
||||
"Models: <strong>not filtered.</strong> The Monitor reads whichever models you have pulled on the Ollama side via <code>ollama pull <model></code>. The dropdown is populated from <code>GET /api/tags</code> on your Ollama server.",
|
||||
|
||||
@@ -64,7 +64,7 @@
|
||||
{
|
||||
"subtab": "Logs (live filter)",
|
||||
"endpoint": "/api/logs",
|
||||
"source": "<code>journalctl</code> with priority, service and day-range filters applied server-side; text search runs in the browser."
|
||||
"source": "The tab requests <code>/api/logs?since_days=N</code>; level, service and text filters run in the browser. The API also accepts <code>priority</code> and <code>service</code>, which the tab does not use yet."
|
||||
},
|
||||
{
|
||||
"subtab": "Download",
|
||||
|
||||
@@ -20,7 +20,7 @@
|
||||
"heading": "Authentication: the one thing every recipe needs",
|
||||
"intro": "Most endpoints used by these integrations are authenticated. You have two ways to satisfy that requirement.",
|
||||
"optAtitle": "Option A — API token (recommended for integrations)",
|
||||
"optAbody1": "Open the dashboard and go to <strong>Admin → Security → API Tokens</strong>. Click <em>Generate token</em>, give it a name (e.g. <em>homepage</em>, <em>home-assistant</em>, <em>prometheus</em>), and copy the token — it's shown <em>once</em>. Long-lived (one-year expiry by default), individually revocable, and what you should be using for any non-browser client.",
|
||||
"optAbody1": "Open the dashboard and go to <strong>Admin → Security → API Tokens</strong>. Click <em>Generate new token</em>, give it a name (e.g. <em>homepage</em>, <em>home-assistant</em>, <em>prometheus</em>), enter your password (and the 2FA code if enabled), then click <em>Generate token</em> and copy the token: it's shown <em>once</em>. Long-lived (one-year expiry by default), individually revocable, and what you should be using for any non-browser client.",
|
||||
"optAbody2": "From that point every request is just:",
|
||||
"optBtitle": "Option B — login flow (username + password)",
|
||||
"optBbody": "Useful for scripts that authenticate as a human user. The returned token is short-lived; most integrations should prefer Option A.",
|
||||
|
||||
@@ -284,14 +284,14 @@
|
||||
"heading": "API tokens (larga duración)",
|
||||
"intro": "Las sesiones de navegador caducan tras 24 horas. Para integraciones desatendidas (widgets de Homepage, sensores de Home Assistant, scrapers de Grafana, probes de Uptime Kuma…) generas un <strong>API token</strong> aparte que vive 365 días. El token es un JWT firmado con el mismo secret que el token de sesión, pero su claim <code>token_name</code> facilita rastrearlo y revocarlo individualmente.",
|
||||
"imageAlt": "Panel de API tokens mostrando la lista de tokens con nombre, prefijo, fecha de creación y caducidad",
|
||||
"imageCaption": "La lista de API tokens bajo Admin → Security — nombre, prefijo (se muestran los últimos 4 caracteres para identificación), fechas de creación y caducidad, acción de revocar.",
|
||||
"imageCaption": "La lista de API tokens bajo Administración → Seguridad — nombre, prefijo (se muestran los últimos 4 caracteres para identificación), fechas de creación y caducidad, acción de revocar.",
|
||||
"generateTitle": "Generar un token",
|
||||
"generateIntro": "Desde el panel:",
|
||||
"generateSteps": [
|
||||
"Abre la sección <strong>Seguridad → API Tokens</strong>.",
|
||||
"Abre <strong>Administración → Seguridad → Tokens API</strong> y pulsa <strong>Generar nuevo token</strong>.",
|
||||
"Escribe un nombre descriptivo (<em>p. ej. \"Home Assistant\"</em>).",
|
||||
"Vuelve a introducir tu contraseña. Si el 2FA está activado, también el código actual de 6 dígitos.",
|
||||
"Pulsa <strong>Generar nuevo token</strong> y después <strong>Generar token</strong>. Se muestra <strong>una sola vez</strong>: cópialo al momento."
|
||||
"Pulsa <strong>Generar token</strong>. El token aparece <strong>una sola vez</strong>: cópialo de inmediato."
|
||||
],
|
||||
"generateCli": "Desde la línea de comandos:",
|
||||
"useTitle": "Usar un token",
|
||||
@@ -310,7 +310,7 @@
|
||||
"intro": "Dos rutas hacia TLS:",
|
||||
"items": [
|
||||
"<strong>Reverse proxy (recomendado).</strong> Termina TLS en Nginx / Caddy / Traefik y reenvía HTTP en el puerto 8008 al proceso Flask. Snippets más abajo.",
|
||||
"<strong>HTTPS directo en AppImage.</strong> Configura un certificado con <code>POST /api/ssl/configure</code> (interfaz: <strong>Admin → Security → SSL / HTTPS</strong>). HTTPS usa <code>gevent.pywsgi</code> con su manejador estándar; flask-sock gestiona la conexión WebSocket para WSS. Las rutas de los certificados se guardan en la configuración SSL."
|
||||
"<strong>HTTPS directo en AppImage.</strong> Configura un certificado con <code>POST /api/ssl/configure</code> (interfaz: <strong>Administración → Seguridad → SSL/HTTPS</strong>). HTTPS usa <code>gevent.pywsgi</code> con su manejador estándar; flask-sock gestiona la conexión WebSocket para WSS. Las rutas de los certificados se guardan en la configuración SSL."
|
||||
],
|
||||
"calloutTitle": "Limitaciones del HTTPS directo",
|
||||
"calloutBody": "Monitor puede usar un certificado gestionado por Proxmox o archivos de certificados propios. No emite certificados ACME. Para emitirlos y renovarlos automáticamente, usa ACME de Proxmox o un proxy inverso como Caddy, Traefik o Nginx y asegúrate de cargar los certificados renovados."
|
||||
|
||||
@@ -165,7 +165,7 @@
|
||||
},
|
||||
"ollama": {
|
||||
"heading": "Ollama (local)",
|
||||
"tagline": "Usa los modelos de tu servidor Ollama. Totalmente local, privado y gratuito de ejecutar.",
|
||||
"tagline": "Usa los modelos expuestos por el servidor Ollama configurado. Los modelos locales se ejecutan allí; los modelos cloud de Ollama envían las peticiones a un proveedor externo. La ejecución local evita cargos de API alojada, pero utiliza tu hardware y electricidad.",
|
||||
"items": [
|
||||
"Sin API key. Configura el campo <em>Ollama URL</em> a tu servidor (por defecto <code>http://localhost:11434</code> o el host que ejecute tu instancia de Ollama).",
|
||||
"Modelos: <strong>no filtrados.</strong> El Monitor lee los modelos que hayas descargado en el lado de Ollama vía <code>ollama pull <model></code>. El dropdown se llena desde <code>GET /api/tags</code> en tu servidor Ollama.",
|
||||
|
||||
@@ -50,7 +50,7 @@
|
||||
},
|
||||
{
|
||||
"name": "Terminal",
|
||||
"owns": "Shell del navegador en el host Proxmox, con <code>xterm.js</code> sobre WebSockets. Las consolas LXC se abren desde la pestaña VMs & LXCs."
|
||||
"owns": "Shell del navegador en el host Proxmox, con <code>xterm.js</code> sobre WebSockets. Las consolas LXC se abren desde la pestaña VM y LXC."
|
||||
},
|
||||
{
|
||||
"name": "Seguridad",
|
||||
|
||||
@@ -203,7 +203,7 @@
|
||||
"heading": "Detección de actualización de LXC",
|
||||
"imageAlt": "Tarjeta de detección de actualizaciones LXC con interruptor para buscar paquetes pendientes en contenedores Debian, Ubuntu y Alpine en ejecución",
|
||||
"imageCaption": "Interruptor del análisis periódico con <code>apt list --upgradable</code> / <code>apk list -u</code> en los CT en ejecución. Viene activado. El interruptor de aviso en Notificaciones → Servicios aparece mientras la detección está activa.",
|
||||
"intro": "El interruptor entre Umbrales y Notificaciones controla el análisis LXC. Al activarlo, consulta los gestores de paquetes de CT en ejecución; los resultados aparecen en VMs & LXCs y alimentan <code>lxc_updates_available</code>. Al desactivarlo, cesan sus llamadas <code>pct exec</code> y se eliminan las entradas LXC de <code>managed_installs.json</code>, por lo que <code>/api/managed-installs</code> deja de mostrar ese estado sin esperar 24 h.",
|
||||
"intro": "El interruptor entre Umbrales y Notificaciones controla el análisis LXC. Al activarlo, consulta los gestores de paquetes de CT en ejecución; los resultados aparecen en VM y LXC y alimentan <code>lxc_updates_available</code>. Al desactivarlo, cesan sus llamadas <code>pct exec</code> y se eliminan las entradas LXC de <code>managed_installs.json</code>, por lo que <code>/api/managed-installs</code> deja de mostrar ese estado sin esperar 24 h.",
|
||||
"whatRunsTitle": "Qué ejecuta el análisis",
|
||||
"whatRunsIntro": "Para cada CT en estado <code>running</code> con un gestor de paquetes compatible:",
|
||||
"whatRunsItems": [
|
||||
|
||||
@@ -52,7 +52,7 @@
|
||||
"backupsTitle": "Backups",
|
||||
"backupsBody": "Los archivos de backup de cada almacenamiento con capacidad de backup (dir, NFS, CIFS, PBS), leídos con <code>pvesh get /nodes/localhost/storage/<id>/content</code>. Las tarjetas de arriba muestran el número de VMs y LXC y el tamaño total; debajo, una fila por archivo con tipo, almacenamiento, tamaño y fecha. La restauración se hace en la interfaz web de Proxmox.",
|
||||
"notificationsTitle": "Notificaciones",
|
||||
"notificationsBody1": "Actividad de notificaciones de Proxmox: líneas del journal de servicios de Proxmox que mencionan notificaciones, correo, webhooks o alertas, los destinos de /etc/pve/notifications.cfg y las tareas de backup de la lista de tareas del cluster. Las filas de tareas de backup permiten descargar el log completo de la tarea. El historial de lo que el propio Monitor envió está en Settings → Notifications → Notification history.",
|
||||
"notificationsBody1": "Actividad de notificaciones de Proxmox: líneas del journal de servicios de Proxmox que mencionan notificaciones, correo, webhooks o alertas, los destinos de /etc/pve/notifications.cfg y las tareas de backup de la lista de tareas del cluster. Las filas de tareas de backup permiten descargar el log completo de la tarea. El historial de lo que el propio Monitor envió está en Ajustes → Notificaciones → Historial de notificaciones.",
|
||||
"notificationsBody2": "Usa esta pestaña para comprobar qué está haciendo el propio sistema de notificaciones de Proxmox. Los canales del Monitor se configuran en la página detallada de <link>Notificaciones</link>."
|
||||
},
|
||||
"dataCollected": {
|
||||
@@ -64,7 +64,7 @@
|
||||
{
|
||||
"subtab": "Logs (filtro en vivo)",
|
||||
"endpoint": "/api/logs",
|
||||
"source": "<code>journalctl</code> con filtros de prioridad, servicio y rango de días aplicados en el servidor; la búsqueda de texto se ejecuta en el navegador."
|
||||
"source": "La pestaña pide <code>/api/logs?since_days=N</code>; los filtros de nivel, servicio y texto se aplican en el navegador. La API también acepta <code>priority</code> y <code>service</code>, que la pestaña todavía no usa."
|
||||
},
|
||||
{
|
||||
"subtab": "Descargar",
|
||||
|
||||
@@ -113,7 +113,7 @@
|
||||
"api": {
|
||||
"heading": "API REST e integraciones",
|
||||
"intro": "Los endpoints REST ofrecen datos de monitorización JSON por HTTP/HTTPS para widgets Homepage, sensores Home Assistant, pruebas Uptime Kuma y scripts. Grafana puede usar el exportador de texto Prometheus en <code>/api/prometheus</code>. Las peticiones se pueden hacer con <code>curl</code>.",
|
||||
"tokens": "Los tokens API de larga duración (365 días) se generan en <strong>Admin → Security → API Tokens</strong> o mediante <code>POST /api/auth/generate-api-token</code>.",
|
||||
"tokens": "Los tokens API de larga duración (365 días) se generan en <strong>Administración → Seguridad → Tokens API</strong> o mediante <code>POST /api/auth/generate-api-token</code>.",
|
||||
"bearer": "Envía tokens con <code>Authorization: Bearer …</code>. <code>/api/health</code> también espera la cabecera Bearer, así que las pruebas de disponibilidad necesitan un token read_only. Bajo <code>/api/auth/*</code> hay rutas públicas de configuración/inicio/estado y rutas protegidas de cuentas y tokens; no todas son anónimas.",
|
||||
"catalog": "El catálogo de endpoints, rotación de tokens y prácticas de seguridad están en <linkApi>Referencia de la API</linkApi>. Los ejemplos para Homepage, Home Assistant, Grafana, Uptime Kuma y cURL están en <linkIntegrations>Integraciones</linkIntegrations>."
|
||||
},
|
||||
|
||||
@@ -20,13 +20,13 @@
|
||||
"heading": "Autenticación: lo único que cada guía necesita",
|
||||
"intro": "La mayoría de los endpoints usados por estas integraciones están autenticados. Tienes dos formas de satisfacer ese requisito.",
|
||||
"optAtitle": "Opción A — API token (recomendado para integraciones)",
|
||||
"optAbody1": "Entra en <strong>Admin → Security → API Tokens</strong>. Pulsa <em>Generar token</em>, ponle un nombre, como <em>homepage</em>, <em>home-assistant</em> o <em>prometheus</em>, y cópialo: se muestra <em>una sola vez</em>. Caduca al año por defecto y puede revocarse individualmente. Úsalo para los clientes externos al navegador.",
|
||||
"optAbody1": "Entra en <strong>Administración → Seguridad → Tokens API</strong>. Pulsa <em>Generar nuevo token</em>, ponle un nombre, como <em>homepage</em>, <em>home-assistant</em> o <em>prometheus</em>, introduce tu contraseña (y el código 2FA si está activado), pulsa <em>Generar token</em> y cópialo: se muestra <em>una sola vez</em>. Caduca al año por defecto y puede revocarse individualmente. Úsalo para los clientes externos al navegador.",
|
||||
"optAbody2": "A partir de ahí cada petición es simplemente:",
|
||||
"optBtitle": "Opción B — flujo de login (usuario + contraseña)",
|
||||
"optBbody": "Útil para scripts que se autentican como un usuario humano. El token devuelto es de corta duración; la mayoría de integraciones deberían preferir la Opción A.",
|
||||
"outro": "El campo TOTP solo hace falta con la autenticación en dos pasos activada. La rotación y revocación de tokens, la política de contraseñas y el registro de auditoría se explican en <link>Acceso y autenticación</link>.",
|
||||
"httpsTitle": "Usando HTTPS en lugar de HTTP",
|
||||
"httpsIntro": "Cada guía de abajo usa <code>http://</code> en las URLs para mantener los ejemplos cortos. Si has activado TLS en el Monitor (<strong>Admin → Security → SSL / HTTPS</strong>), cambia <code>http://</code> por <code>https://</code> en cada URL — ese es el único cambio. Dos notas específicas para ciertas herramientas:",
|
||||
"httpsIntro": "Cada guía de abajo usa <code>http://</code> en las URLs para mantener los ejemplos cortos. Si has activado TLS en el Monitor (<strong>Administración → Seguridad → SSL/HTTPS</strong>), cambia <code>http://</code> por <code>https://</code> en cada URL — ese es el único cambio. Dos notas específicas para ciertas herramientas:",
|
||||
"httpsItems": [
|
||||
"<strong>Certificados autofirmados.</strong> La integración <code>rest:</code> de Home Assistant verifica TLS por defecto. Si el Monitor está usando su propio cert autofirmado, añade <code>verify_ssl: false</code> a cada bloque REST (junto a <code>scan_interval:</code>), o importa la CA del Monitor al trust store de HA. Lo mismo para cualquier herramienta que rechace certs no confiables.",
|
||||
"<strong>Prometheus</strong> ya tiene <code>scheme: https</code> listo en la configuración de scrape de abajo; descomenta / déjalo como <code>https</code> si TLS está activado en el Monitor."
|
||||
@@ -43,7 +43,7 @@
|
||||
"basicTitle": "Widget básico — sin autenticación",
|
||||
"basicIntro": "Usa esto cuando ProxMenux Monitor esté en una red de confianza y aún no hayas activado la autenticación en el lado del Monitor. La entrada más simple posible en <code>services.yaml</code>:",
|
||||
"authedTitle": "Widget autenticado",
|
||||
"authedIntro": "Genera un API token en <strong>Admin → Security → API Tokens</strong> en el Monitor, cópialo y pégalo en la cabecera <code>Authorization</code> de abajo — reemplaza el token de ejemplo mostrado tras <code>Bearer</code> con el que acabas de copiar:",
|
||||
"authedIntro": "Genera un API token en <strong>Administración → Seguridad → Tokens API</strong> en el Monitor, cópialo y pégalo en la cabecera <code>Authorization</code> de abajo — reemplaza el token de ejemplo mostrado tras <code>Bearer</code> con el que acabas de copiar:",
|
||||
"authedOutro": "Reinicia Homepage y la tarjeta se enciende con valores en vivo. Reutiliza el mismo token en todos los widgets Homepage que apunten al mismo host de ProxMenux Monitor.",
|
||||
"multiTitle": "Setup multi-widget — sistema, almacenamiento, red",
|
||||
"multiIntro": "Para una vista más rica, renderiza tres tarjetas separadas respaldadas por distintos endpoints — una para métricas del sistema, una para almacenamiento, una para red. Usa el mismo token en cada tarjeta; es la misma instancia del Monitor.",
|
||||
|
||||
@@ -12,13 +12,13 @@
|
||||
},
|
||||
"intro": {
|
||||
"title": "Qué cubre esta página",
|
||||
"body": "Cómo cambiar el Monitor de HTTP a HTTPS en el panel Admin → Security, a qué apunta realmente cada fuente de certificado en disco, cómo se comporta la opción de Proxmox cuando el host tiene un certificado Let's Encrypt y cómo establecer rutas personalizadas si gestionas certificados fuera de Proxmox."
|
||||
"body": "Cómo cambiar el Monitor de HTTP a HTTPS en el panel Administración → Seguridad, a qué apunta realmente cada fuente de certificado en disco, cómo se comporta la opción de Proxmox cuando el host tiene un certificado Let's Encrypt y cómo establecer rutas personalizadas si gestionas certificados fuera de Proxmox."
|
||||
},
|
||||
"wheresetting": {
|
||||
"heading": "Ubicación del ajuste",
|
||||
"body": "Abre Monitor y ve a <strong>Admin → Security → SSL / HTTPS</strong>. El panel muestra HTTP o HTTPS y, si HTTPS no está activo, las fuentes de certificados detectadas.",
|
||||
"imageAlt": "Panel Admin → Security → SSL / HTTPS en el Monitor mostrando el estado HTTPS desactivado, el certificado de Proxmox autodetectado (subject, issuer, expiry) y la opción Use Custom Certificate",
|
||||
"caption": "Panel Admin → Security → SSL / HTTPS antes de activar HTTPS. Monitor muestra el certificado que usa Proxmox y permite elegirlo con un clic."
|
||||
"body": "Abre Monitor y ve a <strong>Administración → Seguridad → SSL/HTTPS</strong>. El panel muestra HTTP o HTTPS y, si HTTPS no está activo, las fuentes de certificados detectadas.",
|
||||
"imageAlt": "Panel Administración → Seguridad → SSL/HTTPS en el Monitor mostrando el estado HTTPS desactivado, el certificado de Proxmox autodetectado (subject, issuer, expiry) y la opción Use Custom Certificate",
|
||||
"caption": "Panel Administración → Seguridad → SSL/HTTPS antes de activar HTTPS. Monitor muestra el certificado que usa Proxmox y permite elegirlo con un clic."
|
||||
},
|
||||
"twoways": {
|
||||
"heading": "Dos formas de habilitar HTTPS",
|
||||
@@ -117,7 +117,7 @@
|
||||
},
|
||||
"switchToHttps": {
|
||||
"heading": "Cambiar el Monitor a HTTPS",
|
||||
"bodyRich": "Una vez que <code>/etc/pve/local/pveproxy-ssl.pem</code> está firmado por Let's Encrypt, abre <strong>Admin → Security → SSL / HTTPS</strong>, comprueba que el emisor sea <em>Let's Encrypt</em> y no la CA local de Proxmox, y pulsa <strong>Usar certificado de Proxmox</strong>. Monitor se reinicia y la siguiente carga usa HTTPS en 8008 con una cadena de confianza pública. Las renovaciones ACME posteriores se validan y seleccionan en la siguiente conexión TLS nueva, sin sondeo periódico ni reinicio del servicio por renovación. <strong>Actualizar certificado</strong> sigue disponible en Seguridad como acción explícita de diagnóstico y recuperación."
|
||||
"bodyRich": "Una vez que <code>/etc/pve/local/pveproxy-ssl.pem</code> está firmado por Let's Encrypt, abre <strong>Administración → Seguridad → SSL/HTTPS</strong>, comprueba que el emisor sea <em>Let's Encrypt</em> y no la CA local de Proxmox, y pulsa <strong>Usar certificado de Proxmox</strong>. Monitor se reinicia y la siguiente carga usa HTTPS en 8008 con una cadena de confianza pública. Las renovaciones ACME posteriores se validan y seleccionan en la siguiente conexión TLS nueva, sin sondeo periódico ni reinicio del servicio por renovación. <strong>Actualizar certificado</strong> sigue disponible en Seguridad como acción explícita de diagnóstico y recuperación."
|
||||
},
|
||||
"custom": {
|
||||
"heading": "Certificado personalizado — cuándo usarlo",
|
||||
|
||||
@@ -284,14 +284,14 @@
|
||||
"heading": "Jetons API de longue durée",
|
||||
"intro": "Les sessions expirent après 24 heures. Pour Homepage, Home Assistant, Grafana ou Uptime Kuma, créez un <strong>jeton API</strong> valable 365 jours. Ce JWT utilise le même secret de signature ; le champ <code>token_name</code> permet de le suivre et de le révoquer individuellement.",
|
||||
"imageAlt": "Panneau de jetons API montrant la liste de jetons avec nom, préfixe, date de création et expiration",
|
||||
"imageCaption": "Liste des jetons d’API sous Admin → Sécurité : nom, préfixe avec quatre derniers caractères d’identification, dates de création et d’expiration, action de révocation.",
|
||||
"imageCaption": "Liste des jetons d’API sous Administrateur → Sécurité : nom, préfixe avec quatre derniers caractères d’identification, dates de création et d’expiration, action de révocation.",
|
||||
"generateTitle": "Générer un jeton",
|
||||
"generateIntro": "Dans le tableau de bord:",
|
||||
"generateSteps": [
|
||||
"Ouvrez <strong>l’onglet Sécurité → section Jetons d’API</strong>.",
|
||||
"Ouvrez <strong>Administrateur → Sécurité → Jetons API</strong> et cliquez sur <strong>Générer un nouveau jeton</strong>.",
|
||||
"Tapez un nom descriptif (<em>p.ex. \"Home Assistant\"</em>).",
|
||||
"Entrez de nouveau votre mot de passe. Si 2FA est activé, aussi le code à chiffres 6 actuel.",
|
||||
"Cliquez sur <strong>Générer un nouveau jeton</strong>, puis sur <strong>Générer le jeton</strong>. Il s’affiche <strong>une seule fois</strong> : copiez-le immédiatement."
|
||||
"Cliquez sur <strong>Générer un jeton</strong>. Le jeton n’apparaît <strong>qu’une fois</strong> : copiez-le immédiatement."
|
||||
],
|
||||
"generateCli": "Depuis la ligne de commande :",
|
||||
"useTitle": "Utiliser un jeton",
|
||||
@@ -310,7 +310,7 @@
|
||||
"intro": "Deux chemins vers TLS:",
|
||||
"items": [
|
||||
"<strong>Proxy inverse recommandé.</strong> Terminez TLS sur Nginx / Caddy / Traefik et transmettez HTTP au processus Flask sur le port 8008. Exemples ci-dessous.",
|
||||
"<strong>HTTPS direct dans l’AppImage.</strong> Configurez un certificat via <code>POST /api/ssl/configure</code> (interface : <strong>Admin → Sécurité → SSL / HTTPS</strong>). HTTPS utilise <code>gevent.pywsgi</code> avec son gestionnaire standard ; flask-sock gère WebSocket pour WSS. Les chemins des certificats sont enregistrés dans la configuration SSL."
|
||||
"<strong>HTTPS direct dans l’AppImage.</strong> Configurez un certificat via <code>POST /api/ssl/configure</code> (interface : <strong>Administrateur → Sécurité → SSL / HTTPS</strong>). HTTPS utilise <code>gevent.pywsgi</code> avec son gestionnaire standard ; flask-sock gère WebSocket pour WSS. Les chemins des certificats sont enregistrés dans la configuration SSL."
|
||||
],
|
||||
"calloutTitle": "Limites directes de HTTPS",
|
||||
"calloutBody": "Monitor peut utiliser un certificat géré par Proxmox ou des fichiers personnalisés. Il n’émet pas lui-même de certificats ACME. Pour l’émission et le renouvellement automatiques, utilisez Proxmox ACME ou un proxy inverse Caddy, Traefik ou Nginx et veillez au chargement des certificats renouvelés."
|
||||
|
||||
@@ -165,7 +165,7 @@
|
||||
},
|
||||
"ollama": {
|
||||
"heading": "Ollama (local)",
|
||||
"tagline": "Utilise les modèles de votre serveur Ollama. Entièrement local, privé et gratuit à exécuter.",
|
||||
"tagline": "Utilise les modèles du serveur Ollama configuré. Les modèles locaux s’exécutent sur ce serveur ; les modèles cloud transmettent les requêtes à un fournisseur externe. L’exécution locale évite les frais d’API hébergée, mais utilise votre matériel et votre électricité.",
|
||||
"items": [
|
||||
"Pas de clé API. Définissez le champ <em>Ollama URL</em> sur votre serveur (par défaut <code>http://localhost:11434</code> ou quel que soit l'hôte exécute votre instance Ollama).",
|
||||
"Modèles: <strong>non filtré.</strong> Le moniteur lit les modèles que vous avez tirés sur le côté Ollama via <code>ollama pull <model></code>. Le menu déroulant est peuplé de <code>GET /api/tags</code> sur votre serveur Ollama.",
|
||||
|
||||
@@ -50,7 +50,7 @@
|
||||
},
|
||||
{
|
||||
"name": "Terminal",
|
||||
"owns": "Shell dans le navigateur sur l’hôte Proxmox, avec <code>xterm.js</code> via WebSockets. Les consoles LXC s’ouvrent depuis l’onglet VMs & LXCs."
|
||||
"owns": "Shell dans le navigateur sur l’hôte Proxmox, avec <code>xterm.js</code> via WebSockets. Les consoles LXC s’ouvrent depuis l’onglet VM et LXC."
|
||||
},
|
||||
{
|
||||
"name": "Sécurité",
|
||||
|
||||
@@ -203,7 +203,7 @@
|
||||
"heading": "Détection de mise à jour LXC",
|
||||
"imageAlt": "Carte de détection des mises à jour LXC avec interrupteur pour les paquets en attente des conteneurs Debian, Ubuntu et Alpine actifs",
|
||||
"imageCaption": "Interrupteur de l’analyse périodique par <code>apt list --upgradable</code> / <code>apk list -u</code> dans les CT actifs. Activé par défaut. Le réglage associé dans Notifications → Services apparaît lorsque la détection est active.",
|
||||
"intro": "L’interrupteur entre Seuils et Notifications contrôle l’analyse LXC. Activé, il interroge les gestionnaires de paquets des CT actifs ; l’onglet VMs & LXCs affiche les résultats et alimente <code>lxc_updates_available</code>. Désactivé, il arrête ses appels <code>pct exec</code> et supprime les entrées LXC de <code>managed_installs.json</code> ; <code>/api/managed-installs</code> cesse d’afficher cet état sans attendre 24 h.",
|
||||
"intro": "L’interrupteur entre Seuils et Notifications contrôle l’analyse LXC. Activé, il interroge les gestionnaires de paquets des CT actifs ; l’onglet VM et LXC affiche les résultats et alimente <code>lxc_updates_available</code>. Désactivé, il arrête ses appels <code>pct exec</code> et supprime les entrées LXC de <code>managed_installs.json</code> ; <code>/api/managed-installs</code> cesse d’afficher cet état sans attendre 24 h.",
|
||||
"whatRunsTitle": "Ce que l’analyse exécute",
|
||||
"whatRunsIntro": "Pour chaque CT à l’état <code>running</code> avec un gestionnaire de paquets pris en charge :",
|
||||
"whatRunsItems": [
|
||||
|
||||
@@ -52,7 +52,7 @@
|
||||
"backupsTitle": "Sauvegardes",
|
||||
"backupsBody": "Les archives de sauvegarde de chaque stockage compatible avec les sauvegardes (dir, NFS, CIFS, PBS), lues avec <code>pvesh get /nodes/localhost/storage/<id>/content</code>. Les cartes en haut indiquent le nombre de VM et de LXC et la taille totale ; en dessous, une ligne par archive avec type, stockage, taille et date. La restauration se fait dans l’interface web de Proxmox.",
|
||||
"notificationsTitle": "Notifications",
|
||||
"notificationsBody1": "Activité des notifications Proxmox : lignes de journal des services Proxmox qui mentionnent des notifications, des e-mails, des webhooks ou des alertes, les cibles de /etc/pve/notifications.cfg et les tâches de sauvegarde de la liste des tâches du cluster. Les lignes de tâche de sauvegarde permettent de télécharger le journal complet de la tâche. L’historique de ce que Monitor lui-même a envoyé se trouve dans Settings → Notifications → Notification history.",
|
||||
"notificationsBody1": "Activité des notifications Proxmox : lignes de journal des services Proxmox qui mentionnent des notifications, des e-mails, des webhooks ou des alertes, les cibles de /etc/pve/notifications.cfg et les tâches de sauvegarde de la liste des tâches du cluster. Les lignes de tâche de sauvegarde permettent de télécharger le journal complet de la tâche. L’historique de ce que Monitor lui-même a envoyé se trouve dans Paramètres → Notifications → Historique des notifications.",
|
||||
"notificationsBody2": "Cet onglet permet de vérifier ce que fait le système de notification propre à Proxmox. Les canaux de Monitor se configurent sur la page détaillée <link>Notifications</link>."
|
||||
},
|
||||
"dataCollected": {
|
||||
@@ -64,7 +64,7 @@
|
||||
{
|
||||
"subtab": "Journaux (filtre en direct)",
|
||||
"endpoint": "/api/logs",
|
||||
"source": "<code>journalctl</code> avec des filtres de priorité, de service et de plage de jours appliqués sur le serveur ; la recherche de texte s’exécute dans le navigateur."
|
||||
"source": "L’onglet demande <code>/api/logs?since_days=N</code> ; les filtres de niveau, de service et de texte s’appliquent dans le navigateur. L’API accepte aussi <code>priority</code> et <code>service</code>, que l’onglet n’utilise pas encore."
|
||||
},
|
||||
{
|
||||
"subtab": "Télécharger",
|
||||
|
||||
@@ -113,7 +113,7 @@
|
||||
"api": {
|
||||
"heading": "REST API et intégrations",
|
||||
"intro": "Les points d’accès REST exposent les mesures en JSON par HTTP/HTTPS pour Homepage, Home Assistant, Uptime Kuma et les scripts. Grafana peut utiliser l’exporteur texte Prometheus séparé sur <code>/api/prometheus</code>. Les requêtes peuvent être faites avec <code>curl</code>.",
|
||||
"tokens": "Les jetons API à longue durée de vie (365 jours) sont générés à partir de <strong>Admin → Sécurité → Jetons API</strong> ou via <code>POST /api/auth/generate-api-token</code>.",
|
||||
"tokens": "Les jetons API à longue durée de vie (365 jours) sont générés à partir de <strong>Administrateur → Sécurité → Jetons API</strong> ou via <code>POST /api/auth/generate-api-token</code>.",
|
||||
"bearer": "Envoyez les jetons via <code>Authorization: Bearer …</code>. <code>/api/health</code> attend aussi l’en-tête Bearer : les sondes de disponibilité ont donc besoin d’un jeton read_only. Sous <code>/api/auth/*</code> se trouvent à la fois des routes publiques de configuration/connexion/état et des routes protégées de gestion du compte et des jetons ; elles ne sont pas toutes anonymes.",
|
||||
"catalog": "Le catalogue complet des points d'accès, les conseils de rotation des jetons et les bonnes pratiques de sécurité se trouvent dans la <linkApi>référence API</linkApi>. Des exemples pour Homepage, Home Assistant, Grafana et Uptime Kuma, ainsi qu'un modèle générique cURL, sont proposés dans les <linkIntegrations>intégrations</linkIntegrations>."
|
||||
},
|
||||
|
||||
@@ -20,13 +20,13 @@
|
||||
"heading": "Authentification: la seule chose dont chaque recette ait besoin",
|
||||
"intro": "La plupart de ces points d’accès exigent une authentification. Deux méthodes sont proposées.",
|
||||
"optAtitle": "Option A — Jeton API (recommandé pour les intégrations)",
|
||||
"optAbody1": "Ouvrez <strong>Admin → Sécurité → Jetons API</strong>. Choisissez <em>Générer un jeton</em>, nommez-le par exemple <em>homepage</em>, <em>home-assistant</em> ou <em>prometheus</em>, puis copiez-le : il n’est affiché <em>qu’une fois</em>. Sa durée par défaut est d’un an et il peut être révoqué individuellement. Utilisez-le pour les clients autres que le navigateur.",
|
||||
"optAbody1": "Ouvrez <strong>Administrateur → Sécurité → Jetons API</strong>. Choisissez <em>Générer un nouveau jeton</em>, nommez-le par exemple <em>homepage</em>, <em>home-assistant</em> ou <em>prometheus</em>, saisissez votre mot de passe (et le code 2FA s’il est activé), cliquez sur <em>Générer un jeton</em> puis copiez-le : il n’est affiché <em>qu’une fois</em>. Sa durée par défaut est d’un an et il peut être révoqué individuellement. Utilisez-le pour les clients autres que le navigateur.",
|
||||
"optAbody2": "À partir de ce moment, chaque demande est juste:",
|
||||
"optBtitle": "Option B — flux de connexion (nom d'utilisateur + mot de passe)",
|
||||
"optBbody": "Utile pour les scripts qui authentifient en tant qu'utilisateur humain. Le jeton retourné est de courte durée; la plupart des intégrations devraient préférer l'option A.",
|
||||
"outro": "Le champ TOTP n’est requis que si la double authentification est activée. Le renouvellement et la révocation des jetons, les règles de mot de passe et le journal d’audit figurent dans <link>Accès et authentification</link>.",
|
||||
"httpsTitle": "Utiliser HTTPS au lieu de HTTP",
|
||||
"httpsIntro": "Chaque recette ci-dessous utilise <code>http://</code> dans les URLs pour garder les exemples courts. Si vous avez activé TLS sur le moniteur (<strong>Admin → Sécurité → SSL / HTTPS</strong>), échangez <code>http://</code> contre <code>https://</code> dans chaque URL — c’est le seul changement. Deux notes spécifiques à certains outils :",
|
||||
"httpsIntro": "Chaque recette ci-dessous utilise <code>http://</code> dans les URLs pour garder les exemples courts. Si vous avez activé TLS sur le moniteur (<strong>Administrateur → Sécurité → SSL / HTTPS</strong>), échangez <code>http://</code> contre <code>https://</code> dans chaque URL — c’est le seul changement. Deux notes spécifiques à certains outils :",
|
||||
"httpsItems": [
|
||||
"<strong>Certificats autosignés.</strong> L’intégration Home Assistant <code>rest:</code> vérifie TLS par défaut. Pour le certificat autosigné du Monitor, ajoutez <code>verify_ssl: false</code> à chaque bloc REST près de <code>scan_interval:</code>, ou ajoutez son AC au magasin de certificats approuvés. Même principe pour les autres outils qui vérifient les certificats.",
|
||||
"<strong>Prometheus</strong> dispose déjà de <code>scheme: https</code> dans l’exemple ci-dessous. Activez ou conservez <code>https</code> si TLS est activé sur le Monitor."
|
||||
@@ -43,7 +43,7 @@
|
||||
"basicTitle": "Widget de base — pas d'authentification",
|
||||
"basicIntro": "Utilisez ceci lorsque ProxMenux Monitor est sur un réseau de confiance et que vous n'avez pas encore activé l'authentification du côté Monitor. L'entrée la plus simple possible <code>services.yaml</code>:",
|
||||
"authedTitle": "Widget authentifié",
|
||||
"authedIntro": "Générez un jeton API dans <strong>Admin → Sécurité → Jetons API</strong> sur le moniteur, copiez-le et collez-le dans l’en-tête <code>Authorization</code> ci-dessous — remplacez le jeton d’exemple affiché après <code>Bearer</code> par celui que vous venez de copier :",
|
||||
"authedIntro": "Générez un jeton API dans <strong>Administrateur → Sécurité → Jetons API</strong> sur le moniteur, copiez-le et collez-le dans l’en-tête <code>Authorization</code> ci-dessous — remplacez le jeton d’exemple affiché après <code>Bearer</code> par celui que vous venez de copier :",
|
||||
"authedOutro": "Redémarrez Homepage pour afficher les valeurs actualisées. Réutilisez le même jeton pour les widgets qui interrogent la même instance du Monitor.",
|
||||
"multiTitle": "Configuration multi-widget — système, stockage, réseau",
|
||||
"multiIntro": "Pour plus de détails, créez trois cartes utilisant des points d’accès distincts : système, stockage et réseau. Elles utilisent le même jeton pour cette instance du Monitor.",
|
||||
|
||||
@@ -12,13 +12,13 @@
|
||||
},
|
||||
"intro": {
|
||||
"title": "Ce que cette page couvre",
|
||||
"body": "Comment changer le moniteur de HTTP à HTTPS dans le panneau Admin → Sécurité, ce que chaque source de certificat pointe en fait sur le disque, comment l’option Proxmox se comporte quand l’hôte a un cert Let’s Encrypt et comment définir des chemins personnalisés si vous gérez des certs en dehors de Proxmox."
|
||||
"body": "Comment changer le moniteur de HTTP à HTTPS dans le panneau Administrateur → Sécurité, ce que chaque source de certificat pointe en fait sur le disque, comment l’option Proxmox se comporte quand l’hôte a un cert Let’s Encrypt et comment définir des chemins personnalisés si vous gérez des certs en dehors de Proxmox."
|
||||
},
|
||||
"wheresetting": {
|
||||
"heading": "Emplacement du réglage",
|
||||
"body": "Ouvrez Monitor et allez dans <strong>Admin → Sécurité → SSL / HTTPS</strong>. Le panneau affiche HTTP ou HTTPS et, si HTTPS est désactivé, les sources de certificats détectées.",
|
||||
"imageAlt": "Panneau Admin → Sécurité → SSL / HTTPS dans le moniteur montrant l’état HTTPS-off, le certificat Proxmox détecté automatiquement (sujet, émetteur, expiration) et l’option Utiliser un certificat personnalisé",
|
||||
"caption": "Panneau Admin → Sécurité → SSL / HTTPS avant activation. Monitor affiche le certificat utilisé par Proxmox et permet de le choisir en un clic."
|
||||
"body": "Ouvrez Monitor et allez dans <strong>Administrateur → Sécurité → SSL / HTTPS</strong>. Le panneau affiche HTTP ou HTTPS et, si HTTPS est désactivé, les sources de certificats détectées.",
|
||||
"imageAlt": "Panneau Administrateur → Sécurité → SSL / HTTPS dans le moniteur montrant l’état HTTPS-off, le certificat Proxmox détecté automatiquement (sujet, émetteur, expiration) et l’option Utiliser un certificat personnalisé",
|
||||
"caption": "Panneau Administrateur → Sécurité → SSL / HTTPS avant activation. Monitor affiche le certificat utilisé par Proxmox et permet de le choisir en un clic."
|
||||
},
|
||||
"twoways": {
|
||||
"heading": "Deux façons d'activer HTTPS",
|
||||
@@ -117,7 +117,7 @@
|
||||
},
|
||||
"switchToHttps": {
|
||||
"heading": "Changez le moniteur en HTTPS",
|
||||
"bodyRich": "Une fois <code>/etc/pve/local/pveproxy-ssl.pem</code> signé par Let’s Encrypt, ouvrez <strong>Admin → Sécurité → SSL / HTTPS</strong>, vérifiez que l’émetteur est <em>Let’s Encrypt</em> et non l’AC locale de Proxmox, puis cliquez sur <strong>Utiliser le certificat Proxmox</strong>. Monitor redémarre et le prochain chargement utilise HTTPS sur 8008 avec une chaîne de confiance publique. Les renouvellements ACME suivants sont validés et sélectionnés à la prochaine nouvelle connexion TLS, sans interrogation périodique ni redémarrage à chaque renouvellement. <strong>Actualiser le certificat</strong> reste disponible dans Sécurité pour le diagnostic et la récupération."
|
||||
"bodyRich": "Une fois <code>/etc/pve/local/pveproxy-ssl.pem</code> signé par Let’s Encrypt, ouvrez <strong>Administrateur → Sécurité → SSL / HTTPS</strong>, vérifiez que l’émetteur est <em>Let’s Encrypt</em> et non l’AC locale de Proxmox, puis cliquez sur <strong>Utiliser le certificat Proxmox</strong>. Monitor redémarre et le prochain chargement utilise HTTPS sur 8008 avec une chaîne de confiance publique. Les renouvellements ACME suivants sont validés et sélectionnés à la prochaine nouvelle connexion TLS, sans interrogation périodique ni redémarrage à chaque renouvellement. <strong>Actualiser le certificat</strong> reste disponible dans Sécurité pour le diagnostic et la récupération."
|
||||
},
|
||||
"custom": {
|
||||
"heading": "Certificat personnalisé — quand l'utiliser",
|
||||
|
||||
@@ -284,14 +284,14 @@
|
||||
"heading": "Token API di lunga durata",
|
||||
"intro": "Le sessioni scadono dopo 24 ore. Per Homepage, Home Assistant, Grafana o Uptime Kuma crea un <strong>token API</strong> valido 365 giorni. Il JWT usa lo stesso segreto di firma; il campo <code>token_name</code> permette di identificarlo e revocarlo singolarmente.",
|
||||
"imageAlt": "Pannello di token API con nome, prefisso, data e scadenza",
|
||||
"imageCaption": "Elenco token in Admin → Security: nome, prefisso con ultimi quattro caratteri di identificazione, date di creazione e scadenza, revoca.",
|
||||
"imageCaption": "Elenco token in Amministratore → Sicurezza: nome, prefisso con ultimi quattro caratteri di identificazione, date di creazione e scadenza, revoca.",
|
||||
"generateTitle": "Generare un token",
|
||||
"generateIntro": "Dal cruscotto:",
|
||||
"generateSteps": [
|
||||
"Apri la sezione <strong>scheda Security → API Tokens</strong>.",
|
||||
"Apri <strong>Amministratore → Sicurezza → Token API</strong> e premi <strong>Genera nuovo token</strong>.",
|
||||
"Assegna un nome descrittivo, <em>ad esempio \"Home Assistant\"</em>.",
|
||||
"Reinserisci la password e, con 2FA attivo, il codice attuale a sei cifre.",
|
||||
"Premi <strong>Generate new token</strong>, poi <strong>Generate token</strong>. Compare <strong>una sola volta</strong>: copialo subito."
|
||||
"Premi <strong>Genera token</strong>. Compare <strong>una sola volta</strong>: copialo subito."
|
||||
],
|
||||
"generateCli": "Dalla riga di comando:",
|
||||
"useTitle": "Usare un token",
|
||||
@@ -310,7 +310,7 @@
|
||||
"intro": "Due percorsi per TLS:",
|
||||
"items": [
|
||||
"<strong>Proxy inverso consigliato.</strong> Termina TLS su Nginx / Caddy / Traefik e inoltra HTTP al processo Flask sulla porta 8008. Esempi sotto.",
|
||||
"<strong>HTTPS diretto nell’AppImage.</strong> Configura un certificato con <code>POST /api/ssl/configure</code> (interfaccia: <strong>Admin → Security → SSL / HTTPS</strong>). HTTPS usa <code>gevent.pywsgi</code> con il gestore standard; flask-sock gestisce WebSocket per WSS. I percorsi sono salvati nella configurazione SSL."
|
||||
"<strong>HTTPS diretto nell’AppImage.</strong> Configura un certificato con <code>POST /api/ssl/configure</code> (interfaccia: <strong>Amministratore → Sicurezza → SSL/HTTPS</strong>). HTTPS usa <code>gevent.pywsgi</code> con il gestore standard; flask-sock gestisce WebSocket per WSS. I percorsi sono salvati nella configurazione SSL."
|
||||
],
|
||||
"calloutTitle": "Limitazioni dirette HTTPS",
|
||||
"calloutBody": "Monitor può usare un certificato gestito da Proxmox o file personalizzati. Non emette certificati ACME. Per emissione e rinnovo automatici usa Proxmox ACME o un proxy Caddy, Traefik o Nginx e assicurati che i certificati rinnovati vengano caricati."
|
||||
|
||||
@@ -165,7 +165,7 @@
|
||||
},
|
||||
"ollama": {
|
||||
"heading": "Ollama (locale)",
|
||||
"tagline": "Usa i modelli sul tuo server Ollama. Completamente locale, privato e gratuito.",
|
||||
"tagline": "Usa i modelli esposti dal server Ollama configurato. I modelli locali vengono eseguiti lì; i modelli cloud inoltrano le richieste a un provider esterno. L’esecuzione locale evita costi di API ospitate, ma usa hardware ed elettricità tuoi.",
|
||||
"items": [
|
||||
"Nessuna chiave API. Impostare il campo <em>Ollama URL</em> sul server (default <code>http://localhost:11434</code> o qualsiasi host esegue l'istanza Ollama).",
|
||||
"Modelli <strong>non filtrati.</strong> Monitor legge i modelli scaricati con <code>ollama pull <model></code>. L’elenco viene caricato da <code>GET /api/tags</code> sul server Ollama.",
|
||||
|
||||
@@ -50,7 +50,7 @@
|
||||
},
|
||||
{
|
||||
"name": "Terminale",
|
||||
"owns": "Shell nel browser sull’host Proxmox, con <code>xterm.js</code> tramite WebSocket. Le console LXC si aprono dalla scheda VMs & LXCs."
|
||||
"owns": "Shell nel browser sull’host Proxmox, con <code>xterm.js</code> tramite WebSocket. Le console LXC si aprono dalla scheda VM e LXC."
|
||||
},
|
||||
{
|
||||
"name": "Sicurezza",
|
||||
|
||||
@@ -41,7 +41,7 @@
|
||||
"heading": "Unità rete",
|
||||
"imageAlt": "Scheda Unità di rete con il selettore di visualizzazione su Byte",
|
||||
"imageCaption": "Scegli tra bit al secondo e byte al secondo per ogni velocità di rete visualizzata nel cruscotto.",
|
||||
"body": "Scegli come viene mostrata la velocità di rete nella dashboard: <strong>bit al secondo</strong> (Mbps / Gbps) o <strong>byte al secondo</strong> (MB/s / GB/s). I byte sono il valore predefinito, come nella maggior parte degli strumenti di trasferimento file; i bit sono quelli con cui produttori di schede e provider etichettano i prodotti. La scelta è salvata nel browser, quindi ogni browser mantiene la propria. Grafici, etichette e suggerimenti cambiano subito senza ricaricare."
|
||||
"body": "Mostra la velocità in <strong>bit al secondo</strong> (Mbps/Gbps) o <strong>byte al secondo</strong> (MB/s/GB/s). I byte sono predefiniti, come nei trasferimenti di file; schede e provider usano spesso i bit. La scelta viene salvata nel browser. Grafici, etichette e suggerimenti cambiano subito senza ricaricare."
|
||||
},
|
||||
"health": {
|
||||
"heading": "Monitoraggio integrità",
|
||||
@@ -203,7 +203,7 @@
|
||||
"heading": "Rilevamento aggiornamenti LXC",
|
||||
"imageAlt": "Scheda di rilevamento aggiornamenti LXC con interruttore per cercare pacchetti in attesa nei container Debian, Ubuntu e Alpine attivi",
|
||||
"imageCaption": "Interruttore dell’analisi periodica con <code>apt list --upgradable</code> / <code>apk list -u</code> nei CT attivi. È acceso per impostazione predefinita. L’opzione in Notifiche → Servizi appare mentre il rilevamento è attivo.",
|
||||
"intro": "L’interruttore tra Soglie e Notifiche controlla l’analisi LXC. Attivo, interroga i gestori di pacchetti dei CT in esecuzione; i risultati compaiono nei conteggi della scheda VMs & LXCs e alimentano <code>lxc_updates_available</code>. Disattivo, ferma le chiamate <code>pct exec</code> e rimuove subito le voci LXC da <code>managed_installs.json</code>; la dashboard e <code>/api/managed-installs</code> smettono di riportare lo stato senza attendere il ciclo di 24 ore.",
|
||||
"intro": "L’interruttore tra Soglie e Notifiche controlla l’analisi LXC. Attivo, interroga i gestori di pacchetti dei CT in esecuzione; la scheda VM e LXC mostra i risultati e alimenta <code>lxc_updates_available</code>. Disattivo, ferma le chiamate <code>pct exec</code> e rimuove le voci LXC da <code>managed_installs.json</code>; <code>/api/managed-installs</code> smette di riportare lo stato senza attendere 24 ore.",
|
||||
"whatRunsTitle": "Cosa esegue l’analisi",
|
||||
"whatRunsIntro": "Per ogni CT in stato <code>running</code> con un gestore di pacchetti supportato:",
|
||||
"whatRunsItems": [
|
||||
|
||||
@@ -52,7 +52,7 @@
|
||||
"backupsTitle": "Backup",
|
||||
"backupsBody": "Gli archivi di backup su ogni storage che supporta i backup (dir, NFS, CIFS, PBS), letti con <code>pvesh get /nodes/localhost/storage/<id>/content</code>. Le schede in alto mostrano il numero di VM e LXC e la dimensione totale; sotto, una riga per archivio con tipo, storage, dimensione e data. Il ripristino si esegue nell’interfaccia web di Proxmox.",
|
||||
"notificationsTitle": "Notifiche",
|
||||
"notificationsBody1": "Attività di notifica di Proxmox: righe del journal dei servizi Proxmox che citano notifiche, e-mail, webhook o avvisi, le destinazioni in /etc/pve/notifications.cfg e le attività di backup dall’elenco delle attività del cluster. Le righe delle attività di backup permettono di scaricare il log completo. La cronologia di ciò che Monitor stesso ha inviato si trova in Settings → Notifications → Notification history.",
|
||||
"notificationsBody1": "Attività di notifica di Proxmox: righe del journal dei servizi Proxmox che citano notifiche, e-mail, webhook o avvisi, le destinazioni in /etc/pve/notifications.cfg e le attività di backup dall’elenco delle attività del cluster. Le righe delle attività di backup permettono di scaricare il log completo. La cronologia di ciò che Monitor stesso ha inviato si trova in Impostazioni → Notifiche → Cronologia delle notifiche.",
|
||||
"notificationsBody2": "Usa questa scheda per verificare cosa fa il sistema di notifiche di Proxmox. I canali di Monitor si configurano nella pagina dettagliata <link>Notifiche</link>."
|
||||
},
|
||||
"dataCollected": {
|
||||
@@ -64,7 +64,7 @@
|
||||
{
|
||||
"subtab": "Registri (filtro in tempo reale)",
|
||||
"endpoint": "/api/logs",
|
||||
"source": "<code>journalctl</code> con filtri per priorità, servizio e intervallo di giorni applicati sul server; la ricerca testuale viene eseguita nel browser."
|
||||
"source": "La scheda richiede <code>/api/logs?since_days=N</code>; i filtri per livello, servizio e testo vengono applicati nel browser. L’API accetta anche <code>priority</code> e <code>service</code>, che la scheda non usa ancora."
|
||||
},
|
||||
{
|
||||
"subtab": "Scarica",
|
||||
|
||||
@@ -117,7 +117,7 @@
|
||||
"<strong>Destinazione</strong> — storage (PBS-Cloud, PBS-Local, NFS-Backup, …), colorato secondo lo stato.",
|
||||
"<strong>Dimensione</strong> — dimensione finale del backup su disco."
|
||||
],
|
||||
"backupsOutro": "Il pulsante <strong>+ Create Backup</strong> in alto a destra apre una finestra per scegliere storage, modalità (snapshot / suspend / stop), protezione e note prima di avviare un vzdump. Il ripristino si esegue nell'interfaccia web Proxmox; Monitor mostra la vista “questo guest ha un backup recente?”, non il flusso di recupero.",
|
||||
"backupsOutro": "Il pulsante <strong>+ Crea backup</strong> in alto a destra apre una finestra per scegliere storage, modalità (snapshot / suspend / stop), protezione e note prima di avviare un vzdump. Il ripristino si esegue nell'interfaccia web Proxmox; Monitor mostra la vista “questo guest ha un backup recente?”, non il flusso di recupero.",
|
||||
"firewallTitle": "Scheda 7 — Firewall",
|
||||
"firewallIntro": "Legge il log firewall Proxmox del guest direttamente dall'host, senza servizi aggiuntivi né richieste periodiche. La scheda è sempre presente; il contenuto dipende dalla attivazione del firewall e dalla registrazione dei pacchetti da parte di una regola.",
|
||||
"firewallItems": [
|
||||
|
||||
@@ -113,7 +113,7 @@
|
||||
"api": {
|
||||
"heading": "REST API e integrazioni",
|
||||
"intro": "Gli endpoint REST espongono dati di monitoraggio JSON via HTTP/HTTPS per Homepage, Home Assistant, Uptime Kuma e script. Grafana può usare l’esportatore testuale Prometheus separato su <code>/api/prometheus</code>. Le richieste possono usare <code>curl</code>.",
|
||||
"tokens": "I token API a lunga durata (365 giorni) vengono generati in <strong>Admin → Security → API Tokens</strong> o tramite <code>POST /api/auth/generate-api-token</code>.",
|
||||
"tokens": "I token API a lunga durata (365 giorni) vengono generati in <strong>Amministratore → Sicurezza → Token API</strong> o tramite <code>POST /api/auth/generate-api-token</code>.",
|
||||
"bearer": "Invia i token con <code>Authorization: Bearer …</code>. Anche <code>/api/health</code> richiede l’intestazione Bearer, quindi i controlli di disponibilità necessitano di un token read_only. Sotto <code>/api/auth/*</code> ci sono sia rotte pubbliche di configurazione/login/stato sia rotte protette per account e token; non sono tutte anonime.",
|
||||
"catalog": "Catalogo degli endpoint, rotazione dei token e sicurezza sono nel <linkApi>Riferimento API</linkApi>; esempi per Homepage, Home Assistant, Grafana, Uptime Kuma e cURL sono in <linkIntegrations>Integrazioni</linkIntegrations>."
|
||||
},
|
||||
|
||||
@@ -20,13 +20,13 @@
|
||||
"heading": "Autenticazione: l'unica cosa che ogni ricetta ha bisogno",
|
||||
"intro": "La maggior parte degli endpoint utilizzati da queste integrazioni sono autenticati. Hai due modi per soddisfare questo requisito.",
|
||||
"optAtitle": "Opzione A — Token API (consigliato per le integrazioni)",
|
||||
"optAbody1": "Apri la dashboard e vai in <strong>Admin → Security → API Tokens</strong>. Premi <em>Generate token</em>, assegna un nome come <em>homepage</em>, <em>home-assistant</em> o <em>prometheus</em> e copialo: appare <em>una sola volta</em>. Scade dopo un anno per impostazione predefinita ed è revocabile singolarmente. Usalo per i client esterni al browser.",
|
||||
"optAbody1": "Apri la dashboard e vai in <strong>Amministratore → Sicurezza → Token API</strong>. Premi <em>Genera nuovo token</em>, assegna un nome come <em>homepage</em>, <em>home-assistant</em> o <em>prometheus</em>, inserisci la password (e il codice 2FA se attivo), premi <em>Genera token</em> e copialo: appare <em>una sola volta</em>. Scade dopo un anno per impostazione predefinita ed è revocabile singolarmente. Usalo per i client esterni al browser.",
|
||||
"optAbody2": "Da quel punto ogni richiesta è solo:",
|
||||
"optBtitle": "Opzione B — flusso di login (username + password)",
|
||||
"optBbody": "Utile per script che si autenticano come un utente. Il token restituito dura poco; per la maggior parte delle integrazioni scegli l’opzione A.",
|
||||
"outro": "Il campo TOTP è obbligatorio solo se sull’account è attiva la 2FA. Rotazione e revoca dei token, criteri delle password e registro di controllo sono descritti in <link>Accesso e autenticazione</link>.",
|
||||
"httpsTitle": "Utilizzando HTTPS invece di HTTP",
|
||||
"httpsIntro": "Gli esempi usano <code>http://</code> per brevità. Se hai attivato TLS sul Monitor (<strong>Admin → Security → SSL / HTTPS</strong>), sostituisci <code>http://</code> con <code>https://</code> in ogni URL. Due note per alcuni strumenti:",
|
||||
"httpsIntro": "Gli esempi usano <code>http://</code> per brevità. Se hai attivato TLS sul Monitor (<strong>Amministratore → Sicurezza → SSL/HTTPS</strong>), sostituisci <code>http://</code> con <code>https://</code> in ogni URL. Due note per alcuni strumenti:",
|
||||
"httpsItems": [
|
||||
"<strong>Certificati autofirmati.</strong> L’integrazione Home Assistant <code>rest:</code> verifica TLS per impostazione predefinita. Per un certificato autofirmato del Monitor aggiungi <code>verify_ssl: false</code> a ogni blocco REST accanto a <code>scan_interval:</code>, oppure importa la CA del Monitor tra i certificati attendibili. Lo stesso vale per altri strumenti che verificano i certificati.",
|
||||
"<strong>Prometheus</strong> include già <code>scheme: https</code> nell’esempio sotto. Attiva o mantieni <code>https</code> se TLS è attivo sul Monitor."
|
||||
@@ -43,7 +43,7 @@
|
||||
"basicTitle": "widget di base — nessuna autenticazione",
|
||||
"basicIntro": "Utilizzare questo quando ProxMenux Monitor è su una rete di fiducia e non hai ancora abilitato l'autenticazione sul lato Monitor. La voce <code>services.yaml</code> più semplice:",
|
||||
"authedTitle": "widget autenticato",
|
||||
"authedIntro": "Generare un token API in <strong>Admin → Security → API Tokens</strong> sul Monitor, copiarlo e incollarlo nell'intestazione <code>Authorization</code> di seguito — sostituire il token di esempio mostrato dopo <code>Bearer</code> con quello appena copiato:",
|
||||
"authedIntro": "Generare un token API in <strong>Amministratore → Sicurezza → Token API</strong> sul Monitor, copiarlo e incollarlo nell'intestazione <code>Authorization</code> di seguito — sostituire il token di esempio mostrato dopo <code>Bearer</code> con quello appena copiato:",
|
||||
"authedOutro": "Riavvia Homepage per visualizzare i valori aggiornati. Riutilizza lo stesso token nei widget che interrogano la stessa istanza del Monitor.",
|
||||
"multiTitle": "Configurazione multi-widget — sistema, archiviazione, rete",
|
||||
"multiIntro": "Per più dettagli crea tre schede con endpoint diversi: sistema, archiviazione e rete. Usa lo stesso token per questa istanza del Monitor.",
|
||||
|
||||
@@ -12,13 +12,13 @@
|
||||
},
|
||||
"intro": {
|
||||
"title": "Che cosa questa pagina copre",
|
||||
"body": "Come cambiare il Monitor da HTTP a HTTPS nel pannello Admin → Security, ciò che ogni fonte di certificato indica effettivamente sul disco, come l'opzione Proxmox si comporta quando l'host ha un cert Let's Encrypt e come impostare percorsi personalizzati se si gestisce certs al di fuori di Proxmox."
|
||||
"body": "Come cambiare il Monitor da HTTP a HTTPS nel pannello Amministratore → Sicurezza, ciò che ogni fonte di certificato indica effettivamente sul disco, come l'opzione Proxmox si comporta quando l'host ha un cert Let's Encrypt e come impostare percorsi personalizzati se si gestisce certs al di fuori di Proxmox."
|
||||
},
|
||||
"wheresetting": {
|
||||
"heading": "Dove si trova l'impostazione",
|
||||
"body": "Apri Monitor e vai in <strong>Admin → Security → SSL / HTTPS</strong>. Il pannello mostra HTTP o HTTPS e, se HTTPS non è attivo, le fonti di certificato rilevate.",
|
||||
"imageAlt": "Pannello Admin → Security → SSL / HTTPS nel Monitor che mostra lo stato HTTPS-off, il certificato Proxmox auto-determinato (soggetto, emittente, scadenza) e l'opzione Usa Certificato personalizzato",
|
||||
"caption": "Pannello Admin → Security → SSL / HTTPS prima dell'attivazione. Monitor mostra il certificato usato da Proxmox e permette di sceglierlo con un clic."
|
||||
"body": "Apri Monitor e vai in <strong>Amministratore → Sicurezza → SSL/HTTPS</strong>. Il pannello mostra HTTP o HTTPS e, se HTTPS non è attivo, le fonti di certificato rilevate.",
|
||||
"imageAlt": "Pannello Amministratore → Sicurezza → SSL/HTTPS nel Monitor che mostra lo stato HTTPS-off, il certificato Proxmox auto-determinato (soggetto, emittente, scadenza) e l'opzione Usa Certificato personalizzato",
|
||||
"caption": "Pannello Amministratore → Sicurezza → SSL/HTTPS prima dell'attivazione. Monitor mostra il certificato usato da Proxmox e permette di sceglierlo con un clic."
|
||||
},
|
||||
"twoways": {
|
||||
"heading": "Due modi per abilitare HTTPS",
|
||||
@@ -117,7 +117,7 @@
|
||||
},
|
||||
"switchToHttps": {
|
||||
"heading": "Passare il Monitor a HTTPS",
|
||||
"bodyRich": "Quando <code>/etc/pve/local/pveproxy-ssl.pem</code> è firmato da Let's Encrypt, apri <strong>Admin → Security → SSL / HTTPS</strong>, verifica che l'emittente sia <em>Let's Encrypt</em> e non la CA locale Proxmox, poi fai clic su <strong>Usa certificato Proxmox</strong>. Monitor si riavvia e il caricamento successivo usa HTTPS su 8008 con una catena pubblicamente attendibile. I rinnovi ACME successivi sono convalidati e selezionati alla prossima nuova connessione TLS, senza controlli periodici né riavvio al rinnovo. <strong>Aggiorna certificato</strong> rimane disponibile in Sicurezza per diagnosi e recupero."
|
||||
"bodyRich": "Quando <code>/etc/pve/local/pveproxy-ssl.pem</code> è firmato da Let's Encrypt, apri <strong>Amministratore → Sicurezza → SSL/HTTPS</strong>, verifica che l'emittente sia <em>Let's Encrypt</em> e non la CA locale Proxmox, poi fai clic su <strong>Usa certificato Proxmox</strong>. Monitor si riavvia e il caricamento successivo usa HTTPS su 8008 con una catena pubblicamente attendibile. I rinnovi ACME successivi sono convalidati e selezionati alla prossima nuova connessione TLS, senza controlli periodici né riavvio al rinnovo. <strong>Aggiorna certificato</strong> rimane disponibile in Sicurezza per diagnosi e recupero."
|
||||
},
|
||||
"custom": {
|
||||
"heading": "Certificato personalizzato — quando utilizzarlo",
|
||||
|
||||
@@ -284,14 +284,14 @@
|
||||
"heading": "Tokens API de longa duração",
|
||||
"intro": "As sessões expiram após 24 horas. Para Homepage, Home Assistant, Grafana ou Uptime Kuma, crie um <strong>token API</strong> válido por 365 dias. O JWT usa o mesmo segredo; o campo <code>token_name</code> permite identificá-lo e revogá-lo individualmente.",
|
||||
"imageAlt": "Painel de tokens API com nome, prefixo, data de criação e validade",
|
||||
"imageCaption": "Lista em Admin → Security: nome, prefixo com os quatro últimos caracteres de identificação, datas de criação e validade, ação de revogação.",
|
||||
"imageCaption": "Lista em Administrador → Segurança: nome, prefixo com os quatro últimos caracteres de identificação, datas de criação e validade, ação de revogação.",
|
||||
"generateTitle": "Gerar um token",
|
||||
"generateIntro": "Do painel:",
|
||||
"generateSteps": [
|
||||
"Abra a secção <strong>aba Security → API Tokens</strong>.",
|
||||
"Abra <strong>Administrador → Segurança → Tokens de API</strong> e clique em <strong>Gerar novo token</strong>.",
|
||||
"Introduza um nome descritivo, <em>por exemplo \"Home Assistant\"</em>.",
|
||||
"Volta a inserir a tua senha. Se 2FA está ligado, também o código atual 6 dígitos.",
|
||||
"Clique em <strong>Generate new token</strong> e depois em <strong>Generate token</strong>. O token aparece <strong>uma única vez</strong>: copie-o imediatamente."
|
||||
"Clique em <strong>Gerar token</strong>. O token aparece <strong>uma única vez</strong>: copie-o de imediato."
|
||||
],
|
||||
"generateCli": "Da linha de comando:",
|
||||
"useTitle": "Usar um token",
|
||||
@@ -310,7 +310,7 @@
|
||||
"intro": "Dois caminhos para o TLS:",
|
||||
"items": [
|
||||
"<strong>Proxy inverso (recomendado).</strong> Terminar TLS em Nginx / Caddy / Traefik e encaminhar HTTP na porta 8008 para o processo Flask. Excertos abaixo.",
|
||||
"<strong>HTTPS direto na AppImage.</strong> Configure um certificado com <code>POST /api/ssl/configure</code> (interface: <strong>Admin → Security → SSL / HTTPS</strong>). HTTPS usa <code>gevent.pywsgi</code> com o handler padrão; flask-sock trata WebSocket para WSS. Os caminhos ficam na configuração SSL."
|
||||
"<strong>HTTPS direto na AppImage.</strong> Configure um certificado com <code>POST /api/ssl/configure</code> (interface: <strong>Administrador → Segurança → SSL/HTTPS</strong>). HTTPS usa <code>gevent.pywsgi</code> com o handler padrão; flask-sock trata WebSocket para WSS. Os caminhos ficam na configuração SSL."
|
||||
],
|
||||
"calloutTitle": "Limitações diretas do HTTPS",
|
||||
"calloutBody": "O Monitor pode usar um certificado gerido pelo Proxmox ou ficheiros próprios. Não emite certificados ACME. Para emissão e renovação automáticas, use Proxmox ACME ou um proxy Caddy, Traefik ou Nginx e garanta que os certificados renovados são carregados."
|
||||
|
||||
@@ -165,7 +165,7 @@
|
||||
},
|
||||
"ollama": {
|
||||
"heading": "Ollama (local)",
|
||||
"tagline": "Utiliza modelos do seu servidor Ollama. Totalmente local, privado e gratuito.",
|
||||
"tagline": "Utiliza os modelos do servidor Ollama configurado. Os modelos locais executam-se nesse servidor; os modelos cloud encaminham pedidos para um fornecedor externo. A execução local evita custos de API alojada, mas utiliza o seu hardware e eletricidade.",
|
||||
"items": [
|
||||
"Nenhuma chave API. Defina o campo <em>Ollama URL</em> para o seu servidor (padrão <code>http://localhost:11434</code> ou qualquer máquina roda sua instância Ollama).",
|
||||
"Modelos: <strong>não filtrados.</strong> O Monitor lê quaisquer modelos que você extraiu no lado Ollama via <code>ollama pull <model></code>. O menu suspenso é preenchido em <code>GET /api/tags</code> em seu servidor Ollama.",
|
||||
|
||||
@@ -50,7 +50,7 @@
|
||||
},
|
||||
{
|
||||
"name": "Terminal",
|
||||
"owns": "Shell no navegador no host Proxmox, com <code>xterm.js</code> sobre WebSockets. As consolas LXC abrem a partir do separador VMs & LXCs."
|
||||
"owns": "Shell no navegador no host Proxmox, com <code>xterm.js</code> sobre WebSockets. As consolas LXC abrem a partir do separador VMs e LXCs."
|
||||
},
|
||||
{
|
||||
"name": "Segurança",
|
||||
|
||||
@@ -203,7 +203,7 @@
|
||||
"heading": "Detecção de atualização LXC",
|
||||
"imageAlt": "Cartão de deteção de atualizações LXC com interruptor para procurar pacotes pendentes em contentores Debian, Ubuntu e Alpine ativos",
|
||||
"imageCaption": "Interruptor da análise periódica com <code>apt list --upgradable</code> / <code>apk list -u</code> nos CT ativos. Vem ligado. A opção correspondente em Notificações → Serviços aparece com a deteção ativa.",
|
||||
"intro": "O interruptor entre Limites e Notificações controla a análise LXC. Ativo, consulta os gestores de pacotes dos CT em execução; o separador VMs & LXCs mostra os resultados nos contadores e alimenta <code>lxc_updates_available</code>. Desativado, para as chamadas <code>pct exec</code> e remove entradas LXC de <code>managed_installs.json</code>; <code>/api/managed-installs</code> deixa de mostrar esse estado sem esperar 24 h.",
|
||||
"intro": "O interruptor entre Limites e Notificações controla a análise LXC. Ativo, consulta os gestores de pacotes dos CT em execução; o separador VMs e LXCs mostra os resultados nos contadores e alimenta <code>lxc_updates_available</code>. Desativado, para as chamadas <code>pct exec</code> e remove entradas LXC de <code>managed_installs.json</code>; <code>/api/managed-installs</code> deixa de mostrar esse estado sem esperar 24 h.",
|
||||
"whatRunsTitle": "O que a análise executa",
|
||||
"whatRunsIntro": "Para cada CT no estado <code>running</code> com um gestor de pacotes suportado:",
|
||||
"whatRunsItems": [
|
||||
|
||||
@@ -52,7 +52,7 @@
|
||||
"backupsTitle": "Cópias de segurança",
|
||||
"backupsBody": "Os arquivos de backup em cada armazenamento com capacidade de backup (dir, NFS, CIFS, PBS), lidos com <code>pvesh get /nodes/localhost/storage/<id>/content</code>. Os cartões no topo mostram o número de VMs e LXC e o tamanho total; abaixo, uma linha por arquivo com tipo, armazenamento, tamanho e data. A restauração está na interface web do Proxmox.",
|
||||
"notificationsTitle": "Notificações",
|
||||
"notificationsBody1": "Atividade de notificações do Proxmox: linhas do diário dos serviços Proxmox que mencionam notificações, email, webhooks ou alertas, os destinos em /etc/pve/notifications.cfg e as tarefas de backup da lista de tarefas do cluster. As linhas de tarefas de backup permitem descarregar o registo completo da tarefa. O histórico do que o próprio Monitor enviou está em Settings → Notifications → Notification history.",
|
||||
"notificationsBody1": "Atividade de notificações do Proxmox: linhas do diário dos serviços Proxmox que mencionam notificações, email, webhooks ou alertas, os destinos em /etc/pve/notifications.cfg e as tarefas de backup da lista de tarefas do cluster. As linhas de tarefas de backup permitem descarregar o registo completo da tarefa. O histórico do que o próprio Monitor enviou está em Configurações → Notificações → Histórico de notificações.",
|
||||
"notificationsBody2": "Utilize este separador para verificar o que o próprio sistema de notificações do Proxmox está a fazer. Os canais do Monitor configuram-se na página detalhada <link>Notificações</link>."
|
||||
},
|
||||
"dataCollected": {
|
||||
@@ -64,7 +64,7 @@
|
||||
{
|
||||
"subtab": "Registos (filtro em direto)",
|
||||
"endpoint": "/api/logs",
|
||||
"source": "<code>journalctl</code> com filtros de prioridade, serviço e intervalo de dias aplicados no servidor; a pesquisa de texto é feita no navegador."
|
||||
"source": "O separador pede <code>/api/logs?since_days=N</code>; os filtros de nível, serviço e texto são aplicados no navegador. A API também aceita <code>priority</code> e <code>service</code>, que o separador ainda não usa."
|
||||
},
|
||||
{
|
||||
"subtab": "Transferir",
|
||||
|
||||
@@ -117,7 +117,7 @@
|
||||
"<strong>Destino</strong> — armazenamento (PBS-Cloud, PBS-Local, NFS-Backup, …), colorido conforme o estado.",
|
||||
"<strong>Tamanho</strong> — tamanho final em disco da cópia."
|
||||
],
|
||||
"backupsOutro": "O botão <strong>+ Create Backup</strong>, no canto superior direito, abre uma janela para escolher o armazenamento, o modo (snapshot / suspend / stop), a proteção e as notas antes de iniciar um vzdump. O restauro faz-se na interface web Proxmox; o Monitor mostra se o sistema tem cópias recentes, mas não o fluxo de recuperação.",
|
||||
"backupsOutro": "O botão <strong>+ Criar backup</strong>, no canto superior direito, abre uma janela para escolher o armazenamento, o modo (snapshot / suspend / stop), a proteção e as notas antes de iniciar um vzdump. O restauro faz-se na interface web Proxmox; o Monitor mostra se o sistema tem cópias recentes, mas não o fluxo de recuperação.",
|
||||
"firewallTitle": "Página 7 — Firewall",
|
||||
"firewallIntro": "Lê o registo do firewall Proxmox de cada sistema diretamente do host, sem serviço adicional nem consultas periódicas. O separador está sempre presente; o conteúdo depende da ativação do firewall e de uma regra registar pacotes.",
|
||||
"firewallItems": [
|
||||
|
||||
@@ -113,7 +113,7 @@
|
||||
"api": {
|
||||
"heading": "REST API e integrações",
|
||||
"intro": "Os endpoints REST expõem dados de monitorização JSON por HTTP/HTTPS para Homepage, Home Assistant, Uptime Kuma e scripts. Grafana pode usar o exportador de texto Prometheus separado em <code>/api/prometheus</code>. As chamadas podem usar <code>curl</code>.",
|
||||
"tokens": "Tokens API de longa duração (365 dias) são gerados em <strong>Admin → Security → API Tokens</strong> ou via <code>POST /api/auth/generate-api-token</code>.",
|
||||
"tokens": "Tokens API de longa duração (365 dias) são gerados em <strong>Administrador → Segurança → Tokens de API</strong> ou via <code>POST /api/auth/generate-api-token</code>.",
|
||||
"bearer": "Envie tokens com <code>Authorization: Bearer …</code>. <code>/api/health</code> também espera o cabeçalho Bearer, pelo que os testes de disponibilidade precisam de um token read_only. Em <code>/api/auth/*</code> existem tanto rotas públicas de configuração/início/estado como rotas protegidas de contas e tokens; nem todas são anónimas.",
|
||||
"catalog": "O catálogo de endpoints, rotação de tokens e segurança estão na <linkApi>Referência da API</linkApi>; exemplos para Homepage, Home Assistant, Grafana, Uptime Kuma e cURL estão em <linkIntegrations>Integrações</linkIntegrations>."
|
||||
},
|
||||
|
||||
@@ -20,13 +20,13 @@
|
||||
"heading": "Autenticação: a única coisa que cada receita precisa",
|
||||
"intro": "A maioria dos endpoints usados por essas integrações são autenticados. Tem duas maneiras de satisfazer esse requisito.",
|
||||
"optAtitle": "Opção A — API token (recomendado para integrações)",
|
||||
"optAbody1": "Abra <strong>Admin → Security → API Tokens</strong>. Clique em <em>Generate token</em>, dê-lhe um nome como <em>homepage</em>, <em>home-assistant</em> ou <em>prometheus</em> e copie-o: é apresentado <em>uma única vez</em>. Expira ao fim de um ano por predefinição e pode ser revogado individualmente. Use-o em clientes externos ao navegador.",
|
||||
"optAbody1": "Abra <strong>Administrador → Segurança → Tokens de API</strong>. Clique em <em>Gerar novo token</em>, dê-lhe um nome como <em>homepage</em>, <em>home-assistant</em> ou <em>prometheus</em>, introduza a sua senha (e o código 2FA, se estiver ativo), clique em <em>Gerar token</em> e copie-o: é apresentado <em>uma única vez</em>. Expira ao fim de um ano por predefinição e pode ser revogado individualmente. Use-o em clientes externos ao navegador.",
|
||||
"optAbody2": "A partir desse ponto cada pedido é apenas:",
|
||||
"optBtitle": "Opção B – fluxo de login (nome de usuário + senha)",
|
||||
"optBbody": "Útil para scripts que autenticam como um usuário humano. O token retornado é de curta duração; a maioria das integrações deve preferir a Opção A.",
|
||||
"outro": "O campo TOTP só é necessário com autenticação de dois fatores ativa. A rotação e revogação dos tokens, a política de palavras-passe e o registo de auditoria estão em <link>Acesso e autenticação</link>.",
|
||||
"httpsTitle": "Usando HTTPS em vez de HTTP",
|
||||
"httpsIntro": "Cada receita abaixo usa <code>http://</code> nas URLs para manter os exemplos curtos. Se você ativou TLS no Monitor (<strong>Admin → Security → SSL / HTTPS</strong>), troque <code>http://</code> para <code>https://</code> em cada URL — essa é a única mudança. Duas notas específicas para certos instrumentos:",
|
||||
"httpsIntro": "Cada receita abaixo usa <code>http://</code> nas URLs para manter os exemplos curtos. Se você ativou TLS no Monitor (<strong>Administrador → Segurança → SSL/HTTPS</strong>), troque <code>http://</code> para <code>https://</code> em cada URL — essa é a única mudança. Duas notas específicas para certos instrumentos:",
|
||||
"httpsItems": [
|
||||
"<strong>Certificados autoassinados.</strong> A integração Home Assistant <code>rest:</code> verifica TLS por predefinição. Para um certificado autoassinado do Monitor, adicione <code>verify_ssl: false</code> a cada bloco REST junto de <code>scan_interval:</code>, ou importe a CA do Monitor para os certificados de confiança. O mesmo se aplica a outras ferramentas que verificam certificados.",
|
||||
"<strong>Prometheus</strong> já inclui <code>scheme: https</code> no exemplo abaixo. Ative ou mantenha <code>https</code> se TLS estiver ativo no Monitor."
|
||||
@@ -43,7 +43,7 @@
|
||||
"basicTitle": "Elemento básico — sem autenticação",
|
||||
"basicIntro": "Use isso quando o ProxMenux Monitor estiver em uma rede confiável e você ainda não tiver habilitado a autenticação no lado Monitor. A entrada <code>services.yaml</code> mais simples possível:",
|
||||
"authedTitle": "Elemento autenticado",
|
||||
"authedIntro": "Gere um token API em <strong>Admin → Security → API Tokens</strong> no Monitor, copie-o e cole-o no cabeçalho <code>Authorization</code> abaixo — substitua o token de exemplo mostrado após <code>Bearer</code> pelo que você acabou de copiar:",
|
||||
"authedIntro": "Gere um token API em <strong>Administrador → Segurança → Tokens de API</strong> no Monitor, copie-o e cole-o no cabeçalho <code>Authorization</code> abaixo — substitua o token de exemplo mostrado após <code>Bearer</code> pelo que você acabou de copiar:",
|
||||
"authedOutro": "Reinicie o Homepage para apresentar valores atualizados. Reutilize o token nos widgets que consultam a mesma instância do Monitor.",
|
||||
"multiTitle": "Configuração multi-widget — sistema, armazenamento, rede",
|
||||
"multiIntro": "Para mais detalhes, crie três cartões com endpoints diferentes: sistema, armazenamento e rede. Use o mesmo token para esta instância do Monitor.",
|
||||
|
||||
@@ -12,13 +12,13 @@
|
||||
},
|
||||
"intro": {
|
||||
"title": "O que esta página cobre",
|
||||
"body": "Como mudar o Monitor de HTTP para HTTPS no painel Admin → Security, o que cada fonte de certificado realmente aponta no disco, como a opção Proxmox se comporta quando o host tem um certificado Let's Encrypt, e como definir caminhos personalizados se você gerenciar certs fora do Proxmox."
|
||||
"body": "Como mudar o Monitor de HTTP para HTTPS no painel Administrador → Segurança, o que cada fonte de certificado realmente aponta no disco, como a opção Proxmox se comporta quando o host tem um certificado Let's Encrypt, e como definir caminhos personalizados se você gerenciar certs fora do Proxmox."
|
||||
},
|
||||
"wheresetting": {
|
||||
"heading": "Onde se encontra a configuração",
|
||||
"body": "Abra o Monitor e vá a <strong>Admin → Security → SSL / HTTPS</strong>. O painel mostra HTTP ou HTTPS e, se HTTPS ainda estiver desativado, as fontes de certificados detetadas.",
|
||||
"imageAlt": "Painel Admin → Security → SSL / HTTPS no Monitor mostrando o estado HTTPS-off, o certificado Proxmox auto-detectado (sujeito, emissor, expiração) e a opção Use Custom Certificate",
|
||||
"caption": "Painel Admin → Security → SSL / HTTPS antes da ativação. O Monitor mostra o certificado utilizado pelo Proxmox e permite escolhê-lo com um clique."
|
||||
"body": "Abra o Monitor e vá a <strong>Administrador → Segurança → SSL/HTTPS</strong>. O painel mostra HTTP ou HTTPS e, se HTTPS ainda estiver desativado, as fontes de certificados detetadas.",
|
||||
"imageAlt": "Painel Administrador → Segurança → SSL/HTTPS no Monitor mostrando o estado HTTPS-off, o certificado Proxmox auto-detectado (sujeito, emissor, expiração) e a opção Use Custom Certificate",
|
||||
"caption": "Painel Administrador → Segurança → SSL/HTTPS antes da ativação. O Monitor mostra o certificado utilizado pelo Proxmox e permite escolhê-lo com um clique."
|
||||
},
|
||||
"twoways": {
|
||||
"heading": "Duas maneiras de ativar o HTTPS",
|
||||
@@ -117,7 +117,7 @@
|
||||
},
|
||||
"switchToHttps": {
|
||||
"heading": "Mudar o monitor para HTTPS",
|
||||
"bodyRich": "Quando <code>/etc/pve/local/pveproxy-ssl.pem</code> estiver assinado por Let's Encrypt, abra <strong>Admin → Security → SSL / HTTPS</strong>, confirme que o emissor é <em>Let's Encrypt</em> e não a CA local Proxmox, e clique em <strong>Usar certificado Proxmox</strong>. O Monitor reinicia e o próximo carregamento utiliza HTTPS em 8008 com uma cadeia de confiança pública. As renovações ACME seguintes são validadas e selecionadas na próxima nova ligação TLS, sem consultas periódicas nem reinício por renovação. <strong>Atualizar certificado</strong> continua disponível em Security para diagnóstico e recuperação."
|
||||
"bodyRich": "Quando <code>/etc/pve/local/pveproxy-ssl.pem</code> estiver assinado por Let's Encrypt, abra <strong>Administrador → Segurança → SSL/HTTPS</strong>, confirme que o emissor é <em>Let's Encrypt</em> e não a CA local Proxmox, e clique em <strong>Usar certificado Proxmox</strong>. O Monitor reinicia e o próximo carregamento utiliza HTTPS em 8008 com uma cadeia de confiança pública. As renovações ACME seguintes são validadas e selecionadas na próxima nova ligação TLS, sem consultas periódicas nem reinício por renovação. <strong>Atualizar certificado</strong> continua disponível em Segurança para diagnóstico e recuperação."
|
||||
},
|
||||
"custom": {
|
||||
"heading": "Certificado personalizado — quando usá-lo",
|
||||
|
||||
@@ -284,14 +284,14 @@
|
||||
"heading": "API tokeny (dlhodobé)",
|
||||
"intro": "Relácie prehliadača platia 24 hodín. Pre Homepage, Home Assistant, Grafana či Uptime Kuma vytvorte samostatný <strong>token API</strong> platný 365 dní. JWT používa rovnaký podpisový kľúč; pole <code>token_name</code> umožňuje sledovať a jednotlivo zrušiť token.",
|
||||
"imageAlt": "Panel tokenov API znázorňujúci zoznam tokenov s názvom, predponou, vytvoreným dátumom a expiráciou",
|
||||
"imageCaption": "Zoznam tokenov API v Admin → Security: názov, predpona s poslednými štyrmi identifikačnými znakmi, dátum vytvorenia a platnosť, možnosť zrušenia.",
|
||||
"imageCaption": "Zoznam tokenov API v Správa → Bezpečnosť: názov, predpona s poslednými štyrmi identifikačnými znakmi, dátum vytvorenia a platnosť, možnosť zrušenia.",
|
||||
"generateTitle": "Generovať token",
|
||||
"generateIntro": "Z panelu:",
|
||||
"generateSteps": [
|
||||
"Otvorte sekciu <strong>karta Security → API Tokens</strong>.",
|
||||
"Otvorte <strong>Správa → Bezpečnosť → API tokeny</strong> a kliknite na <strong>Vytvoriť nový token</strong>.",
|
||||
"Zadajte opisný názov, <em>napríklad \"Home Assistant\"</em>.",
|
||||
"Zadajte svoje heslo. Ak je zapnutá 2FA, aj súčasný 6-miestny kód.",
|
||||
"Kliknite na <strong>Generate new token</strong> a potom na <strong>Generate token</strong>. Token sa zobrazí <strong>iba raz</strong>: hneď ho skopírujte."
|
||||
"Kliknite na <strong>Vytvoriť token</strong>. Token sa zobrazí <strong>iba raz</strong>: hneď ho skopírujte."
|
||||
],
|
||||
"generateCli": "Z príkazového riadku:",
|
||||
"useTitle": "Použitie tokenu",
|
||||
@@ -310,7 +310,7 @@
|
||||
"intro": "Dve cesty k TLS:",
|
||||
"items": [
|
||||
"<strong>Odporúčaný reverzný proxy.</strong> Ukončite TLS na Nginx / Caddy / Traefik a posielajte HTTP procesu Flask na port 8008. Príklady sú nižšie.",
|
||||
"<strong>Priame HTTPS v AppImage.</strong> Certifikát nastavte cez <code>POST /api/ssl/configure</code> (rozhranie: <strong>Admin → Security → SSL / HTTPS</strong>). HTTPS používa <code>gevent.pywsgi</code> so štandardným handlerom; flask-sock obsluhuje WebSocket pre WSS. Cesty certifikátov sa uložia v konfigurácii SSL."
|
||||
"<strong>Priame HTTPS v AppImage.</strong> Certifikát nastavte cez <code>POST /api/ssl/configure</code> (rozhranie: <strong>Správa → Bezpečnosť → SSL / HTTPS</strong>). HTTPS používa <code>gevent.pywsgi</code> so štandardným handlerom; flask-sock obsluhuje WebSocket pre WSS. Cesty certifikátov sa uložia v konfigurácii SSL."
|
||||
],
|
||||
"calloutTitle": "Priame obmedzenia HTTPS",
|
||||
"calloutBody": "Monitor môže použiť certifikát spravovaný Proxmoxom alebo vlastné súbory. Sám certifikáty ACME nevydáva. Na automatické vydávanie a obnovu použite Proxmox ACME alebo proxy Caddy, Traefik či Nginx a zabezpečte načítanie obnovených certifikátov."
|
||||
|
||||
@@ -165,7 +165,7 @@
|
||||
},
|
||||
"ollama": {
|
||||
"heading": "Ollama (miestne)",
|
||||
"tagline": "Používa modely na vašom serveri Ollama. Plne lokálne, súkromné a bezplatné na prevádzku.",
|
||||
"tagline": "Používa modely sprístupnené nastaveným serverom Ollama. Lokálne modely bežia na ňom; cloudové modely Ollama posielajú požiadavky cloudovému poskytovateľovi. Lokálna prevádzka nemá poplatok za hostované API, ale využíva vlastný hardvér a elektrinu.",
|
||||
"items": [
|
||||
"Kľúč API netreba. Pole <em>Ollama URL</em> nastavte na svoj server, predvolene <code>http://localhost:11434</code>, alebo na hostiteľa s vašou inštanciou Ollama.",
|
||||
"Modely sa <strong>nefiltrujú.</strong> Monitor načíta modely stiahnuté pomocou <code>ollama pull <model></code>. Ponuku naplní z <code>GET /api/tags</code> na serveri Ollama.",
|
||||
|
||||
@@ -50,7 +50,7 @@
|
||||
},
|
||||
{
|
||||
"name": "Terminál",
|
||||
"owns": "Shell v prehliadači na hostiteľovi Proxmox pomocou <code>xterm.js</code> cez WebSockets. Konzoly LXC sa otvárajú z karty VMs & LXCs."
|
||||
"owns": "Shell v prehliadači na hostiteľovi Proxmox pomocou <code>xterm.js</code> cez WebSockets. Konzoly LXC sa otvárajú z karty VM a LXC."
|
||||
},
|
||||
{
|
||||
"name": "Zabezpečenie",
|
||||
|
||||
@@ -41,7 +41,7 @@
|
||||
"heading": "Jednotky siete",
|
||||
"imageAlt": "Karta Jednotky siete s výberom zobrazenia na Bajty",
|
||||
"imageCaption": "Vyberte bity alebo bajty za sekundu pre všetky sieťové rýchlosti v prehľade.",
|
||||
"body": "Zvoľte, ako sa na paneli zobrazuje sieťová priepustnosť: v <strong>bitoch za sekundu</strong> (Mbps/Gbps) alebo <strong>bajtoch za sekundu</strong> (MB/s/GB/s). Predvolené sú bajty, ako ich uvádza väčšina nástrojov na prenos súborov; bity používajú výrobcovia sieťových kariet a poskytovatelia pri označovaní svojich produktov. Voľba sa ukladá v prehliadači, takže každý prehliadač má vlastnú. Nastavenie platí pre všetky grafy, štítky a pomôcky so sieťovou rýchlosťou a uplatní sa ihneď, bez obnovenia."
|
||||
"body": "Zobrazuje priepustnosť v <strong>bitoch za sekundu</strong> (Mbps/Gbps) alebo <strong>bajtoch za sekundu</strong> (MB/s/GB/s). Predvolené sú bajty. Voľba sa ukladá v prehliadači. Grafy, štítky a pomôcky sa zmenia ihneď bez obnovenia."
|
||||
},
|
||||
"health": {
|
||||
"heading": "Monitor zdravia",
|
||||
@@ -203,7 +203,7 @@
|
||||
"heading": "Kontrola aktualizácií v LXC",
|
||||
"imageAlt": "Karta zisťovania aktualizácií LXC s prepínačom hľadania balíkov v spustených kontajneroch Debian, Ubuntu a Alpine",
|
||||
"imageCaption": "Prepínač pravidelnej kontroly cez <code>apt list --upgradable</code> / <code>apk list -u</code> v spustených CT. Predvolene zapnutý. Súvisiaci prepínač v Oznámenia → Služby sa zobrazuje pri zapnutej detekcii.",
|
||||
"intro": "Prepínač medzi Prahmi monitora stavu a kartou Oznámenia riadi kontrolu aktualizácií LXC. Zapnutý prejde všetky bežiace CT a spýta sa správcu balíkov v kontajneri na čakajúce aktualizácie; výsledky sa zobrazia v počtoch na karte VMs & LXCs a vstupujú do oznámenia <code>lxc_updates_available</code>. Vypnutý kontrolu úplne zastaví (žiadne volania <code>pct exec</code>) a všetky existujúce záznamy LXC v <code>managed_installs.json</code> sa okamžite odstránia, takže panel aj koncový bod <code>/api/managed-installs</code> prestanú hlásiť stav aktualizácií LXC bez čakania na ďalší 24-hodinový cyklus.",
|
||||
"intro": "Prepínač medzi prahmi monitora stavu a kartou Oznámenia riadi kontrolu aktualizácií LXC. Zapnutý zisťuje čakajúce aktualizácie balíkov v spustených CT; výsledky sa zobrazujú na karte VM a LXC a používajú sa v oznámení <code>lxc_updates_available</code>. Vypnutý zastaví volania <code>pct exec</code> a odstráni záznamy LXC z <code>managed_installs.json</code>; <code>/api/managed-installs</code> prestane hlásiť stav bez čakania na ďalší 24-hodinový cyklus.",
|
||||
"whatRunsTitle": "Čo kontrola spúšťa",
|
||||
"whatRunsIntro": "Pre každý CT v stave <code>running</code> s podporovaným správcom balíkov:",
|
||||
"whatRunsItems": [
|
||||
|
||||
@@ -52,7 +52,7 @@
|
||||
"backupsTitle": "Zálohy",
|
||||
"backupsBody": "Záložné archívy na každom úložisku schopnom ukladať zálohy (dir, NFS, CIFS, PBS), načítané cez <code>pvesh get /nodes/localhost/storage/<id>/content</code>. Karty hore ukazujú počty VM a LXC a celkovú veľkosť; pod nimi je jeden riadok na archív s typom, úložiskom, veľkosťou a dátumom. Obnova sa vykonáva vo webovom rozhraní Proxmox.",
|
||||
"notificationsTitle": "Oznámenia",
|
||||
"notificationsBody1": "Aktivita oznámení Proxmox: riadky denníka zo služieb Proxmox, ktoré spomínajú oznámenia, e-mail, webhooky alebo upozornenia, ciele v /etc/pve/notifications.cfg a úlohy zálohovania zo zoznamu úloh klastra. Riadky úloh zálohovania umožňujú stiahnuť úplný záznam úlohy. História toho, čo odoslal samotný Monitor, je v Settings → Notifications → Notification history.",
|
||||
"notificationsBody1": "Aktivita oznámení Proxmox: riadky denníka zo služieb Proxmox, ktoré spomínajú oznámenia, e-mail, webhooky alebo upozornenia, ciele v /etc/pve/notifications.cfg a úlohy zálohovania zo zoznamu úloh klastra. Riadky úloh zálohovania umožňujú stiahnuť úplný záznam úlohy. História toho, čo odoslal samotný Monitor, je v Nastavenia → Notifikácie → História upozornení.",
|
||||
"notificationsBody2": "Táto karta slúži na kontrolu, čo robí vlastný systém oznámení Proxmoxu. Kanály Monitora sa nastavujú na podrobnej stránke <link>Oznámenia</link>."
|
||||
},
|
||||
"dataCollected": {
|
||||
@@ -64,7 +64,7 @@
|
||||
{
|
||||
"subtab": "Záznamy (živý filter)",
|
||||
"endpoint": "/api/logs",
|
||||
"source": "<code>journalctl</code> s filtrami priority, služby a rozsahu dní uplatnenými na serveri; vyhľadávanie textu prebieha v prehliadači."
|
||||
"source": "Karta načíta <code>/api/logs?since_days=N</code>; filtre úrovne, služby a textu sa uplatňujú v prehliadači. API prijíma aj <code>priority</code> a <code>service</code>, ktoré karta zatiaľ nepoužíva."
|
||||
},
|
||||
{
|
||||
"subtab": "Stiahnuť",
|
||||
|
||||
@@ -117,7 +117,7 @@
|
||||
"<strong>Cieľ</strong> — úložisko (PBS-Cloud, PBS-Local, NFS-Backup, …), farebne podľa stavu.",
|
||||
"<strong>Veľkosť</strong> — konečná veľkosť zálohy na disku."
|
||||
],
|
||||
"backupsOutro": "Tlačidlo <strong>+ Create Backup</strong> vpravo hore otvorí dialóg na výber úložiska, režimu (snapshot / suspend / stop), ochrany a poznámok pred spustením vzdump. Obnova sa vykonáva vo webovom rozhraní Proxmox; Monitor ukazuje pohľad „bola táto VM nedávno zálohovaná?“, nie postup obnovy.",
|
||||
"backupsOutro": "Tlačidlo <strong>+ Vytvoriť zálohu</strong> vpravo hore otvorí dialóg na výber úložiska, režimu (snapshot / suspend / stop), ochrany a poznámok pred spustením vzdump. Obnova sa vykonáva vo webovom rozhraní Proxmox; Monitor ukazuje pohľad „bola táto VM nedávno zálohovaná?“, nie postup obnovy.",
|
||||
"firewallTitle": "Karta 7 — Firewall",
|
||||
"firewallIntro": "Číta záznam firewallu Proxmox daného systému priamo z hostiteľa, bez ďalšej služby a pravidelných dotazov. Karta je vždy prítomná; obsah závisí od zapnutia firewallu a od toho, či pravidlo zaznamenáva pakety.",
|
||||
"firewallItems": [
|
||||
|
||||
@@ -113,7 +113,7 @@
|
||||
"api": {
|
||||
"heading": "REST API a integrácie",
|
||||
"intro": "Endpointy REST poskytujú monitorovacie dáta JSON cez HTTP/HTTPS pre Homepage, Home Assistant, Uptime Kuma a skripty. Grafana môže použiť samostatný textový exportér Prometheus na <code>/api/prometheus</code>. Požiadavky možno posielať cez <code>curl</code>.",
|
||||
"tokens": "Tokeny API s dlhou životnosťou (365 dni) sa generujú z <strong>Admin → Security → API Tokens</strong> alebo prostredníctvom <code>POST /api/auth/generate-api-token</code>.",
|
||||
"tokens": "Tokeny API s dlhou životnosťou (365 dni) sa generujú z <strong>Správa → Bezpečnosť → API tokeny</strong> alebo prostredníctvom <code>POST /api/auth/generate-api-token</code>.",
|
||||
"bearer": "Tokeny posielajte ako <code>Authorization: Bearer …</code>. Aj <code>/api/health</code> očakáva hlavičku Bearer, takže kontroly dostupnosti potrebujú token read_only. Pod <code>/api/auth/*</code> sú verejné trasy nastavenia/prihlásenia/stavu aj chránené trasy správy účtov/tokenov; nie všetky sú anonymné.",
|
||||
"catalog": "Katalóg endpointov, rotácia tokenov a zabezpečenie sú v <linkApi>Referenčnej príručke API</linkApi>; príklady pre Homepage, Home Assistant, Grafana, Uptime Kuma a cURL sú v <linkIntegrations>Integrácie</linkIntegrations>."
|
||||
},
|
||||
|
||||
@@ -20,13 +20,13 @@
|
||||
"heading": "Overenie: jedna vec, ktorú každý recept potrebuje",
|
||||
"intro": "Väčšina použitých koncových bodov vyžaduje overenie. Požiadavku možno splniť dvoma spôsobmi.",
|
||||
"optAtitle": "Možnosť A API token (odporúčané pre integráciu)",
|
||||
"optAbody1": "Otvorte <strong>Admin → Security → API Tokens</strong>. Kliknite na <em>Generovať token</em>, zadajte názov ako <em>homepage</em>, <em>home-assistant</em> alebo <em>prometheus</em> a skopírujte ho: zobrazí sa <em>iba raz</em>. Predvolene platí rok a možno ho samostatne odvolať. Používajte ho pre klientov mimo prehliadača.",
|
||||
"optAbody1": "Otvorte <strong>Správa → Bezpečnosť → API tokeny</strong>. Kliknite na <em>Vytvoriť nový token</em>, zadajte názov ako <em>homepage</em>, <em>home-assistant</em> alebo <em>prometheus</em>, vyplňte heslo (a kód 2FA, ak je zapnutá), kliknite na <em>Vytvoriť token</em> a hneď ho skopírujte: zobrazí sa <em>iba raz</em>. Predvolene platí rok a možno ho samostatne odvolať. Používajte ho pre klientov mimo prehliadača.",
|
||||
"optAbody2": "Od tohto bodu je každá žiadosť jednoducho:",
|
||||
"optBtitle": "Možnosť B — prihlásenie menom a heslom",
|
||||
"optBbody": "Vhodné pre skripty, ktoré sa overujú ako používateľ. Vrátený token platí krátko; väčšina integrácií by mala použiť možnosť A.",
|
||||
"outro": "Pole TOTP treba iba pri zapnutom dvojfaktorovom overení. Výmenu a odvolanie tokenov, pravidlá hesiel a auditný denník opisuje <link>Prístup a overenie</link>.",
|
||||
"httpsTitle": "Používanie HTTPS namiesto HTTP",
|
||||
"httpsIntro": "Príklady používajú pre stručnosť <code>http://</code>. Ak ste na Monitore zapli TLS (<strong>Admin → Security → SSL / HTTPS</strong>), v každej URL nahraďte <code>http://</code> za <code>https://</code>. Dve poznámky pre konkrétne nástroje:",
|
||||
"httpsIntro": "Príklady používajú pre stručnosť <code>http://</code>. Ak ste na Monitore zapli TLS (<strong>Správa → Bezpečnosť → SSL / HTTPS</strong>), v každej URL nahraďte <code>http://</code> za <code>https://</code>. Dve poznámky pre konkrétne nástroje:",
|
||||
"httpsItems": [
|
||||
"<strong>Certifikáty podpísané vlastným kľúčom.</strong> Integrácia Home Assistant <code>rest:</code> predvolene overuje TLS. Pri takomto certifikáte Monitora pridajte <code>verify_ssl: false</code> do každého bloku REST vedľa <code>scan_interval:</code> alebo importujte CA Monitora medzi dôveryhodné certifikáty. Rovnako postupujú iné nástroje overujúce certifikáty.",
|
||||
"<strong>Prometheus</strong> má v príklade nižšie pripravené <code>scheme: https</code>. Zapnite alebo ponechajte <code>https</code>, ak je TLS na Monitore zapnuté."
|
||||
@@ -43,7 +43,7 @@
|
||||
"basicTitle": "Základný widget — bez overenia",
|
||||
"basicIntro": "Použite to, keď je ProxMenux Monitor na dôveryhodnej sieti a ešte ste nezaviedli autentifikáciu na strane monitora. Najjednoduchšia možná položka <code>services.yaml</code>:",
|
||||
"authedTitle": "Overený grafický prvok",
|
||||
"authedIntro": "Na Monitore vytvorte token v <strong>Admin → Security → API Tokens</strong>. Skopírujte ho do hlavičky <code>Authorization</code> nižšie: ukážkový token za <code>Bearer</code> nahraďte vlastným.",
|
||||
"authedIntro": "Na Monitore vytvorte token v <strong>Správa → Bezpečnosť → API tokeny</strong>. Skopírujte ho do hlavičky <code>Authorization</code> nižšie: ukážkový token za <code>Bearer</code> nahraďte vlastným.",
|
||||
"authedOutro": "Reštartujte Homepage a karta zobrazí aktuálne hodnoty. Rovnaký token použite vo widgetoch, ktoré čítajú tú istú inštanciu Monitora.",
|
||||
"multiTitle": "Nastavenie multi- widgetu Systém, úložisko, sieť",
|
||||
"multiIntro": "Pre viac podrobností vytvorte tri karty s rôznymi koncovými bodmi: systém, úložisko a sieť. Pre tú istú inštanciu Monitora použite rovnaký token.",
|
||||
|
||||
@@ -12,13 +12,13 @@
|
||||
},
|
||||
"intro": {
|
||||
"title": "Čo táto stránka obsahuje",
|
||||
"body": "Ako prepnúť Monitor z HTTP na HTTPS v paneli Admin → Security, na aké súbory ukazujú zdroje certifikátov, ako sa správa možnosť Proxmox s certifikátom Let’s Encrypt a ako nastaviť vlastné cesty pri správe certifikátov mimo Proxmox."
|
||||
"body": "Ako prepnúť Monitor z HTTP na HTTPS v paneli Správa → Bezpečnosť, na aké súbory ukazujú zdroje certifikátov, ako sa správa možnosť Proxmox s certifikátom Let’s Encrypt a ako nastaviť vlastné cesty pri správe certifikátov mimo Proxmox."
|
||||
},
|
||||
"wheresetting": {
|
||||
"heading": "Kde nájdete nastavenie",
|
||||
"body": "Otvorte Monitor a prejdite na <strong>Admin → Security → SSL / HTTPS</strong>. Panel zobrazuje HTTP alebo HTTPS a pri vypnutom HTTPS rozpoznané zdroje certifikátov.",
|
||||
"imageAlt": "Panel Admin → Security → SSL / HTTPS na monitore zobrazujúci vypnutý stav HTTPS, automaticky zistený certifikát Proxmox (predmet, vydavateľ, expirácia) a možnosť Použiť vlastný certifikát",
|
||||
"caption": "Panel Admin → Security → SSL / HTTPS pred aktiváciou. Monitor zobrazí certifikát používaný Proxmoxom a umožní ho vybrať jedným kliknutím."
|
||||
"body": "Otvorte Monitor a prejdite na <strong>Správa → Bezpečnosť → SSL / HTTPS</strong>. Panel zobrazuje HTTP alebo HTTPS a pri vypnutom HTTPS rozpoznané zdroje certifikátov.",
|
||||
"imageAlt": "Panel Správa → Bezpečnosť → SSL / HTTPS na monitore zobrazujúci vypnutý stav HTTPS, automaticky zistený certifikát Proxmox (predmet, vydavateľ, expirácia) a možnosť Použiť vlastný certifikát",
|
||||
"caption": "Panel Správa → Bezpečnosť → SSL / HTTPS pred aktiváciou. Monitor zobrazí certifikát používaný Proxmoxom a umožní ho vybrať jedným kliknutím."
|
||||
},
|
||||
"twoways": {
|
||||
"heading": "Dva spôsoby, ako umožniť HTTPS",
|
||||
@@ -117,7 +117,7 @@
|
||||
},
|
||||
"switchToHttps": {
|
||||
"heading": "Prepnúť monitor na HTTPS",
|
||||
"bodyRich": "Keď je <code>/etc/pve/local/pveproxy-ssl.pem</code> podpísaný Let's Encrypt, otvorte <strong>Admin → Security → SSL / HTTPS</strong>, overte vydavateľa <em>Let's Encrypt</em> namiesto miestnej CA Proxmox a kliknite na <strong>Použiť certifikát Proxmox</strong>. Monitor sa reštartuje a ďalšie načítanie použije HTTPS na 8008 s verejne dôveryhodným reťazcom. Ďalšie obnovy ACME sa overia a vyberú pri nasledujúcom novom spojení TLS bez pravidelného dopytovania alebo reštartu služby pri obnove. <strong>Aktualizovať certifikát</strong> zostáva v Zabezpečení dostupné ako explicitná diagnostická a obnovovacia akcia."
|
||||
"bodyRich": "Keď je <code>/etc/pve/local/pveproxy-ssl.pem</code> podpísaný Let's Encrypt, otvorte <strong>Správa → Bezpečnosť → SSL / HTTPS</strong>, overte vydavateľa <em>Let's Encrypt</em> namiesto miestnej CA Proxmox a kliknite na <strong>Použiť certifikát Proxmox</strong>. Monitor sa reštartuje a ďalšie načítanie použije HTTPS na 8008 s verejne dôveryhodným reťazcom. Ďalšie obnovy ACME sa overia a vyberú pri nasledujúcom novom spojení TLS bez pravidelného dopytovania alebo reštartu služby pri obnove. <strong>Aktualizovať certifikát</strong> v časti Bezpečnosť umožňuje ručne skontrolovať a znovu načítať certifikát bez reštartu Monitora."
|
||||
},
|
||||
"custom": {
|
||||
"heading": "Vlastný certifikát — kedy ho použiť",
|
||||
|
||||
@@ -284,14 +284,14 @@
|
||||
"heading": "API-token med lång giltighetstid",
|
||||
"intro": "Sessioner löper ut efter 24 timmar. Skapa ett separat <strong>API-token</strong> giltigt i 365 dagar för Homepage, Home Assistant, Grafana eller Uptime Kuma. JWT:t använder samma signeringshemlighet; fältet <code>token_name</code> gör att det kan identifieras och återkallas separat.",
|
||||
"imageAlt": "API-tokenlista med namn, prefix, datum för skapande och utgångsdatum",
|
||||
"imageCaption": "Listan över API-token under Admin → Säkerhet visar namn, prefix (de fyra sista tecknen visas för identifiering), skapande- och utgångsdatum samt återkallelse.",
|
||||
"imageCaption": "Listan över API-token under Administration → Säkerhet visar namn, prefix (de fyra sista tecknen visas för identifiering), skapande- och utgångsdatum samt återkallelse.",
|
||||
"generateTitle": "Generera en token",
|
||||
"generateIntro": "Från panelen:",
|
||||
"generateSteps": [
|
||||
"Öppna <strong>Säkerhet → API-åtkomsttoken</strong>.",
|
||||
"Öppna <strong>Administration → Säkerhet → API-tokens</strong> och välj <strong>Generera ny token</strong>.",
|
||||
"Skriv ett beskrivande namn (<em>t.ex. \"Home Assistant\"</em>).",
|
||||
"Skriv in ditt lösenord. Om 2FA är på, även den nuvarande 6-siffriga koden.",
|
||||
"Välj <strong>Generera ny token</strong> och sedan <strong>Generera token</strong>. Det visas <strong>endast en gång</strong>: kopiera direkt."
|
||||
"Välj <strong>Generera token</strong>. Den visas <strong>endast en gång</strong>: kopiera direkt."
|
||||
],
|
||||
"generateCli": "Från kommandoraden:",
|
||||
"useTitle": "Använd en token",
|
||||
@@ -310,7 +310,7 @@
|
||||
"intro": "Två vägar till TLS:",
|
||||
"items": [
|
||||
"<strong>Omvänd proxy rekommenderas.</strong> Avsluta TLS på Nginx / Caddy / Traefik och vidarebefordra HTTP till Flask på port 8008. Exempel nedan.",
|
||||
"<strong>Direkt HTTPS i AppImage.</strong> Ange certifikat via <code>POST /api/ssl/configure</code> (gränssnitt: <strong>Admin → Säkerhet → SSL / HTTPS</strong>). HTTPS använder <code>gevent.pywsgi</code> med standardhanteraren; flask-sock hanterar WebSocket för WSS. Certifikatsökvägar sparas i SSL-konfigurationen."
|
||||
"<strong>Direkt HTTPS i AppImage.</strong> Ange certifikat via <code>POST /api/ssl/configure</code> (gränssnitt: <strong>Administration → Säkerhet → SSL / HTTPS</strong>). HTTPS använder <code>gevent.pywsgi</code> med standardhanteraren; flask-sock hanterar WebSocket för WSS. Certifikatsökvägar sparas i SSL-konfigurationen."
|
||||
],
|
||||
"calloutTitle": "Direkt HTTPS begränsningar",
|
||||
"calloutBody": "Monitor kan använda ett certifikat hanterat av Proxmox eller egna certifikatsfiler. Det utfärdar inte ACME-certifikat självt. Använd Proxmox ACME eller Caddy, Traefik eller Nginx för automatisk utfärdning och förnyelse, och se till att förnyade certifikat läses in."
|
||||
|
||||
@@ -165,7 +165,7 @@
|
||||
},
|
||||
"ollama": {
|
||||
"heading": "Ollama (lokal)",
|
||||
"tagline": "Använder modeller på din Ollama-server. Helt lokalt, privat och gratis att köra.",
|
||||
"tagline": "Använder modeller som din konfigurerade Ollama-server visar. Lokala modeller körs där; Ollamas molnmodeller vidarebefordrar anrop till en molnleverantör. Lokal körning undviker avgifter för ett hostat API men använder egen hårdvara och el.",
|
||||
"items": [
|
||||
"Ingen API nyckel. Ställ in <em>Ollama URL</em>-fältet till din server (standard <code>http://localhost:11434</code> eller vilken värd som helst kör din Ollama-instans).",
|
||||
"Modellerna <strong>filtreras inte.</strong> Monitor läser modeller som hämtats med <code>ollama pull <model></code>. Listrutan hämtas från <code>GET /api/tags</code> på din Ollama-server.",
|
||||
|
||||
@@ -50,7 +50,7 @@
|
||||
},
|
||||
{
|
||||
"name": "Terminal",
|
||||
"owns": "Skal i webbläsaren på Proxmox-värden, med <code>xterm.js</code> över WebSockets. LXC-konsoler öppnas från fliken VMs & LXCs."
|
||||
"owns": "Skal i webbläsaren på Proxmox-värden, med <code>xterm.js</code> över WebSockets. LXC-konsoler öppnas från fliken VM och LXC."
|
||||
},
|
||||
{
|
||||
"name": "Säkerhet",
|
||||
|
||||
@@ -203,7 +203,7 @@
|
||||
"heading": "Identifiering av LXC-uppdateringar",
|
||||
"imageAlt": "Kort för LXC-uppdateringar med reglage för att söka väntande paket i körande Debian-, Ubuntu- och Alpine-containrar",
|
||||
"imageCaption": "Reglage för regelbundna kontroller med <code>apt list --upgradable</code> / <code>apk list -u</code> i körande CT. Påslaget som standard. Motsvarande aviseringsreglage under Aviseringar → Tjänster visas när detektering är på.",
|
||||
"intro": "Ett särskilt reglage för LXC-uppdateringskontrollen, placerat mellan Gränser och Aviseringar. Påslaget går ProxMenux igenom varje körande CT på värden och frågar pakethanteraren i containern efter väntande uppdateringar; resultaten visas i antalsmärkena på fliken VMs & LXCs och matar aviseringen <code>lxc_updates_available</code>. Avstängt stoppar kontrollen helt (inga <code>pct exec</code>-anrop) och befintliga LXC-poster i <code>managed_installs.json</code> tas bort direkt, så att panelen och <code>/api/managed-installs</code> slutar visa LXC-uppdateringsstatus utan att vänta på nästa 24-timmarscykel.",
|
||||
"intro": "Ett särskilt reglage för LXC-uppdateringskontrollen, placerat mellan Gränser och Aviseringar. Påslaget går ProxMenux igenom varje körande CT på värden och frågar pakethanteraren i containern efter väntande uppdateringar; resultaten visas i antalsmärkena på fliken VM och LXC och matar aviseringen <code>lxc_updates_available</code>. Avstängt stoppar kontrollen helt (inga <code>pct exec</code>-anrop) och befintliga LXC-poster i <code>managed_installs.json</code> tas bort direkt, så att panelen och <code>/api/managed-installs</code> slutar visa LXC-uppdateringsstatus utan att vänta på nästa 24-timmarscykel.",
|
||||
"whatRunsTitle": "Vad kontrollen kör",
|
||||
"whatRunsIntro": "För varje CT i tillståndet <code>running</code> med en pakethanterare som stöds:",
|
||||
"whatRunsItems": [
|
||||
|
||||
@@ -52,7 +52,7 @@
|
||||
"backupsTitle": "Säkerhetskopieringar",
|
||||
"backupsBody": "Säkerhetskopieringsarkiven på varje lagring som kan hålla säkerhetskopior (dir, NFS, CIFS, PBS), lästa med <code>pvesh get /nodes/localhost/storage/<id>/content</code>. Korten överst visar antal VM:ar och LXC samt total storlek; nedanför visas en rad per arkiv med typ, lagring, storlek och datum. Återställning sker i Proxmox webbgränssnitt.",
|
||||
"notificationsTitle": "Aviseringar",
|
||||
"notificationsBody1": "Proxmox aviseringsaktivitet: journalrader från Proxmox-tjänster som nämner aviseringar, e-post, webhooks eller larm, målen i /etc/pve/notifications.cfg samt säkerhetskopieringsuppgifter från klustrets uppgiftslista. Rader för säkerhetskopieringsuppgifter kan ladda ner hela uppgiftsloggen. Historiken över vad Monitor själv har skickat finns under Settings → Notifications → Notification history.",
|
||||
"notificationsBody1": "Proxmox aviseringsaktivitet: journalrader från Proxmox-tjänster som nämner aviseringar, e-post, webhooks eller larm, målen i /etc/pve/notifications.cfg samt säkerhetskopieringsuppgifter från klustrets uppgiftslista. Rader för säkerhetskopieringsuppgifter kan ladda ner hela uppgiftsloggen. Historiken över vad Monitor själv har skickat finns under Inställningar → Aviseringar → Aviseringshistorik.",
|
||||
"notificationsBody2": "Använd fliken för att kontrollera vad Proxmox egna aviseringssystem gör. Kanalinställningar för Monitor finns på den detaljerade sidan <link>Aviseringar</link>."
|
||||
},
|
||||
"dataCollected": {
|
||||
@@ -64,7 +64,7 @@
|
||||
{
|
||||
"subtab": "Loggar (livefilter)",
|
||||
"endpoint": "/api/logs",
|
||||
"source": "<code>journalctl</code> med filter för prioritet, tjänst och antal dagar tillämpade på servern; textsökning körs i webbläsaren."
|
||||
"source": "Fliken hämtar <code>/api/logs?since_days=N</code>; filter för nivå, tjänst och text tillämpas i webbläsaren. API:et tar även emot <code>priority</code> och <code>service</code>, som fliken ännu inte använder."
|
||||
},
|
||||
{
|
||||
"subtab": "Ladda ner",
|
||||
|
||||
@@ -113,7 +113,7 @@
|
||||
"api": {
|
||||
"heading": "REST API och integrationer",
|
||||
"intro": "REST-endpointar ger övervakningsdata som JSON över HTTP/HTTPS för Homepage, Home Assistant, Uptime Kuma och skript. Grafana kan använda den separata Prometheus-textexportören på <code>/api/prometheus</code>. Anrop kan göras med <code>curl</code>.",
|
||||
"tokens": "Långlivade API-token (365 dagar) skapas under <strong>Admin → Säkerhet → API-token</strong> eller via <code>POST /api/auth/generate-api-token</code>.",
|
||||
"tokens": "Långlivade API-token (365 dagar) skapas under <strong>Administration → Säkerhet → API-token</strong> eller via <code>POST /api/auth/generate-api-token</code>.",
|
||||
"bearer": "Skicka token som <code>Authorization: Bearer …</code>. Även <code>/api/health</code> förväntar sig Bearer-headern, så tillgänglighetskontroller behöver en read_only-token. Under <code>/api/auth/*</code> finns både offentliga inställnings-/inloggnings-/statusrutter och skyddade rutter för konto-/tokenhantering; alla är inte anonyma.",
|
||||
"catalog": "Den fullständiga slutpunktskatalogen, vägledning för tokenrotation och bästa säkerhetspraxis finns i <linkApi>API Referens</linkApi>; Färdiga exempel för Homepage, Home Assistant, Grafana, Uptime Kuma och ett generiskt cURL-mönster finns i <linkIntegrations>Integrationer</linkIntegrations>."
|
||||
},
|
||||
|
||||
@@ -20,13 +20,13 @@
|
||||
"heading": "Autentisering: det enda varje recept behöver",
|
||||
"intro": "De flesta endpoints som används av dessa integrationer är autentiserade. Du har två sätt att tillfredsställa detta krav.",
|
||||
"optAtitle": "Alternativ A – API token (rekommenderas för integrationer)",
|
||||
"optAbody1": "Öppna <strong>Admin → Säkerhet → API-token</strong>. Välj <em>Skapa token</em>, ge den ett namn som <em>homepage</em>, <em>home-assistant</em> eller <em>prometheus</em> och kopiera den: den visas <em>bara en gång</em>. Den gäller ett år som standard och kan återkallas separat. Använd den för klienter utanför webbläsaren.",
|
||||
"optAbody1": "Öppna <strong>Administration → Säkerhet → API-tokens</strong>. Välj <em>Generera ny token</em>, ge den ett namn som <em>homepage</em>, <em>home-assistant</em> eller <em>prometheus</em>, ange ditt lösenord (och 2FA-koden om den är på), välj sedan <em>Generera token</em> och kopiera den: den visas <em>bara en gång</em>. Den gäller ett år som standard och kan återkallas separat. Använd den för klienter utanför webbläsaren.",
|
||||
"optAbody2": "Från den punkten är varje begäran bara:",
|
||||
"optBtitle": "Alternativ B – inloggningsflöde (användarnamn + lösenord)",
|
||||
"optBbody": "Användbart för skript som autentiserar som en mänsklig användare. Den returnerade token är kortlivad; de flesta integrationer bör föredra Alternativ A.",
|
||||
"outro": "TOTP-fältet behövs bara med tvåfaktorsautentisering påslagen. Rotation och återkallande av token, lösenordsregler och granskningslogg beskrivs i <link>Åtkomst och autentisering</link>.",
|
||||
"httpsTitle": "Använda HTTPS istället för HTTP",
|
||||
"httpsIntro": "Exemplen använder <code>http://</code> för korthet. Om TLS är påslaget i Monitor (<strong>Admin → Säkerhet → SSL / HTTPS</strong>), byt <code>http://</code> mot <code>https://</code> i varje URL. Två verktygsspecifika anmärkningar:",
|
||||
"httpsIntro": "Exemplen använder <code>http://</code> för korthet. Om TLS är påslaget i Monitor (<strong>Administration → Säkerhet → SSL / HTTPS</strong>), byt <code>http://</code> mot <code>https://</code> i varje URL. Två verktygsspecifika anmärkningar:",
|
||||
"httpsItems": [
|
||||
"<strong>Självsignerade certifikat.</strong> Home Assistants <code>rest:</code>-integration verifierar TLS som standard. Med Monitors självsignerade certifikat kan du lägga till <code>verify_ssl: false</code> i varje REST-block bredvid <code>scan_interval:</code> eller importera dess CA i betrodda certifikat. Detsamma gäller andra verktyg som verifierar certifikat.",
|
||||
"<strong>Prometheus</strong> har redan <code>scheme: https</code> i exemplet nedan. Aktivera eller behåll <code>https</code> när TLS är påslaget i Monitor."
|
||||
@@ -43,7 +43,7 @@
|
||||
"basicTitle": "Grundläggande widget - ingen autentisering",
|
||||
"basicIntro": "Använd detta när ProxMenux Monitor är på ett pålitligt nätverk och du har inte aktiverat autentisering på Monitor sidan ännu. Den enklaste möjliga <code>services.yaml</code>-posten:",
|
||||
"authedTitle": "Autentiserad widget",
|
||||
"authedIntro": "Skapa en API-token under <strong>Admin → Säkerhet → API-token</strong> i Monitor. Kopiera den till headern <code>Authorization</code> nedan och ersätt exempeltoken efter <code>Bearer</code>.",
|
||||
"authedIntro": "Skapa en API-token under <strong>Administration → Säkerhet → API-token</strong> i Monitor. Kopiera den till headern <code>Authorization</code> nedan och ersätt exempeltoken efter <code>Bearer</code>.",
|
||||
"authedOutro": "Starta om Homepage så visar kortet aktuella värden. Återanvänd token i widgetar som läser samma Monitor-instans.",
|
||||
"multiTitle": "Multi-widget setup – system, lagring, nätverk",
|
||||
"multiIntro": "För fler detaljer skapar du tre kort med olika endpoints: system, lagring och nätverk. Använd samma token för denna Monitor-instans.",
|
||||
|
||||
@@ -12,13 +12,13 @@
|
||||
},
|
||||
"intro": {
|
||||
"title": "Vad denna sida täcker",
|
||||
"body": "Hur man byter Monitor från HTTP till HTTPS i panelen Admin → Säkerhet, vad varje certifikatkälla faktiskt pekar på på disken, hur Proxmox-alternativet beter sig när värden har en Let's Encrypt-cert och hur man ställer in anpassade vägar om du hanterar certer utanför Proxmox."
|
||||
"body": "Hur man byter Monitor från HTTP till HTTPS i panelen Administration → Säkerhet, vad varje certifikatkälla faktiskt pekar på på disken, hur Proxmox-alternativet beter sig när värden har en Let's Encrypt-cert och hur man ställer in anpassade vägar om du hanterar certer utanför Proxmox."
|
||||
},
|
||||
"wheresetting": {
|
||||
"heading": "Var inställningen finns",
|
||||
"body": "Öppna Monitor och gå till <strong>Admin → Säkerhet → SSL / HTTPS</strong>. Panelen visar HTTP eller HTTPS och, om HTTPS inte aktiverats, de upptäckta certifikatkällorna.",
|
||||
"imageAlt": "Panelen Admin → Säkerhet → SSL / HTTPS i Monitorn som visar HTTPS-off-tillståndet, det automatiska upptäckta Proxmox-certifikatet (ämne, emittent, utgång) och alternativet Använd anpassat certifikat",
|
||||
"caption": "Panelen Admin → Säkerhet → SSL / HTTPS före aktivering. Monitor visar certifikatet som Proxmox använder och låter dig välja det med ett klick."
|
||||
"body": "Öppna Monitor och gå till <strong>Administration → Säkerhet → SSL / HTTPS</strong>. Panelen visar HTTP eller HTTPS och, om HTTPS inte aktiverats, de upptäckta certifikatkällorna.",
|
||||
"imageAlt": "Panelen Administration → Säkerhet → SSL / HTTPS i Monitorn som visar HTTPS-off-tillståndet, det automatiska upptäckta Proxmox-certifikatet (ämne, emittent, utgång) och alternativet Använd anpassat certifikat",
|
||||
"caption": "Panelen Administration → Säkerhet → SSL / HTTPS före aktivering. Monitor visar certifikatet som Proxmox använder och låter dig välja det med ett klick."
|
||||
},
|
||||
"twoways": {
|
||||
"heading": "Två sätt att aktivera HTTPS",
|
||||
@@ -117,7 +117,7 @@
|
||||
},
|
||||
"switchToHttps": {
|
||||
"heading": "Byt Monitor till HTTPS",
|
||||
"bodyRich": "När <code>/etc/pve/local/pveproxy-ssl.pem</code> signerats av Let's Encrypt öppnar du <strong>Admin → Säkerhet → SSL / HTTPS</strong>, kontrollerar att utfärdaren är <em>Let's Encrypt</em> och inte Proxmox lokala CA och klickar på <strong>Använd Proxmox-certifikat</strong>. Monitor startar om och nästa sidladdning använder HTTPS på 8008 med en offentligt betrodd certifikatkedja. Senare ACME-förnyelser valideras och väljs vid nästa nya TLS-anslutning, utan återkommande avfrågning eller omstart vid förnyelse. <strong>Uppdatera certifikat</strong> finns kvar under Säkerhet för diagnos och återställning."
|
||||
"bodyRich": "När <code>/etc/pve/local/pveproxy-ssl.pem</code> signerats av Let's Encrypt öppnar du <strong>Administration → Säkerhet → SSL / HTTPS</strong>, kontrollerar att utfärdaren är <em>Let's Encrypt</em> och inte Proxmox lokala CA och klickar på <strong>Använd Proxmox-certifikat</strong>. Monitor startar om och nästa sidladdning använder HTTPS på 8008 med en offentligt betrodd certifikatkedja. Senare ACME-förnyelser valideras och väljs vid nästa nya TLS-anslutning, utan återkommande avfrågning eller omstart vid förnyelse. <strong>Uppdatera certifikat</strong> finns kvar under Säkerhet för diagnos och återställning."
|
||||
},
|
||||
"custom": {
|
||||
"heading": "Anpassat certifikat - när du ska använda det",
|
||||
|
||||
Reference in New Issue
Block a user