Flexisip 2.6 配置参数详解

目标：系统讲清 Flexisip 2.6 配置文件的结构、查看与修改方式、各核心段的参数含义与默认值，并给出生产配置模板。全部参数名与默认值来自 2026-10-25 在 Flexisip 2.6.2-1 上用 --dump-default 与 flexisip_cli.py CONFIG_LIST 的实测输出。

一、环境信息

• 软件版本：Flexisip 2.6.2-1（Belledonne 官方 APT 仓库 noble/stable）
• 配置文件：/etc/flexisip/flexisip.conf（INI 格式，默认 2762 行，全部参数以注释形式带官方说明与默认值）
• 在线管理：/opt/belledonne-communications/bin/flexisip_cli.py（CONFIG_GET/SET/LIST 热查热改）
• 重载方式：文件修改需 systemctl restart flexisip-proxy；CONFIG_SET 热改立即生效但不写回配置文件（重启后回退文件值）

二、前置条件

1. 已安装 Flexisip 2.6.x（见《Ubuntu 24.04 安装 Flexisip 2.6.2 指南》），flexisip-proxy 服务在运行。
2. 理解 Flexisip 的角色划分：proxy / presence / regevent / b2bua / voicemail 五类服务共用同一份配置文件，各服务只读自己相关的段。

三、参数查看与修改方式

Flexisip 提供四种互补的参数管理方式，先建立全貌再逐段详解：

3.1 配置文件（持久生效）

直接编辑 /etc/flexisip/flexisip.conf，去掉参数前的 # 并改值，重启服务生效。所有参数默认值都以 #param=值 注释形式躺在文件里，配注释自带的官方说明即权威文档。

3.2 命令行导出默认配置（查权威默认值）

/opt/belledonne-communications/bin/flexisip --dump-default module::Registrar   # 导出单段
/opt/belledonne-communications/bin/flexisip --dump-default all                 # 导出全部
/opt/belledonne-communications/bin/flexisip --list-sections                    # 列出全部配置段
/opt/belledonne-communications/bin/flexisip --list-modules                     # 列出全部模块

实测 --list-sections 回显（2.6.2 共 38 个段）：

notif
global
cluster
mdns-register
event-logs
stun-server
conference-server
global::flexiapi
presence-server
regevent-server
b2bua-server
b2bua-server::sip-bridge
b2bua-server::trenscrypter
voicemail-server
module::DoSProtection
module::SanityChecker
module::GarbageIn
module::Capabilities
module::NatHelper
module::Authentication
module::AuthTrustedHosts
module::AuthOpenIDConnect
module::Authorization
module::Redirect
module::RegEvent
module::B2bua
module::GatewayAdapter
module::Presence
module::Registrar
module::StatisticsCollector
module::ContactRouteInserter
module::Router
module::PushNotification
module::LoadBalancer
module::MediaRelay
module::Transcoder
module::Forward
inter-domain-connections

3.3 flexisip_cli 在线查改（临时生效）

python3 /opt/belledonne-communications/bin/flexisip_cli.py CONFIG_GET global/transports

实测回显：global/transports: sip:*

python3 /opt/belledonne-communications/bin/flexisip_cli.py CONFIG_SET global/log-level debug

实测回显：global/log-level: debug（立即生效，常用于临时开调试日志）。

CONFIG_LIST <段名> 可列出该段全部参数及说明（输出较长，适合 grep 检索）：

python3 /opt/belledonne-communications/bin/flexisip_cli.py CONFIG_LIST global | grep -E "^(log|transports|aliases)"

实测回显：

log-directory: Path to the directory where log files will be created.
log-filename: Name of the log file
log-level: Logging verbosity.
transports: List of whitespace separated SIP URIs where the proxy must listen.
aliases: List of whitespace separated host names pointing to this machine.

⚠️ 注意：CONFIG_SET 只改运行中进程的内存值，不持久化；长期配置务必落回 flexisip.conf。

3.4 配置翻新与清理（升级后对齐）

/opt/belledonne-communications/bin/flexisip -c /etc/flexisip/flexisip.conf --rewrite-config > flexisip.new   # 保留现有值，补入新版本新增参数与文档
/opt/belledonne-communications/bin/flexisip -c /etc/flexisip/flexisip.conf --remove-deprecated --rewrite-config > flexisip.new  # 顺带剔除已废弃参数

四、参数总览

配置段分两大类：

Proxy 的默认模块处理链（消息流经顺序，实测 debug 日志确认）：DoSProtection → SanityChecker → Capabilities → NatHelper → Registrar → Router → Forward（Authentication/PushNotification/MediaRelay 等默认未进链，启用后加入）。

