跳到正文

deploy 部署配置与运行参考 ​

deploy/ 目录保存 AI Voice Platform 当前生产环境(阿里云公网核心节点)与本地运行环境(WSL /data/ai-voice 容器化集群)的运行产物、部署配置、服务定义与编排文件。三类目录边界如下:wsl-docker/ 负责 WSL 计算集群编排,aliyun/ 保存阿里云现场配置,freeswitch/ 保存可迁移的通用 FreeSWITCH 运行时归档与运维基线。

text
deploy/
├── aliyun/                           # 阿里云公网核心节点部署配置
│   ├── README.md                     # 阿里云节点配置与前端/ESL 更新说明
│   ├── nginx/                        # 公网 Nginx 反向代理、HTTPS SSL 与前端静态托管
│   │   ├── ai-voice-public.conf
│   │   └── README.md                 # 8 个 server 块、反代规则与排障速查
│   ├── callflow-esl/                 # Outbound ESL 业务编排服务
│   │   ├── callflow-esl.config.toml
│   │   └── callflow-esl.service
│   ├── freeswitch/                   # 阿里云线上 FreeSWITCH 现场配置快照
│   │   └── README.md                 # 现场配置树说明与比对基线
│   ├── frp/                          # FRP 反向代理穿透服务端 (FRPS)
│   │   ├── frps.toml
│   │   └── frps.service
│   ├── coturn/                       # STUN/TURN 媒体穿透服务
│   │   ├── turnserver.conf.example
│   │   ├── coturn.service
│   │   └── README.md
│   └── docs-site/                    # 官方文档站 Nginx 配置
│       ├── nginx.conf
│       ├── nginx-http-bootstrap.conf
│       └── README.md
│
├── freeswitch/                       # FreeSWITCH 容器化部署包与运维指南(通用基线包)
│   ├── docker_fs_server.tar.gz       # WSL /data/docker_fs_server 打包产物(FS 1.11.2 + mod_audio_fork + mod_shout + Nginx,已内置背景音配置与素材,约 22MB)
│   ├── README.md                     # 解压使用步骤、关键配置调整清单(IP/ESL/拨号计划/ASR/TTS等)与运维指南
│   └── docs/                         # 5 篇专题文档
│       ├── network-and-nat.md        # 网络模式、IP 绑定与 NAT / STUN
│       ├── sip-profiles.md           # SIP Profiles 架构与外呼网关
│       ├── ai-and-modules.md         # 核心模块库与实时 AI 语音集成
│       ├── module-configs.md         # autoload_configs/ 模块配置详解
│       └── integration-and-dialplan.md # 业务集成、拨号计划与录音托管
│
├── wsl-docker/                       # WSL 本地 /data/ai-voice 容器化与语音服务部署配置
│   ├── README.md                     # WSL 部署与运行手册
│   ├── .dockerignore                 # 运行镜像构建上下文排除规则
│   ├── Dockerfile                    # 统一运行环境基础镜像 (ai-voice-runtime:latest)
│   ├── build-image.sh                # WSL 基础运行镜像构建脚本
│   ├── docker-compose.yml            # 5 个业务与语音服务容器 + 1 个 FRPC 编排
│   ├── configs/                      # 容器服务 TOML 配置文件
│   │   ├── callflow-server.toml
│   │   ├── callout-server.toml
│   │   ├── emotion-analysis-server.toml
│   │   ├── sherpa-asr-server.toml
│   │   └── sherpa-tts-server.toml
│   └── frpc/                         # WSL 宿主机 FRP 客户端
│       ├── frpc.service
│       └── frpc.toml
│
├── softphone-webrtc-ice-turn-guide.md # 5G 软电话 WebRTC ICE/TURN 穿透手册
└── README.md                         # 部署目录总说明(本文件)

部署拓扑与数据流向 ​

  1. 公网接入与控制中心(阿里云 aliyun):

    • Nginx:直接在本地静态托管 callflow-webpage、callout-webpage 两端 SPA 产物与 ai-voice-docs 文档站;终结全站 8 个域名 HTTPS/WSS(Let's Encrypt 证书)并将 /api/ 路由与各模型端点转发至 FRP 回环隧道。
    • callflow-esl:常驻运行,直接控制本地 FreeSWITCH,并通过本地 12000~12012 FRP 回环端口与 WSL 计算集群交互。
    • FreeSWITCH:云端已有常驻实例,提供 SIP 交换、WebRTC WSS 音频流及 mod_audio_fork 识别分流,通过 12004 连通 WSL 核心数据库,无需再次部署。
    • FRPS:监听 7000 端口,聚合来自 WSL 宿主机的反向代理隧道。
    • coTURN:监听 3478 端口与 31000-31040 relay 范围,提供 WebRTC ICE/TURN NAT 穿透。
  2. 业务计算与语音模型集群(WSL /data/ai-voice):

    • Docker Compose:统一编排 callflow-server、callout-server(原生内嵌 AI 策略中台)2 个应用服务端,以及 sherpa-asr-server、sherpa-tts-server、emotion-analysis-server 3 个 ONNX 语音服务。
    • FRPC:在 WSL 宿主机运行,建立至阿里云 FRPS 的长连接,带有物理网卡直连路由守护。
    • 数据库与模型:直连本地 PostgreSQL 15(数据库 freeswitch,包含 callflow / callout 等 schema)、Redis 7.2 及本地 LLM 推理后端。

文档与代码在同一仓库维护,现有 Markdown 是唯一内容源。