adelorenzo/web-terminal
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Added info about multi-architectures

Browse Source
This commit is contained in:
Raoni Meira Gabriel 2020-12-08 18:13:39 -03:00
parent fac98f0e4f
commit 7e8a119cd2
1 changed files with 25 additions and 20 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

45
README.md
View File

@ -2,14 +2,20 @@
## What is this? ## What is this?
This is a lightweight (~43MB) alpine based docker image that comes pre-packaged with 2 wonderful tools: This is a lightweight (~43MB) alpine based docker image that comes pre-packaged with 2 wonderful tools:
* [ttyd](https://github.com/tsl0922/ttyd): is a simple command-line tool for sharing terminal over the web, using websockets. * [ttyd](https://github.com/tsl0922/ttyd): is a simple command-line tool for sharing a terminal over the web, using WebSockets.
* [ngrok](https://ngrok.com/): Creates reverse tunnels that allow access to your box from the internet. * [ngrok](https://ngrok.com/): Creates reverse tunnels that allow access to your box from the internet.
On top of those, I've added socat, nginx, openssh and openssl. On top of those, I've added socat, Nginx, OpenSSH, and OpenSSL.
This allows you to quickly provision an isolated (docker container) that can serve as a base for a lot of tunelling solutions. Use your imagination. :wink: This allows you to quickly provision an isolated (docker container) that can serve as a base for a lot of tunneling solutions. Use your imagination. :wink:
If you run this with docker option **--rm** (as bellow), keep in mind that docker will remove the container once it gets stopped. This is good if you don't want to leave any garbage behind. If you run this with docker option **--rm** (as bellow), keep in mind that docker will remove the container once it gets stopped. This is good if you don't want to leave any garbage behind.
---
# Multi-Arch
This image supports the following architectures: linux/armv7, linux/arm64, linux/386 and linux/amd64.
This means you get it running on your RaspberryPi.
--- ---
# Usage # Usage
```sh ```sh
@ -28,12 +34,11 @@ ngrok http -region=sa -bind-tls=true -inspect=false localhost:7681
``` ```
Check its running: Check its running:
``` ```
ngrok by @inconshreveable (Ctrl+C to quit) ngrok by @inconshreveable
Session Status online
Session Status online Session Expires 7 hours, 59 minutes
Session Expires 7 hours, 59 minutes Version 2.3.35
Version 2.3.35 Region South America (sa)
Region South America (sa)
Forwarding https://e0075a2a0966.ngrok.io -> http://localhost:7681 Forwarding https://e0075a2a0966.ngrok.io -> http://localhost:7681
``` ```
@ -46,17 +51,17 @@ Now, let's try that with nginx. First, run the embedded nginx in the background
# nginx & # nginx &
# ngrok http 80 # ngrok http 80
ngrok by @inconshreveable (Ctrl+C to quit) ngrok by @inconshreveable
Session Status online
Session Status online Session Expires 7 hours, 59 minutes
Session Expires 7 hours, 59 minutes Version 2.3.35
Version 2.3.35 Region United States (us)
Region United States (us) Web Interface http://127.0.0.1:4040
Web Interface http://127.0.0.1:4040 Forwarding http://cf96bd9d722e.ngrok.io -> http://localhost:80
Forwarding http://cf96bd9d722e.ngrok.io -> http://localhost:80
Forwarding https://cf96bd9d722e.ngrok.io -> http://localhost:80 Forwarding https://cf96bd9d722e.ngrok.io -> http://localhost:80
``` ```
And now you have your nginx exposed to the internet over HTTP and HTPS. On this example, the web interface is also enabled on port 4040. And now you have your nginx exposed to the internet over HTTP and HTPS (there are 2 **Forwarding** mappings).
On this example, the web interface is also enabled on port 4040.
Keep in mind that you can also use any other TCP based service server because ngrok supports not only HTTP/HTTPS but also raw TCP tunnels. Keep in mind that you can also use any other TCP based service server because ngrok supports not only HTTP/HTTPS but also raw TCP tunnels.
@ -118,7 +123,7 @@ Build, then run it:
# docker build . -t js-box # docker build . -t js-box
# docker run --rm --hostname jsbox -d -p 7681:7681 js-box # docker run --rm --hostname jsbox -d -p 7681:7681 js-box
``` ```
Because we configured the **~/.ngrok2/ngrok.yml** on this custom image, you can start the ngrok tunnel by name inside the container as following: Because we configured the **~/.ngrok2/ngrok.yml** on this custom image, you can start the ngrok tunnel by name inside the container as follows:
```sh ```sh
# ngrok start nodejs # ngrok start nodejs
``` ```
@ -131,7 +136,7 @@ We could also use have used socat, openssh tunnels or event ngrok to forward the
--- ---
## ngrok account and plans ## ngrok account and plans
ngrok suports TLS, TCP tunnels, certs, built-in fileserver, forwarding to another machines so please take a look on https://ngrok.com/docs for more help. ngrok suports TLS, TCP tunnels, certs, built-in fileserver, forwarding to other machines so please take a look on https://ngrok.com/docs for more help.
Keep in mind that some of the advanced features require you to create a (free) account then use the provided auth token. See https://ngrok.com/docs#getting-started-authtoken for more info. Keep in mind that some of the advanced features require you to create a (free) account then use the provided auth token. See https://ngrok.com/docs#getting-started-authtoken for more info.