《gnu-gatekeeper-使用手册》由会员分享，可在线阅读，更多相关《gnu-gatekeeper-使用手册（8页珍藏版）》请在金锄头文库上搜索。
1、最近在做H.323网守部分的开发。网上只有很老版本的繁体中文版的用户手册，最新版本是2.2.7的。（但是程序已经更新到2.2.8了）趁着最近还熟悉里面的东西，顺手翻译一下，供今后学习参考用。OpenH323 Gatekeeper - The GNU Gatekeeper 使用手冊Version 2.2.81. 介绍 关于 版权 名称 下载2. 编译和安装 编译网守 addpasswd的功能 安装网守3. 启动（指南） 第一次简单实验 使用状态接口监控网守 以路由模式启动网守 虚拟PBX：中断所有呼叫 通过网关进行呼叫路由来呼叫外部用户 改写E.164号码4. 网守基本配置 令行参数 配置文件
2、Gatekeeper:Main GkStatus:Auth GkStatus:Filtering LogFile5. 路由模式及代理配置 RoutedMode Proxy6. 路由配置 RoutingPolicy RoutingPolicy RasSrv:RewriteE164 RasSrv:RewriteAlias RasSrv:GWRewriteE164 Endpoint:RewriteE164 Routing:Sql Routing:NumberAnalysis RewriteCLI7. RAS配置 RasSrv:GWPrefixes RasSrv:PermanentEndpoints
3、RasSrv:RRQFeatures RasSrv:ARQFeatures RasSrv:AssignedAlias RasSrv:AssignedGatekeeper NATedEndpoints8. 认证配置 Gatekeeper:Auth FileIPAuth SimplePasswordAuth SQLPasswordAuth RasSrv:RRQAuth SQLAliasAuth SQLAuth PrefixAuth RadAuth RadAliasAuth CapacityControl GkH350:Settings9. 账户配置 Gatekeeper:Acct FileAcct
4、 RadAcct SQLAcct StatusAcct SyslogAcct10. 邻居配置 RasSrv:Neighbors RasSrv:LRQFeatures Neighbor:11. 终端配置 EP:12. 高级配置 CallTable H225toQ931 GkQoSMonitor Endpoint CTI:Agents CTI:MakeCall SQLConfig13. 监控网守 状态接口的端口 命令行（参考） 消息（参考） 状态端口过滤1. 介绍1.1 关于 OpenH323 Gatekeeper The GNU Gatekeeper是一个H.323网关的开源项目。网守为H.32
5、3终端提供呼叫控制服务。它是基于H.323协议的互联网电话体系中的必需的一部分。 根据H.323协议，网守应提供以下功能：l 地址翻译l 呼入控制l 带宽控制l 区域管理l 呼叫控制信令l 呼叫认证l 带宽管理l 呼叫管理The GNU Gatekeeper基于OpenH323协议栈实现了大多数功能。H.323协议是由ITU公布的国际标准。它是互联网上音频、视频和数据通信的标准。1.2 版权 它适用于GNU通用公共授权（GNU GPL）。另外，我们明确地获得权力来连接OpenH323库和OpenSSL库。 一般来说，GNU GPL允许你拷贝、发布、转售或者修改这个软件，但是它要求所有源于此的工
6、作也必须遵循GNU GPL。这意味着你必须公开所有引用了网守的扩展程序的源代码。细节请参考COPYING。 否则，你必须通过TCP连接至状态端口来和网守进行互交。这样，你只需要公开和网守集合的功能（并且提供这部分的源代码），同时可以保持应用部分私有。 名字这个项目的全名是OpenH323 Gatekeeper The GNU Gatekeeper，简称GnuGk。我们以此强调这个软件是自由软件。 下载最新版本在http:/www.gnugk.org下载2 编译和安装2.1 编译网守 为了生成网守，你需要PWLib 1.7.5.2和OpenH323 1.14.1.2或者更新的版本。开发版通常需要
7、最新版本的OpenH323。 编译顺序1. PWLib（发行版本和调试版本）2. OpenH3233. OpenH323测试程序（非必需，仅仅用来确认之前的工作）4. 网守在Unix上，通过在网守目录运行configure，然后分别运行make debug和make opt来生成调试版本和发行版本。运行make可以同时生成两个版本。注意，你只能使用高于3.3.x版本的GCC的编译。低于此版本则无法编译通过。好习惯是在实际编译（make debug 或者make opt）之前在网守目录运行make dependency或者make optdepend。这些命令生成适当的以来列表，这样，当你从CV
8、S更新源代码的时候，所有受影响的文件将被重新编译。在Windows上，仅仅需要使用Microsoft Visual Studio .NET 2003或者Microsoft Visual Studio 6.0 SP6打开并编译对应的解决方案或工作空间即可。当然，PWLib和OpenH323必需已经编译好并设置好路径。如果你需要MySQL或PostgreSQL功能，则需要编译并安装适当的库并且在网守项目中添加HAS_MYSQL=1和HAS_PGSQL=1的宏。你也必须设置好这些库以及对应头文件的路径。执行configure help可以查看所有编译时选项。包括网守属性是开启禁用状态。例如，如果你不
9、需要RADIUS功能，则执行configure disable-radius。执行make optnoshared，则OpenH323会被静态编译到网守中。为了在高负载的情况下使用网守，推荐开启LARGE_FDSET特性（仅仅针对UNIX）（configure with-large-fdset=4096）.某些系统还需要使用ulimit来取消单进程仅能申请1024个套接字的限制。注意，PWLib从1.5.3版本开始就支持这些特性，所以选择在GnuGk和PWLib中启动LARGE_FDSET特性。在GnuGk中设置性能会更好。LARGE_FDSE的最大值可以安装以下公式来计算：最大并发呼叫数 *
10、 10 * 120%10 = 2个套接字用于Q.931 + 2个套接字用于H.245 + 6个套接字用于RTP和其他用途所以100个并发呼叫甚至不需要1024个套接字。2.2 addpasswd的功能 状态接口访问认证和简单密码认证模块需要在配置文件中保存被加密的密码。自2.2.2版本开始，网守可以对配置文件中所有密码加密。Addpasswd用来生成和保存密码的密文。网守已经包含这个功能，同时你可以单独编译： $ make addpasswd 使用方法： $ addpasswd CONFIG SECTION KEYNAME PASSWORD示例1：在GkStatus:Auth中给添加用户gka
11、dmin，密码为secret： $ addpasswd gnugk.ini GkStatus:Auth gkadmin secrect示例2：通过将用名joe，密码为secert添加到Password中来启用终端认证：$ addpasswd gnugk.ini Password joe secret示例3： 将一个被加密的共享密钥添加到RadAuth中： $ addpasswd gnugk.ini RadAuth SharedSecret VerySecretPassword注意：变量KeyFilled定义了加密密钥的初始值。可以在配置文件中忽略它（如果被忽略，它的值被设为0），如果指定了这个变量的值，当变量值发生变化后，所有被密码的密文将会重新生成（用addpasswd重新加密）。2.3 安装网守 没有什么特殊的安装过程。只需要拷贝二进制文件到任意一个目录中，并为它创建一个配置文件。在源码树的etc/中有几个配置文件的示例。具体细节请参考4.2配置文件。 例如，在Linux x86平台上，最合适的gnugk二进制文件在obj_linux_x
