63 lines
1.6 KiB
Markdown
63 lines
1.6 KiB
Markdown
|
# 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.
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
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.
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
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
|
|||
|
|
```bash
|
|||
|
|
sudo bash scripts/install.sh
|
|||
|
|
```
|
|||
|
|
Uninstall:
|
|||
|
|
```bash
|
|||
|
|
sudo bash scripts/uninstall.sh
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## 📖 Man Page
|
|||
|
|
```bash
|
|||
|
|
man backtunnel
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## 🧾 License
|
|||
|
|
Licensed under **GNU GPL v3.0**. See `LICENSE`.
|