FreeSWITCH 1.10.12 在 Debian 最新版本系统中的编译指南

 
 
1. 引言

FreeSWITCH 是一个开源的、跨平台的、可伸缩的电话通信平台，可用于构建从小型SOHO PBX到大型企业级软交换的各种应用。本指南旨在为技术爱好者和开发者提供一份详尽的步骤，以在最新的Debian发行版（如Debian 11 “Bullseye” 或更高版本）上从源代码编译和安装 FreeSWITCH 1.10.12 版本。本指南将尽可能详细地解释每个步骤，并指出可能遇到的问题和解决方案。
本指南基于 SignalWire 官方文档 [1] 和其他社区资源，并针对 FreeSWITCH 1.10.12 版本和最新的 Debian 系统进行了验证和补充。
2. 环境准备与前提条件

在开始编译之前，请确保您的 Debian 系统满足以下条件，并完成相应的准备工作。
2.1 系统更新

首先，强烈建议您将系统更新到最新的软件包版本，以确保系统的稳定性和安全性。打开终端并执行以下命令：

1. sudo apt update && sudo apt upgrade -y

复制代码

2.2 安装基础编译工具

编译 FreeSWITCH 需要一些基础的开发工具，如 git、curl、build-essential 等。您可以通过以下命令一次性安装它们：

1. sudo apt install -y git curl build-essential autoconf automake libtool wget libncurses-dev

复制代码

这些工具是编译大多数开源软件所必需的，它们将为后续的编译过程提供支持。
3. 获取 FreeSWITCH 源代码

FreeSWITCH 的源代码托管在 GitHub 上。为了获取特定版本 1.10.12 的源代码，我们将使用 git clone 命令并指定版本分支。建议将源代码克隆到 /usr/src/ 目录下，这是一个存放源代码的常用位置。
首先，进入 /usr/src/ 目录：

1. cd /usr/src/

复制代码

然后，使用以下命令克隆 FreeSWITCH 1.10.12 版本的源代码：

1. sudo git clone -b v1.10.12 https://github.com/signalwire/freeswitch.git

复制代码

此命令会创建一个名为 freeswitch 的目录，并将 FreeSWITCH 1.10.12 的所有源代码下载到其中。-b v1.10.12 参数确保我们获取的是精确的 1.10.12 版本，而不是开发中的 master 分支或其他版本。如果您需要其他版本，只需将 v1.10.12 替换为相应的版本号或分支名。
注意： 在从源代码编译 FreeSWITCH 时，您不需要 SignalWire Personal Access Token (PAT)。PAT 主要用于通过 fsget 脚本安装预编译的 FreeSWITCH 包，而 git clone 命令直接从 GitHub 获取源代码，不涉及 PAT 的验证 [2]。
4. 安装编译依赖

FreeSWITCH 依赖于大量的库和工具才能成功编译。Debian 系统提供了一个方便的命令 apt-get build-dep，可以自动安装一个软件包编译所需的所有依赖项。我们将利用此功能来安装 FreeSWITCH 的编译依赖。
首先，确保您的 apt 软件包列表是最新的：

1. sudo apt update

复制代码

然后，安装 FreeSWITCH 的构建依赖：

1. sudo apt-get build-dep freeswitch -y

复制代码

此命令会分析 FreeSWITCH 软件包的依赖关系，并自动安装所有必要的开发库和头文件。这包括了像 sofia-sip 和 spandsp 这样在 FreeSWITCH 1.10.4 版本之后已从主代码库中移除但仍需外部依赖的组件 [1]。
潜在问题与解决方案：

• 依赖安装失败： 如果 apt-get build-dep freeswitch 命令执行失败，提示找不到某些包，这可能是因为您的 sources.list 文件没有包含 deb-src 源。您需要编辑 /etc/apt/sources.list 文件，取消注释或添加 deb-src 行。例如：
  

1. deb http://deb.debian.org/debian/ bullseye main contrib non-freedeb-src http://deb.debian.org/debian/ bullseye main contrib non-freedeb http://deb.debian.org/debian/ bullseye-updates main contrib non-freedeb-src http://deb.debian.org/debian/ bullseye-updates main contrib non-freedeb http://security.debian.org/debian-security bullseye-security main contrib non-freedeb-src http://security.debian.org/debian-security bullseye-security main contrib non-free

复制代码

修改后，请务必再次运行 sudo apt update。

• 特定库版本冲突： 极少数情况下，系统上已安装的某些库版本可能与 FreeSWITCH 所需的版本不兼容。此时，您可能需要手动升级或降级相关库，或者考虑使用容器化技术（如 Docker）来提供一个干净的编译环境。
  

5. 编译和安装 FreeSWITCH

