Node-turn：一个Node.js的STUN/TURN服务器技术文档

Node-turn：一个Node.js的STUN/TURN服务器技术文档

node-turn Node-turn is a STUN/TURN server for Node.JS 项目地址: https://gitcode.com/gh_mirrors/no/node-turn

Node-turn是一款专为Node.js设计的STUN/TURN（Session Traversal Utilities for NAT）服务器实现，支持RFC5389和RFC5766标准。该库允许应用程序在NAT环境下顺利地进行P2P通信，通过提供中转服务来穿透网络地址转换的限制。

安装指南

Node-turn可以通过npm轻松安装到您的项目中。只需在命令行执行以下指令：

npm install node-turn

这将下载Node-turn库及其依赖项到您的项目中的node_modules文件夹。

作为独立服务器使用

若要将Node-turn作为独立服务器运行，请按照以下步骤操作：

1. 进入Node-turn模块目录：

   cd ./node_modules/node-turn
   

2. 创建配置目录并复制样例配置：

   sudo mkdir /etc/node-turn
   sudo cp ./sample-config.conf /etc/node-turn/node-turn.conf
   

3. 设置权限和日志文件：

   sudo chmod 640 /etc/node-turn/node-turn.conf
   sudo touch /var/log/node-turn.log
   sudo chmod 640 /var/log/node-turn.log
   

   然后退出sudo模式。

4. 编辑配置文件以符合您的需求：

   vi /etc/node-turn/node-turn.conf
   

5. 启动服务器：

   npm run start
   

作为库集成到项目中

要将Node-turn集成到您的Node.js应用中，您需要：

const Turn = require('node-turn');
const server = new Turn({
  authMech: 'long-term',
  credentials: {
    username: "your_username",
    password: "your_password"
  }
});
server.start();

确保替换your_username和your_password为您实际的用户名和密码。

配置选项

Node-turn提供了丰富的配置选项来定制其行为，如：

• listeningPort: 监听端口，默认为3478。
• listeningIps: 监听IP地址数组。
• relayIps: 中继地址数组，用于指定中继数据的本地IP地址。
• externalIps: 外部IP地址配置，用于NAT穿越。
• 更多选项如认证机制(authMech)、调试级别(debugLevel)等，详细见官方文档。

认证机制与调试等级

• 认证机制包括无认证('none')、短时机制('short-term')以及长期机制('long-term')。
• 调试等级从不记录('OFF')到记录所有信息('ALL')不等，便于开发者调试。

库方法概览

• start(): 启动服务器。
• stop(): 停止服务器。
• addUser(username, password): 添加用户至认证列表。
• removeUser(username): 从认证列表移除用户。

通过遵循以上指南，您可以有效地部署和利用Node-turn，以支持您的应用在不同网络环境下的通信需求。

node-turn Node-turn is a STUN/TURN server for Node.JS 项目地址: https://gitcode.com/gh_mirrors/no/node-turn