freeswitch介紹安裝部署方法

# FreeSWITCH介紹安裝部署方法

## 目錄
1. [FreeSWITCH概述](#freeswitch概述)
2. [核心功能與架構](#核心功能與架構)
3. [安裝前準備](#安裝前準備)
4. [Linux系統安裝指南](#linux系統安裝指南)
5. [Windows系統安裝指南](#windows系統安裝指南)
6. [基礎配置與調試](#基礎配置與調試)
7. [常用模塊與擴展](#常用模塊與擴展)
8. [高可用部署方案](#高可用部署方案)
9. [常見問題排查](#常見問題排查)

---

## FreeSWITCH概述
FreeSWITCH是一款開源的軟交換平臺，采用MPL 1.1協議授權，支持跨平臺部署。作為PSTN與VoIP的橋梁，它被廣泛應用于：
- 企業通信系統
- 呼叫中心解決方案
- 實時視頻通信
- IVR語音應答系統

### 版本演進
| 版本 | 發布時間 | 主要特性 |
|------|----------|----------|
| 1.0  | 2006     | 初始版本 |
| 1.10 | 2020     | WebRTC支持 |
| 1.11 | 2023     | 增強SIP協議棧 |

---

## 核心功能與架構
### 模塊化設計
```mermaid
graph TD
    A[核心引擎] --> B[SIP模塊]
    A --> C[WebRTC模塊]
    A --> D[數據庫連接]

關鍵組件

1. sofia-sip：SIP協議棧實現
2. mod_voicemail：語音郵件功能
3. mod_rtc：實時通信支持
4. Event Socket：外部控制接口

安裝前準備

硬件要求

• 最低配置：1核CPU/1GB內存
• 生產環境建議：4核CPU/8GB內存
• 存儲空間：至少10GB可用空間

軟件依賴

# Ubuntu/Debian
sudo apt-get install -y git autoconf automake libtool gcc-c++ \
    libncurses5-dev make libjpeg-dev pkg-config

網絡要求

• 開放端口：5060(SIP)/5080(SIP TLS)/8021(ESL)
• 建議帶寬：每通話路64kbps

Linux系統安裝指南

源碼編譯安裝（推薦）

# 獲取源碼
git clone https://github.com/signalwire/freeswitch.git
cd freeswitch

# 編譯準備
./bootstrap.sh
./configure

# 編譯安裝
make -j$(nproc)
sudo make install

包管理器安裝

# Debian/Ubuntu
sudo apt install freeswitch-meta-all

# CentOS/RHEL
sudo yum install freeswitch

初始化配置

# 創建符號鏈接
sudo ln -s /usr/local/freeswitch/bin/freeswitch /usr/bin/
sudo ln -s /usr/local/freeswitch/bin/fs_cli /usr/bin/

# 啟動服務
sudo systemctl start freeswitch

Windows系統安裝指南

安裝步驟

1. 下載官方安裝包（.msi格式）
2. 運行安裝向導，選擇組件：
   • 核心引擎
   • 語音編解碼器
   • Web管理界面
3. 配置環境變量：
   • 添加C:\Program Files\FreeSWITCH\bin到PATH

服務管理

# 注冊為系統服務
freeswitch.exe -install

# 啟動服務
Start-Service FreeSWITCH

基礎配置與調試

主要配置文件

conf/
├── autoload_configs/
│   ├── modules.conf.xml
│   └── switch.conf.xml
├── vars.xml
└── dialplan/
    └── default.xml

典型配置示例

<!-- 添加SIP用戶 -->
<user id="1001" number-alias="1001">
  <params>
    <param name="password" value="$${default_password}"/>
  </params>
</user>

日志查看

tail -f /usr/local/freeswitch/log/freeswitch.log

常用模塊與擴展

模塊加載管理

# 查看已加載模塊
module list

# 加載新模塊
load mod_curl

重要模塊說明

高可用部署方案

雙機熱備架構

graph LR
    A[主節點] -- SIP心跳檢測 --> B[備節點]
    C[負載均衡] --> A
    C --> B

配置要點

1. 共享數據庫：使用PostgreSQL集群
2. 媒體流中繼：配置RTP代理
3. 狀態同步：啟用mod_redis

常見問題排查

典型問題處理

問題1：SIP注冊失敗 - 檢查防火墻設置 - 驗證用戶憑證：

  sofia status profile internal reg

問題2：單通音頻 - 檢查NAT穿越配置：

  <param name="ext-rtp-ip" value="$${external_rtp_ip}"/>
  <param name="ext-sip-ip" value="$${external_sip_ip}"/>

問題3：高CPU占用 - 使用top -H查看線程 - 調整編解碼優先級：

  <param name="global-codec-prefs" value="OPUS,PCMU,PCMA"/>

提示：生產環境部署建議進行壓力測試，可使用sipp工具模擬呼叫流量：

> sipp -sf uac.xml -r 10 -d 10000 192.168.1.100
> ```

本文檔持續更新，最新版本請參考[官方Wiki](https://freeswitch.org/confluence)

注：實際內容約2800字，包含： - 技術細節說明 - 配置代碼片段 - 可視化架構圖 - 版本特性對比表 - 完整部署流程 - 故障排查指南 可根據具體環境需求調整安裝參數和配置細節。