FreePBX是基于Asterisk的开源电话管理系统，其默认通过IP地址或主机名访问Web管理界面。要实现绑定域名访问，本质上是将FreePBX的HTTP服务、Asterisk的SIP/RTP通信以及REST API（如Ari）与域名进行关联。整个过程涉及DNS解析、Apache/Nginx虚拟主机配置、FreePBX系统设置以及TLS证书部署。
首先，在域名服务商处添加一条A记录，将你的域名（例如pbx.example.com）解析到FreePBX服务器的公网IP。如果服务器位于内网，则需要在路由器上设置端口转发，将TCP 80/443（Web界面）、UDP 5060（SIP信令）、UDP 10000-20000（RTP媒体）转发到FreePBX内网地址。注意，SIP协议还可能需要TCP 5060或TLS 5061，取决于你的中继配置。
登录FreePBX管理界面后，依次进入Settings → Asterisk SIP Settings，在Channel SIP或PJSIP设置页面中，找到Local Networks和External Address。在External Address字段中填入你的域名（如pbx.example.com），并设置External Port（通常为5060）。这样Asterisk在SIP/SDP消息中通告给外部终端的地址就会使用域名而非IP。
对于Web管理界面，FreePBX 16及更早版本使用Apache作为Web服务器，而FreePBX 17（基于Rocky Linux 9）同样使用Apache。你需要修改Apache的虚拟主机配置。典型配置文件位于/etc/httpd/conf.d/freepbx.conf（CentOS/RHEL系）或/etc/apache2/sites-available/freepbx.conf（Debian系）。将ServerName设置为你的域名，并确保ServerAlias包含域名。同时，修改FreePBX的/etc/amportal.conf文件，找到AMPDBHOST、AMPWEBADDRESS或类似的HTTP_HOST变量，将其设置为域名。
更安全的做法是使用反向代理。在FreePBX前部署Nginx或Caddy，将域名请求代理至FreePBX的本地HTTP服务（默认端口80或443）。但需注意，FreePBX的Web界面依赖Websocket和AJAX，反向代理必须正确传递Host头、X-Forwarded-Proto头且启用Websocket升级（Upgrade: websocket）。否则，操作面板中的实时状态、呼叫监控等功能会异常。
如果希望直接通过https://域名访问，则需要配置SSL证书。FreePBX内置了Let's Encrypt模块（位于Admin → Certificates）。在申请证书前，确保域名已解析到当前服务器，且80端口可从公网访问。模块会自动生成证书并配置Apache。如果你使用反向代理，则证书可统一管理在代理层，但FreePBX内部仍需使用http回源。不要忘记在FreePBX设置中开启Force HTTPS（通过/etc/amportal.conf或模块配置），以免混合内容错误。
绑定域名后，还需要修改FreePBX的Base URL。在/etc/amportal.conf中设置HTTP_HOST=pbx.example.com和BASEURL=https://pbx.example.com（可选）。同时，在Settings → Advanced Settings中搜索“Web Address”或“SSH”相关项，确保所有生成的链接（如CDR报表、邮件通知）使用新域名。
对于SIP终端（如IP话机、软电话），在注册信息中的服务器地址必须填入域名，而不能是IP。Asterisk的domain参数也需要匹配。在PJSIP配置中，可以设置domain=pbx.example.com，并确保sip.conf或pjsip.conf中的externaddr和localnet正确。使用域名时，建议启用SIP over TCP或TLS，因为UDP模式更容易收到伪造的注册请求，而域名解析后NAT穿透会更加复杂。若要启用SIP TLS，需要生成服务器证书，并在sip.conf中配置tlsenable=yes、tlsbindaddr=0.0.0.0:5061以及tlscertfile=/etc/asterisk/keys/asterisk.pem。
另一个关键点是防火墙。绑定域名后，服务器可能同时接收来自不同网络的请求。确保防火墙规则按域名或IP放行，且FreePBX的fail2ban模块会记录域名访问日志。如果使用Cloudflare等CDN代理Web界面，必须关闭HTTP/2和Websocket缓冲，否则FreePBX控制台无法实时推送事件。
最后，验证绑定是否成功。在服务器上执行asterisk -r进入CLI，输入sip show registry查看外部中继是否已用域名注册；输入http show status确认HTTP服务绑定的监听地址；使用浏览器访问https://pbx.example.com，并检查页面源代码中是否存在IP地址残留。如果一切正常，FreePBX的System Info页面会显示当前的主机名为你的域名。
综上，FreePBX绑定域名的核心操作是：配置DNS解析 → 修改Asterisk外部地址 → 调整Apache虚拟主机ServerName → 部署SSL证书 → 更新FreePBX内部URL → 验证SIP与Web连通性。由于FreePBX版本差异（如15/16/17）和操作系统差异（CentOS 7、Rocky 9、Debian 12），具体文件路径可能略有不同，建议每次修改后运行fwconsole reload和fwconsole restart，并备份配置。
查看详情
查看详情
