Skip to main content

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/"

Metadata

Release files for toori-server 1.1.10

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for toori-server 1.1.10
File Size Uploaded
toori-server-1.1.10.tar.gz 5.0 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for toori-server 1.1.10
File Interpreter ABI Platform
toori_server-1.1.10-py3-none-any.whl Python 3 none any Details

Total release size: 10.4 kB

Release files / toori-server-1.1.10.tar.gz

Download URL toori-server-1.1.10.tar.gz
Size 5.0 kB
Tags Source
SHA-256 checksum
How to use checksums
3dd2f390c0df944cab8ce87bc656288d736dc873b472973885a41323d9b3296f
BLAKE2b-256 checksum
How to use checksums
e838167ecc9271895f055ada4b5b5c9a12a163c1cffeaab519209f6de474b765
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/4.0.2 CPython/3.7.17

Release files / toori_server-1.1.10-py3-none-any.whl

Download URL toori_server-1.1.10-py3-none-any.whl
Size 5.4 kB
Tags Python 3
SHA-256 checksum
How to use checksums
30fe3a85daa23a4199e60fe72b24b42d67736964cfca598d3e58f80c1201ae0f
BLAKE2b-256 checksum
How to use checksums
5a1b8387963ac25782ad61ede6e5433a05d363cfc03463593f4c6261e7163708
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/4.0.2 CPython/3.7.17

Release history Release notifications | RSS feed

This release

1.1.10 This release

2 release files

1.1.9

2 release files

1.1.8

2 release files

1.1.7

2 release files

1.1.6

2 release files

1.1.5

2 release files

1.1.4

2 release files

1.1.3

2 release files

1.1.2

2 release files

1.1.1

2 release files

1.1.0

2 release files

1.0.0

2 release files

0.0.5

2 release files

0.0.4

2 release files

0.0.3

2 release files

0.0.2

2 release files

0.0.1

1 release file

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page