Wie installiere ich FreePBX 17 auf einem Debian-12-VPS?
FreePBX 17 und Asterisk mit dem offiziellen Skript installieren, die SIP- und RTP-Ports öffnen, NAT einstellen, eine Nebenstelle und einen SIP-Trunk
FreePBX ist eine freie Weboberfläche für Asterisk, die Software für Telefonanlagen (IP-PBX). Auf einem VPS installiert, verwaltet es die Nebenstellen des Teams, die SIP-Leitungen des Anbieters, Voicemail, Warteschlangen und Öffnungszeiten, ohne Hardware vor Ort. Version 17 wird mit einem offiziellen Skript von Sangoma installiert, das nur Debian 12 unterstützt.
Schritt-für-Schritt-Anleitung
-
Einen VPS mit Debian 12 vorbereiten
Wählen Sie bei der Bestellung Debian 12 oder installieren Sie den VPS mit diesem System neu: Das Skript erwartet eine saubere Installation ohne vorhandenen Webserver oder Datenbank. Verbinden Sie sich dann per SSH als root.
-
Aktualisieren und den Rechner benennen
Führen Sie apt update && apt upgrade -y aus und starten Sie neu, falls ein neuer Kernel installiert wurde. Geben Sie dem VPS einen vollständigen Namen (FQDN) wie pbx.example.com mit hostnamectl set-hostname und einer Zeile in /etc/hosts: Das Skript bricht ab, wenn hostname -f nichts zurückgibt.
-
Das offizielle Skript ausführen
Laden Sie sng_freepbx_debian_install.sh aus dem GitHub-Repository FreePBX/sng_freepbx_debian_install herunter und führen Sie es mit bash aus. Es installiert Asterisk 22, FreePBX, Apache, PHP 8.2, MariaDB, Fail2ban und die Basismodule; rechnen Sie mit 15 bis 30 Minuten. Das ausführliche Log liegt in /var/log/pbx/.
-
Administratorkonto anlegen
Öffnen Sie http://VPS_IP/ im Browser. FreePBX fragt nach Benutzername, Passwort und einer E-Mail-Adresse für Benachrichtigungen. Die Aktivierung bei Sangoma ist optional: Sie dient den kommerziellen Modulen.
-
Die SIP- und RTP-Ports öffnen
Erlauben Sie in der „Firewall“ des ACLClouds-Panels 5060/UDP für die SIP-Signalisierung und den Bereich 10000-20000/UDP für die Sprache (RTP). Beschränken Sie 80 und 443/TCP, die Administrationsoberfläche, auf Ihre IP-Adresse.
-
NAT einstellen und eine Nebenstelle anlegen
Klicken Sie unter „Settings“ > „Asterisk SIP Settings“ auf „Detect Network Settings“, um die externe Adresse und die lokalen Netze einzutragen. Legen Sie dann unter „Applications“ > „Extensions“ eine PJSIP-Nebenstelle an, richten Sie sie auf einem Softphone ein und klicken Sie auf „Apply Config“.
Rechner benennen und FreePBX 17 installieren
apt update && apt upgrade -y
hostnamectl set-hostname pbx.example.com
echo "127.0.1.1 pbx.example.com pbx" >> /etc/hosts
hostname -f
wget https://github.com/FreePBX/sng_freepbx_debian_install/raw/master/sng_freepbx_debian_install.sh -O /tmp/sng_freepbx_debian_install.sh
bash /tmp/sng_freepbx_debian_install.sh
Nützliche Befehle nach der Installation
fwconsole restart
fwconsole reload
fwconsole ma upgradeall
fwconsole chown
asterisk -rvvv
In der Asterisk-Konsole
pjsip show endpoints
pjsip show registrations
core show channels
Bevor Sie beginnen
Eine FreePBX-Telefonanlage braucht für ein kleines Team wenig Ressourcen: Die Last entsteht vor allem durch die Zahl gleichzeitiger Gespräche, die Gesprächsaufzeichnung und das Transkodieren zwischen Codecs. Außerdem brauchen Sie einen SIP-Trunk, also eine Leitung eines VoIP-Anbieters, um nach außen zu telefonieren und Anrufe auf Ihren Nummern zu empfangen.
- Debian 12 (bookworm) ist das einzige System, das das Skript von FreePBX 17 akzeptiert; es lehnt Debian 13 ab und blockiert dieses Upgrade.
- Der VPS muss dieselbe IP-Adresse behalten: Anbieter und Telefone verweisen darauf.
- Standardmäßig installiert das Skript auch die kommerziellen Module von Sangoma, darunter System Admin und Firewall; die Option --opensourceonly entfernt sie, einschließlich des Firewall-Moduls.
Einen SIP-Trunk hinzufügen
Fügen Sie unter „Connectivity“ > „Trunks“ einen PJSIP-Trunk mit den Daten des Anbieters hinzu: SIP-Server, Benutzername, Passwort und je nach Tarif Registrierung oder Authentifizierung per IP-Adresse. Legen Sie dann pro Nummer eine eingehende Route („Inbound Routes“) und eine ausgehende Route („Outbound Routes“) mit den erlaubten Rufnummernformaten an.
Wenn der Anbieter per IP-Adresse authentifiziert, geben Sie ihm die IPv4 des VPS und öffnen Sie 5060/UDP in der Firewall nur für seine Adressen.
Die Telefonanlage schützen
Ein öffentlicher SIP-Port erhält wenige Stunden nach dem Start automatische Anmeldeversuche. Das Hauptrisiko ist Gebührenbetrug: Anrufe zu Mehrwert- oder Auslandsnummern über eine gekaperte Nebenstelle, abgerechnet über Ihr Anbieterkonto.
- Behalten Sie Fail2ban, das das Skript installiert: Es sperrt Adressen nach mehreren fehlgeschlagenen SIP-Anmeldungen.
- Geben Sie jeder Nebenstelle ein langes, zufälliges Passwort, niemals die Nummer der Nebenstelle.
- Lehnen Sie anonyme Anrufe ab: Setzen Sie „Allow Anonymous Inbound SIP Calls“ und „Allow SIP Guests“ unter „Asterisk SIP Settings“ auf „No“.
- Beschränken Sie ausgehende Routen auf die nötigen Ziele und bitten Sie den Anbieter um ein Ausgabenlimit oder eine Sperre für Mehrwert- und Auslandsnummern.
Häufige Fehler und Lösungen
Die meisten Sprachprobleme entstehen durch NAT oder die RTP-Ports. pjsip show endpoints und das Log /var/log/asterisk/full nennen meist die Ursache.
- Gespräch steht, aber kein Ton oder Ton nur in eine Richtung: Der Bereich 10000-20000/UDP ist geschlossen oder die externe Adresse unter „Asterisk SIP Settings“ ist leer. Korrigieren Sie das und klicken Sie auf „Apply Config“.
- Die Nebenstelle registriert sich nicht und erhält 401 Unauthorized: falscher Benutzername oder falsches Passwort. Erhält sie nach mehreren Versuchen gar keine Antwort mehr, hat Fail2ban ihre Adresse gesperrt.
- Das Skript bricht mit Unsupported OS version ab: Das System ist nicht Debian 12. Installieren Sie den VPS mit Debian 12 neu und starten Sie es erneut.
- Das Skript bricht bei Fully qualified domain name (FQDN) is not set correctly ab: Geben Sie dem Rechner mit hostnamectl und /etc/hosts einen vollständigen Namen.
- Die Oberfläche zeigt nach einem Update eine leere Seite oder einen Fehler: Führen Sie fwconsole chown und dann fwconsole restart aus.
Welcher VPS für FreePBX?
Bei ACLClouds kostet der VPS Mini (2 vCPU, 8 GB RAM, 40 GB Speicher) Stand 17. November 2026 4,99 € pro Monat ohne Laufzeit oder 3,99 € pro Monat bei 1 Jahr Laufzeit: genug für die Telefonanlage eines kleinen Unternehmens samt Voicemail. Der VPS Essentiel (4 vCPU, 16 GB RAM, 80 GB) für 9,99 € pro Monat lässt Spielraum für Gesprächsaufzeichnungen und viele gleichzeitige Gespräche. Das Netzwerk bietet bis zu 1 Gbit/s; ein Gespräch in G.711 belegt etwa 90 kbit/s pro Richtung.
Schnellüberprüfung
- http://VPS_IP/ zeigt die Anmeldung von FreePBX.
- pjsip show endpoints zeigt die Nebenstelle als verfügbar.
- Ein Gespräch zwischen zwei Nebenstellen kommt mit Ton in beide Richtungen zustande.
- Der Trunk erscheint in pjsip show registrations als registriert.
- Die Administrationsoberfläche ist nur von Ihren Adressen aus erreichbar.
Häufig gestellte Fragen
Ist FreePBX kostenlos?
Ja. FreePBX und Asterisk sind freie Software ohne Lizenz pro Nebenstelle. Nur einige kommerzielle Module von Sangoma kosten Geld, etwa EndPoint Manager; eine vollständige Telefonanlage funktioniert ohne sie. Externe Gespräche rechnet Ihr SIP-Anbieter ab.
Lässt sich FreePBX 17 auf Debian 13 oder Ubuntu installieren?
Nicht mit dem offiziellen Skript, das auf jedem anderen System als Debian 12 abbricht. Eine manuelle Installation ist möglich, wird von Sangoma aber nicht unterstützt: Wählen Sie für eine produktive Telefonanlage Debian 12.
Brauche ich ein HTTPS-Zertifikat für die Oberfläche?
Das ist empfehlenswert, sobald Sie die Oberfläche oder das Benutzerportal (UCP) im Internet öffnen. Lassen Sie einen Domainnamen auf den VPS zeigen und beantragen Sie ein Let’s-Encrypt-Zertifikat; das FreePBX-Modul „Certificate Management“ kann es ebenfalls ausstellen und erneuern.
Wie viele gleichzeitige Gespräche schafft ein kleiner VPS?
Ohne Transkodierung oder Aufzeichnung passen einige Dutzend Gespräche auf 2 vCPU: Asterisk leitet vor allem Pakete weiter. Transkodierung (zum Beispiel G.722 nach G.729) und die Aufzeichnung jedes Gesprächs erhöhen die CPU- und Speicherlast deutlich. Messen Sie mit core show channels zu Spitzenzeiten, bevor Sie Nebenstellen hinzufügen.