Onsite Proxy

Übersicht

Der Onsite Proxy ist eine kommandozeilenbasierte Proxy-Software, die eine sichere Verbindung zwischen Ihrer Cloud-Telefonanlage und IP-Telefonen an entfernten Standorten herstellt. Er überwindet gängige Firewall- und Netzwerkprobleme, indem er als lokaler Vermittler zwischen den Telefonen und der cloudbasierten Telefonanlage fungiert.

Um Onsite-Proxy-Instanzen zu verwalten, melden Sie sich im PBX-Adminportal an und navigieren Sie zu System > Onsite Proxy.

Einsatzszenario

Wenn mehrere IP-Telefone in einem entfernten Subnetz bereitgestellt werden (z. B. in einer Zweigstelle), können Sie den Onsite-Proxy auf einem Host im selben Subnetz wie die Telefone installieren. Nur der Proxy benötigt eine Verbindung zur Cloud-Telefonanlage – die einzelnen Telefone benötigen keinen direkten Zugang zur Cloud.

Der Onsite-Proxy leitet dann Provisionierungslinks, SIP-Signalisierung und RTP-Pakete zwischen den Telefonen und der Telefonanlage weiter, sodass diese funktionieren, als befänden sie sich im selben Netzwerk wie die Telefonanlage. Dadurch entfällt die Notwendigkeit, Portweiterleitungen oder Firewall-Regeln für jedes Telefon einzeln zu konfigurieren, und die Latenz wird im Vergleich zu herkömmlichen Fernzugriffslösungen reduziert.

Hauptfunktionen

Automatische Erkennung von IP-Telefonen

Der Onsite-Proxy erkennt automatisch verfügbare IP-Telefone im selben Subnetz über PnP (Plug-and-Play) und meldet deren Informationen (einschliesslich MAC-Adresse, IP-Adresse, Hersteller und Modell) an die Telefonanlage.

Zero-Touch-Auto-Provisionierung

Wenn Sie Nebenstellen den vom Onsite Proxy erkannten IP-Telefonen zuweisen, sendet der Proxy automatisch den Provisionierungslink von der Telefonanlage an die Telefone. Die Telefone laden dann ihre Konfiguration herunter und schliessen die Nebenstellenregistrierung ohne manuellen Eingriff ab.

SIP-Signalisierungs-Proxy

Der Onsite Proxy leitet SIP-Registrierungsanfragen von Telefonen an die Telefonanlage weiter und hält eine stabile Registrierung aufrecht. Er vermittelt die gesamte SIP-Signalisierung (wie REGISTER, INVITE und BYE) zwischen den Telefonen und der Telefonanlage über einen einzigen UDP-Port 5060 auf dem Proxy-Host.

Audio-RTP-Passthrough

Der Onsite Proxy unterstützt Audio-RTP-Passthrough. Wenn aktiviert und IP-Telefone über denselben Onsite Proxy registriert sind, werden die RTP-Audioströme zwischen ihnen direkt (Peer-to-Peer) übertragen und umgehen sowohl die Telefonanlage als auch den Proxy. Dies reduziert die Latenz, spart Bandbreite und verbessert die Gesprächsqualität.

Voraussetzungen

Onsite-Proxy-Host

Empfohlene Spezifikationen

Die vom Onsite Proxy unterstützte Kapazität hängt von den dem Host zugewiesenen Systemressourcen ab.

Schritt 1: Onsite-Proxy-Instanz auf der Telefonanlage anlegen

Bevor Sie die Onsite-Proxy-Software installieren, müssen Sie eine Onsite-Proxy-Instanz auf der Telefonanlage erstellen. Dabei werden die Verbindungsdaten (Verbindungsadresse, UUID und geheimer Schlüssel) generiert, die Sie bei der Installation des Proxys benötigen.

1. Melden Sie sich im PBX-Adminportal an und gehen Sie zu System > Onsite Proxy. Klicken Sie auf Hinzufügen.

2. Konfigurieren Sie im Abschnitt Basis die folgenden Einstellungen:

   Einstellung	Beschreibung
   Name	Geben Sie einen Namen ein, um diese Onsite-Proxy-Instanz zu identifizieren (z. B. den Standort der Zweigstelle).
   Plattform	Wählen Sie Linux.

   

3. Aktivieren oder deaktivieren Sie im Abschnitt Audio-RTP-Passthrough die Option nach Bedarf.
   • Wenn aktiviert, werden RTP-Audioströme zwischen Telefonen, die über denselben Onsite Proxy registriert sind, direkt (Peer-to-Peer) übertragen.
   • Wenn deaktiviert, werden RTP-Audioströme über die Telefonanlage geleitet.
4. Klicken Sie auf Speichern und Übernehmen.

Die Onsite-Proxy-Instanz erscheint in der Liste mit den automatisch generierten Verbindungsinformationen (Verbindungsadresse, UUID und geheimer Schlüssel).

Schritt 2: Onsite-Proxy-Software installieren

