- Python 68.8%
- HTML 16.1%
- Shell 13.7%
- PowerShell 0.8%
- Dockerfile 0.6%
| Filename | Latest commit message | Latest commit date |
|---|---|---|
|
All checks were successful
handbuch / publish (push) Successful in 17s
Wie bei bashclub-zsync: render.py publish aktualisiert die Seiten, deren aufbereiteter Text sich seit dem vorigen Stand geändert hat, und die Beschreibung der Collection. Workflow handbuch.yml prüft jeden PR und veröffentlicht jeden Push auf main, der das Handbuch ändert; von Hand gestartet alle Seiten. Secret OUTLINE_API_KEY. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Signed-off-by: Thorsten Spille <thorsten@spille-edv.de> |
||
| .forgejo/workflows | ||
| docs | ||
| install | ||
| jumphost | ||
| src/trmmwebrelay | ||
| tests | ||
| trmm-scripts | ||
| .gitignore | ||
| CLAUDE.md | ||
| config.example.toml | ||
| CONTRIBUTING.md | ||
| LICENSE | ||
| pyproject.toml | ||
| README.de.md | ||
| README.md | ||
TRMM Web-Relay
Like TRMM Web-Relay?
Development takes place at https://code.bashclub.org/bashclub/trmm-web-relay
Handbook (German, no login required): https://docs.bashclub.org/s/trmm-web-relay
Open web interfaces in customer networks on demand, without permanent VPN tunnels. One click on the local control page makes Tactical RMM start a time-limited reverse SOCKS tunnel on an agent at the customer site. A dedicated browser profile then opens the real address of the target, e.g. https://192.168.1.1.
- Nothing stays open: the tunnel exists only during the session and ends after idle time (30 min), after 4 h at most, or on "Beenden" (stop).
- No VPN server and no port forwarding at the customer: the TRMM agent connects outbound to a jump host run by the MSP.
- Short-lived certificates: the client signs throwaway keys for 15 minutes per session; the jump host checks site, port and source IP.
- Browser only: a dedicated browser profile talks to a local SOCKS router that only lets targets of active sessions through. Overlapping address ranges at different customers are no problem.
- Targets live in TRMM: web sites and preferred tunnel agents are two custom fields on the site, edited on the control page. No second inventory.
- Several TRMM servers per client, one at a time.
Agents: Linux and macOS (Windows planned). Client: Linux, macOS, Windows (Windows and macOS less tested). Jump host: Linux server with Podman 4.4 or newer.
Quick start
- Install the client (needs the OpenSSH client and Brave, Chromium, Chrome or Edge):
On Windows:git clone https://code.bashclub.org/bashclub/trmm-web-relay.git sh trmm-web-relay/install/client.shpowershell -ExecutionPolicy Bypass -File trmm-web-relay\install\client.ps1 - Prepare TRMM: create a user and role for the client (permissions
List Clients,List Agents,View Custom Fields,List Scripts,Run Scripts; for the setup alsoManage Custom Fields,Manage Scripts,Manage Sites) and an API key for that user. - Setup: double-click "TRMM Web-Relay", add the server, click "Prüfen" (check) and work through the steps (create fields and scripts in TRMM, create the CA).
- Jump host: download the installer in the setup and run it on a Linux server with Podman (
bash trmm-web-relay-sprunghost-*.sh), open TCP 22222, confirm the fingerprint in the client. - Use it: on the control page click "Bearbeiten" (edit) at a site, enter the web sites, click "Verbinden" (connect).
The user interface and the handbook are in German for now.
Commands
trmm-web-relay # start the client (like the double-click)
trmm-web-relay stop # stop the running client (like "Beenden" in the tray icon)
trmm-web-relay check # check the setup of all servers (read-only)
trmm-web-relay targets # show targets and tunnel agents from TRMM
trmm-web-relay desktop # create the launcher (--remove: remove it)
Support
- Help: handbook (German), especially Fehlerbehebung und FAQ (troubleshooting).
- Bugs, questions, wishes: issues. An account on code.bashclub.org is needed, you can sign in with GitHub.
- Commercial support, setup and maintenance: Spille IT Solutions, kontakt@spille-it.de.
- Support the development: ko-fi.com/thorakel.
License and contributing
GPL-3.0-or-later. Contributions as pull requests, see CONTRIBUTING.md.
Maintainer: Thorsten Spille, Spille IT Solutions, bashclub.