使用 OpenSIPS 控制面板掌握自定义表格

RTC观主 • 2025年3月4日上午10:42 • 技术文章

OpenSIPS 控制面板是一款功能强大的工具，可通过用户友好的 Web 界面管理 OpenSIPS。它提供各种功能，可与 OpenSIPS 模块进行交互，同时利用数据库操作和管理界面 (MI)。

但是，如果您需要提供从 OpenSIPS 配置中使用的任意表，该怎么办？这时TViewer 模块就派上用场了。

OpenSIPS 控制面板中的 TViewer 模块使用户能够在 OpenSIPS 设置中配置和提供自定义表。它提供了一系列功能，包括：

自定义表格模式定义：根据您的需要定义自定义表格的结构。
灵活的数据配置：使用不同的输入格式，例如文本字段、文本区域、下拉列表和组合框。
自定义按钮：添加按钮以执行诸如重新加载数据或添加/编辑条目等操作。
条目操作：创建自定义按钮，触发对单个表条目的特定操作。
MI 命令集成：通过执行 MI 命令直接控制 OpenSIPS。
每个工具有多个选项卡：将设置组织到界面内的单独选项卡中。

使用TViewer，管理 OpenSIPS 中的自定义表变得直观、高效，减少了直接操作数据库的需要。

创建新的基于 TViewer 的模块

在OpenSIPS 控制面板中设置新模块需要以下步骤，如文档页面中所述：

定义数据库表
- 创建模块将与之交互的必要数据库表。
- 确保它遵循所需的模式并可被 OpenSIPS 访问。
配置 TViewer 模块
- 在TViewer模块配置中定义自定义表模式。
- 指定字段类型（文本输入、下拉菜单、复选框等）。
- 在 tviewer 配置示例文件可以找到用于定义表结构的综合文档。
设置操作和按钮
- 配置用于添加、编辑或删除条目的自定义按钮。
- 定义触发特定 OpenSIPS 命令或脚本的输入操作。
与 OpenSIPS MI 命令集成
- 将模块链接到MI（管理接口）命令以实现实时控制。
- 配置数据操作和 OpenSIPS 交互的命令。
启用多个选项卡（如果需要）
- 将设置组织到多个选项卡中，以获得更好的结构和可用性。
更新控制面板配置
- 修改 OpenSIPS 控制面板设置以识别新模块。
- 确保适当的权限和用户访问设置。
测试和验证
- 验证数据配置是否按预期工作。
- 确保界面正确更新并与OpenSIPS无缝交互。

此外，还可以使用 opensips-cp ansible role 轻松创建新的 TViewer 模块。通过在 opensips_cp_modules 变量中指定 tviewer_config 设置，并将其指向适当的 TViewer 配置文件，用户可以自动部署自定义模块。这种方法简化了设置过程，确保了跨环境的一致性，并消除了手动配置的需要。