OpenSIPS Dispatcher 模块 使用指南

便于大伙学习，翻译了官方文档。如有不妥之处，请见谅，望联系。

目录表：

1.管理指南

1.1 概况

1.2 依赖

1.3 导出参数（ Exported Parameters）

1.4 导出函数（Exported Function）

1.5 导出MI函数

1.6 导出事件

1.7 安装和运行

正文部分：

1.1 概况

1.2 依赖

1.3 导出参数（ Exported Parameters）

1.4 导出函数（Exported Function）

1.4.1  ds_select_dst(set, alg [, (flags M max_results)*])

该方法从给定的地址集中挑选一个目的地。它会覆写SIP请求（$du）的“destination URI”值。

以下是各个参数的意义：

• set  - 分区名称，后面跟冒号、领取到目的地址的集合ID或集合ID列表（接受变量）。如果缺少分区名称，将使用默认分区。
• alg  -  用于选择目标地址的算法（接受变量）：
  • “0”： 在callid上哈希
  • “1”：在“from uri“上哈希
  • “2”： 在“to uri“上哈希
  • “3”：在“request uri”上哈希
  • “4”：加权轮询（下一个目的地）
  • “5”：通过授权用 户名（ authorization-username ）哈希
  • “6”：随机（使用rand()）
  • “7”： 哈希 PVs字符串的内容。注意：仅当设置参数hash_pvar时，此方法才有效。
  • “8”： 选择集合中的第一个条目
  • “9”： pvar_algo_pattern参数用于确定每个服务器上的负载。如果未指定参数，则选择集合中的第一个条目
  • “X”： 如果未实现该算法，则选择集合中的第一个条目

• flags  M max_results  -  如果指定，这将是在启动时指定的先前版本中的标志。这些标志是：
  • 'f'/ 'F'：支持failover。
  • 'u'/'U'： 用户唯一。 将指定仅uri用户部分将用于哈希。
  • 'S'/'s'：强制目的地。如果目的地址已经设置，将跳过覆写目的地址。
  • 'D'/'d'：默认。 使用目的地中的最后一个地址作为最后一个选项来发送消息。

你也可以使用PVs指定这些标志。这些标志按分区保留。

第二个参数max_results表示最多只能将max_results的最大值放入指定的avp中以进行failover操作。这样可以有许多目的地，但 如果某个数字注定会在任何地方失败，则可以限制无用的流量。 从2.1版开始，最后一个参数可以由flags和max_results的列表表示，并用逗号分隔。你可以仅指定标志，也可以仅指定max_results参数，但是如果要一起指定它们，则必须使用'M'字符，如下实例：flags M max_results。

如果设置了'flags'中的字符'f'，则目标集中的其余地址将存储在AVP列表中。你可以使用"ds_next_dst()"来使用下一个地址来实现到所有可能目的地的串行分支。如果使用多个调度组，则根据列表中每个调度ID的位置来构造AVP列表：第一个具有较高的优先级，其次是第二个，依此类推。

可以在REQUEST_ROUTE，BRANCH_ROUTE和FAILURE_ROUTE中使用此函数。

例子 1.33  ds_select_dst 的用法

...
ds_select_dst("1", "0");
...
ds_select_dst("part2 : 1", "0", "5");
...
ds_select_dst("part3 : 1", "0", "fUsD");
...
ds_select_dst("part4 : 2,3", "0,1", "fuD M 5, fuS M 2");
...
# dispatch over multiple dispatching groups
$var(part_name) = "p4"
$var(setid) = "1, 2";
$var(alg) = "4, 2";
$var(flags) = " sFDU M 2, fuS M 3";
ds_select_dst("$var(part_name):$var(setid)","$var(alg)","$var(flags)");
...

1.5 导出MI函数

1.6 导出事件

1.7 安装和运行

附注：持续更新