wurenzhi
136c2fa579
- 新增文档模板和导航结构 - 实现服务器基础API路由和控制器 - 添加扩展插件配置和前端框架 - 引入多租户和权限管理模块 - 集成日志和数据库配置 - 添加核心业务模型和类型定义
144 lines
7.3 KiB
Markdown
144 lines
7.3 KiB
Markdown
# Asterisk(R) 开源 PBX
|
||
|
||
```
|
||
由 Mark Spencer <markster@digium.com> 和 Asterisk.org 开发社区编写。
|
||
版权所有 (C) 2001-2025 Sangoma Technologies Corporation 及其他版权持有人。
|
||
```
|
||
|
||
## 安全
|
||
|
||
在尝试配置和运行 Asterisk 服务器之前，请务必阅读并充分理解安全信息文档的内容。
|
||
|
||
更多信息请参阅 [重要安全注意事项](https://docs.asterisk.org/Deployment/Important-Security-Considerations)。
|
||
|
||
## 什么是 ASTERISK？
|
||
|
||
Asterisk 是一个开源 PBX 和电话工具包。从某种意义上说，它是底层互联网和电话通道与顶层互联网和电话应用之间的中间件。然而，Asterisk 支持的电话接口不仅仅是互联网电话。Asterisk 还对传统 PSTN 电话提供了广泛的支持。
|
||
|
||
有关项目本身的更多信息，请访问 [Asterisk 主页](https://www.asterisk.org) 和官方 [Asterisk 文档](https://docs.asterisk.org)。
|
||
|
||
## 支持的操作系统
|
||
|
||
### Linux
|
||
|
||
Asterisk 开源 PBX 主要在 GNU/Linux 操作系统上开发和测试，并支持所有主流的 GNU/Linux 发行版。
|
||
|
||
### 其他
|
||
|
||
据报道，Asterisk 也已被“移植”并在其他操作系统上正常运行，如苹果的 Mac OS X 和 BSD 变体。
|
||
|
||
## 入门指南
|
||
|
||
如今大多数用户都排他性地使用 VoIP/SIP，但如果你需要连接到 TDM 或模拟服务或设备，请确保你有支持的硬件。
|
||
|
||
支持的电话硬件包括：
|
||
* 来自 Sangoma 的所有模拟和数字接口卡
|
||
* PortAudio 支持的任何全双工声卡
|
||
* Xorcom Astribank 通道银行
|
||
|
||
### 从早期版本升级
|
||
|
||
如果你是从旧版本的 Asterisk 更新，请务必阅读变更日志。
|
||
|
||
<!-- CHANGELOGS (the URL will change based on the location of this README) -->
|
||
[变更日志](https://downloads.asterisk.org/pub/telephony/asterisk)
|
||
<!-- END-CHANGELOGS -->
|
||
|
||
### 全新安装
|
||
|
||
确保你的系统包含兼容的编译器和开发库。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，但这些发行版可能没有完全支持，或者可能已过时。
|
||
|
||
那么，让我们开始吧：
|
||
|
||
1. 阅读文档。<br>
|
||
[Asterisk 文档](https://docs.asterisk.org) 网站提供了构建、安装、配置和运行 Asterisk 的完整信息。
|
||
|
||
2. 运行 `./configure`<br>
|
||
执行 configure 脚本以猜测编译过程中使用的系统相关变量的值。如果脚本指示缺少某些必需组件，你可以运行 `./contrib/scripts/install_prereq install` 来安装必要的组件。请注意，这将安装 Asterisk 所有功能的所有依赖项。运行脚本后，你需要重新运行 `./configure`。
|
||
|
||
3. 运行 `make menuselect`<br>
|
||
如果你想选择要编译的模块并检查各种可选模块的依赖项，则需要此步骤。
|
||
|
||
4. 运行 `make`<br>
|
||
假设构建成功完成：
|
||
|
||
5. 运行 `make install`<br>
|
||
如果是第一次使用 Asterisk，你可能希望安装示例 PBX，其中包含演示扩展等。如果是这样，请运行：
|
||
|
||
6. 运行 `make samples`<br>
|
||
这样做将覆盖你已安装的任何现有配置文件。
|
||
|
||
7. 最后，你可以使用以下命令在前台模式（非守护进程）下启动 Asterisk：<br>
|
||
`asterisk -vvvc`<br>
|
||
在 Asterisk 初始化时，你会看到屏幕上飞过一堆详细消息（这就是“非常非常详细”模式）。准备就绪后，如果你指定了 "c"，你将获得一个命令行控制台，如下所示：<br>
|
||
`*CLI>`<br>
|
||
你可以随时输入 `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`。在文件底部添加以下行：
|
||
|
||
```text
|
||
root soft nofile 4096
|
||
root hard nofile 8196
|
||
asterisk soft nofile 4096
|
||
asterisk hard nofile 8196
|
||
```
|
||
|
||
（根据需要调整数字）。你可能需要重启系统才能使这些更改生效。
|
||
|
||
#### 通用 UNIX 系统
|
||
|
||
如果上面没有专门适用于你的系统的说明，你可以尝试将命令 `ulimit -n 8192` 添加到启动 Asterisk 的脚本中。
|
||
|
||
## 更多信息
|
||
|
||
访问 [Asterisk 文档](https://docs.asterisk.org) 网站以获取有关各种功能的更多文档，并请阅读包含配置选项文档的所有配置示例。
|
||
|
||
最后，你可能希望加入 [Asterisk 社区论坛](https://community.asterisk.org)。
|
||
|
||
欢迎加入不断壮大的全球 Asterisk 用户社区！
|
||
|
||
```
|
||
Mark Spencer 以及 Asterisk.org 开发社区
|
||
```
|
||
|
||
---
|
||
|
||
Asterisk 是 Sangoma Technologies Corporation 的商标
|
||
|
||
\[[Sangoma](https://www.sangoma.com/)\]
|
||
\[[主页](https://www.asterisk.org)\]
|
||
\[[支持](https://www.asterisk.org/support)\]
|
||
\[[文档](https://docs.asterisk.org)\]
|
||
\[[社区论坛](https://community.asterisk.org)\]
|
||
\[[发布说明](https://github.com/asterisk/asterisk/releases)\]
|
||
\[[安全](https://docs.asterisk.org/Deployment/Important-Security-Considerations/)\]
|
||
\[[邮件列表存档](https://lists.digium.com)\]
|