在所有依赖都安装完毕后，我们就可以开始编译 FreeSWITCH 了。这个过程包括配置、编译和安装三个主要步骤。
首先，进入 FreeSWITCH 源代码目录：

1. cd /usr/src/freeswitch

复制代码

5.1 运行 bootstrap.sh

bootstrap.sh 脚本用于生成 configure 脚本以及其他必要的构建文件。-j 参数可以加速构建过程，但请注意，在某些系统上这可能会导致问题。如果遇到编译错误，可以尝试移除 -j 参数。

1. sudo ./bootstrap.sh -j

复制代码

5.2 配置编译选项

configure 脚本用于检查系统环境，并根据您的需求生成 Makefile。您可以通过编辑 modules.conf 文件来选择性地编译或排除 FreeSWITCH 模块。在运行 configure 之前，您可以打开 modules.conf 进行编辑：

1. sudo vi modules.conf

复制代码

在 modules.conf 文件中，通过添加或移除行首的 # 注释符来启用或禁用模块。例如，如果您想启用 mod_python 模块，找到 languages/mod_python 这一行，并确保它没有被注释掉。保存并退出文件后，运行 configure：

1. sudo ./configure

复制代码

重要提示： 为了避免在后续 git pull 更新时出现冲突，建议在克隆后设置 git config pull.rebase true。虽然对于特定版本编译来说不是必需的，但这是一个良好的实践：

1. sudo git config pull.rebase true

复制代码

5.3 编译 FreeSWITCH

现在，使用 make 命令开始编译 FreeSWITCH。这个过程可能需要一些时间，具体取决于您的系统性能。

1. sudo make -j

复制代码

同样，-j 参数可以加速编译。如果遇到编译错误，可以尝试移除 -j 参数，或者检查错误信息以确定是缺少依赖还是代码问题。
5.4 安装 FreeSWITCH

编译成功后，使用 make install 命令将 FreeSWITCH 安装到系统中。默认情况下，FreeSWITCH 会被安装到 /usr/local/freeswitch 目录下。

1. sudo make install

复制代码

5.5 安装音频文件

FreeSWITCH 还需要一些音频文件（如提示音和音乐）才能正常工作。您可以使用以下命令安装它们：

1. sudo make cd-sounds-install cd-moh-install

复制代码

这将把必要的音频文件安装到 FreeSWITCH 的相应目录中。
6. 配置和启动 FreeSWITCH

编译并安装 FreeSWITCH 后，还需要进行一些配置才能使其正常运行。
6.1 设置文件权限和所有权

从源代码编译安装的 FreeSWITCH，其文件权限和所有权可能不正确，这会导致 FreeSWITCH 无法正常启动或访问其配置文件和日志。通常，FreeSWITCH 建议以 freeswitch 用户和组的身份运行。您需要创建这个用户和组，并设置 FreeSWITCH 安装目录的权限。
首先，创建 freeswitch 用户和组：

1. sudo adduser --system --no-create-home --group freeswitch

复制代码

然后，将 FreeSWITCH 的安装目录（默认为 /usr/local/freeswitch）的所有权更改为 freeswitch 用户和组：

1. sudo chown -R freeswitch:freeswitch /usr/local/freeswitch

复制代码

6.2 配置 FreeSWITCH

FreeSWITCH 的主要配置文件位于 /usr/local/freeswitch/conf 目录下。在首次启动之前，您可能需要根据您的需求修改一些配置，例如网络设置、模块加载等。通常，默认配置已经足够启动一个基本的 FreeSWITCH 实例。
如果您需要编辑配置文件，可以使用文本编辑器：

1. sudo vi /usr/local/freeswitch/conf/vars.xml

复制代码

6.3 启动 FreeSWITCH

您可以通过以下命令启动 FreeSWITCH：

1. sudo /usr/local/freeswitch/bin/freeswitch -nc

复制代码

-nc 参数表示不作为守护进程运行，这样您可以在终端中看到 FreeSWITCH 的输出。一旦 FreeSWITCH 成功启动，您可以使用 fs_cli 客户端连接到它：

1. sudo /usr/local/freeswitch/bin/fs_cli

复制代码

这将打开 FreeSWITCH 命令行界面，您可以在其中执行各种命令来管理 FreeSWITCH。
将 FreeSWITCH 设置为开机自启动：
为了方便管理，建议将 FreeSWITCH 设置为系统服务，以便在系统启动时自动运行。这通常通过 systemd 来实现。您可以创建一个 freeswitch.service 文件：

1. sudo vi /etc/systemd/system/freeswitch.service

复制代码

并添加以下内容：

