Skip to main content

Server for a minimal layer 3 tunnel over http(s).

Project description

Iro

GHCR PyPI Release PyPI Version

Server for a minimal layer 3 tunnel over http(s).

Deploying with Docker

Instead of installing toori-server on the host, it can be deployed as a Docker container with much convenience.

Pull from GHCR:

sudo docker pull ghcr.io/kokseen1/toori-server:latest

Run the container:

sudo docker run -d --cap-add=NET_ADMIN -p 80:80 ghcr.io/kokseen1/toori-server

HTTPS

To deploy with HTTPS, run the container with a bind mount and pass the port and certs directory as arguments:

sudo docker run -d -v /etc/letsencrypt:/etc/letsencrypt --cap-add=NET_ADMIN -p 443:443 ghcr.io/kokseen1/toori-server 443 /etc/letsencrypt/live/toori.server/

Installation

pip3 install toori-server --no-binary :all:

Prerequisites

  • Libtins (optional, will fallback to Scapy (slow) if not installed)

RST Packets

Because the Linux kernel sends a RST to connections it did not establish, use the following command to ensure that outgoing packets are sent successfully:

sudo iptables -A OUTPUT -p tcp --tcp-flags RST RST -s <local address> -j DROP

See here for more information.

Usage

Run with root permissions:

iro <port>

Example with HTTPS:

iro 443 -c "/etc/letsencrypt/live/toori.server/"

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

toori-server-1.1.10.tar.gz (5.0 kB view hashes)

Uploaded Source

Built Distribution

toori_server-1.1.10-py3-none-any.whl (5.4 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page