BackTunnel/README.md

BackTunnel – Reverse SSH Folder Sharing Toolkit

Share and mount folders between Linux machines behind NAT/firewalls using two friendly commands.

✨ Commands

backtunnel-share

Start a reverse SSH tunnel from the sharing machine for a limited time.

backtunnel-share /path/to/folder with remoteuser:remotehost for <duration> [options]
# or: remoteuser@remotehost

Duration formats: 30m, 2h, 1d (passed to timeout)

Options

• -p, --tunnel-port <PORT>: Remote port to expose with -R (default: 2222)
• -l, --local-ssh-port <PORT>: Local sshd port to forward to (default: 22)

backtunnel-access

Mount a folder from the remote side via SSHFS.

backtunnel-access /path/to/folder from remoteuser:remotehost [options]
# or: remoteuser@remotehost

Options

• -p, --port <PORT>: Port on the remote host where the reverse tunnel listens (default: 2222)
• -m, --mount-point <PATH>: Local mount point (default: /mnt/remote-rssh)

🧰 Dolphin Service Menus

Two context actions for Dolphin:

• Share via BackTunnel… (right-click a folder on the sharing machine)
• Access via BackTunnel… (right-click a folder path on the remote machine)

Installed into:

• Plasma 6: /usr/share/kio/servicemenus/
• Plasma 5: /usr/share/kservices5/ServiceMenus/

🔐 Requirements

• ssh, sshfs, timeout, konsole, kdialog
• Optional: bash-completion

📦 Install

sudo bash scripts/install.sh

Uninstall:

sudo bash scripts/uninstall.sh

📖 Man Page

man backtunnel

🧾 License

Licensed under GNU GPL v3.0. See LICENSE.