telephoneorg/freeswitch

Freeswitch 1.6 Kubernetes镜像

维护者

Joe Black | <***> | https://github.com/joeblackwaslike

镜像概述和主要用途

本镜像为Freeswitch 1.6版本，专为Kubernetes环境设计并提供相关部署清单。采用最小化设计，支持TLS加密和捕获服务器功能，缓存与数据库存储于ramfs以获得最佳性能。基于自定义的最小版Debian Linux系统，可通过环境变量轻松定制Freeswitch配置，同时保持镜像轻量化。

核心功能和特性

• 最小化设计：基于自定义Debian Linux，减少镜像体积
• 性能优化：缓存和数据库使用ramfs存储，提升运行效率
• 安全支持：内置TLS加密功能，保障通信安全
• 捕获服务器：支持捕获服务器配置，便于流量分析
• 高度可定制：通过环境变量灵活配置模块、编解码器和语言
• Kubernetes适配：提供专用部署清单，简化容器编排

使用场景和适用范围

• Kubernetes集群中的VoIP服务部署
• 需要高性能和低延迟的语音通信系统
• 需自定义模块和编解码器的企业级IP电话系统
• 语音会议、呼叫中心等实时通信场景
• 需TLS加密的安全语音通信服务

详细配置说明

构建环境变量

构建环境变量用于在Docker构建阶段调整版本号和配置选项，可通过构建参数覆盖默认值：

运行环境变量

运行环境变量用于入口脚本渲染配置模板和控制流程，可在docker run或Kubernetes的env数组中覆盖：

使用方法

Docker运行（预构建镜像）

本镜像已发布至Docker Hub，可直接拉取使用：

bash
docker pull docker.xuanyuan.run/telephoneorg/freeswitch

运行命令示例：

bash
docker run -d \
    --name freeswitch \
    -h freeswitch.local \
    -p "11000:10000" \
    -p "11000:10000/udp" \
    -p "16384-16484:16384-16484/udp" \
    -p "8031:8031" \
    -e "FREESWITCH_DISABLE_NAT_DETECTION=false" \
    -e "FREESWITCH_RTP_PORT_RANGE=16384-16484" \
    -e "ERLANG_COOKIE=test-cookie" \
    --cap-add IPC_LOCK \
    --cap-add SYS_NICE \
    --cap-add SYS_RESOURCE \
    --cap-add NET_ADMIN \
    --cap-add NET_RAW \
    --cap-add NET_BROADCAST \
    docker.xuanyuan.run/telephoneorg/freeswitch:latest

注意：生产环境中，建议使用主机网络模式以获得最佳性能。此时需移除端口映射并添加--net=host参数。

Docker Compose

使用docker-compose管理容器：

拉取镜像：

bash
docker-compose pull

启动服务：

bash
# 前台运行
docker-compose up --abort-on-container-exit

# 后台运行
docker-compose up -d

Kubernetes部署

1. 编辑kubernetes/<environment>目录下的清单文件，根据实际环境调整配置

2. 创建Erlang Cookie密钥：

bash
kubectl create secret generic erlang --from-literal=erlang.cookie=$(LC_ALL=C tr -cd '[:alnum:]' < /dev/urandom | head -c 64)

3. 部署Freeswitch：

bash
kubectl create -f kubernetes/<environment>