HoRain云--FreeSWITCH容器化全流程指南
🎬 HoRain云小助手：个人主页
🔥 个人专栏: 《Linux 系列教程》《c语言教程》
⛺️生活的理想，就是为了理想的生活!
⛳️ 推荐
前些天发现了一个超棒的服务器购买网站，性价比超高，大内存超划算！忍不住分享一下给大家。点击跳转到网站。
专栏介绍
专栏名称 | 专栏介绍 |
《C语言》 | 本专栏主要撰写C干货内容和编程技巧，让大家从底层了解C，把更多的知识由抽象到简单通俗易懂。 |
《网络协议》 | 本专栏主要是注重从底层来给大家一步步剖析网络协议的奥秘，一起解密网络协议在运行中协议的基本运行机制！ |
《docker容器精解篇》 | 全面深入解析 docker 容器，从基础到进阶，涵盖原理、操作、实践案例，助您精通 docker。 |
《linux系列》 | 本专栏主要撰写Linux干货内容，从基础到进阶，知识由抽象到简单通俗易懂，帮你从新手小白到扫地僧。 |
《python 系列》 | 本专栏着重撰写Python相关的干货内容与编程技巧，助力大家从底层去认识Python，将更多复杂的知识由抽象转化为简单易懂的内容。 |
《试题库》 | 本专栏主要是发布一些考试和练习题库（涵盖软考、HCIE、HRCE、CCNA等） |
目录
⛳️ 推荐
专栏介绍
🚀 快速入门：基础镜像构建
🛠️ 关键步骤详解与优化
🏗️ 进阶技巧：多阶段构建
🚢 生产环境部署建议
⚠️ 注意事项
将 FreeSWITCH 容器化能极大简化部署，下面是一份从基础操作到高级优化的全流程指南。
🚀 快速入门：基础镜像构建
我们先从一个能工作的基础镜像开始。
准备 Dockerfile
创建一个
Dockerfile，基础命令如下。它的作用是安装依赖、编译并安装 FreeSWITCH。FROM ubuntu:latest RUN apt-get update && apt-get install -y \ build-essential git autoconf automake libtool libncurses5-dev \ wget libjpeg-dev zlib1g-dev libsqlite3-dev libssl-dev \ libcurl4-openssl-dev libpcre3-dev libspeexdsp-dev \ libldns-dev libedit-dev libopus-dev libsndfile1-dev liblua5.3-dev RUN git clone https://github.com/signalwire/freeswitch.git /usr/src/freeswitch WORKDIR /usr/src/freeswitch RUN ./bootstrap.sh -j && ./configure --prefix=/usr/local/freeswitch && make && make install ENV PATH="/usr/local/freeswitch/bin:${PATH}" EXPOSE 5060/tcp 5060/udp 5080/tcp 5080/udp 7443/tcp CMD ["freeswitch", "-nonat"]构建与运行
在
Dockerfile所在目录执行命令构建镜像并运行容器。# 构建镜像，-t 参数为其命名 docker build -t my-freeswitch . # 运行容器，-p 映射端口，-d 在后台运行 docker run -d --name fs-container -p 5060:5060/udp -p 5080:5080 my-freeswitch现在，一个基础的 FreeSWITCH 容器就运行起来了。
🛠️ 关键步骤详解与优化
基础镜像简单但庞大且不够安全。以下是打造生产级镜像的核心要点。
优化点 | 基础做法 | 推荐做法 |
|---|---|---|
基础镜像 |
|
|
包管理 | 直接安装，不清理缓存 | 同一行命令中清理缓存 |
源码获取 | 编译环境与运行环境不分 | 多阶段构建 |
权限安全 | 默认 root 用户运行 | 创建专用非 root 用户 |
选择合适的基础镜像：使用更轻量、更安全的官方镜像如
debian:stable-slim或ubuntu:22.04作为基础。处理认证与依赖：从 FreeSWITCH 1.10 开始，安装依赖需 SignalWire 的个人访问令牌（PAT）。建议通过
--build-arg传递令牌以避免泄露。# 在Dockerfile中 ARG TOKEN RUN wget --http-user=signalwire --http-password=${TOKEN} -O /usr/share/keyrings/signalwire-freeswitch-repo.gpg https://freeswitch.signalwire.com/repo/deb/debian-release/signalwire-freeswitch-repo.gpg# 构建时传入Token docker build --build-arg TOKEN=pat_xxxxxx -t my-freeswitch .加速构建与减小体积：在同一
RUN命令中完成安装、清理缓存和临时文件来减小镜像层体积。RUN apt-get update && apt-get install -y some-package \ && ... \ && apt-get clean && rm -rf /var/lib/apt/lists/* /tmp/* /var/tmp/*
🏗️ 进阶技巧：多阶段构建
这是优化镜像体积（从 3.4G 到 260M）的关键策略。
核心思想：一个“构建阶段”负责编译，另一个“运行阶段”只复制编译好的程序运行。
优势：最终镜像不包含编译工具、源码和中间文件，极其精简和安全。
# 第一阶段：构建阶段 FROM debian:latest as builder # ... (安装编译工具和依赖) RUN git clone https://github.com/signalwire/freeswitch.git /usr/src/freeswitch WORKDIR /usr/src/freeswitch RUN ./bootstrap.sh -j && ./configure && make # 第二阶段：运行阶段 FROM debian:stable-slim # 从构建阶段只复制安装好的程序 COPY --from=builder /usr/local/freeswitch /usr/local/freeswitch # ... (设置路径、用户、端口等) CMD ["freeswitch", "-nonat"]
🚢 生产环境部署建议
配置持久化：绝不能让容器运行时产生的配置、日志、录音等丢失。使用 Docker 卷（Volume）或目录挂载。
docker run -d --name fs-production \ -v /host/path/freeswitch/conf:/etc/freeswitch \ -v /host/path/freeswitch/recordings:/var/lib/freeswitch/recordings \ my-freeswitch健康检查：在
Dockerfile中加入健康检查命令，方便编排工具监控。HEALTHCHECK --interval=30s --timeout=10s \ CMD fs_cli -x status | grep -q ^UP || exit 1网络模式：FreeSWITCH 对网络性能要求高，处理大量媒体流时，可考虑使用 Docker 的
host网络模式以减少网络开销。docker run -d --name fs-host-network --network=host my-freeswitch
⚠️ 注意事项
编译时间：在配置较低的机器上编译 FreeSWITCH 可能耗时较长（超过30分钟）。
网络稳定性：构建过程需下载大量依赖，请确保网络连接稳定。
模块定制：默认配置会编译大量模块。若追求极致精简，可在
./configure前编辑modules.conf文件，注释掉不需要的模块。
按照上述步骤，你应该能成功构建并运行一个高效、可靠的 FreeSWITCH Docker 镜像。如果你在具体操作中遇到问题，例如有特定的模块依赖或性能要求，可以告诉我，我们一起探讨更细致的解决方案。
❤️❤️❤️本人水平有限，如有纰漏，欢迎各位大佬评论批评指正！😄😄😄
💘💘💘如果觉得这篇文对你有帮助的话，也请给个点赞、收藏下吧，非常感谢!👍 👍 👍
🔥🔥🔥Stay Hungry Stay Foolish 道阻且长,行则将至,让我们一起加油吧！🌙🌙🌙