当前位置：首页 > web >正文

FreeSWITCH中SIP网关（Gateway）操作

web 2025/7/19 4:37:02

freeswitch是一款简单好用的VOIP开源软交换平台。

以下是一篇关于FreeSWITCH中SIP网关（Gateway）操作的技术指南，基于提供的官方文档内容整理：

一、网关生命周期管理

1. 创建新SIP Profile并启动

FreeSWITCH支持多SIP Profile（如internal/external）。新建Profile后需手动启动：

freeswitch> sofia profile <new_profile_name> start

示例：新建一个名为custom的Profile

freeswitch> sofia profile custom start

2. 配置重载与热更新profile&gateway

动态重载配置（不影响当前通话）

# 仅重新扫描配置文件（不中断服务）  
freeswitch> sofia profile <profile_name> rescan reloadxml  # 完全重启Profile（中断当前连接）  
freeswitch> sofia profile <profile_name> restart reloadxml

注意：rescan无法更新IP地址和UDP端口等核心参数，需用restart。

3. 网关删除操作

删除指定网关或批量清理：

# 删除单个网关  
freeswitch> sofia profile <profile_name> killgw <gateway_name>  # 删除所有网关  
freeswitch> sofia profile <profile_name> killgw _all_

4. 强制网关重启（触发重注册）

freeswitch> sofia profile <profile_name> killgw <gateway_name>  
freeswitch> sofia profile <profile_name> rescan

应用场景：修改网关密码后强制重注册，或修复网络中断后的恢复。

二、网关配置实时修改

1. 新增/修改网关

假设网关文件位于conf/sip_profiles/external/目录：

# 编辑配置文件后触发动态加载  
freeswitch> sofia profile external rescan reloadxml

2. 错误配置热修复

若发现配置错误（如IP地址错误）：

# 1. 停止问题网关  
freeswitch> sofia profile external killgw faulty_gw  # 2. 修改配置文件  
vim conf/sip_profiles/external/faulty_gw.xml  # 3. 重新加载配置  
freeswitch> sofia profile external rescan reloadxml

三、网关状态监控

1. 网关健康状态列表

# 列出活跃网关  
freeswitch> sofia profile <profile> gwlist up  # 列出故障网关  
freeswitch> sofia profile <profile> gwlist down

依赖条件：需配置网关的ping参数（周期性心跳检测）：

<param name="ping" value="30"/>  <!-- 每30秒发送OPTIONS探测 -->

2. 网关数据查询

# 获取入站变量值  
sofia_gateway_data <gateway_name> ivar <variable_name>  # 获取出站变量值  
sofia_gateway_data <gateway_name> ovar <variable_name>  # 自动匹配变量类型  
sofia_gateway_data <gateway_name> var <variable_name>

应用场景：检查网关的codec-prefs或expire-seconds参数值。