FreeSWITCH 部署指南：脚本 / 镜像 / 容器三种方式详解
FreeSWITCH 支持 SIP 分机、中继对接、IVR、录音、会议等企业通信功能。本文提供 三种主流部署方式，适配 AlmaLinux、Rocky Linux、Anolis OS（龙蜥）、openEuler（欧拉）、麒麟等国产及 RHEL 兼容系统。
✅ 默认登录地址：
http://<服务器IP>
✅ 默认账号密码：admin / admin
⚠️ 首次使用后请立即修改默认密码！
🦍相关资源下载：https://pan.baidu.com/share/init?surl=V3CuCDxp-rLcjCrLFyqjcg&pwd=apy4
1. 硬件与环境要求
1.1 建议最低硬件配置
为确保系统稳定运行，推荐满足以下最低配置：
- 内存：4 GB RAM（支持 ≤400 路语音并发）
- CPU：64 位 x86 架构，2 GHz 或以上
- 存储：20 GB 可用硬盘空间
- 部署环境：建议使用独立物理服务器或虚拟机
补充说明：
- 4GB 内存是正常运行的基准线。若并发量较低（如 <100 路），2GB 内存也可部署，但需手动优化 MySQL 8 配置以降低内存占用。undefined修改
/etc/my.cnf，注释以下两行：
#performance_schema = off
#innodb_buffer_pool_size = 128M
然后执行：
systemctl restart mysqld
- 实际资源需求受业务规模影响：
分机数量、是否启用视频通话、并发呼叫数均会显著增加 CPU、内存和网络负载。 - 容器化部署存在网络复杂性：
SIP 信令与 RTP 媒体流对 NAT 穿透、端口映射高度敏感。bridge模式需精确暴露大量 UDP 端口，调试难度高，仅建议用于测试环境。
2. 脚本安装（推荐用于生产环境）
2.1 准备工作
相关资源备份下载：https://pan.baidu.com/share/init?surl=V3CuCDxp-rLcjCrLFyqjcg&pwd=apy4
- 操作系统选择
推荐使用各发行版的 Minimal（最小化）安装模式，避免冗余软件包引发依赖冲突。 - 支持的操作系统列表
| 安装包类型 | 适配系统 | 推荐版本 |
|---|---|---|
myfs.xx.centos8.bin |
AlmaLinux / Rocky Linux / Anolis OS / openEuler / Alibaba Cloud Linux / Huawei EulerOS / Oracle Linux / Red Hat / CentOS / OpenCloudOS / 银河麒麟 V10/V11 | AlmaLinux 8.8、Anolis OS 8.9、openEuler 22.03/24.03、Kylin V10 SP3 |
myfs.xx.debian.bin |
Debian / Ubuntu | Debian 12、Ubuntu 22.04 LTS |
myfs.xx.ky10.bin |
银河麒麟（ARM64） | Kylin Server V10 SP3 (ARM64) |
- 上传安装脚本
将对应系统的myfs.xxx.bin安装包上传至服务器（如/root/目录）。 - 可选：一键在线安装（仅限 x86_64）
# 主源
bash <(curl -Ss https://gitee.com/jiasp123/myfs/raw/master/git-install.sh)
# 备源
bash <(curl -Ss https://cnb.cool/myfspbx/install/-/git/raw/master/git-install.sh)
⚠️ 注意：在线脚本需 root 权限，并自动识别系统类型下载对应安装包。
2.2 执行安装
chmod +x myfs.xxx.bin
./myfs.xxx.bin install
📌 安装注意事项：若因网络问题导致 RPM/DEB 包下载失败，请手动配置可用软件源后重试；
若出现包冲突，可先卸载冲突包再重新运行脚本；
建议先安装 IPPBX，再部署其他服务（如 Web 服务器、监控工具），避免端口或依赖干扰；
安装完成后必须重启系统，以完成服务初始化。
2.3 登录验证
重启后，等待约 5 分钟（系统初始化需要时间），然后访问：
http://<服务器IP>
使用默认账号 admin/admin 登录 Web 管理界面。
2.4 卸载程序
如需卸载，执行：
./myfs.xxx.bin uninstall
3. 系统镜像安装（开箱即用）
3.1 获取与写入镜像
- 下载 ISO 镜像文件（如
myfs.xx.al88.iso），该镜像基于 AlmaLinux 8.8 Minimal 定制。 - 使用 Rufus、balenaEtcher 等工具将 ISO 写入 U 盘（建议保留默认卷标，如
MYFS-v1.0）。
3.2 安装流程
- 将 U 盘插入服务器，从 UEFI 或 Legacy BIOS 启动；
- 在启动菜单中选择 “Install MyFreeSWITCH”；
- 系统将自动完成分区、安装与配置。
💡 若 BIOS 启动失败，请尝试切换至 UEFI 模式。undefined🔁 安装完成后会自动重启一次，期间可能黑屏约 5 分钟（正在初始化服务）。
3.3 登录使用
重启后，系统默认 IP 通常为 192.168.0.100（具体以实际网络配置为准）。
访问：
http://192.168.0.100
使用 admin/admin 登录。
🔄 若镜像安装失败，可改用标准 AlmaLinux 8.8 系统 + 脚本方式安装。
4. 容器化部署（Docker / Podman）
⚠️ 仅建议用于测试或演示环境
4.1 拉取镜像
podman pull registry.cn-hangzhou.aliyuncs.com/pbx/myfs:latest
4.2 启动容器
方式一：Host 网络模式（简单测试）
podman run -itd \
--network=host \
--privileged \
--name myfs \
registry.cn-hangzhou.aliyuncs.com/pbx/myfs:latest
方式二：Bridge 模式（显式端口映射）
podman run -itd \
-p 80:80/tcp \
-p 5060-5090:5060-5090/udp \
-p 6060-6090:6060-6090/udp \
-p 10000-10500:10000-10500/udp \
-p 20000-20100:20000-20100/udp \
--mac-address=aa:ab:ac:11:12:13 \
--privileged \
--name myfs \
registry.cn-hangzhou.aliyuncs.com/pbx/myfs:latest
📌 关键说明：
--privileged：必需参数；
固定 MAC 地址：部分授权机制依赖此设置；
端口用途：5060–5090：SIP 分机注册6060–6090：SIP 中继对接10000–10500：RTP 语音流20000–20100：TRUN 中继（可选）
首次启动需 5–10 分钟 初始化，可通过podman exec -it myfs top查看进程状态。
4.3 登录管理界面
访问：
http://<服务器IP>
默认账号密码：admin/admin
5. 总结与建议
| 部署方式 | 优点 | 适用场景 |
|---|---|---|
| 脚本安装 | 灵活、可控、兼容性强 | 中小型生产环境（推荐） |
| 系统镜像 | 开箱即用、零配置 | 批量交付、一体机部署 |
| 容器化 | 快速启动、环境隔离 | 测试、演示、开发验证 |
🔐 安全提醒：切勿将默认配置暴露于公网；
生产环境务必配置防火墙、启用 HTTPS、修改默认密码；📌 本文仅用于技术交流与内部部署参考，不包含任何商业推广或外部引流内容。
✅ 本文仅作技术分享，不包含任何推广或外部引流内容。
📌 建议结合官方文档与实际网络环境进行部署。
