├── inlets_version
├── Procfile
├── .gitignore
├── bin
    └── wget.exe
├── init.sh
├── client
    ├── run-mac.sh
    ├── run-linux.sh
    └── run-windows.bat
├── app.json
└── README.md


/inlets_version:
--------------------------------------------------------------------------------
1 | 2.7.4


--------------------------------------------------------------------------------
/Procfile:
--------------------------------------------------------------------------------
1 | web: chmod a+x ./init.sh && ./init.sh


--------------------------------------------------------------------------------
/.gitignore:
--------------------------------------------------------------------------------
1 | .wget-hsts
2 | /bin/*
3 | !/bin/wget.exe


--------------------------------------------------------------------------------
/bin/wget.exe:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/ngxson/inlets-heroku/HEAD/bin/wget.exe


--------------------------------------------------------------------------------
/init.sh:
--------------------------------------------------------------------------------
 1 | #!/bin/bash
 2 | 
 3 | INLETS_VERSION=`cat inlets_version`
 4 | 
 5 | if [ ! -f "./bin/inlets" ]; then
 6 |   wget "https://github.com/inlets/inlets/releases/download/$INLETS_VERSION/inlets" -O "./bin/inlets"
 7 | fi
 8 | 
 9 | chmod a+x ./bin/inlets
10 | ./bin/inlets server --port=$PORT --token="$TOKEN"
11 | 


--------------------------------------------------------------------------------
/client/run-mac.sh:
--------------------------------------------------------------------------------
 1 | export REMOTE="https://example.herokuapp.com"
 2 | export TOKEN="CLIENT-TOKEN-HERE"
 3 | export UPSTREAM="http://127.0.0.1:3000"
 4 | 
 5 | if ! [ -x "$(command -v inlets)" ]; then
 6 |   echo 'Please run "brew install inlets" to install inlets first' >&2
 7 |   exit 1
 8 | fi
 9 | 
10 | inlets client \
11 |  --remote=$REMOTE \
12 |  --upstream=$UPSTREAM \
13 |  --token $TOKEN


--------------------------------------------------------------------------------
/client/run-linux.sh:
--------------------------------------------------------------------------------
 1 | #!/bin/bash
 2 | 
 3 | TOKEN="you_password"
 4 | REMOTE="your_app.herokuapp.com"
 5 | LOCALPORT=80
 6 | INLETS_VERSION=`cat ../inlets_version`
 7 | 
 8 | if [ ! -f "../bin/inlets" ]; then
 9 |   wget "https://github.com/inlets/inlets/releases/download/$INLETS_VERSION/inlets" -O "../bin/inlets"
10 | fi
11 | 
12 | chmod a+x ../bin/inlets
13 | ../bin/inlets client --remote=$REMOTE --upstream=http://127.0.0.1:$LOCALPORT --token $TOKEN
14 | 


--------------------------------------------------------------------------------
/client/run-windows.bat:
--------------------------------------------------------------------------------
 1 | @echo off
 2 | cls
 3 | 
 4 | set TOKEN="you_password"
 5 | set REMOTE="your_app.herokuapp.com"
 6 | set LOCALPORT="80"
 7 | 
 8 | cd ..
 9 | set /p INLETS_VERSION=<inlets_version
10 | 
11 | cd bin
12 | 
13 | if not exist inlets.exe (
14 |   wget.exe https://github.com/inlets/inlets/releases/download/%INLETS_VERSION%/inlets.exe -O inlets.exe
15 | )
16 | 
17 | inlets.exe client --remote="%REMOTE%" --token "%TOKEN%" --upstream=http://127.0.0.1:%LOCALPORT%
18 | pause
19 | 


--------------------------------------------------------------------------------
/app.json:
--------------------------------------------------------------------------------
 1 | {
 2 |   "name": "Inlets Reverse Proxy",
 3 |   "description": "Using inlets as a service tunnel and reverse proxy",
 4 |   "repository": "https://github.com/ngxson/inlets-heroku.git",
 5 |   "website": "https://github.com/ngxson/inlets-heroku",
 6 |   "logo": "https://raw.githubusercontent.com/inlets/inlets/master/docs/inlets-logo-sm.png",
 7 |   "env": {
 8 |     "TOKEN": {
 9 |       "description": "Your secret password (token). Ideally should be a random string.",
10 |       "value": ""
11 |     }
12 |   },
13 |   "formation": {
14 |     "web": {
15 |       "quantity": 1,
16 |       "size": "free"
17 |     }
18 |   },
19 |   "buildpacks": [
20 |     {"url": "https://github.com/maximkulkin/heroku-buildpack-dummy.git"}
21 |   ]
22 | }


--------------------------------------------------------------------------------
/README.md:
--------------------------------------------------------------------------------
 1 | # Inlets Reverse Proxy
 2 | 
 3 | Author: [ngxson](https://github.com/ngxson)
 4 | 
 5 | ## What is this?
 6 | 
 7 | Briefly, `inlets` let you expose your localhost to the Internet, through any NAT or firewall.
 8 | 
 9 | It can be an alternative solution to `ngrok` or `localtunnel`. Since it can be deployed to **heroku**, you can have your own **fixed address**, which is better for testing a **webhook server**.
10 | 
11 | The original project can be found here: [https://github.com/inlets/inlets](https://github.com/inlets/inlets)
12 | 
13 | Tutorial on LinkedIn: [Set your own "ngrok alternative"​ on Heroku](https://www.linkedin.com/pulse/set-your-own-ngrok-alternative-heroku-xuan-son-nguyen/)
14 | 
15 | ## Setup the server
16 | 
17 | Just click this button:
18 | 
19 | [![Deploy](https://www.herokucdn.com/deploy/button.svg)](https://heroku.com/deploy?template=https://github.com/ngxson/inlets-heroku/tree/master)
20 | 
21 | P/s: for the password, you can choose a simple one like `this1sMypassw0rd`
22 | 
23 | ## How to use
24 | 
25 | On your local machine:
26 | 
27 | For Windows® users:
28 | - Open and edit `client/run-windows.bat`
29 | - Change `TOKEN`, `REMOTE`, `LOCALPORT` to match your settings
30 | - Double click on `run-windows.bat`
31 | 
32 | For Linux users:
33 | - Open and edit `client/run-linux.sh`
34 | - Change `TOKEN`, `REMOTE`, `LOCALPORT` to match your settings
35 | - `cd inlets-heroku/client && chmod a+x run-linux.sh && ./run-linux.sh`
36 | 
37 | For MacOS users:
38 | - Install inlets using `brew install inlets`
39 | - Open and edit `client/run-mac.sh`
40 | - Change `TOKEN`, `REMOTE`, `UPSTREAM` to match your settings
41 | - `cd inlets-heroku/client && chmod a+x run-mac.sh && ./run-mac.sh`
42 | 
43 | ## Troubleshoot
44 | 
45 | For Windows: If it does not work, delete `inlets.exe` in `bin` folder, then try again.
46 | 
47 | ## Thanks to
48 | 
49 | - [inlets](https://github.com/inlets) dev team for their excellent work
50 | - [sahilmob](https://github.com/sahilmob) for MacOS script
51 | 


--------------------------------------------------------------------------------