wurenzhi
136c2fa579
- 新增文档模板和导航结构 - 实现服务器基础API路由和控制器 - 添加扩展插件配置和前端框架 - 引入多租户和权限管理模块 - 集成日志和数据库配置 - 添加核心业务模型和类型定义
Asterisk(R) 开源 PBX
由 Mark Spencer <markster@digium.com> 和 Asterisk.org 开发社区编写。
版权所有 (C) 2001-2025 Sangoma Technologies Corporation 及其他版权持有人。
安全
在尝试配置和运行 Asterisk 服务器之前，请务必阅读并充分理解安全信息文档的内容。
更多信息请参阅 重要安全注意事项。
什么是 ASTERISK？
Asterisk 是一个开源 PBX 和电话工具包。从某种意义上说，它是底层互联网和电话通道与顶层互联网和电话应用之间的中间件。然而，Asterisk 支持的电话接口不仅仅是互联网电话。Asterisk 还对传统 PSTN 电话提供了广泛的支持。
有关项目本身的更多信息，请访问 Asterisk 主页 和官方 Asterisk 文档。
支持的操作系统
Linux
Asterisk 开源 PBX 主要在 GNU/Linux 操作系统上开发和测试，并支持所有主流的 GNU/Linux 发行版。
其他
据报道，Asterisk 也已被“移植”并在其他操作系统上正常运行，如苹果的 Mac OS X 和 BSD 变体。
入门指南
如今大多数用户都排他性地使用 VoIP/SIP，但如果你需要连接到 TDM 或模拟服务或设备，请确保你有支持的硬件。
支持的电话硬件包括：
- 来自 Sangoma 的所有模拟和数字接口卡
- PortAudio 支持的任何全双工声卡
- Xorcom Astribank 通道银行
从早期版本升级
如果你是从旧版本的 Asterisk 更新，请务必阅读变更日志。
全新安装
确保你的系统包含兼容的编译器和开发库。Asterisk 要求 GNU 编译器集合 (GCC) 4.1 或更高版本，或者支持 C99 规范和某些 gcc 语言扩展的编译器。此外，你的系统需要有 C 库头文件以及 ncurses 的头文件和库。
许多模块有额外的依赖项。要查看正在查找哪些库，请参阅 ./configure --help，或运行 make menuselect 来查看特定模块的依赖项。
在许多发行版中，这些依赖项由名称类似于 'glibc-devel'、'ncurses-devel'、'openssl-devel' 和 'zlib-devel' 或类似的软件包安装。contrib/scripts/install_prereq 脚本可用于为大多数基于 Debian 和 Redhat 的 Linux 发行版安装依赖项。该脚本还处理 SUSE、Arch、Gentoo、FreeBSD、NetBSD 和 OpenBSD，但这些发行版可能没有完全支持，或者可能已过时。
那么，让我们开始吧：
-
阅读文档。
Asterisk 文档 网站提供了构建、安装、配置和运行 Asterisk 的完整信息。 -
运行
./configure
执行 configure 脚本以猜测编译过程中使用的系统相关变量的值。如果脚本指示缺少某些必需组件，你可以运行./contrib/scripts/install_prereq install来安装必要的组件。请注意，这将安装 Asterisk 所有功能的所有依赖项。运行脚本后，你需要重新运行./configure。 -
运行
make menuselect
如果你想选择要编译的模块并检查各种可选模块的依赖项，则需要此步骤。 -
运行
make
假设构建成功完成： -
运行
make install
如果是第一次使用 Asterisk，你可能希望安装示例 PBX，其中包含演示扩展等。如果是这样，请运行： -
运行
make samples
这样做将覆盖你已安装的任何现有配置文件。 -
最后，你可以使用以下命令在前台模式（非守护进程）下启动 Asterisk：
asterisk -vvvc
在 Asterisk 初始化时，你会看到屏幕上飞过一堆详细消息（这就是“非常非常详细”模式）。准备就绪后，如果你指定了 "c"，你将获得一个命令行控制台，如下所示：
*CLI>
你可以随时输入core show help以获取系统帮助。如需特定命令的帮助，请输入core show help <command>。
在 Unix/Linux 命令行提示符下输入 man asterisk 将为你提供有关如何启动和停止 Asterisk 的详细信息，以及启动 Asterisk 的所有命令行选项。
关于配置文件
所有 Asterisk 配置文件共享一种通用格式。注释由 ; 分隔（因为 # 作为 DTMF 数字，可能出现在许多地方）。配置文件分为若干部分，其名称出现在 [] 中。每个部分通常包含 variable = value 形式的语句，尽管你可能会在较旧的示例中看到 variable => value。
关于时间的特别说明
使用 SIP 电话的用户应注意，Asterisk 对时间的剧烈跳变非常敏感。手动使用 date(1)（或其他类似命令）更改系统时间可能会导致 SIP 注册和其他内部流程失败。因此，你应该始终使用时间同步软件包来保持系统时间的准确性。所有操作系统/发行版都提供以下一个或多个软件包：
- ntpd/ntpsec
- chronyd
- systemd-timesyncd
请务必安装并配置其中一个（且仅一个）。
文件描述符
根据系统的规模和配置，Asterisk 可能会消耗大量文件描述符。在 UNIX 中，文件描述符不仅用于磁盘上的文件。文件描述符还用于处理网络通信（例如 SIP、IAX2 或 H.323 调用）和硬件访问（例如模拟和数字中继硬件）。Asterisk 访问许多磁盘文件，从配置信息到语音邮件存储。
大多数系统限制 Asterisk 一次可以打开的文件描述符数量。这可能会限制系统可以处理的并发呼叫数。例如，如果限制设置为 1024（常见的默认值），Asterisk 大约可以同时处理 150 个 SIP 呼叫。要更改文件描述符的数量，请按照下面针对你的系统的说明进行操作：
基于 PAM 的 LINUX 系统
如果你的系统使用 PAM (可插拔认证模块)，请编辑 /etc/security/limits.conf。在文件底部添加以下行：
root soft nofile 4096
root hard nofile 8196
asterisk soft nofile 4096
asterisk hard nofile 8196
（根据需要调整数字）。你可能需要重启系统才能使这些更改生效。
通用 UNIX 系统
如果上面没有专门适用于你的系统的说明，你可以尝试将命令 ulimit -n 8192 添加到启动 Asterisk 的脚本中。
更多信息
访问 Asterisk 文档 网站以获取有关各种功能的更多文档，并请阅读包含配置选项文档的所有配置示例。
最后，你可能希望加入 Asterisk 社区论坛。
欢迎加入不断壮大的全球 Asterisk 用户社区！
Mark Spencer 以及 Asterisk.org 开发社区
Asterisk 是 Sangoma Technologies Corporation 的商标