No description
  • Python 68.8%
  • HTML 16.1%
  • Shell 13.7%
  • PowerShell 0.8%
  • Dockerfile 0.6%
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
Thorsten Spille a2bc720fef
All checks were successful
handbuch / publish (push) Successful in 17s
Handbuch per CI nach Outline veröffentlichen
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>
2026-11-11 22:47:36 +01:00
.forgejo/workflows Handbuch per CI nach Outline veröffentlichen 2026-11-11 22:47:36 +01:00
docs Handbuch per CI nach Outline veröffentlichen 2026-11-11 22:47:36 +01:00
install TRMM Web-Relay 0.2.0 2026-11-08 14:01:38 +01:00
jumphost TRMM Web-Relay 0.2.0 2026-11-08 14:01:38 +01:00
src/trmmwebrelay Web Store: go-updater.brave.com freigeben 2026-11-11 16:29:59 +01:00
tests Web Store: go-updater.brave.com freigeben 2026-11-11 16:29:59 +01:00
trmm-scripts TRMM Web-Relay 0.2.0 2026-11-08 14:01:38 +01:00
.gitignore TRMM Web-Relay 0.2.0 2026-11-08 14:01:38 +01:00
CLAUDE.md Symbol im Infobereich und Befehl stop (0.5.0) 2026-11-11 14:03:05 +01:00
config.example.toml Hinweis auf neue Versionen, Browserprofil in der Einrichtung (0.4.0) 2026-11-08 19:06:07 +01:00
CONTRIBUTING.md TRMM Web-Relay 0.2.0 2026-11-08 14:01:38 +01:00
LICENSE TRMM Web-Relay 0.2.0 2026-11-08 14:01:38 +01:00
pyproject.toml Symbol im Infobereich und Befehl stop (0.5.0) 2026-11-11 14:03:05 +01:00
README.de.md Symbol im Infobereich und Befehl stop (0.5.0) 2026-11-11 14:03:05 +01:00
README.md Symbol im Infobereich und Befehl stop (0.5.0) 2026-11-11 14:03:05 +01:00

TRMM Web-Relay

Deutsch

Like TRMM Web-Relay?

Support the development

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

  1. Install the client (needs the OpenSSH client and Brave, Chromium, Chrome or Edge):
    git clone https://code.bashclub.org/bashclub/trmm-web-relay.git
    sh trmm-web-relay/install/client.sh
    
    On Windows: powershell -ExecutionPolicy Bypass -File trmm-web-relay\install\client.ps1
  2. 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 also Manage Custom Fields, Manage Scripts, Manage Sites) and an API key for that user.
  3. 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).
  4. 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.
  5. 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

License and contributing

GPL-3.0-or-later. Contributions as pull requests, see CONTRIBUTING.md.

Maintainer: Thorsten Spille, Spille IT Solutions, bashclub.