五、核心参数分类详解

5.1 [global] 全局段

所有服务共享的基础参数。实测默认值（--dump-default global）：

5.2 [cluster] 集群段

多实例组成集群时的协同参数（实测默认值）：

集群启用后，module::Registrar/db-implementation 需切到 redis，各节点共享注册库。

5.3 [stun-server] 内置 STUN 段

5.4 [module::Registrar] 注册模块

注册服务器核心，实测默认值：

5.5 [module::Authentication] 认证模块

💡 技术拓展：SIP 摘要认证算法可选 MD5 / SHA-256 / SHA-512-256（RFC 8760）。MD5 兼容性最好但强度弱；SHA-256 为当前推荐，但老客户端可能不支持。Flexisip 用 available-algorithms 白名单同时声明多种算法时按客户端能力协商，本文默认值为 MD5，生产建议追加 SHA-256。

5.6 [module::Router] 路由模块

消息分发与叉路（fork）策略，实测默认值：

5.7 [module::PushNotification] 推送模块

移动端唤醒（RFC 8599），默认 enabled=false，要点：

配套命令行推送测试工具 flexisip_pusher 见《Flexisip 2.6.2 常用 CLI 命令与工具详解》。

5.8 [module::MediaRelay] 媒体中继段

5.9 [event-logs] 事件日志段

结构化话单/事件输出（注册、呼叫、消息），默认 enabled=false、logger=filesystem（写 /var/log/flexisip），可切 database-backend=mysql 落库，配合 database-connection-string 与 database-max-queue-size 100。

六、生产配置模板

场景：单台 8GB 内存服务器，为公司域 sip.example.com 提供带认证的 SIP 代理 + 注册服务，启用 TLS，日志 info 级。相对默认配置的最小改动集（直接改 /etc/flexisip/flexisip.conf 对应行）：

[global]
transports=sip:* sips:*
aliases=sip.example.com
log-level=message
tls-certificates-file=/etc/flexisip/tls/agent.pem
tls-certificates-private-key=/etc/flexisip/tls/agent-key.pem

[module::Registrar]
reg-domains=sip.example.com
db-implementation=internal        # 单节点先用内存；多节点集群改 redis 并配 [cluster]

[module::Authentication]
enabled=true
auth-domains=sip.example.com
available-algorithms=MD5 SHA-256
db-implementation=file
file-path=/etc/flexisip/passwd

[module::MediaRelay]
sdp-port-range=40000-49999        # 收窄媒体端口池，防火墙按此放行

[event-logs]
enabled=true
logger=filesystem
filesystem-directory=/var/log/flexisip

改完重启并验证：

systemctl restart flexisip-proxy
python3 /opt/belledonne-communications/bin/flexisip_cli.py CONFIG_GET global/transports

⚠️ 注意：密码文件 /etc/flexisip/passwd 建议权限 chmod 640，内容形如 alice@sip.example.com clrtext:q1w2e3r4（演示口令）；生产接 MySQL 时用 db-implementation=soci 并改写 soci-password-request 适配自有账号表。

七、常见问题

Q1：改了 flexisip.conf 没生效？

文件修改必须 systemctl restart flexisip-proxy；若之前用 CONFIG_SET 热改过同名参数，重启后以文件值为准。用 CONFIG_GET <段>/<参数> 可查看当前运行值。

Q2：怎么确认某参数名的写法与默认值？

/opt/belledonne-communications/bin/flexisip --dump-default <段名> 导出官方带注释的默认段；或 flexisip_cli.py CONFIG_LIST <段名> 在线列出。

Q3：升级到 2.6 后配置里多出/少了参数？

用 --rewrite-config 生成对齐新版本的配置（保留现有值、补新参数），再 diff 审阅后替换。

Q4：reg-domains 与 auth-domains、aliases 三者关系？

reg-domains 决定 Registrar 受理哪些域的注册；auth-domains 决定对哪些域发起认证质询；global/aliases 是「本机=哪些名字」的防环判定。三者通常设成同一组域名。

八、参考链接

• 官方配置参考指南：https://wiki.linphone.org/xwiki/wiki/public/view/Flexisip/Core%20servers/Configuration%20reference%20guide/
• 过滤器语法（filter 参数通用）：https://wiki.linphone.org/xwiki/wiki/public/view/Flexisip/Configuration/Filter%20syntax/
• 官方仓库：https://gitlab.linphone.org/BC/public/flexisip