|
| 1 | + |
| 2 | + |
| 3 | +# <img src="https://i.postimg.cc/qv6ffhWv/topico-trans.png)" alt="topico" width="150"/> SSH Tunnel Manager |
| 4 | + |
| 5 | +Tunnel Manager is a tool for **proxying, pivoting and securing connections over SSH.** |
| 6 | +It's basically a GUI wrapper for **plink** but adds **profiling, notifications** and is focused on **automation** and **session persistence**. |
| 7 | +It is written mainly in **[AutoHotkey](https://www.autohotkey.com/)** and the GUI framework that I used is [Neutron.ahk](https://github.com/G33kDude/Neutron.ahk), so it has a little bit of HTML, CSS (Bootstrap 3), JS and JQuery. |
| 8 | +> **Pro Tip:** Press **Ctrl** key while Tunnel Manager is active to change **"copy to clipboard"** icon into **"generate QR"** mode. |
| 9 | +
|
| 10 | +## Compiled Version & Downloads |
| 11 | +Go check **[releases](https://github.com/elModo7/Tunnel_Manager/releases)** for compiled binaries if you don't want to have AutoHotkey installed. |
| 12 | +You can also **download from this document.** |
| 13 | +|Version| Download | |
| 14 | +|--|--| |
| 15 | +| `Latest` | [`Download Link`](https://github.com/elModo7/Tunnel_Manager/releases/latest/download/TunnelManager.zip) | |
| 16 | +| 1.2.29 | [Download Link](https://github.com/elModo7/Tunnel_Manager/releases/download/1.2.29/TunnelManager.zip) | |
| 17 | + |
| 18 | +## Sample Usage (Secure VNC Session) |
| 19 | + |
| 20 | +```mermaid |
| 21 | +sequenceDiagram |
| 22 | +Server ->> SSH Server: Forward port 5900 to 8034 (SSH) |
| 23 | +Note right of SSH Server: Proxying 5900:8034 |
| 24 | +Client--x Server: I want to connect securely thorugh VNC 5900 |
| 25 | +Server-->> Client: VNC is not encrypted but I can tunnel it through 8034 |
| 26 | +Client->> SSH Server: Connect to VNC:8034 |
| 27 | +Server->> Client: I am sharing a secure VNC Session! |
| 28 | +Note right of Client: The client has<br/>established a secure<br/>connection with the<br/>server by tunneling<br/>the VNC session<br/>through SSH. |
| 29 | +
|
| 30 | +``` |
| 31 | + |
| 32 | +#### Recommended sshd_config match user config: |
| 33 | + GatewayPorts yes |
| 34 | + AllowTcpForwarding yes |
| 35 | + X11Forwarding no |
| 36 | + AllowAgentForwarding no |
| 37 | + ForceCommand /bin/false |
| 38 | + |
| 39 | +## Features |
| 40 | + |
| 41 | +- Support Local, Remote and Dynamic SSH Tunneling |
| 42 | +- Server and Tunnel Profiling |
| 43 | +- Neutron Web UI |
| 44 | +- Console Output |
| 45 | +- Auto Accept SSH Key |
| 46 | +- Silent Mode with Profile Select / Silent/NoGUI (1.2.24+) |
| 47 | +- Hide Tray icon option for Shadow Mode (1.2.16+) |
| 48 | +- DRM Copy Protection included via Online Validation of Serial based on Hardware Fingerprint |
| 49 | +- Temporary Tunnels without Saving |
| 50 | +- Relaunch Tunnel on disconnect |
| 51 | +- No need for a full reload on profile select |
| 52 | +- Online version checker based on GitHub repo |
| 53 | +- Allow enabling/disabling per proflie+tunnel configuration |
| 54 | +- Keep track of last used profile (path) |
| 55 | +- Config checks on repeated/incorrect tunnel configurations (Improved in 1.2.11+) |
| 56 | +- DRM Two Way Encryption (1.2.10+) |
| 57 | +- Quick Copy Tunnel (1.2.14+) |
| 58 | +- QR Code Generator (1.2.17+) / Press Ctrl while the app is active and click on Copy Link Button |
| 59 | +- Discord WebHook Notify / Telegram API Notify / PushBullet Notify (1.2.18+) |
| 60 | +- Console Output Toggle (1.2.21+) |
| 61 | +- Reload Tunnel While Running (1.2.23+) / Allows restarting the tunnel in case configuration changed and you are working remotely |
| 62 | +- Quick Hide/Show by Double Clicking Tray Icon (1.2.23+) |
| 63 | +- Increased Command Line Tools and Tray Actions (1.2.24+) |
| 64 | +- Parameter info on cmd (chalk) or msgbox (1.2.24+) |
| 65 | +- Added License (1.2.26+) |
| 66 | +- Auto Update PLink Client to the latest version on first run (1.2.28+) |
| 67 | +- Option to download latest PLink or use built in on first run or proxy deletion (1.2.29+) |
| 68 | +- Fully Open Source (1.2.29+) |
| 69 | +- Remove DRM Protection (No Serial Required) (1.2.29+) |
| 70 | + |
| 71 | +#### PARAMS: |
| 72 | +- -nogui (Disables GUI) |
| 73 | +- -silent (Disables Tray Notifications) |
| 74 | +- -notray (Removes Tray Icon) |
| 75 | +- -hidden (Starts Hidden) |
| 76 | +- -autostart (Starts Tunneling on Startup) |
| 77 | +- -profile <profile_path> |
| 78 | + |
| 79 | +#### TODO: |
| 80 | +- TCP / Websocket Interop (Server) |
| 81 | + |
| 82 | +#### REQUIERES: |
| 83 | +- Windows 7 x64 (Windows 10+ Recommended) |
| 84 | +- AutoHotkey U64 1.1.31+ |
| 85 | + |
| 86 | +#### DROPPED / DISCARDED: |
| 87 | +- Keep Serial active for 7 days before asking again (DRM Security Risk) |
| 88 | +- Change order of each individual Tunnel |
| 89 | +- IRC Notify |
| 90 | +- IRC Control Plugin |
| 91 | +- Telegram API Control Plugin |
| 92 | + |
| 93 | +#### BUGFIXES: |
| 94 | +- Too Many Hotkeys Triggered (1.2.22) |
| 95 | +- Profile Param had to be last param or else it wouldn't load (1.2.28) |
| 96 | + |
| 97 | +## Screenshots |
| 98 | +### Main Window |
| 99 | + |
| 100 | +### Server Settings |
| 101 | + |
| 102 | +### Notification Settings |
| 103 | + |
| 104 | + |
| 105 | +Tunnel Manager icon by [Hotpot.ai](https://hotpot.ai/) |
| 106 | + |
| 107 | +**Víctor Santiago Martínez Picardo (elModo7)** 17/JAN/2024 |
0 commit comments