https://github.com/pjvds/tunl

Instantly expose local services to the internet
https://github.com/pjvds/tunl

docker fileserver golang reverse-proxy tunnel tunnel-client

Last synced: 5 months ago
JSON representation

Instantly expose local services to the internet

Host: GitHub
URL: https://github.com/pjvds/tunl
Owner: pjvds
License: apache-2.0
Created: 2020-12-27T22:00:18.000Z (over 5 years ago)
Default Branch: master
Last Pushed: 2023-05-01T04:11:52.000Z (about 3 years ago)
Last Synced: 2025-10-27T02:53:38.051Z (8 months ago)
Topics: docker, fileserver, golang, reverse-proxy, tunnel, tunnel-client
Language: Go
Homepage: https://tunl.es
Size: 2.29 MB
Stars: 22
Watchers: 1
Forks: 5
Open Issues: 4
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE

README

# Tunl

With Tunl you can expose services on your localhost to the public via a fast and secure tunnel.

## Expose local http process

```
$ tunl http localhost:3000
https://red-fox.tunl.es/ -> http://localhost:3000
```

## Share a local directory

```
$ tunl files /dir
https://red-fox.tunl.es/ -> /dir
```

## Expose a local MySQL

```
$ tunl tcp localhost:3306
tunl.es:89311 -> localhost:3306
```

## Expose a service running in a docker container

```
$ tunl docker [container-name]:
tunl.es:48221 -> :
```

# Installation

Download the [binary release](https://github.com/pjvds/tunl/releases/latest) and put it somewhere in your `$PATH`.

## Basic

**curl**
```
# install it to ./bin/tunl
curl -fsSL https://get.tunl.es | sh
```

```
# install it to /sbin/tunl
curl -fsSL https://get.tunl.es | sudo sh -s -- -b /sbin
```

**wget**

```
# install it to ./bin/tunl
wget -qO- https://get.tunl.es | sh
```

```
# install it to /sbin/tunl
wget -qO- https://get.tunl.es | sudo sh -s -- -b /sbin
```

## Arch Linux

```
yay tunl
```

## Ubuntu

```
sudo snap install tunl --edge
```

## Docker

```
docker run --rm --network=host -v $PWD:$PWD tunl/tunl
```

**warning**: this maps the current working directory and means files outside the current working directory cannot be shared