escomputers/freepbx

FreePBX Docker镜像文档

镜像概述

本镜像为基于Docker Compose的最小可行应用，用于运行FreePBX——Asterisk的VoIP管理系统。启动该多容器应用后，将提供一个开箱即用的SIP呼叫PBX系统。

核心组件版本

• FreePBX 17.0.21
• PHP 8.2.29
• Asterisk 21.10.2
• MariaDB 10.11.14
• Apache 2.4.65
• NodeJS v18.20.4
• 基础镜像：Debian https://hub.docker.com/_/debian/

核心功能与特性

• 安全防护：预配置Fail2ban，采用严格的 enforcement 规则
• 邮件通知：支持系统事件邮件通知
• 日志管理：为Asterisk和FreePBX配置日志轮转
• 数据持久化：支持数据持久化存储
• 网络服务：提供HTTP/HTTPS访问及SIP协议支持
• 注意：不支持DAHDI通道

端口说明

以下端口通过Docker暴露：

RTP端口（如16384-32767/udp）需要特殊配置才能正确暴露。由于Docker暴露大量端口会导致内存占用过高的https://github.com/moby/moby/issues/***，这些端口需通过Docker主机的`iptables`手动配置，`run.sh`脚本会处理iptables配置、镜像构建和运行。

主机要求

• 系统需安装ip、iptables和awk命令
• Docker链中的iptables规则会绕过系统防火墙规则
• iptables规则默认是临时的，如需持久化（Debian类系统）：

  bash
  sudo apt-get update
  sudo apt-get install -y iptables-persistent
  sudo systemctl enable netfilter-persistent
  sudo systemctl restart netfilter-persistent
  sudo systemctl status netfilter-persistent
  
  # 每次修改iptables后，需保存规则到磁盘
  sudo sh -c 'iptables-save > /etc/iptables/rules.v4'
  

• 通过编辑fail2ban/jail.local自定义Fail2ban偏好设置（当前规则：30秒内2次连续SIP注册失败即封禁1周）
• 为Docker容器配置有效的DNS服务器，在/etc/docker/daemon.json中添加（保存后重启Docker）：

  json
  {
    "dns": ["1.1.1.1"]
  }
  

使用方法

1. 创建必要密码文件

bash
# MySQL root用户密码
printf "your-mysql-root-password" > mysql_root_password.txt
printf "yourstrongmysqlfreepbxuserpassword" > freepbxuser_password.txt

# Postfix密码（即使不需要邮件通知也需运行此命令）
printf "[smtp-server-fqdn]:port your-email@gmail.com:your-app-password" > sasl_passwd.txt

# 设置文件权限
chmod 600 mysql_root_password.txt freepbxuser_password.txt sasl_passwd.txt

2. 配置Postfix

编辑postfix/main.cf中的relayhost，使其与sasl_passwd.txt中定义的SMTP服务器匹配。

3. 构建或使用镜像

选项A：从源码构建镜像

bash
cd source && sudo docker build -t your-image-name:your-tag .

然后编辑docker-compose.yaml中的services.freepbx.image，设置正确的镜像版本和标签。

选项B：使用Docker Hub预构建镜像

直接跳至下一步。

4. 配置RTP端口并运行

bash
# 配置RTP端口并构建运行Compose项目
sudo bash run.sh

# 覆盖默认RTP端口范围（默认16384-32767）
sudo bash run.sh --rtp 10000-20000

# 注意：若先使用默认RTP范围，之后更改范围，需手动删除旧的iptables规则

# 安装FreePBX
sudo bash run.sh --install-freepbx

# 可选：清理容器、网络和卷
sudo bash run.sh --clean-all

5. Let's Encrypt DNS挑战配置TLS

bash
# 确保防火墙允许80和443 TCP端口，且有有效的DNS A记录
sudo docker compose exec -it freepbx certbot --apache -d your.domain.com --email your-email@email.com --agree-tos --redirect -n

登录Web服务器管理界面即可开始配置系统！

项目地址

https://github.com/escomputers/freepbx-docker