1. [Unit]Description=FreeSWITCH Voice PlatformAfter=network.target[Service]Type=forkingUser=freeswitchGroup=freeswitchExecStart=/usr/local/freeswitch/bin/freeswitch -nc -nonatExecStop=/usr/local/freeswitch/bin/fs_cli -x 'shutdown'Restart=alwaysWorkingDirectory=/usr/local/freeswitch[Install]WantedBy=multi-user.target

复制代码

保存并退出文件后，重新加载 systemd 配置并启用 FreeSWITCH 服务：

1. sudo systemctl daemon-reloadsudo systemctl enable freeswitchsudo systemctl start freeswitch

复制代码

您可以使用 sudo systemctl status freeswitch 来检查 FreeSWITCH 服务的运行状态。
7. 常见问题与解决方案

在 FreeSWITCH 的编译和安装过程中，可能会遇到各种问题。以下是一些常见问题及其解决方案：
7.1 编译错误：缺少头文件或库

问题描述： 在运行 ./configure 或 make 时，出现类似“fatal error: some_header.h: No such file or directory”或“cannot find -l_some_library”的错误。
解决方案： 这通常意味着缺少必要的开发库。请确保您已运行 sudo apt-get build-dep freeswitch -y。如果仍然出现问题，您可能需要手动安装缺失的开发包。通常，缺少 libsomething 会导致缺少 libsomething-dev 包。例如，如果缺少 libjpeg.h，则需要安装 libjpeg-dev。
您可以使用 apt search  来查找相关的开发包。
7.2 bootstrap.sh 错误

问题描述： 运行 ./bootstrap.sh -j 时报错，或者在 make 阶段出现奇怪的错误。
解决方案： 尝试移除 -j 参数，即只运行 ./bootstrap.sh。-j 参数会并行执行任务，但在某些系统或特定环境下可能导致竞态条件或资源问题。如果移除 -j 后问题解决，说明是并行编译导致的问题。
7.3 make 编译中断或失败

问题描述： make 过程中断，提示内存不足或 CPU 占用过高。
解决方案： 编译 FreeSWITCH 是一个资源密集型任务。如果您的系统资源有限，可以尝试减少 make -j 后面的数字（例如 make -j2 或 make -j1），或者在编译时关闭其他占用资源的应用程序。增加系统的 SWAP 空间也可能有所帮助。
7.4 FreeSWITCH 无法启动或报错

问题描述： 启动 FreeSWITCH 后立即退出，或者在日志中看到权限相关的错误。
解决方案： 检查 FreeSWITCH 安装目录的文件权限和所有权。确保 /usr/local/freeswitch 及其子目录的所有者是 freeswitch:freeswitch，并且 freeswitch 用户对这些文件有读写执行权限。请参考本指南的“6.1 设置文件权限和所有权”部分。
另外，检查 FreeSWITCH 的日志文件（通常在 /usr/local/freeswitch/log/freeswitch.log）以获取更详细的错误信息。
7.5 fs_cli 无法连接

问题描述： 运行 fs_cli 后无法连接到 FreeSWITCH，提示连接失败。
解决方案： 确保 FreeSWITCH 进程正在运行。您可以使用 ps aux | grep freeswitch 命令来检查。如果 FreeSWITCH 没有运行，请检查其启动日志。如果 FreeSWITCH 正在运行但 fs_cli 无法连接，可能是 FreeSWITCH 的事件套接字配置有问题，或者防火墙阻止了连接。检查 /usr/local/freeswitch/conf/autoload_configs/event_socket.conf.xml 文件中的配置，并确保防火墙允许 fs_cli 连接到 FreeSWITCH 的事件套接字端口（默认为 8021）。
8. 结论

通过遵循本指南中的步骤，您应该能够在最新的 Debian 系统上成功编译和安装 FreeSWITCH 1.10.12 版本。从源代码编译 FreeSWITCH 提供了最大的灵活性，允许您根据自己的需求定制模块和功能。在遇到问题时，请仔细阅读错误信息，并参考本指南的常见问题部分，或查阅 FreeSWITCH 官方文档和社区论坛。
FreeSWITCH 是一个功能强大的通信平台，掌握其编译和安装过程是深入了解和使用它的重要一步。祝您使用愉快！
9. 参考文献

[1] Debian | FreeSWITCH Documentation. https://developer.signalwire.com/freeswitch/FreeSWITCH-Explained/Installation/Linux/Debian_67240088/
[2] signalwire/freeswitch v1.10.12 on GitHub - NewReleases.io. https://newreleases.io/project/github/signalwire/freeswitch/release/v1.10.12

空空如常
求真得真

来源：程序园用户自行投稿发布，如果侵权，请联系站长删除
免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！

这个好，看起来很实用