> For the complete documentation index, see [llms.txt](https://docs.verge.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.verge.io/knowledge-base/de/tenants/configuring-proxy.md). # Proxy konfigurieren Die Verwendung eines Proxys ermöglicht es, 1 IP-Adresse für mehrere Tenant-Umgebungen zu nutzen, indem FQDN-Hostnamen zugeordnet werden. Dadurch entfällt die Notwendigkeit, pro Tenant 1 IP-Adresse bereitzustellen, und IPv4-Adressen werden geschont. ### Proxy aktivieren 1. Vom externen Netzwerk aus, das für den Zugriff auf Tenant-Umgebungen verwendet wird: * Wählen Sie **Bearbeiten** im linken Menü. * Aktivieren **Proxy**. * In den meisten Fällen kann das **Proxy-Listen-Adresse** Feld leer gelassen werden. Dies setzt standardmäßig auf `0.0.0.0`, was bedeutet, dass es auf allen Adressen lauscht. {% hint style="warning" %} **Für VergeOS-Versionen 4.12.6 und älter** ‚Bind DNS‘ muss vorübergehend aktiviert werden, wenn es im Netzwerk noch nicht verwendet wird. Dadurch wird die IP-Alias-Auswahl in der UI (Schritt 2) angezeigt. Senden Sie die Einstellungen ab, aber ***STARTEN SIE DAS NETZWERK NOCH NICHT NEU UND WENDEN SIE NOCH KEINE REGELN AN!*** {% endhint %} 2. Vom selben externen Netzwerk aus: * Wählen Sie **IP-Adressen** im linken Menü. * Bearbeiten oder erstellen Sie eine IP-Adresse und setzen Sie die **Typ** zu **IP-Alias**. * Absenden. * Setzen Sie die DNS-Einstellung des externen Netzwerks wieder auf die ursprüngliche Einstellung zurück (vor Version 4.12.4). * Wählen Sie **Regeln**. * Erstellen Sie eine neue Regel, die wie im folgenden Bild aussieht: ![proxy\_accept\_rule.png](/files/7aea6adcf7401c17ac773afbdcd20db4e333a318) * Starten Sie das Netzwerk neu und wenden Sie die Regeln an. * Testen Sie die Regel, indem Sie einen Browser-Tab öffnen und zur URL navigieren, wobei Sie die im vorherigen Schritt zugewiesene IP-Alias-Adresse verwenden. Wenn alles korrekt funktioniert, wird die UI-Anmeldeseite unter der IP-Alias-Adresse geöffnet. ### Einen neuen Tenant mit Proxy erstellen 1. Erstellen Sie eine **A-Record** für den neuen Tenant bei Ihrem Domain-Registrar, der auf den zugewiesenen IP-Alias zeigt. 2. Erstellen Sie einen neuen Tenant: * Geben Sie alle gewünschten Einstellungen ein und lassen Sie die **URL** leer. 3. Im **UI-Verwaltung** Registerkarte auf der Seite zur Tenant-Erstellung, wählen Sie **Einen neuen FQDN erstellen**. 4. Im **Proxy-Tenant-Konfiguration** Seite: * Wählen Sie das Netzwerk aus, auf dem der Proxy-Dienst ausgeführt wird. * Wählen Sie den Tenant-Namen aus. * Geben Sie den FQDN des Tenants ein (den in Schritt 1 erstellten A-Record). * Absenden. 5. Wählen Sie **Überspringen** am unteren Ende der **UI-Verwaltung** Seite, um zu vermeiden, dass dem Tenant direkt eine IP zugewiesen wird. {% hint style="info" %} **Ein Tenant kann nicht gleichzeitig eine UI-IP-Adresse UND einen per Proxy bereitgestellten FQDN haben.** {% endhint %} 6. Wählen Sie im neuen Tenant-Dashboard **Proxy anwenden** in der hervorgehobenen Warnung. 7. Starten Sie den Tenant und navigieren Sie in einem Browser-Tab zu seiner URL, um sich anzumelden. ### Einen vorhandenen Tenant zur Verwendung von Proxy bearbeiten 1. Erstellen Sie eine **A-Record** für den Tenant bei Ihrem Domain-Registrar, der auf den zugewiesenen IP-Alias zeigt (falls noch keiner vorhanden ist). 2. Wählen Sie im Tenant-Dashboard **Bearbeiten** im linken Menü aus: * Im **UI-Adresse** Feld wählen Sie **Keine**. 3. Navigieren Sie zu dem Netzwerk, auf dem der Proxy-Dienst läuft: * Wählen Sie **Proxy** im linken Menü. 4. Von der **Proxy-Dashboard**: * Wählen Sie **Tenants anzeigen**. * Wählen Sie **Neu**. 5. Im **Proxy-Tenant-Konfiguration** Seite: * Wählen Sie das Netzwerk aus, auf dem der Proxy-Dienst ausgeführt wird. * Wählen Sie den Tenant-Namen aus. * Geben Sie den FQDN des Tenants ein (den in Schritt 1 erstellten A-Record). 6. Navigieren Sie zum Tenant-Dashboard und wählen Sie **Proxy anwenden** in der hervorgehobenen Warnung. 7. Wählen Sie im Tenant-Dashboard das Tenant-Netzwerk (hervorgehoben) aus. ![tenant\_apply\_rules.png](/files/c44fc1973cf11503a1f5af86cf65b4d520259a08) 8. Wählen Sie **Regeln anwenden** in der hervorgehobenen Warnung. 9. Testen Sie den Zugriff auf den Tenant, indem Sie in einem Browser-Tab zu seiner URL navigieren. *** {% hint style="info" %} **Dokumentinformationen** * Zuletzt aktualisiert: 2024-08-29 * vergeOS-Version: 4.12.6 {% endhint %} --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.verge.io/knowledge-base/de/tenants/configuring-proxy.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.