总览

平台各组件的配置文件与环境变量统一汇总在这里。

组件 配置来源 说明
callflow-esl apps/callflow-esl/config.json ESL + HTTP + audioFork + tts + db
sherpa-asr-online-server onnx-platform/sherpa-asr-online-server/config.json WS + ASR + VAD
sherpa-tts-server onnx-platform/sherpa-tts-server/config.json HTTP + TTS pool（默认 vits-zh-ll，可切 matcha/vits/kokoro）
aliyun-speech-gateway apps/aliyun-speech-gateway/config.json + ALIYUN_NLS_* 环境变量 可选阿里云 NLS ASR/TTS 兼容网关
emotion-analysis-server onnx-platform/emotion-analysis-server/config.json HTTP + 文本/音频情绪模型目录
callout-server apps/callout-server/config.json + CALLOUT_* 环境变量 server + 鉴权 + 调度 + 策略 + 外部API + freeswitch + redis + db（+ 回铃检测 / 情绪分析）
callflow-server 环境变量（无 config.json） 管理台 API + 数据库连接
callflow-webpage / callout-webpage VITE_* 环境变量 前端连后端的 API 地址
mod_audio_fork 环境变量 + channel variable 运行时
FreeSWITCH conf/dialplan/*.xml 等 信令 + 路由

callflow-esl config.json

完整结构：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
{
  "esl-server": {
    "host": "0.0.0.0",
    "port": 9911,
    "commandTimeoutMs": 15000,
    "asrTimeoutMs": 30000,
    "settleDelayMs": 1000
  },
  "logging": {
    "dir": "./logs",
    "level": "info",
    "maxSize": "20m",
    "maxFiles": "14d"
  },
  "http-server": {
    "host": "0.0.0.0",
    "port": 9912
  },
  "freeswitch": {
    "host": "192.168.2.184",
    "port": 8021,
    "password": "ClueCon",
    "callbackHost": "192.168.2.246",
    "callbackPort": 9911,
    "originateDialStringTemplate": "user/{{destinationNumber}}"
  },
  "audioFork": {
    "wsUrl": "ws://192.168.2.246:10096/audio",
    "bugName": "callflow_asr",
    "mixType": "mono",
    "sampleRate": "16k",
    "bidirectionalAudioEnabled": false,
    "bidirectionalAudioStreamEnabled": false,
    "bidirectionalAudioStreamSampleRate": 16000,
    "connectTimeoutMs": 5000,
    "eventSubscriptionMode": "all"
  },
  "tts": {
    "defaults": {
      "speakerId": 0,
      "speed": 1,
      "requestTimeoutMs": 10000
    },
    "use": {
      "call": "shout",
      "conference": "wav"
    },
    "profiles": {
      "wav": {
        "endpoint": "http://127.0.0.1:9080/tts",
        "playbackTarget": "wav-url",
        "fsPlaybackBaseDir": ""
      },
      "shout": {
        "endpoint": "http://127.0.0.1:9080/tts-stream",
        "playbackPrefix": "shout://"
      }
    }
  },
  "recording": {
    "directory": "/usr/local/freeswitch/record",
    "publicBaseUrl": ""
  },
  "callout": {
    "resultCallbackEndpoint": "http://127.0.0.1:9920/api/call-results",
    "resultCallbackToken": "",
    "resultCallbackTimeoutMs": 40000,
    "agentRouteEndpoint": "http://127.0.0.1:9920/api/transfers/route"
  },
  "redis": {
    "enabled": true,
    "host": "127.0.0.1",
    "port": 6379,
    "db": 0,
    "keyPrefix": "callflow",
    "ttlMs": 300000
  },
  "db": {
    "url": "postgres://postgres:postgres@localhost:5432/freeswitch"
  }
}

esl-server

字段 说明
host / port ESL outbound 监听地址与端口
commandTimeoutMs ESL 命令等待 reply 的超时
asrTimeoutMs 单轮 hear() 默认超时（业务可在入参覆盖）
settleDelayMs 手动 answer 后建议的等待，给信令稳定

http-server

字段 说明
host / port HTTP 监听地址，承载 /outbound-calls

freeswitch

字段 说明
host / port / password inbound ESL（用于 originate）
callbackHost / callbackPort FreeSWITCH 在外呼接通后回拨当前 ESL 服务使用的地址，必须 FS 进程可达
originateDialStringTemplate 所有外呼场景的默认拨号串模板，必须含 {{destinationNumber}}

audioFork

字段 说明
wsUrl mod_audio_fork 要连接的 ASR WebSocket 地址
bugName media bug 名称，用于 uuid_audio_fork stop 精确定位
mixType / sampleRate 上行音频通道与采样率；mono/16k 适合大多数 ASR
bidirectionalAudioEnabled / bidirectionalAudioStreamEnabled 下行音频通道；hear-only 模式保持关闭
bidirectionalAudioStreamSampleRate 下行音频流采样率
connectTimeoutMs 等待 WebSocket 连接成功事件的超时
eventSubscriptionMode ESL 事件订阅策略："all"（推荐）/ "custom-subclass" / "channel-plus-custom"

tts

TTS 采用 defaults + use + profiles 三段结构。流式与否不再由单独开关控制，
而是由 use.call / use.conference 选择走哪个 profile（"shout" = 流式 MP3，
"wav" = 整段 wav）。

字段 说明
defaults.speakerId / defaults.speed ctx.speak({kind:"tts"}) 未指定时的默认音色与语速
defaults.requestTimeoutMs 请求 sherpa-tts-server 的 HTTP 超时（含 /tts 与 /tts-stream link）
use.call 普通通话场景使用的 profile 名（"shout" 或 "wav"）
use.conference 会议场景使用的 profile 名（会议播报通常走 "wav"，避免 mod_shout 与会议混音冲突）
profiles.wav.endpoint sherpa-tts-server 的 POST /tts 地址（整段 wav）
profiles.wav.playbackTarget "wav-url"（默认，让 FS 直接拉 wav URL）或 "file-path"（先落 FS 本地再播）
profiles.wav.fsPlaybackBaseDir playbackTarget=file-path 时使用的目录前缀；为空且选 file-path 会报错
profiles.shout.endpoint sherpa-tts-server 的 POST /tts-stream 地址（流式 MP3 link）
profiles.shout.playbackPrefix 流式链接交给 FreeSWITCH playback 前追加的前缀，已启用 mod_shout 时为 "shout://"

旧版扁平字段 sherpaHttpEndpoint / sherpaStreamEndpoint / streamingEnabled /
streamPlaybackPrefix / playbackTarget 已移除，迁移时改写为上面的 profiles 结构。

recording

字段 说明
directory FreeSWITCH 进程可写的录音目录
publicBaseUrl 可选公开访问前缀；为空时 ctx.startRecording() 返回 fileUrl=null

callout

与 智能外呼 服务对接的回写 / 转人工集成，供 callout-platform-demo-business
及 AI 转人工业务使用：

字段 说明
resultCallbackEndpoint callout-server 的 POST /api/call-results 地址，业务回写通话 / 业务结果
resultCallbackToken 与 callout-server internalApi.callResultToken 对应的共享令牌，非空时回写 / 路由请求带 X-Callout-Internal-Token
resultCallbackTimeoutMs 回写 / 路由请求的客户端超时（毫秒）
agentRouteEndpoint callout-server 的 POST /api/transfers/route 地址，AI 通话转人工时请求空闲坐席入会；详见 转人工与坐席

redis

跨 callflow-esl 实例的会议状态协调（conference-coordinator.ts 基于 Redis Pub/Sub）。
单实例部署可 enabled=false，协调器自动降级为 no-op；多实例部署必须启用，
否则跨实例的会议 audio_fork 同步、playback 抢占停止、成员状态广播会失效。
详见 转人工与坐席。

字段 说明
enabled 是否启用 Redis 协调层；false 时所有跨实例协调降级为 no-op
host / port / db Redis 连接信息
keyPrefix 协调层 Hash / Pub/Sub channel 的键前缀
ttlMs 会议成员 / 监听者 / playback 运行态在 Redis 中的 TTL

db

PostgreSQL 连接信息。当前 Drizzle schema 使用 callflow schema：
callflow.call_businesses、callflow.call_business_number_mappings 和
callflow.callflow_runtime_configs，定义见 apps/callflow-esl/src/db/schema.ts。

sherpa-asr-online-server config.json

服务与 IO

字段 默认 说明
listenHost 127.0.0.1 监听地址
listenPort 10096 监听端口
healthPath /health HTTP 健康检查路径
wsPath /audio WebSocket 升级路径
wsSubprotocol audio.drachtio.org 子协议；空则不强制
maxSessions 256 并发会话上限
ioWorkers 8 I/O worker 线程数
sessionPoolSize 48 预热的 ASR session 数
maxFrameBytes 4194304 单帧最大字节数
readBufferBytes 65536 每连接 recv 缓冲
writeBufferBytes 65536 每连接 send 缓冲（预留）
socketRecvBufferBytes 262144 SO_RCVBUF，0=不调整
socketSendBufferBytes 262144 SO_SNDBUF，0=不调整
acceptBacklog SOMAXCONN listen(backlog)
workerPollTimeoutMs 10 worker 单轮 select 超时，夹紧 [1, 1000]
tcpNoDelay true 启用 TCP_NODELAY
debugLogTextFrames false 打印每条 metadata 文本帧
debugLogAudioFrames false 每个二进制帧落识别状态日志
debugLogRecognitionState false 识别状态变化都落日志
recordAudioEnabled false 启用上行音频录制
recordAudioDir recordings 录制目录

Sherpa ASR / VAD

ASR 模型采用 activeAsrModel + asrModels profile 表结构：在 asrModels 下
声明多个模型 profile，用 activeAsrModel 指定当前加载哪一个。切换模型只改
activeAsrModel，无需改动各 profile 的文件路径。

字段 默认 说明
activeAsrModel sherpa-onnx-streaming-zipformer-zh-int8-2025-06-30 当前加载的模型 profile id，必须存在于 asrModels
asrModels （profile 表） 模型 profile 表，每个 profile 含 modelDir / encoder / decoder / joiner / tokens / modelType / modelingUnit
vadModel ../models/silero_vad.onnx silero-vad onnx
provider cpu ONNX 推理后端
sampleRate 16000 上行采样率（仅支持 16kHz）
numThreads 1 ONNX 线程数
debug false sherpa-onnx 内部 debug
enableVad true 启用 VAD 分段
enableEndpoint true 启用 endpoint 检测
sendPartialResults true 是否下发 partial 文本帧
endpointRule1MinTrailingSilence 2.4 sherpa endpoint 规则 1
endpointRule2MinTrailingSilence 1.2 sherpa endpoint 规则 2
endpointRule3MinUtteranceLength 20.0 sherpa endpoint 规则 3
partialMinIntervalMs 300 同句 partial 最小下发间隔
decodeBatchMs 80 批量 decode 节奏
vadBufferSizeSeconds 30.0 silero-vad ring buffer
vadThreshold 0.5 VAD 置信度阈值
vadMinSilenceDuration 0.5 触发段尾的最小静音时长
vadMinSpeechDuration 0.25 视为有效语音的最小时长
vadWindowSize 512 VAD 窗大小（采样点）
vadMaxSpeechDuration 20.0 单段最大语音时长
hotwordsScore 1.5 热词权重
hotwordProfiles {} 热词 profile 表，按需配置

默认配置声明两个 profile：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
{
  "activeAsrModel": "sherpa-onnx-streaming-zipformer-zh-int8-2025-06-30",
  "asrModels": {
    "sherpa-onnx-streaming-zipformer-zh-int8-2025-06-30": {
      "modelDir": "sherpa-onnx-streaming-zipformer-zh-int8-2025-06-30",
      "encoder": "encoder.int8.onnx",
      "decoder": "decoder.onnx",
      "joiner": "joiner.int8.onnx",
      "tokens": "tokens.txt",
      "modelType": "",
      "modelingUnit": "cjkchar"
    },
    "sherpa-onnx-streaming-zipformer-bilingual-zh-en": {
      "modelDir": "sherpa-onnx-streaming-zipformer-bilingual-zh-en",
      "encoder": "encoder-epoch-99-avg-1.onnx",
      "decoder": "decoder-epoch-99-avg-1.onnx",
      "joiner": "joiner-epoch-99-avg-1.onnx",
      "tokens": "tokens.txt",
      "modelType": "zipformer",
      "modelingUnit": "cjkchar"
    }
  }
}

旧版扁平字段 asrModelName / asrEncoder / asrDecoder / asrJoiner /
asrTokens / asrBpeVocab / asrModelType / asrModelingUnit 已移除，
迁移时改写为 activeAsrModel + asrModels profile 表。

sherpa-tts-server config.json

TTS 模型与 ASR 一样采用 activeTtsModel + ttsModels profile 表结构：在
ttsModels 下声明多个模型 profile（每个 profile 的 backend 才是 sherpa-onnx
后端类型 matcha / vits / kokoro），用 activeTtsModel 指定当前加载哪一个。
切换模型只改 activeTtsModel。默认配置同时声明四个 profile（matcha-icefall-zh-en、
vits-aishell3、vits-zh-ll、kokoro-multi-lang-v1_1），仓库默认 activeTtsModel
为 vits-zh-ll（5 说话人中文 VITS）。

字段 默认 说明
listenHost 127.0.0.1 实际监听地址
listenPort 9080 实际监听端口
publicBaseUrl http://127.0.0.1:9080 返给客户端的 wav URL 前缀；反代后必须改
workerThreads CPU 核心数 HTTP 请求处理线程数
ttsPoolSize max(CPU/2, 1) 预热的 OfflineTts 实例数
ttsModelNumThreads 2 单个 OfflineTts 实例内部 ONNX Runtime 推理线程数；调低偏吞吐，调高偏单请求低 RTF
mp3EncoderPath ffmpeg 流式 TTS 把 PCM 实时编码为 MP3 使用的 ffmpeg 可执行路径；mod_shout 拉流必需
mp3BitrateKbps 192 流式 MP3 的 CBR 码率，范围 64..320
mp3VolumeGainDb 3.0 流式 MP3 响度增益（dB），范围 -20..20；正增益同时启用 limiter 降低削波风险
maxActiveStreams 24 同时处理的 GET /tts-stream/<id>.mp3 上限；超出在发音频头前返回 503。若 >= workerThreads 会被自动 clamp，预留 worker 给 link 创建与 /health
streamMaxDurationMs 60000 单条流式 GET /tts-stream/<id>.mp3 允许占用连接的最长时间；到点 watchdog 主动断开并释放 worker
socketReadTimeoutMs 5000 HTTP socket 读超时；0 = 系统默认
socketSendTimeoutMs 15000 HTTP socket 写超时；慢读 / 断连客户端超过该时间本次请求失败
ffmpegExitTimeoutMs 5000 等待 ffmpeg 退出的超时；超时 kill 子进程并记失败，避免僵尸 ffmpeg 占满 worker
wavSendChunkBytes 65536 流式发送块大小
maxRequestBodyBytes 1048576 单请求体最大字节数
maxQueuedRequests 0（不限） 等待队列上限，超出立刻 503
logDir logs 日志目录；相对路径按运行目录解析，按天滚动
startupScanCache true 启动时扫描 public/wav/ 建文件索引
activeTtsModel 必填 当前加载的模型 profile id，必须存在于 ttsModels
ttsModels 必填 模型 profile 表；每个 profile 含 backend（matcha/vits/kokoro）、modelDir、speakerNames?、lengthScale? 及后端专属字段

maxActiveStreams（流式 GET 并发上限）与 maxQueuedRequests（连接队列上限）是
两层独立保护：前者限制同时编码推流的连接数，后者限制排队等待 worker 的连接数。
调优时注意 ttsModelNumThreads × ttsPoolSize 的乘积不应明显超过 CPU 核心数。

旧版扁平字段 ttsModelType / ttsKokoro* / ttsMatcha* / ttsVits* /
ttsModelDir 已移除，不再做兼容转换，迁移时必须改写为 activeTtsModel +
ttsModels profile 表。详见 TTS 服务。

aliyun-speech-gateway config.json

阿里云语音网关是可选组件，默认不在根目录 bun run dev 中启动。它提供兼容
mod_audio_fork 的 ASR WebSocket 和兼容本地 TTS 的 HTTP 接口：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
{
  "aliyun": {
    "appKey": "",
    "token": "",
    "url": "wss://nls-gateway-cn-shanghai.aliyuncs.com/ws/v1"
  },
  "asr": {
    "host": "0.0.0.0",
    "port": 10097,
    "healthPath": "/health",
    "wsPath": "/audio",
    "wsSubprotocol": "audio.drachtio.org",
    "maxSessions": 64,
    "sampleRate": 16000,
    "format": "pcm"
  },
  "tts": {
    "host": "0.0.0.0",
    "port": 9081,
    "publicBaseUrl": "http://127.0.0.1:9081",
    "sampleRate": 24000,
    "defaultVoice": "aixia",
    "voices": []
  }
}
字段 说明
aliyun.appKey / aliyun.token / aliyun.url 阿里云 NLS 应用、临时 token 与网关地址；建议用环境变量覆盖
asr.host / asr.port ASR HTTP/WebSocket 监听地址，默认 10097
asr.wsPath / asr.wsSubprotocol WebSocket 路径与子协议，默认兼容 mod_audio_fork
asr.maxSessions 最大 ASR 并发会话数
asr.sampleRate / asr.format 发给阿里云识别 SDK 的音频格式，默认 16k PCM
tts.host / tts.port TTS HTTP 监听地址，默认 9081
tts.publicBaseUrl 返回给调用方的 wav/stream 公开地址前缀，跨主机部署必须改
tts.defaultVoice / tts.voices 默认音色与 speakerId 映射
logging.* 日志目录、级别、轮转大小与保留时间

环境变量覆盖：

环境变量 说明
ALIYUN_NLS_APP_KEY 覆盖 aliyun.appKey
ALIYUN_NLS_TOKEN 覆盖 aliyun.token
ALIYUN_NLS_URL 覆盖 aliyun.url

切换到阿里云网关时，把 callflow-esl 的 audioFork.wsUrl 改成
ws://<gateway-host>:10097/audio，把 tts.profiles.wav.endpoint 与
tts.profiles.shout.endpoint 改成 http://<gateway-host>:9081/tts 和
http://<gateway-host>:9081/tts-stream。

详见 阿里云语音网关。

emotion-analysis-server config.json

通话后情绪分析服务（C++ HTTP，默认 127.0.0.1:9090）。是否调用由外呼侧
emotionAnalysis.enabled 决定，本服务自身只有少量配置：

1
2
3
4
5
6
7
8
9
{
  "listenHost": "127.0.0.1",
  "listenPort": 9090,
  "workerThreads": 2,
  "maxQueuedRequests": 32,
  "maxRequestBodyBytes": 2097152,
  "textModelDir": "emotion-text",
  "audioModelDir": "emotion-audio"
}
字段 默认 说明
listenHost / listenPort 127.0.0.1 / 9090 HTTP 监听地址
workerThreads 2 HTTP 处理线程数
maxQueuedRequests 32 等待队列上限，超出 503
maxRequestBodyBytes 2097152 单请求体最大字节数
textModelDir / audioModelDir emotion-text / emotion-audio 相对 onnx-platform/models/ 的模型目录

详见 情绪分析服务。

callout-server config.json

外呼子系统配置较多，按功能分组。下面是仓库默认 config.json（完整字段与环境变量覆盖以
apps/callout-server/src/config.ts 与 智能外呼 为准）：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
{
  "server": {
    "host": "0.0.0.0",
    "port": 9920,
    "allowedOrigins": ["http://localhost:19920", "http://127.0.0.1:19920"]
  },
  "auth": { "enabled": true, "sessionTtlSeconds": 86400 },
  "scheduler": { "enabled": true, "intervalMs": 5000, "batchSize": 20 },
  "redis": {
    "host": "127.0.0.1", "port": 6379, "username": "default", "password": "redis",
    "db": 0, "keyPrefix": "callout", "lockTtlMs": 60000
  },
  "emotionAnalysis": {
    "enabled": true, "endpoint": "http://127.0.0.1:9090/analyze",
    "timeoutMs": 30000, "intervalMs": 5000, "maxConcurrency": 2,
    "retryIntervalMs": 60000, "maxRetries": 3
  },
  "internalApi": { "callResultToken": "" },
  "freeswitch": {
    "host": "192.168.2.184", "port": 8021, "password": "ClueCon",
    "callbackHost": "192.168.2.246", "callbackPort": 9911,
    "originateDialStringTemplate": "user/{{destinationNumber}}",
    "commandTimeoutMs": 15000
  },
  "db": { "url": "postgres://postgres:postgres@localhost:5432/freeswitch" }
}
分组 说明
server HTTP 监听地址；allowedOrigins 为管理台跨域白名单（可用 CALLOUT_CORS_ALLOWED_ORIGINS 覆盖）
auth 管理 API 角色鉴权开关与会话有效期；默认开启，本地联调可 CALLOUT_AUTH_ENABLED=false 关闭，启用后自动创建引导管理员
scheduler 后台派发器开关、轮询间隔、每轮每活动批量
redis 多实例分布式锁（缺省时单实例运行；CALLOUT_REDIS_ENABLED=false 可强制关闭）
emotionAnalysis 通话后情绪分析开关、emotion-analysis-server 端点、超时/轮询/并发/重试
internalApi.callResultToken callflow-esl 回写 /api/call-results 的共享令牌（请求头 X-Callout-Internal-Token）
freeswitch inbound ESL + 回拨地址 + 拨号串模板（agentDialStringTemplate 为坐席软电话呼出模板，默认 user/{{agentExtension}}）
db.url PostgreSQL；callout 从中派生 callout 与 callflow 两个 schema

此外 config.ts 还支持这些带内置默认值、按需添加的分组：lifecycleReconcile（卡死联系人补偿）、
conferenceReconcile（转人工会议僵尸会话对账，默认 30s 一轮 / 60s 宽限）、importJobs（异步导入 worker）、
notifications（运行事件告警 webhook）、ringbackDetection（回铃音 / 嘟声检测），以及
freeswitchEvents（inbound ESL 接听/挂机兜底）。

可用 CALLOUT_ 前缀环境变量覆盖（如 CALLOUT_SERVER_PORT、CALLOUT_FREESWITCH_HOST、
CALLOUT_ORIGINATE_DIAL_STRING_TEMPLATE、CALLOUT_AUTH_ENABLED、CALLOUT_EMOTION_ANALYSIS_ENABLED）。
回铃音检测由 ringbackDetection 配置块控制（代码默认关闭，但仓库内 config.json 默认开启，含
mod_spandsp 嘟声检测），也可用 CALLOUT_RINGBACK_DETECTION_ENABLED、..._WS_URL、..._MIX_TYPE、
..._SAMPLE_RATE、..._TIMEOUT_MS、..._TONE_ENABLED、..._TONE_FREQUENCY、..._TONE_HITS 覆盖。活动 /
联系人 / 线路级策略（并发、重试、工作时段、禁呼、频控等）存在数据库里，不在配置文件中，详见 智能外呼。

管理台与前端环境变量

callflow-server（管理控制台 API，无 config.json，全部走环境变量）：

环境变量 默认 说明
CALLFLOW_SERVER_HOST / CALLFLOW_SERVER_PORT 0.0.0.0 / 9913 HTTP 监听地址
FREESWITCH_DB_URL …@192.168.2.246:5432/freeswitch FreeSWITCH 数据库（只读视图）
CALLFLOW_DB_URL …@localhost:5432/freeswitch?options=-c search_path=callflow callflow 数据库（读写）
CALLFLOW_ESL_BASE_URL http://127.0.0.1:9912 callflow-esl HTTP，用于运行时配置重载

前端（Quasar，构建/开发期注入 VITE_*）：

应用 环境变量 默认 dev 端口
callflow-webpage VITE_CALLFLOW_API_BASE http://127.0.0.1:9913 19913
callout-webpage VITE_CALLOUT_API_BASE_URL http://127.0.0.1:9920 19920

管理控制台把 TTS / 录音运行时配置写进 callflow-esl 同一套 callflow schema，再触发
热重载，因此控制台与 callflow-esl 必须连到同一个 callflow 数据库。

mod_audio_fork 环境变量

变量 默认 说明
MOD_AUDIO_FORK_SUBPROTOCOL_NAME audio.drachtio.org WebSocket 子协议名
MOD_AUDIO_FORK_SERVICE_THREADS 1 服务线程数（1-5）
MOD_AUDIO_FORK_BUFFER_SECS 2 缓冲秒数（1-5）

mod_audio_fork channel variable

可在 dialplan 或 uuid_setvar 中设置：

变量 用途
MOD_AUDIO_BASIC_AUTH_USERNAME WSS 端的 Basic Auth 用户名
MOD_AUDIO_BASIC_AUTH_PASSWORD WSS 端的 Basic Auth 密码
MOD_AUDIO_FORK_ALLOW_SELFSIGNED TLS 允许自签证书
MOD_AUDIO_FORK_SKIP_SERVER_CERT_HOSTNAME_CHECK 跳过 TLS hostname 校验
MOD_AUDIO_FORK_ALLOW_EXPIRED 允许过期证书

FreeSWITCH dialplan 关键片段

把通话路由到 callflow-esl：

1
2
3
4
5
6
<extension name="route-to-callflow">
  <condition field="destination_number" expression="^(.+)$">
    <action application="set" data="hangup_after_bridge=true"/>
    <action application="socket" data="<callflow-esl-host>:9911 async full"/>
  </condition>
</extension>

可选：在 dialplan 提前设 channel variable，业务侧可读：

1
2
<action application="set" data="campaign_id=may-test"/>
<action application="set" data="business_code=my-business"/>

启用 mod_audio_fork：

1
2
<!-- conf/autoload_configs/modules.conf.xml -->
<load module="mod_audio_fork"/>

ESL inbound（callflow-esl 调用 FS 用）：

1
2
3
4
5
6
7
8
9
<!-- conf/autoload_configs/event_socket.conf.xml -->
<configuration name="event_socket.conf" description="Socket Client">
  <settings>
    <param name="listen-ip" value="0.0.0.0"/>
    <param name="listen-port" value="8021"/>
    <param name="password" value="ClueCon"/>
    <param name="apply-inbound-acl" value="localnet.auto"/>
  </settings>
</configuration>

配置变更速查

想做 改哪个
改 ASR 监听端口 sherpa-asr-online-server/config.json listenPort + audioFork.wsUrl
改 TTS 监听端口 sherpa-tts-server/config.json listenPort + tts.profiles.wav.endpoint + tts.profiles.shout.endpoint + publicBaseUrl
切换到阿里云 ASR/TTS 启动 bun run dev:aliyun-speech，再改 audioFork.wsUrl、tts.profiles.wav.endpoint、tts.profiles.shout.endpoint 指向网关
改 callflow-esl ESL/HTTP 端口 esl-server.port / http-server.port + FS dialplan socket 地址
改 FS 反向回拨地址 freeswitch.callbackHost
改 ASR 模型 sherpa-asr-online-server/config.json activeAsrModel（在 asrModels 里声明 profile）
改 TTS 模型 sherpa-tts-server/config.json activeTtsModel（在 ttsModels 里声明 profile）
改 hear 默认超时 esl-server.asrTimeoutMs（业务可在 hear() 入参覆盖）
改 ASR 并发 maxSessions + sessionPoolSize
改 TTS 并发 workerThreads + ttsPoolSize + ttsModelNumThreads；流式连接另受 maxActiveStreams 限制
切换流式 / 整段 TTS tts.use.call / tts.use.conference 选 "shout"（流式）或 "wav"（整段）；流式需 FS 启用 mod_shout
切换 ffmpeg 路径 sherpa-tts-server/config.json mp3EncoderPath
开启 ASR 上行录音 recordAudioEnabled: true
切换业务路由 PostgreSQL 表 callflow.call_businesses + callflow.call_business_number_mappings
改外呼 API 端口 apps/callout-server/config.json server.port（或 CALLOUT_SERVER_PORT）
调外呼并发 / 重试 / 工作时段 活动级字段（存数据库），见 智能外呼
启用回铃音检测 CALLOUT_RINGBACK_DETECTION_ENABLED=true + ..._WS_URL
启用通话后情绪分析 callout emotionAnalysis.enabled=true + endpoint；并启动 emotion-analysis-server，见 情绪分析服务
启用会议跨实例协调 callflow-esl redis.enabled=true，多实例部署必需，见 转人工与坐席
改管理台 API 端口 CALLFLOW_SERVER_PORT + 前端 VITE_CALLFLOW_API_BASE
在线调 TTS / 录音配置 管理控制台 /callflow 页保存后点重载，见 管理控制台
不拨电话测试 ASR 管理控制台 /asr-test 页上传音频或录音，端点可指向本地 ASR 或阿里云网关
许可协议

本文采用 署名-非商业性使用-相同方式共享 4.0 国际 许可协议，转载请注明出处。

分享文章

评论区仅供交流，有问题请提 issue 反馈。