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 details)

Uploaded Source

Built Distribution

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

Uploaded Python 3

File details

Details for the file toori-server-1.1.10.tar.gz.

File metadata

  • Download URL: toori-server-1.1.10.tar.gz
  • Upload date:
  • Size: 5.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.7.17

File hashes

Hashes for toori-server-1.1.10.tar.gz
Algorithm Hash digest
SHA256 3dd2f390c0df944cab8ce87bc656288d736dc873b472973885a41323d9b3296f
MD5 91ffb66c5cd8d573053c6d693d7c37e9
BLAKE2b-256 e838167ecc9271895f055ada4b5b5c9a12a163c1cffeaab519209f6de474b765

See more details on using hashes here.

File details

Details for the file toori_server-1.1.10-py3-none-any.whl.

File metadata

File hashes

Hashes for toori_server-1.1.10-py3-none-any.whl
Algorithm Hash digest
SHA256 30fe3a85daa23a4199e60fe72b24b42d67736964cfca598d3e58f80c1201ae0f
MD5 4c39514cf638243201e5bbe3df690371
BLAKE2b-256 5a1b8387963ac25782ad61ede6e5433a05d363cfc03463593f4c6261e7163708

See more details on using hashes here.

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