Installieren Sie den Onsite Proxy auf einem Linux-Host im selben Subnetz wie die IP‑Telefone. Während der Installation führt Sie ein Konfigurationsassistent durch die Verbindung des Proxys mit der Cloud-Telefonanlage.

Voraussetzungen

• Sie haben eine Onsite-Proxy-Instanz auf der Telefonanlage angelegt (Schritt 1) und die Verbindungsdaten (Verbindungsadresse, UUID, geheimer Schlüssel) erhalten.
• Der Linux-Host erfüllt die oben genannten Anforderungen (Betriebssystem, Port, IP-Adresse).
• HTTPS muss für die PBX-Verbindungsadresse aktiviert sein.

Installationspaket herunterladen und entpacken

1. Greifen Sie auf die Kommandozeile des Onsite-Proxy-Hosts zu.
2. Führen Sie sudo -i aus, um zum Root-Benutzer zu wechseln.
3. Laden Sie das neueste Onsite-Proxy-Installationspaket herunter:
   • x86_64:
     wget https://www.virtual-call.net/hubfs/download/onsite-proxy/onsiteproxy-x86_64.tar.gz -O /tmp/onsiteproxy.tar.gz
   • ARM64:
     wget https://www.virtual-call.net/hubfs/download/onsite-proxy/onsiteproxy-aarch64.tar.gz -O /tmp/onsiteproxy.tar.gz
4. Entpacken Sie das Paket in das Stammverzeichnis:
   tar -xzf /tmp/onsiteproxy.tar.gz -C /

Installer ausführen und Verbindung konfigurieren

1. Führen Sie onsite-proxy-install aus, um die Installation zu starten.

2. Überprüfen Sie im Fenster Onsite Proxy Installation die Version und Systemdetails, wählen Sie Yes und drücken Sie die Eingabetaste.

   

3. Bestätigen Sie im Fenster Important Requirements, dass UDP-Port 5060 verfügbar und HTTPS aktiviert ist, und drücken Sie die Eingabetaste.

   

4. Drücken Sie im Willkommensfenster des Configuration Wizard die Eingabetaste, um zu beginnen.

   

5. Konfigurieren Sie die Verbindungsinformationen von der Telefonanlage:

   Einstellung	Beschreibung
   PBX Connection Address	Fügen Sie die von der Telefonanlage erhaltene Verbindungsadresse ein. Dies kann eine IP-Adresse oder ein Domänenname sein.
   UUID	Fügen Sie die von der Telefonanlage erhaltene UUID ein.
   Secret Key	Fügen Sie den von der Telefonanlage erhaltenen geheimen Schlüssel ein. Bewahren Sie diesen Schlüssel sicher auf.
   PBX External Web Server Port	Der HTTPS-Port der Telefonanlage. Für die Cloud-Telefonanlage ist der Standard 443.
   PBX External Tunnel Port	Der Tunnel-Port für die Proxy-Verbindung. Standard: 1090.
   Local IP	Wählen Sie die dem Proxy-Host zugewiesene statische IP-Adresse oder wählen Sie manual, um sie manuell einzugeben.

   

6. Überprüfen Sie im Fenster Configuration Summary alle Einstellungen und wählen Sie Yes zur Bestätigung.

   

7. Warten Sie, bis die Überprüfung abgeschlossen ist. Drücken Sie in den Fenstern Verification Successful und Configuration Complete jeweils die Eingabetaste.

   

8. Drücken Sie im Fenster Installation Complete die Eingabetaste, um den Vorgang abzuschliessen.

   

Der Onsite-Proxy ist nun installiert und mit der Cloud-Telefonanlage verbunden. Auf der Telefonanlage wechselt der Instanzstatus zu einem grünen Häkchen und zeigt die Proxy-Version, interne und öffentliche IP-Adresse an.

Onsite Proxy verwalten

Status und Informationen anzeigen

Gehen Sie zu System > Onsite Proxy, um den Status aller Onsite-Proxy-Instanzen anzuzeigen. Die Liste zeigt Name, Plattform, Version, UUID und geheimen Schlüssel jeder Instanz. Sie können auch das Suchfeld und den Spaltenfilter verwenden, um bestimmte Instanzen zu finden.

Onsite-Proxy-Instanz bearbeiten

Klicken Sie auf das Bearbeitungssymbol neben einer Instanz, um den Namen, die Plattform oder die Audio-RTP-Passthrough-Einstellung zu ändern. Im Abschnitt Verbindungsinformationen werden auch die Verbindungsadresse, UUID und der geheime Schlüssel angezeigt.

Proxy-Status und Informationen abfragen

Nachdem der Onsite-Proxy verbunden ist, können Sie detaillierte Statusinformationen anzeigen, indem Sie auf das Statussymbol neben der Instanz klicken. Dies umfasst die Proxy-Version, interne und öffentliche IP-Adressen sowie die Systemressourcenauslastung.

Proxy neu konfigurieren oder deinstallieren

Nach der Installation können Sie die folgenden Befehle auf dem Proxy-Host verwenden: