turn-rs

Crates.ioturn-rs
lib.rsturn-rs
version1.2.2
sourcesrc
created_at2023-01-01 05:35:30.212879
updated_at2023-12-24 15:37:36.091281
descriptionA library for handling round sessions.
homepagehttps://github.com/mycrl/turn-rs
repositoryhttps://github.com/mycrl/turn-rs
max_upload_size
id748732
size139,106
Lazy Panda (mycrl)

documentation

README

简体中文 / English

TURN Server implemented by ❤️ Rust
RFC: https://datatracker.ietf.org/doc/html/rfc8656


A turn server implemented pure in rust. Compared with coturn, the advantage is that it provides better performance. It can reach a decoding speed of 5Gib/s in a single thread, and the forwarding delay is less than 35 microseconds. However, it does not provide the same With rich functional support like coturn, this project is most suitable for scenarios where stun/turn servers are used in webrtc.

Who uses it?

Table of contents

Features

  • Only long-term authentication mechanisms are supported.
  • Static authentication lists can be used in configuration files.
  • Only virtual ports are always allocated and no real system ports are occupied.
  • The transport layer supports tcp and udp protocols, and supports binding multiple network cards or interfaces.
  • Provides a simple command line tool to manage and monitor the turn server through the command line tool graphical interface. (turn-cli)
  • The GRPC interface can be used so that the turn server can proactively notify the external service of events and use external authentication mechanisms, and the external can also proactively control the turn server and manage the session. (proto)

Usage

The versions on crates.io and docker may be very outdated. It is recommended to compile directly from the github source code.

cargo install turn-server

Start with configuration file:

turn-server --config=/etc/turn_server/config.toml

Please check the example configuration file for details: turn_server.toml

Docker

// docker hub
docker pull quasipaa/turn-server
// github packages
docker pull ghcr.io/mycrl/turn-server

The custom configuration file overrides the /etc/turn-server/config.toml path inside the image through -v.

Linux service

./install-service.sh

This will compile the project and install and start the service.

Building

Prerequisites

You need to install the Rust toolchain, if you have already installed it, you can skip it, Install Rust, then get the source code:

git clone https://github.com/mycrl/turn-rs

Build workspace

Compile the entire workspace in release mode:

cd turn-rs
cargo build --release

After the compilation is complete, you can find the binary file in the "target/release" directory.

License

GPL3.0 Copyright (c) 2022 Mr.Panda.

Commit count: 356

cargo fmt