▀▀█▀▀ █  █ █▄ █ █▄ █ █▀▀ █   █▀▀ █▀█ █▀█ █▀▀ █▀▀
    █   █  █ █ ▀█ █ ▀█ █▀▀ █   █▀  █ █ █▀█ █ █ █▀▀
    █    ▀▀  █  █ █  █ ▀▀▀ ▀▀▀ █   ▀▀▀ █ █ ▀▀▀ ▀▀▀
  

The Ultimate Single-File SSH Tunnel Manager

One script. Every tunnel type. Full TUI. Live dashboard.
_{SOCKS5 • Local Forward • Remote Forward • Jump Hosts • TLS Obfuscation • Telegram Bot • Kill Switch • DNS Leak Protection}

---

Quick Start

One-line install:

curl -fsSL https://git.samnet.dev/SamNet-dev/tunnelforge/raw/branch/main/tunnelforge.sh -o tunnelforge.sh && sudo bash tunnelforge.sh install

Alternative (mirror, for restricted regions):

curl -fsSL https://dl.samnet.dev/SamNet-dev/tunnelforge/raw/branch/main/tunnelforge.sh -o tunnelforge.sh && sudo bash tunnelforge.sh install

Or clone the repo:

git clone https://git.samnet.dev/SamNet-dev/tunnelforge.git
cd tunnelforge
sudo bash tunnelforge.sh install

Launch the interactive menu:

tunnelforge menu

Or use CLI directly:

tunnelforge create                  # Create your first tunnel
tunnelforge start my-tunnel         # Start it
tunnelforge dashboard               # Watch it live

_{Interactive TUI — manage tunnels, security, services, and more from a single menu}

---

Why TunnelForge?

Most SSH tunnel tools are either too simple (just a wrapper around ssh -D) or too complex (requiring Docker, Go, Python, or a dozen config files). TunnelForge is different:

	TunnelForge	Others
Installation	Single bash file, zero dependencies	Python/Go/Node.js + package managers
Interface	Full TUI menu + CLI + live dashboard	CLI-only or web UI requiring a browser
Security	DNS leak protection, kill switch, audit scoring	Basic SSH only
Obfuscation	TLS wrapping + PSK to bypass DPI/censorship	Not available
Monitoring	Real-time sparkline bandwidth graphs	Log files
Notifications	Telegram bot with remote commands	None
Persistence	Auto-generated systemd services	Manual configuration
Education	Built-in Learn menu with diagrams	External docs
Client Sharing	One-click generated scripts (Linux + Windows)	Manual setup

TunnelForge is the most complete SSH tunnel manager available as a single file.

---

Features Overview

Tunnel Management

• SOCKS5 Dynamic Proxy (-D) — Route all traffic through SSH server
• Local Port Forwarding (-L) — Access remote services locally
• Remote/Reverse Forwarding (-R) — Expose local services remotely
• Jump Host / Multi-Hop (-J) — Chain through bastion servers
• AutoSSH Integration — Automatic reconnection on drop
• ControlMaster Multiplexing — Reuse SSH connections
• Multi-tunnel Support — Run dozens of tunnels simultaneously

Security

• DNS Leak Protection — Rewrites resolv.conf + locks with chattr
• Kill Switch — iptables rules block all traffic if tunnel drops (IPv4 + IPv6)
• 6-Point Security Audit — Scored assessment of your tunnel security posture
• SSH Key Generation — Create ed25519, RSA, or ECDSA keys
• SSH Key Deployment — One-command deploy to remote servers
• Host Fingerprint Verification — Verify server identity before connecting
• Server Hardening — Automated sshd, firewall, fail2ban, sysctl configuration

Monitoring & Dashboard

• Live TUI Dashboard — Real-time tunnel status with auto-refresh
• Sparkline Bandwidth Graphs — ASCII sparklines (▁▂▃▄▅▆▇█) for RX/TX
• Traffic Counters — Total bytes transferred per tunnel
• Uptime Tracking — Per-tunnel uptime display
• Connection Quality — Latency measurement with color-coded indicators
• Speed Test — Built-in download speed test through tunnel
• Pagination — Navigate across pages when running many tunnels

Telegram Bot

• Real-time Alerts — Start, stop, fail, reconnect notifications
• Remote Commands — /tf_status, /tf_list, /tf_ip, /tf_config and more
• Periodic Reports — Scheduled status reports to your phone
• Client Sharing — Send connection scripts + PSK via Telegram
• SOCKS5 Routing — Bot works through your tunnel when Telegram is blocked

TLS Obfuscation (Anti-Censorship)

• Outbound TLS Wrapping — SSH traffic disguised as HTTPS via stunnel
• Inbound PSK Protection — SOCKS5 listener secured with Pre-Shared Key
• Client Script Generator — Auto-generate connect scripts for Linux + Windows
• One-Click Server Setup — Automated stunnel installation and configuration
• DPI Bypass — Traffic appears as normal HTTPS on port 443

System Integration

• Systemd Service Generator — Auto-create hardened unit files
• Backup & Restore — Full configuration backup with rotation
• Server Setup Wizard — Harden a fresh server for receiving tunnels
• Profile Management — Create, edit, delete, import tunnel profiles
• Log Management — Per-tunnel logs with rotation
• Clean Uninstall — Complete removal of all files, services, and configs

Built-in Education

• Learn Menu — 9 interactive lessons on SSH tunneling concepts
• Scenario Examples — Step-by-step real-world use cases with diagrams
• ASCII Diagrams — Visual traffic flow for every tunnel type

---

Tunnel Types Explained

SOCKS5 Dynamic Proxy (-D)

Route all your TCP traffic through a remote SSH server. Your traffic appears to originate from the server's IP address.

┌──────────┐          ┌──────────┐          ┌──────────┐
│  Client   │  SSH     │  SSH     │  Direct  │  Target  │
│           ├─────────►│  Server  ├─────────►│  Website │
│ :1080     │ Encrypted│          │          │          │
└──────────┘          └──────────┘          └──────────┘
     ▲
  Browser
  SOCKS5

Use cases: Private browsing, bypass geo-restrictions, hide your IP, route traffic through a different country.

tunnelforge create    # Select "SOCKS5 Proxy" → set port 1080
tunnelforge start my-proxy
# Configure browser: SOCKS5 proxy → 127.0.0.1:1080
curl --socks5-hostname 127.0.0.1:1080 https://ifconfig.me

---

Local Port Forwarding (-L)

Access a remote service as if it were running locally. Map a local port to a service behind the SSH server.

┌──────────┐          ┌──────────┐          ┌──────────┐
│  Client   │  SSH     │  SSH     │  Local   │  MySQL   │
│           ├─────────►│  Server  ├─────────►│  :3306   │
│ :3306     │ Encrypted│          │ Network  │          │
└──────────┘          └──────────┘          └──────────┘
     ▲
  mysql -h
  127.0.0.1

Use cases: Access remote databases, internal web apps, admin panels behind firewalls.

tunnelforge create    # Select "Local Forward" → local 3306 → remote db:3306
tunnelforge start db-tunnel
mysql -h 127.0.0.1 -P 3306 -u admin -p

---

Remote/Reverse Forwarding (-R)

Expose a local service to the outside world through a remote SSH server. Users connect to the server and reach your local machine.

┌──────────┐          ┌──────────┐          ┌──────────┐
│  Local    │  SSH     │  SSH     │  Public  │  Users   │
│  Dev App  │◄────────►│  Server  │◄─────────│  on Web  │
│ :3000     │ Encrypted│ :9090    │          │          │
└──────────┘          └──────────┘          └──────────┘

Use cases: Webhook development, share local app for testing, NAT traversal, demo to clients.

tunnelforge create    # Select "Remote Forward" → remote 9090 ← local 3000
tunnelforge start dev-share
# Others access: http://your-server:9090

---

Jump Hosts / Multi-Hop (-J)

Reach servers behind multiple layers of firewalls by chaining through intermediate SSH servers.

┌──────────┐     ┌──────────┐     ┌──────────┐     ┌──────────┐
│  Client   │────►│  Bastion  │────►│  Jump 2   │────►│  Target  │
│           │ SSH │  Server   │ SSH │  Server   │ SSH │  Server  │
└──────────┘     └──────────┘     └──────────┘     └──────────┘

Use cases: Corporate networks, multi-tier architectures, isolated environments, high-security zones.

tunnelforge create    # Select "Jump Host" → jumps: admin@bastion:22
tunnelforge start corp-tunnel

---

Installation

Requirements

Requirement	Details
OS	Linux (Ubuntu, Debian, CentOS, Fedora, Arch, Alpine)
Bash	4.3 or higher
Privileges	Root access for installation
SSH	OpenSSH client (pre-installed on most systems)
Optional	autossh (auto-reconnect), stunnel (TLS obfuscation), sshpass (password auth)

Install

# Option 1: Git clone
git clone https://git.samnet.dev/SamNet-dev/tunnelforge.git
cd tunnelforge
sudo bash tunnelforge.sh install

# Option 2: Direct download
curl -fsSL https://git.samnet.dev/SamNet-dev/tunnelforge/raw/branch/main/tunnelforge.sh -o tunnelforge.sh
sudo bash tunnelforge.sh install

Alternative (mirror, for restricted regions):

curl -fsSL https://dl.samnet.dev/SamNet-dev/tunnelforge/raw/branch/main/tunnelforge.sh -o tunnelforge.sh && sudo bash tunnelforge.sh install

Verify Installation

tunnelforge version
# TunnelForge v1.0.0

Directory Structure

After installation, TunnelForge creates:

/opt/tunnelforge/
├── tunnelforge.sh              # Main script
├── config/
│   └── tunnelforge.conf        # Global configuration
├── profiles/
│   └── *.conf                  # Tunnel profiles
├── pids/                       # Running tunnel PIDs
├── logs/                       # Per-tunnel log files
├── backups/                    # Configuration backups
├── data/
│   ├── bandwidth/              # Bandwidth history (sparklines)
│   └── reconnects/             # Reconnect statistics
└── sockets/                    # SSH ControlMaster sockets

A symlink is created at /usr/local/bin/tunnelforge for global access.

---

Quick Examples

Browse Privately via SOCKS5

tunnelforge create
# → Name: private-proxy
# → Type: SOCKS5
# → Server: user@myserver.com
# → Port: 1080

tunnelforge start private-proxy

# Test it
curl --socks5-hostname 127.0.0.1:1080 https://ifconfig.me

# Configure Firefox: Settings → Network → Manual Proxy → SOCKS5: 127.0.0.1:1080

Access a Remote Database

tunnelforge create
# → Name: prod-db
# → Type: Local Forward
# → Server: admin@db-server.internal
# → Local port: 3306 → Remote: localhost:3306

tunnelforge start prod-db
mysql -h 127.0.0.1 -P 3306 -u dbuser -p

Share Your Local Dev Server

tunnelforge create
# → Name: demo-share
# → Type: Remote Forward
# → Server: user@public-vps.com
# → Remote port: 8080 ← Local: localhost:3000

tunnelforge start demo-share
# Share with anyone: http://public-vps.com:8080

Chain Through Jump Hosts

tunnelforge create
# → Name: corp-access
# → Type: Jump Host
# → Jump: admin@bastion.corp.com:22
# → Target: user@internal-server:22
# → SOCKS5 port: 1080

tunnelforge start corp-access

Bypass Censorship with TLS Obfuscation

# First, set up stunnel on your VPS
tunnelforge obfs-setup my-tunnel

# Now SSH traffic is wrapped in TLS on port 443
# DPI sees: normal HTTPS traffic
# Reality: SSH tunnel inside TLS
tunnelforge start my-tunnel

# Share with others
tunnelforge client-script my-tunnel    # Generates connect scripts
tunnelforge telegram share my-tunnel   # Send scripts via Telegram

---

CLI Reference

Tunnel Commands

Command	Description
tunnelforge start <name>	Start a tunnel
tunnelforge stop <name>	Stop a tunnel
tunnelforge restart <name>	Restart a tunnel
tunnelforge start-all	Start all autostart tunnels
tunnelforge stop-all	Stop all running tunnels
tunnelforge status	Show all tunnel statuses
tunnelforge dashboard	Launch live TUI dashboard
tunnelforge logs [name]	Tail tunnel logs

Profile Commands

Command	Description
tunnelforge create	Create a new tunnel profile (wizard)
tunnelforge list	List all profiles
tunnelforge delete <name>	Delete a profile

Security Commands

Command	Description
tunnelforge audit	Run 6-point security audit
tunnelforge key-gen [type]	Generate SSH key (ed25519/rsa/ecdsa)
tunnelforge key-deploy <name>	Deploy SSH key to server
tunnelforge fingerprint <host> [port]	Verify SSH host fingerprint

Telegram Commands

Command	Description
tunnelforge telegram setup	Configure Telegram bot
tunnelforge telegram test	Send test notification
tunnelforge telegram status	Show notification config
tunnelforge telegram send <msg>	Send a message
tunnelforge telegram report	Send status report
tunnelforge telegram share [name]	Share client scripts via Telegram

Service Commands

Command	Description
tunnelforge service <name>	Generate systemd service
tunnelforge service <name> enable	Enable and start service
tunnelforge service <name> disable	Disable and stop service
tunnelforge service <name> status	Show service status
tunnelforge service <name> remove	Remove service file

System Commands

Command	Description
tunnelforge menu	Launch interactive TUI
tunnelforge install	Install TunnelForge
tunnelforge server-setup	Harden server for tunnels
tunnelforge obfs-setup <name>	Set up TLS obfuscation
tunnelforge client-config <name>	Show client connection config
tunnelforge client-script <name>	Generate client scripts
tunnelforge backup	Backup all configs
tunnelforge restore [file]	Restore from backup
tunnelforge uninstall	Remove everything
tunnelforge version	Show version
tunnelforge help	Show help

---

Interactive TUI Menu

Launch with tunnelforge menu or just tunnelforge (no arguments):

╔══════════════════════════════════════════════════════════════╗
║              TunnelForge — Main Menu                         ║
╚══════════════════════════════════════════════════════════════╝

  ── Tunnels ──
    1) Create new tunnel            Setup wizard
    2) Start a tunnel               Launch SSH tunnel
    3) Stop a tunnel                Terminate tunnel
    4) Start All tunnels            Launch autostart tunnels
    5) Stop All tunnels             Terminate all

  ── Monitoring ──
    6) Status                       Show tunnel statuses
    7) Dashboard                    Live TUI dashboard

  ── Management ──
    8) Profiles                     Manage tunnel profiles
    9) Settings                     Configure defaults
    s) Services                     Systemd service manager
    b) Backup / Restore             Manage backups

  ── Security ──
    x) Security Audit               Check security posture
    k) SSH Key Management            Generate & deploy keys
    f) Fingerprint Check             Verify host fingerprints

  ── Extras ──
    t) Telegram                     Notification settings
    c) Client Configs               TLS+PSK connection info
    e) Examples                     Real-world scenarios
    l) Learn                        SSH tunnel concepts
    a) About                        Version & info

    u) Uninstall
    q) Quit

  Select:

Navigate by pressing a single key. No Enter needed. Every menu is keyboard-driven.

---

Live Dashboard

Launch with tunnelforge dashboard or press 7 in the main menu:

_{Live dashboard with sparkline bandwidth graphs, active connections, reconnect log, and system resources}

╔══════════════════════════════════════════════════════════════╗
║              TunnelForge Dashboard v1.0.0                    ║
║              Page 1/2  │  2026-02-07 14:32:15                ║
╚══════════════════════════════════════════════════════════════╝

  NAME              TYPE     STATUS     LOCAL             UPTIME
  ────────────────────────────────────────────────────────────
  iran-proxy        SOCKS5   ● ALIVE    127.0.0.1:1080    2h 8m
    RX ▁▂▃▅▇█▇▅▃▂  412.3 MB    TX ▁▁▂▃▅▇▅▃  82.1 MB

  t1-socks5         SOCKS5   ● ALIVE    127.0.0.1:4001    2h 9m
    RX ▁▁▁▂▂▃▂▁▁▁  96.7 KB     TX ▁▁▁▁▂▂▁▁  12.3 KB

  db-tunnel         LOCAL    ■ STOPPED  127.0.0.1:3306       —

  dev-share         REMOTE   ● ALIVE    0.0.0.0:9090      45m
    RX ▁▂▂▃▃▂▁▁▁▁  1.2 MB      TX ▁▁▁▂▃▅▃▂  890 KB

  ── Active Connections ──
  iran-proxy       : 3 connections
  t1-socks5        : 1 connection

  ── Recent Log ──
  14:32:10 [info] Tunnel 'iran-proxy' reconnected (AutoSSH)
  14:30:05 [info] Speed test: 12.4 Mbps via iran-proxy

  s=start t=stop r=restart c=create p=speed g=qlty q=quit [</>]

Dashboard Keyboard Controls

Key	Action
s	Start a tunnel
t	Stop a tunnel
r	Restart all running tunnels
c	Create a new profile
p	Run speed test
g	Check connection quality
[ / ]	Previous / next page
q	Exit dashboard

What It Shows

• Status — Live running/stopped state per tunnel
• Uptime — How long each tunnel has been connected
• Sparkline Graphs — Real-time bandwidth visualization using 8 levels (▁▂▃▄▅▆▇█)
• Traffic Totals — Cumulative RX/TX bytes per tunnel
• Active Connections — Number of established TCP connections through each tunnel
• Recent Logs — Last 4 log entries across all tunnels
• Pagination — Automatically pages when running 5+ tunnels

---

Security Features

DNS Leak Protection

Prevents DNS queries from bypassing the tunnel and revealing your real location.

How it works:

1. Backs up your current /etc/resolv.conf
2. Rewrites it to use only tunnel-safe DNS servers (default: 8.8.8.8, 8.8.4.4)
3. Locks the file with chattr +i (immutable) to prevent system overrides
4. Automatically restores original DNS when tunnel stops

# Enable per-profile in the wizard or editor
# Verify with:
tunnelforge audit    # Check DNS leak protection status

Kill Switch

If the tunnel drops, all internet traffic is blocked to prevent data leaks.

How it works:

1. Creates a custom TUNNELFORGE iptables chain
2. Allows only SSH tunnel traffic + loopback
3. Blocks everything else (IPv4 + IPv6)
4. Automatically removes rules when tunnel stops or is manually disabled

# Enable per-profile in the wizard or editor
# Verify with:
tunnelforge audit    # Check kill switch status

SSH Key Management

# Generate a new key
tunnelforge key-gen ed25519      # Recommended (fast, secure)
tunnelforge key-gen rsa          # 4096-bit RSA (broad compatibility)
tunnelforge key-gen ecdsa        # ECDSA alternative

# Deploy to a tunnel's server
tunnelforge key-deploy my-tunnel

Host Fingerprint Verification

Verify a server's SSH fingerprint before trusting it:

tunnelforge fingerprint myserver.com 22
# Displays SHA256 and MD5 fingerprints
# Compare against your server's known fingerprint

6-Point Security Audit

Scores your security posture out of 100 points:

tunnelforge audit

Check	What It Verifies
SSH Key Permissions	Private keys are 600 or 400
SSH Directory	~/.ssh is 700
DNS Leak Protection	Active DNS protection on running tunnels
Kill Switch	iptables chain is active
Tunnel Integrity	PIDs are valid, processes running
System Packages	Required security tools installed

Server Hardening

Prepare a fresh server to receive SSH tunnels securely:

tunnelforge server-setup

What it configures:

• SSH daemon — Disable password auth, disable root login, custom port
• Firewall — UFW/iptables rules for SSH + tunnel ports only
• Fail2ban — Auto-ban after failed login attempts
• Kernel — Sysctl hardening (SYN flood protection, ICMP redirects, IP forwarding)

---

TLS Obfuscation (Anti-Censorship)

In networks with Deep Packet Inspection (DPI), SSH traffic can be detected and blocked. TunnelForge wraps your SSH connection inside a TLS layer, making it look like normal HTTPS traffic.

How It Works

Without TLS Obfuscation:
Client ──── SSH (detectable) ────► VPS          ← DPI can block this

With TLS Obfuscation:
Client ──── TLS/443 (looks like HTTPS) ────► VPS ──── SSH ────► Internet
                                              ▲
                                          stunnel
                                          unwraps TLS

Setup (Server Side)

# Automatically installs stunnel, generates TLS cert, configures port mapping
tunnelforge obfs-setup my-tunnel

This will:

1. Install stunnel on the remote server
2. Generate a self-signed TLS certificate
3. Map port 443 (TLS) → port 22 (SSH)
4. Enable as a systemd service
5. Open the firewall port

Inbound PSK Protection

Protect your local SOCKS5 listener with a Pre-Shared Key. Without the PSK, nobody can connect to your tunnel — even if they find the port.

Client with PSK ──── TLS+PSK ────► Your Machine ──── SOCKS5 ────► Tunnel
Unauthorized     ──── TLS ────► Your Machine ──── REJECTED

Share With Others

Generate standalone connect scripts that anyone can use:

# Generate Linux + Windows scripts
tunnelforge client-script my-tunnel

# Share via Telegram (sends scripts + PSK + instructions)
tunnelforge telegram share my-tunnel

Generated scripts include:

• tunnelforge-connect.sh — Linux bash script (./connect.sh start|stop|status)
• tunnelforge-connect.ps1 — Windows PowerShell script

Both scripts auto-configure stunnel, create PSK files, and manage the connection lifecycle.

Standalone Windows Client

TunnelForge also ships with windows-client/tunnelforge-client.bat — a ready-to-distribute Windows batch client. Users just double-click it, paste their connection details, and they're connected. No PowerShell required.

Features:

• Interactive setup — prompts for server, port, and PSK
• Auto-installs stunnel (via winget, Chocolatey, or manual download link)
• Saves connection for instant reconnect
• Commands: tunnelforge-client.bat stop / status
• Prints browser proxy setup instructions (Firefox + Chrome)

How to distribute:
1. Send windows-client/tunnelforge-client.bat to the user
2. Give them the PSK + server info (from: tunnelforge client-config <profile>)
3. User double-clicks the .bat → enters details → connected

---

Telegram Bot

Get real-time tunnel notifications on your phone and control tunnels remotely.

Setup

tunnelforge telegram setup

1. Create a bot — Talk to @BotFather on Telegram, send /newbot
2. Enter your token — Paste the bot token into TunnelForge
3. Get your Chat ID — Send /start to your bot, TunnelForge auto-detects your ID
4. Done — You'll receive a test message confirming setup

Notifications You'll Receive

Event	Message
Tunnel started	Profile name, PID, tunnel type
Tunnel stopped	Profile name
Tunnel failed	Error details
Tunnel reconnected	AutoSSH auto-recovery
Security alert	DNS leak or kill switch event
Status report	All tunnels overview (periodic)

Bot Commands

Send these commands to your bot from Telegram:

Command	Response
/tf_status	All tunnel statuses
/tf_list	List all profiles
/tf_ip	Server's public IP
/tf_config	Client connection configs (PSK info)
/tf_uptime	Server uptime
/tf_report	Full status report
/tf_help	Available commands

Configuration

tunnelforge telegram status     # View current config
tunnelforge telegram test       # Send test message
tunnelforge telegram send "Hello from TunnelForge!"

Enable periodic reports (e.g., every hour):

Settings → Telegram → Toggle Status Reports → Set Interval

---

Systemd Services

Make your tunnels survive reboots with auto-generated systemd service files.

Usage

# Generate a service file
tunnelforge service my-tunnel

# Enable and start (survives reboot)
tunnelforge service my-tunnel enable

# Check status
tunnelforge service my-tunnel status

# Disable
tunnelforge service my-tunnel disable

# Remove service file
tunnelforge service my-tunnel remove

Generated Service Features

The auto-generated unit file includes security hardening:

• ProtectSystem=strict — Read-only filesystem
• ProtectHome=tmpfs — Isolated home directory
• PrivateTmp=true — Private temp directory
• CAP_NET_ADMIN — Only if kill switch is enabled
• CAP_LINUX_IMMUTABLE — Only if DNS leak protection is enabled
• Automatic restart policies
• Proper start/stop timeouts

---

Backup & Restore

Backup

tunnelforge backup

Creates a timestamped .tar.gz archive containing:

• All tunnel profiles
• Global configuration
• SSH keys (if stored in TunnelForge directory)
• Systemd service files

Backups are stored in /opt/tunnelforge/backups/ with automatic rotation.

Restore

# Restore from latest backup
tunnelforge restore

# Restore from specific file
tunnelforge restore /path/to/backup.tar.gz

---

Configuration Reference

Global Config (/opt/tunnelforge/config/tunnelforge.conf)

Setting	Default	Description
SSH_DEFAULT_USER	root	Default SSH username
SSH_DEFAULT_PORT	22	Default SSH port
SSH_DEFAULT_KEY	—	Default identity key path
SSH_CONNECT_TIMEOUT	10	Connection timeout (seconds)
AUTOSSH_ENABLED	true	Enable AutoSSH by default
AUTOSSH_POLL	30	AutoSSH poll interval (seconds)
CONTROLMASTER_ENABLED	false	SSH connection multiplexing
LOG_LEVEL	info	Logging verbosity (debug/info/warn/error)
DASHBOARD_REFRESH	3	Dashboard refresh rate (seconds)
DNS_LEAK_PROTECTION	false	DNS leak protection default
KILL_SWITCH	false	Kill switch default
TELEGRAM_ENABLED	false	Enable Telegram notifications
TELEGRAM_BOT_TOKEN	—	Bot token from @BotFather
TELEGRAM_CHAT_ID	—	Your Telegram chat ID
TELEGRAM_ALERTS	true	Send tunnel event alerts
TELEGRAM_PERIODIC_STATUS	false	Send periodic reports
TELEGRAM_STATUS_INTERVAL	3600	Report interval (seconds)

Profile Fields

Each tunnel profile (/opt/tunnelforge/profiles/<name>.conf) contains:

Field	Description
TUNNEL_TYPE	socks5, local, remote, or jump
SSH_HOST	Server hostname or IP
SSH_PORT	SSH port (default 22)
SSH_USER	SSH username
SSH_PASSWORD	SSH password (optional)
IDENTITY_KEY	Path to SSH private key
LOCAL_BIND_ADDR	Local bind address
LOCAL_PORT	Local port number
REMOTE_HOST	Remote target host
REMOTE_PORT	Remote target port
JUMP_HOSTS	Comma-separated jump hosts
SSH_OPTIONS	Extra SSH flags
AUTOSSH_ENABLED	AutoSSH toggle
DNS_LEAK_PROTECTION	DNS protection toggle
KILL_SWITCH	Kill switch toggle
AUTOSTART	Start on boot
OBFS_MODE	none or stunnel
OBFS_PORT	TLS obfuscation port
OBFS_LOCAL_PORT	Inbound TLS+PSK port
OBFS_PSK	Pre-Shared Key (hex)
DESCRIPTION	Profile description

---

Real-World Scenarios

Each scenario below is expandable and shows the exact wizard steps you'll follow. Both SSH-only and TLS-encrypted variants are covered where applicable.

Scenario 1: Private Browsing via SOCKS5

Goal: Route all your browser traffic through a VPS so websites see the VPS IP instead of yours.

Your PC :1080 ──── SSH (Encrypted) ────► VPS ──── Direct ────► Internet
                                         ▲
                                    Websites see
                                    the VPS IP

What you need: A VPS or remote server with SSH access.

Wizard Steps (SSH-only)

tunnelforge create

Step	Prompt	What to enter
1	Profile name	private-proxy
2	Tunnel type	1 — SOCKS5 Proxy
3	SSH host	Your VPS IP (e.g. 45.33.32.10)
4	SSH port	22 (default)
5	SSH user	root (or your username)
6	SSH password	Your password (or Enter to skip for key auth)
7	Identity key	~/.ssh/id_ed25519 (or Enter to skip)
8	Auth test	Automatic — verifies connection
9a	Bind address	127.0.0.1 (local only) or 0.0.0.0 (share with LAN)
9b	SOCKS5 port	1080
10	Connection mode	1 — Regular SSH
11	Inbound protection	1 — None
12	AutoSSH	y (recommended)
13	Save & start	y then y

Wizard Steps (TLS-encrypted — for censored networks)

Same as above, but at step 10:

Step	Prompt	What to enter
10	Connection mode	2 — TLS Encrypted
10a	TLS port	443 (looks like HTTPS)
10b	Setup stunnel now?	y (auto-installs on server)
11	Inbound protection	1 — None (you're the only user)

After Starting

Firefox:

1. Settings → search "proxy" → Manual proxy configuration
2. SOCKS Host: 127.0.0.1 — Port: 1080
3. Select "SOCKS v5"
4. Check "Proxy DNS when using SOCKS v5"

Chrome:

google-chrome --proxy-server="socks5://127.0.0.1:1080"

Test it works:

curl --socks5-hostname 127.0.0.1:1080 https://ifconfig.me
# Should show your VPS IP, not your real IP

Scenario 2: Access a Remote Database

Goal: Access MySQL/PostgreSQL running on your VPS as if it were on your local machine.

Your PC :3306 ──── SSH (Encrypted) ────► VPS ──── Local ────► MySQL :3306

What you need: A VPS with a database running (e.g. MySQL on port 3306).

Wizard Steps

tunnelforge create

Step	Prompt	What to enter
1	Profile name	prod-db
2	Tunnel type	2 — Local Port Forward
3	SSH host	Your VPS IP (e.g. 45.33.32.10)
4	SSH port	22
5	SSH user	root
6	SSH password	Your password (or Enter to skip)
7	Identity key	Enter to skip (or path to key)
8	Auth test	Automatic
9a	Bind address	127.0.0.1
9b	Local port	3306 (port on YOUR machine)
9c	Remote host	127.0.0.1 (means "on the VPS itself")
9d	Remote port	3306 (MySQL port on VPS)
10	Connection mode	1 — Regular SSH
11	Inbound protection	1 — None
12	AutoSSH	y
13	Save & start	y then y

After Starting

# MySQL
mysql -h 127.0.0.1 -P 3306 -u dbuser -p

# PostgreSQL (change ports to 5432)
psql -h 127.0.0.1 -p 5432 -U postgres

# Redis (change ports to 6379)
redis-cli -h 127.0.0.1 -p 6379

# Web admin panel (change ports to 8080)
# Open browser: http://127.0.0.1:8080

Common Variations

Service	Local Port	Remote Port
MySQL	3306	3306
PostgreSQL	5432	5432
Redis	6379	6379
Web panel	8080	8080
MongoDB	27017	27017

Tip: Set Remote host to another IP on the VPS network (e.g. 10.0.0.5) to reach a database on a private subnet that only the VPS can access.

Scenario 3: Share Your Local Dev Server

Goal: You have a website running locally (e.g. on port 3000) and want others on the internet to access it through your VPS.

Local App :3000 ◄──── SSH (Encrypted) ────► VPS :9090 ◄──── Users on Web

What you need: A local service running + a VPS with a public IP.

Wizard Steps

tunnelforge create

Step	Prompt	What to enter
1	Profile name	dev-share
2	Tunnel type	3 — Remote/Reverse Forward
3	SSH host	Your VPS IP (e.g. 45.33.32.10)
4	SSH port	22
5	SSH user	root
6	SSH password	Your password
7	Identity key	Enter to skip
8	Auth test	Automatic
9a	Remote bind	0.0.0.0 (public access — requires GatewayPorts yes in sshd)
9b	Remote port	9090 (port on VPS others connect to)
9c	Local host	127.0.0.1 (this machine)
9d	Local port	3000 (your running app)
10	Connection mode	1 — Regular SSH
11	Inbound protection	1 — None
12	AutoSSH	y
13	Save & start	y then y

Important: Enable GatewayPorts

If using 0.0.0.0 bind (public access), your VPS sshd needs:

# On VPS: edit /etc/ssh/sshd_config
GatewayPorts yes

# Then restart sshd
sudo systemctl restart sshd

If using 127.0.0.1 bind, the port is only accessible from the VPS itself.

After Starting

# Make sure your local service is running first:
python3 -m http.server 3000    # or: npm start, etc.

# Test from VPS (SSH into it):
curl http://localhost:9090

# Test from anywhere (if bind is 0.0.0.0):
curl http://45.33.32.10:9090

# Share with clients:
# "Visit http://45.33.32.10:9090 to see the demo"

Common Use Cases

Use Case	Local Port	What's Exposed
Node.js dev server	3000	Web app
React/Vue dev server	5173	Frontend
Webhook receiver	8080	API endpoint
SSH to home PC	22	SSH access

Scenario 4: Multi-Hop Through Bastion / Jump Hosts

Goal: Reach a server that is NOT directly accessible from the internet. You hop through one or more intermediate servers.

Your PC ── SSH ──► Bastion (public) ── SSH ──► Target (hidden)

What you need: SSH access to the jump/bastion server + the target server.

Wizard Steps (SOCKS5 at target)

tunnelforge create

Step	Prompt	What to enter
1	Profile name	corp-access
2	Tunnel type	4 — Jump Host
3	SSH host	Target IP (e.g. 10.0.50.100)
4	SSH port	22
5	SSH user	admin (user on target)
6	SSH password	Password for target
7	Identity key	Key for target
8	Auth test	May fail (target not reachable directly) — continue anyway
9a	Jump hosts	root@bastion.example.com:22
9b	Tunnel type at destination	1 — SOCKS5 Proxy
9c	Bind address	127.0.0.1
9d	SOCKS5 port	1080
10	Connection mode	1 — Regular SSH
11	Inbound protection	1 — None
12	AutoSSH	y
13	Save & start	y then y

Important: Step 3-7 are for the TARGET server. Jump host credentials go in step 9a using the format user@host:port.

Wizard Steps (Local Forward at target)

Same as above, but at step 9:

Step	Prompt	What to enter
9a	Jump hosts	root@bastion.example.com:22
9b	Tunnel type at destination	2 — Local Port Forward
9c	Bind address	127.0.0.1
9d	Local port	8080
9e	Remote host	127.0.0.1 (on the target)
9f	Remote port	80 (web server on target)

Multiple Jump Hosts

Chain through several servers by comma-separating them:

Jump hosts: user1@hop1.com:22,user2@hop2.com:22

Your PC ──► hop1.com ──► hop2.com ──► Target

After Starting

# SOCKS5 mode — set browser proxy:
# 127.0.0.1:1080

# Local Forward mode — open in browser:
# http://127.0.0.1:8080 → shows target's web server

Scenario 5: Bypass DPI Censorship (Single VPS)

Goal: Your ISP uses Deep Packet Inspection (DPI) to detect and block SSH traffic. Wrap SSH in TLS so it looks like normal HTTPS.

Without TLS:  Your PC ──── SSH (blocked by DPI) ────► VPS
With TLS:     Your PC ──── TLS/443 (looks like HTTPS) ────► VPS ──► Internet

What you need: 1 VPS outside the censored network.

Wizard Steps

tunnelforge create

Step	Prompt	What to enter
1	Profile name	bypass-proxy
2	Tunnel type	1 — SOCKS5 Proxy
3	SSH host	Your VPS IP (e.g. 45.33.32.10)
4	SSH port	22
5	SSH user	root
6	SSH password	Your password
7	Identity key	Enter to skip
8	Auth test	Automatic
9a	Bind address	127.0.0.1
9b	SOCKS5 port	1080
10	Connection mode	2 — TLS Encrypted
10a	TLS port	443 (mimics HTTPS — most effective)
10b	Setup stunnel on server?	y (auto-installs stunnel on VPS)
11	Inbound protection	1 — None (you're connecting directly)
12	AutoSSH	y
13	Save & start	y then y

What Happens Behind the Scenes

1. TunnelForge installs stunnel on your VPS
2. Stunnel listens on port 443 (TLS) and forwards to SSH port 22
3. Your local SSH client connects through stunnel via openssl s_client
4. DPI only sees a TLS handshake on port 443 — indistinguishable from HTTPS

After Starting

# Set browser SOCKS5 proxy: 127.0.0.1:1080
curl --socks5-hostname 127.0.0.1:1080 https://ifconfig.me
# Shows VPS IP — you're browsing through TLS-wrapped SSH

What DPI Sees

Your PC ──── HTTPS traffic on port 443 ────► VPS IP
Verdict: Normal website browsing. Allowed.

Scenario 6: Double-Hop TLS Chain (Two VPS)

Goal: Run a shared proxy for multiple users. VPS-A is the entry point (relay). VPS-B is the exit point. Both legs are TLS-encrypted. Users connect with a PSK.

Users ── TLS+PSK:1443 ──► VPS-A (relay) ── TLS:443 ──► VPS-B (exit) ──► Internet
                           stunnel+PSK        stunnel
                           SOCKS5:1080        SSH:22

What you need: 2 VPS servers. VPS-A = relay (can be in censored country). VPS-B = exit (outside).

Wizard Steps (run on VPS-A)

Install TunnelForge on VPS-A, then:

tunnelforge create

Step	Prompt	What to enter
1	Profile name	double-hop
2	Tunnel type	1 — SOCKS5 Proxy
3	SSH host	VPS-B IP (e.g. 203.0.113.50)
4	SSH port	22
5	SSH user	root
6	SSH password	VPS-B password
7	Identity key	Enter to skip
8	Auth test	Automatic
9a	Bind address	127.0.0.1 (stunnel handles external)
9b	SOCKS5 port	1080
10	Connection mode	2 — TLS Encrypted
10a	TLS port	443
10b	Setup stunnel on VPS-B?	y
11	Inbound protection	2 — TLS + PSK
11a	Inbound TLS port	1443 (users connect here)
11b	PSK	Auto-generated (saved in profile)
12	AutoSSH	y
13	Save & start	y then y

Generate Client Scripts for Users

# On VPS-A after tunnel is running:
tunnelforge client-script double-hop

# Creates:
#   tunnelforge-connect.sh   (Linux)
#   tunnelforge-connect.ps1  (Windows)

# Or send via Telegram:
tunnelforge telegram share double-hop

What Users Do

Linux:

chmod +x tunnelforge-connect.sh
./tunnelforge-connect.sh          # Connect
./tunnelforge-connect.sh stop     # Disconnect
./tunnelforge-connect.sh status   # Check
# Set browser proxy: 127.0.0.1:1080

Windows PowerShell:

powershell -ExecutionPolicy Bypass -File tunnelforge-connect.ps1          # Connect
powershell -ExecutionPolicy Bypass -File tunnelforge-connect.ps1 stop     # Disconnect
powershell -ExecutionPolicy Bypass -File tunnelforge-connect.ps1 status   # Check
# Set browser proxy: 127.0.0.1:1080

Windows Batch (standalone client):

tunnelforge-client.bat            # Double-click, enter server/port/PSK
tunnelforge-client.bat stop       # Disconnect
tunnelforge-client.bat status     # Check
# Set browser proxy: 127.0.0.1:1080

What DPI Sees

User PC ──── HTTPS:1443 ──► VPS-A IP     (normal TLS)
VPS-A   ──── HTTPS:443  ──► VPS-B IP     (normal TLS)
No SSH protocol visible anywhere in the chain.

Scenario 7: Share Your Tunnel With Others

Goal: You have a working tunnel with TLS+PSK protection and want to give others access. TunnelForge generates a standalone script they just run.

What you need: A running tunnel with Inbound TLS+PSK enabled (see Scenario 5 or 6).

Step 1 — Generate Client Scripts

tunnelforge client-script my-tunnel

This creates two files:

• tunnelforge-connect.sh — for Linux/Mac
• tunnelforge-connect.ps1 — for Windows PowerShell

Each script contains your server address, port, and PSK — everything needed to connect.

Or use the standalone Windows client: Send users windows-client/tunnelforge-client.bat from the repo — they double-click it, enter connection details, and they're connected. No scripts to generate.

Step 2 — Send to Users

Share via:

• Telegram: tunnelforge telegram share my-tunnel
• WhatsApp, email, USB drive, or any file transfer method
• For Windows users: also send windows-client/tunnelforge-client.bat (or just send the .bat alone with PSK info)

Step 3 — User Runs the Script

Linux:

chmod +x tunnelforge-connect.sh
./tunnelforge-connect.sh            # Connect (auto-installs stunnel if needed)
./tunnelforge-connect.sh stop       # Disconnect
./tunnelforge-connect.sh status     # Check connection

Windows (PowerShell — generated script):

powershell -ExecutionPolicy Bypass -File tunnelforge-connect.ps1
powershell -ExecutionPolicy Bypass -File tunnelforge-connect.ps1 stop
powershell -ExecutionPolicy Bypass -File tunnelforge-connect.ps1 status

Windows (Batch — standalone client):

tunnelforge-client.bat              # Double-click or run — enter server/port/PSK when prompted
tunnelforge-client.bat stop         # Disconnect
tunnelforge-client.bat status       # Check connection

All clients automatically:

1. Install stunnel if not present (winget/Chocolatey/apt)
2. Write config files locally
3. Start stunnel and create a local SOCKS5 proxy
4. Print browser setup instructions (Firefox + Chrome)

After Connecting

Browser proxy: 127.0.0.1:1080
All traffic routes through the tunnel.

View Connection Info Without Scripts

# Show PSK + server + port info (for manual setup):
tunnelforge client-config my-tunnel

Revoking Access

To revoke a user's access:

1. Edit the profile and regenerate the PSK
2. Regenerate client scripts: tunnelforge client-script my-tunnel
3. Restart the tunnel: tunnelforge restart my-tunnel
4. Old scripts will no longer work — distribute the new ones to authorized users only

---

Learn Menu (Built-in Education)

TunnelForge includes an interactive learning system accessible from the main menu (l key) or CLI. Each topic includes explanations, ASCII diagrams, and practical examples.

#	Topic	Description
1	What is an SSH Tunnel?	Encrypted channel fundamentals
2	SOCKS5 Dynamic Proxy	Route all traffic through -D flag
3	Local Port Forwarding	Access remote services via -L flag
4	Remote/Reverse Forwarding	Expose local services via -R flag
5	Jump Hosts & Multi-hop	Chain through bastions via -J flag
6	ControlMaster Multiplexing	Reuse SSH connections for speed
7	AutoSSH & Reconnection	Automatic tunnel recovery
8	What is TLS Obfuscation?	Wrap SSH in TLS to bypass DPI
9	PSK Authentication	Pre-Shared Key for tunnel security

---

License & Author

TunnelForge is licensed under the GNU General Public License v3.0.

Copyright (C) 2026 SamNet Technologies, LLC

This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.

---

  ▀▀█▀▀ █  █ █▄ █ █▄ █ █▀▀ █   █▀▀ █▀█ █▀█ █▀▀ █▀▀
    █   █  █ █ ▀█ █ ▀█ █▀▀ █   █▀  █ █ █▀█ █ █ █▀▀
    █    ▀▀  █  █ █  █ ▀▀▀ ▀▀▀ █   ▀▀▀ █ █ ▀▀▀ ▀▀▀
  

کامل‌ترین مدیر تانل SSH در یک فایل

یک اسکریپت. همه انواع تانل. رابط کاربری کامل. داشبورد زنده..
_{SOCKS5 • Local Forward • Remote Forward • Jump Host • رمزنگاری TLS • ربات تلگرام • Kill Switch • محافظت DNS}

---

شروع سریع

نصب با یک دستور:

curl -fsSL https://git.samnet.dev/SamNet-dev/tunnelforge/raw/branch/main/tunnelforge.sh -o tunnelforge.sh && sudo bash tunnelforge.sh install

جایگزین (میرور، برای مناطق محدود):

curl -fsSL https://dl.samnet.dev/SamNet-dev/tunnelforge/raw/branch/main/tunnelforge.sh -o tunnelforge.sh && sudo bash tunnelforge.sh install

یا کلون ریپو:

git clone https://git.samnet.dev/SamNet-dev/tunnelforge.git
cd tunnelforge
sudo bash tunnelforge.sh install

اجرای منوی تعاملی:

tunnelforge menu

یا استفاده مستقیم از CLI:

tunnelforge create                  # ساخت اولین تانل
tunnelforge start my-tunnel         # شروع تانل
tunnelforge dashboard               # داشبورد زنده

_{رابط کاربری تعاملی — مدیریت تانل‌ها، امنیت، سرویس‌ها و بیشتر از یک منو}

---

چرا TunnelForge؟

بیشتر ابزارهای مدیریت تانل SSH یا خیلی ساده هستند (فقط یک wrapper روی ssh -D) یا خیلی پیچیده (نیاز به Docker، Go، Python یا دهها فایل تنظیمات). TunnelForge متفاوت است:

	TunnelForge	سایر ابزارها
نصب	یک فایل bash، بدون وابستگی	Python/Go/Node.js + package manager
رابط کاربری	منوی TUI کامل + CLI + داشبورد زنده	فقط CLI یا Web UI
امنیت	محافظت DNS، کیل سوییچ، امتیازدهی امنیتی	فقط SSH ساده
رمزنگاری	پوشش TLS + PSK برای عبور از DPI	ندارد
مانیتورینگ	نمودار پهنای باند لحظه‌ای	فایل‌های لاگ
اطلاع‌رسانی	ربات تلگرام با دستورات ریموت	ندارد
پایداری	سرویس systemd خودکار	تنظیم دستی
آموزش	منوی یادگیری داخلی با دیاگرام	مستندات خارجی
اشتراک‌گذاری	تولید اسکریپت اتصال (Linux + Windows)	تنظیم دستی

TunnelForge کامل‌ترین مدیر تانل SSH موجود در یک فایل است.

---

مروری بر امکانات

مدیریت تانل

• پراکسی SOCKS5 داینامیک (-D) — مسیریابی تمام ترافیک از طریق سرور SSH
• Port Forwarding محلی (-L) — دسترسی محلی به سرویس‌های ریموت
• Port Forwarding معکوس (-R) — نمایش سرویس‌های محلی به بیرون
• Jump Host / چند مرحله‌ای (-J) — عبور از سرورهای واسط
• AutoSSH — اتصال مجدد خودکار
• ControlMaster — استفاده مجدد از اتصالات SSH
• چند تانل همزمان — اجرای دهها تانل به صورت موازی

امنیت

• محافظت از نشت DNS — بازنویسی resolv.conf + قفل با chattr
• کیل سوییچ — مسدود کردن تمام ترافیک در صورت قطع تانل (IPv4 + IPv6)
• ممیزی امنیتی ۶ نقطه‌ای — ارزیابی امتیازی وضعیت امنیتی
• تولید کلید SSH — ساخت کلیدهای ed25519، RSA یا ECDSA
• استقرار کلید SSH — ارسال کلید به سرور با یک دستور
• تأیید اثرانگشت سرور — بررسی هویت سرور قبل از اتصال
• سخت‌سازی سرور — تنظیم خودکار sshd، فایروال، fail2ban و sysctl

مانیتورینگ و داشبورد

• داشبورد TUI زنده — وضعیت لحظه‌ای تانل‌ها با رفرش خودکار
• نمودار پهنای باند Sparkline — نمودارهای ASCII (▁▂▃▄▅▆▇█) برای RX/TX
• شمارنده ترافیک — کل بایت‌های ارسال و دریافت هر تانل
• ردیابی Uptime — نمایش زمان اتصال هر تانل
• کیفیت اتصال — اندازه‌گیری تأخیر با نشانگر رنگی
• تست سرعت — تست سرعت دانلود داخلی از طریق تانل
• صفحه‌بندی — ناوبری در صفحات مختلف برای تانل‌های زیاد

_{داشبورد زنده با نمودار پهنای باند، اتصالات فعال، لاگ اتصال مجدد و منابع سیستم}

ربات تلگرام

• اعلان‌های لحظه‌ای — شروع، توقف، خطا، اتصال مجدد
• دستورات ریموت — /tf_status، /tf_list، /tf_ip، /tf_config و بیشتر
• گزارش‌های دوره‌ای — ارسال زمان‌بندی شده وضعیت به گوشی
• اشتراک‌گذاری — ارسال اسکریپت اتصال + PSK از طریق تلگرام
• مسیریابی SOCKS5 — ربات از طریق تانل کار می‌کند وقتی تلگرام مسدود است

رمزنگاری TLS (ضد سانسور)

• پوشش TLS خروجی — ترافیک SSH به شکل HTTPS از طریق stunnel
• محافظت PSK ورودی — لیسنر SOCKS5 با کلید پیش‌اشتراکی
• تولید اسکریپت کلاینت — ساخت خودکار اسکریپت اتصال برای Linux + Windows
• راه‌اندازی خودکار سرور — نصب و پیکربندی stunnel با یک دستور
• عبور از DPI — ترافیک مانند HTTPS معمولی روی پورت 443

یکپارچگی سیستم

• تولیدکننده سرویس Systemd — ساخت خودکار فایل‌های unit امن
• پشتیبان‌گیری و بازیابی — بکاپ کامل تنظیمات با چرخش
• ویزارد سخت‌سازی سرور — آماده‌سازی سرور تازه برای دریافت تانل
• مدیریت پروفایل — ساخت، ویرایش، حذف، وارد کردن پروفایل
• مدیریت لاگ — لاگ مجزا برای هر تانل با چرخش
• حذف کامل — پاکسازی تمام فایل‌ها، سرویس‌ها و تنظیمات

آموزش داخلی

• منوی یادگیری — ۹ درس تعاملی درباره مفاهیم تانل SSH
• سناریوهای واقعی — راهنمای گام به گام با دیاگرام
• دیاگرام‌های ASCII — نمایش بصری جریان ترافیک

---

انواع تانل

پراکسی SOCKS5 داینامیک (-D)

تمام ترافیک TCP خود را از طریق سرور SSH مسیریابی کنید. ترافیک شما از IP سرور ارسال می‌شود.

Client :1080 ──── SSH (Encrypted) ────► Server ──── Direct ────► Internet

کاربردها: مرور خصوصی، عبور از محدودیت‌های جغرافیایی، مخفی کردن IP، مسیریابی ترافیک.

tunnelforge create    # انتخاب "SOCKS5 Proxy" → پورت 1080
tunnelforge start my-proxy
curl --socks5-hostname 127.0.0.1:1080 https://ifconfig.me

---

Port Forwarding محلی (-L)

به یک سرویس ریموت دسترسی پیدا کنید انگار روی سیستم خودتان اجرا می‌شود.

Client :3306 ──── SSH (Encrypted) ────► Server ──── Local ────► MySQL :3306

کاربردها: دسترسی به دیتابیس ریموت، وب اپلیکیشن‌های داخلی، پنل‌های مدیریتی پشت فایروال.

tunnelforge create    # انتخاب "Local Forward" → محلی 3306 → ریموت db:3306
tunnelforge start db-tunnel
mysql -h 127.0.0.1 -P 3306 -u admin -p

---

Port Forwarding معکوس (-R)

یک سرویس محلی را از طریق سرور SSH در دسترس دنیای بیرون قرار دهید.

Local App :3000 ◄──── SSH (Encrypted) ────► Server :9090 ◄──── Users

کاربردها: توسعه webhook، اشتراک‌گذاری اپ برای تست، عبور از NAT، دمو به مشتری.

tunnelforge create    # انتخاب "Remote Forward" → ریموت 9090 ← محلی 3000
tunnelforge start dev-share

---

Jump Host / چند مرحله‌ای (-J)

به سرورهایی که پشت چندین لایه فایروال هستند از طریق سرورهای واسط دسترسی پیدا کنید.

Client ── SSH ──► Jump 1 ── SSH ──► Jump 2 ── SSH ──► Target

کاربردها: شبکه‌های سازمانی، معماری چند لایه، محیط‌های ایزوله، مناطق امنیتی.

---

نصب

پیش‌نیازها

پیش‌نیاز	جزئیات
سیستم عامل	Linux (Ubuntu، Debian، CentOS، Fedora، Arch، Alpine)
Bash	نسخه ۴.۳ یا بالاتر
دسترسی	دسترسی root برای نصب
SSH	کلاینت OpenSSH (در اکثر سیستم‌ها نصب است)
اختیاری	autossh (اتصال مجدد خودکار)، stunnel (رمزنگاری TLS)، sshpass (احراز هویت با رمز)

نصب

# روش ۱: کلون از Git
git clone https://git.samnet.dev/SamNet-dev/tunnelforge.git
cd tunnelforge
sudo bash tunnelforge.sh install

# روش ۲: دانلود مستقیم
curl -fsSL https://git.samnet.dev/SamNet-dev/tunnelforge/raw/branch/main/tunnelforge.sh -o tunnelforge.sh
sudo bash tunnelforge.sh install

جایگزین (میرور، برای مناطق محدود):

curl -fsSL https://dl.samnet.dev/SamNet-dev/tunnelforge/raw/branch/main/tunnelforge.sh -o tunnelforge.sh && sudo bash tunnelforge.sh install

تأیید نصب

tunnelforge version
# TunnelForge v1.0.0

ساختار دایرکتوری

/opt/tunnelforge/
├── tunnelforge.sh              # اسکریپت اصلی
├── config/
│   └── tunnelforge.conf        # تنظیمات کلی
├── profiles/
│   └── *.conf                  # پروفایل تانل‌ها
├── pids/                       # فایل‌های PID تانل‌های فعال
├── logs/                       # لاگ هر تانل
├── backups/                    # فایل‌های پشتیبان
├── data/
│   ├── bandwidth/              # تاریخچه پهنای باند
│   └── reconnects/             # آمار اتصال مجدد
└── sockets/                    # سوکت‌های ControlMaster

---

مثال‌های سریع

مرور خصوصی با SOCKS5

tunnelforge create
# → نام: private-proxy
# → نوع: SOCKS5
# → سرور: user@myserver.com
# → پورت: 1080

tunnelforge start private-proxy
curl --socks5-hostname 127.0.0.1:1080 https://ifconfig.me

# تنظیم فایرفاکس: Settings → Network → Manual Proxy → SOCKS5: 127.0.0.1:1080

دسترسی به دیتابیس ریموت

tunnelforge create
# → نام: prod-db
# → نوع: Local Forward
# → سرور: admin@db-server.internal
# → پورت محلی: 3306 → ریموت: localhost:3306

tunnelforge start prod-db
mysql -h 127.0.0.1 -P 3306 -u dbuser -p

اشتراک‌گذاری سرور توسعه

tunnelforge create
# → نام: demo-share
# → نوع: Remote Forward
# → سرور: user@public-vps.com
# → پورت ریموت: 8080 ← محلی: localhost:3000

tunnelforge start demo-share
# لینک اشتراک: http://public-vps.com:8080

عبور از سانسور با رمزنگاری TLS

# ۱. راه‌اندازی stunnel روی VPS
tunnelforge obfs-setup my-tunnel

# ۲. شروع تانل — SSH حالا در TLS پورت 443 پوشش داده شده
tunnelforge start my-tunnel

# DPI می‌بیند: ترافیک HTTPS عادی
# واقعیت: تانل SSH داخل TLS

# ۳. اشتراک با دیگران
tunnelforge client-script my-tunnel    # تولید اسکریپت اتصال
tunnelforge telegram share my-tunnel   # ارسال از طریق تلگرام

---

مرجع دستورات CLI

دستورات تانل

دستور	توضیح
tunnelforge start <name>	شروع تانل
tunnelforge stop <name>	توقف تانل
tunnelforge restart <name>	راه‌اندازی مجدد
tunnelforge start-all	شروع همه تانل‌های خودکار
tunnelforge stop-all	توقف همه تانل‌ها
tunnelforge status	نمایش وضعیت
tunnelforge dashboard	داشبورد زنده
tunnelforge logs [name]	مشاهده لاگ

دستورات پروفایل

دستور	توضیح
tunnelforge create	ساخت پروفایل جدید (ویزارد)
tunnelforge list	لیست پروفایل‌ها
tunnelforge delete <name>	حذف پروفایل

دستورات امنیتی

دستور	توضیح
tunnelforge audit	ممیزی امنیتی ۶ نقطه‌ای
tunnelforge key-gen [type]	تولید کلید SSH
tunnelforge key-deploy <name>	استقرار کلید روی سرور
tunnelforge fingerprint <host>	بررسی اثرانگشت سرور

دستورات تلگرام

دستور	توضیح
tunnelforge telegram setup	پیکربندی ربات
tunnelforge telegram test	ارسال پیام آزمایشی
tunnelforge telegram status	نمایش تنظیمات
tunnelforge telegram send <msg>	ارسال پیام
tunnelforge telegram report	ارسال گزارش وضعیت
tunnelforge telegram share [name]	اشتراک اسکریپت‌ها

دستورات سرویس

دستور	توضیح
tunnelforge service <name>	تولید سرویس systemd
tunnelforge service <name> enable	فعال‌سازی سرویس
tunnelforge service <name> disable	غیرفعال‌سازی
tunnelforge service <name> status	وضعیت سرویس
tunnelforge service <name> remove	حذف سرویس

دستورات سیستم

دستور	توضیح
tunnelforge menu	منوی تعاملی
tunnelforge install	نصب TunnelForge
tunnelforge server-setup	سخت‌سازی سرور
tunnelforge obfs-setup <name>	راه‌اندازی رمزنگاری TLS
tunnelforge client-config <name>	نمایش تنظیمات کلاینت
tunnelforge client-script <name>	تولید اسکریپت کلاینت
tunnelforge backup	پشتیبان‌گیری
tunnelforge restore [file]	بازیابی
tunnelforge uninstall	حذف کامل
tunnelforge version	نمایش نسخه
tunnelforge help	راهنما

---

امنیت

محافظت از نشت DNS

از ارسال درخواست‌های DNS خارج از تانل جلوگیری می‌کند.

نحوه کار:

1. از /etc/resolv.conf فعلی بکاپ می‌گیرد
2. آن را با سرورهای DNS امن بازنویسی می‌کند (پیش‌فرض: 8.8.8.8)
3. فایل را با chattr +i قفل می‌کند تا سیستم نتواند آن را تغییر دهد
4. هنگام توقف تانل، DNS اصلی بازیابی می‌شود

کیل سوییچ

اگر تانل قطع شود، تمام ترافیک اینترنت مسدود می‌شود.

نحوه کار:

1. زنجیره iptables سفارشی TUNNELFORGE ایجاد می‌کند
2. فقط ترافیک تانل SSH + loopback مجاز است
3. بقیه ترافیک مسدود (IPv4 + IPv6)
4. هنگام توقف تانل، قوانین حذف می‌شوند

ممیزی امنیتی ۶ نقطه‌ای

tunnelforge audit

بررسی	توضیح
مجوزهای کلید SSH	بررسی 600 یا 400 بودن
دایرکتوری SSH	تأیید 700 بودن ~/.ssh
محافظت DNS	وضعیت محافظت فعال
کیل سوییچ	فعال بودن زنجیره iptables
سلامت تانل	بررسی اعتبار PID‌ها
بسته‌های سیستم	ابزارهای امنیتی نصب شده

سخت‌سازی سرور

tunnelforge server-setup

تنظیمات:

• SSH — غیرفعال‌سازی احراز هویت رمز عبور، غیرفعال‌سازی root login
• فایروال — قوانین UFW/iptables فقط برای SSH + پورت‌های تانل
• Fail2ban — مسدودسازی خودکار بعد از تلاش‌های ناموفق
• Kernel — سخت‌سازی sysctl (محافظت SYN flood، ICMP)

---

رمزنگاری TLS (ضد سانسور)

در شبکه‌هایی که بازرسی عمیق بسته (DPI) دارند، ترافیک SSH قابل شناسایی و مسدودسازی است. TunnelForge اتصال SSH شما را داخل یک لایه TLS می‌پیچد تا مانند ترافیک HTTPS عادی به نظر برسد.

نحوه کار

بدون رمزنگاری TLS:
Client ──── SSH (قابل شناسایی) ────► VPS          ← DPI می‌تواند مسدود کند

با رمزنگاری TLS:
Client ──── TLS/443 (شبیه HTTPS) ────► VPS ──── SSH ────► اینترنت

راه‌اندازی سمت سرور

tunnelforge obfs-setup my-tunnel

این دستور به صورت خودکار:

1. stunnel را روی سرور ریموت نصب می‌کند
2. گواهی TLS خودامضا تولید می‌کند
3. پورت 443 (TLS) را به پورت 22 (SSH) مپ می‌کند
4. سرویس systemd فعال می‌کند
5. پورت فایروال باز می‌کند

اشتراک‌گذاری با دیگران

# تولید اسکریپت برای Linux + Windows
tunnelforge client-script my-tunnel

# ارسال از طریق تلگرام
tunnelforge telegram share my-tunnel

اسکریپت‌های تولید شده شامل تنظیمات stunnel، فایل PSK و مدیریت کامل اتصال هستند.

کلاینت مستقل ویندوز

فایل windows-client/tunnelforge-client.bat یک کلاینت مستقل ویندوز است که در ریپو موجود است. کاربران فقط دابل‌کلیک می‌کنند، اطلاعات اتصال را وارد می‌کنند و متصل می‌شوند. نیازی به PowerShell نیست.

امکانات:

• تنظیم تعاملی — سرور، پورت و PSK را می‌پرسد
• نصب خودکار stunnel (از طریق winget، Chocolatey یا لینک دانلود)
• ذخیره اتصال برای اتصال مجدد فوری
• دستورات: tunnelforge-client.bat stop / status
• نمایش تنظیمات پراکسی مرورگر (Firefox + Chrome)

توزیع:
1. فایل windows-client/tunnelforge-client.bat را به کاربر بدهید
2. اطلاعات PSK + سرور را بدهید (از: tunnelforge client-config <profile>)
3. کاربر دابل‌کلیک → اطلاعات وارد → متصل

---

ربات تلگرام

اطلاع‌رسانی لحظه‌ای تانل‌ها روی گوشی و کنترل ریموت.

راه‌اندازی

tunnelforge telegram setup

1. ساخت ربات — به @BotFather پیام دهید و /newbot ارسال کنید
2. وارد کردن توکن — توکن ربات را در TunnelForge وارد کنید
3. دریافت Chat ID — به ربات /start ارسال کنید، TunnelForge خودکار شناسایی می‌کند
4. تمام — پیام آزمایشی تأیید ارسال می‌شود

اعلان‌ها

رویداد	پیام
شروع تانل	نام، PID، نوع تانل
توقف تانل	نام پروفایل
خطای تانل	جزئیات خطا
اتصال مجدد	بازیابی خودکار AutoSSH
هشدار امنیتی	نشت DNS یا کیل سوییچ
گزارش وضعیت	مرور کلی تمام تانل‌ها

دستورات ربات

دستور	پاسخ
/tf_status	وضعیت تمام تانل‌ها
/tf_list	لیست پروفایل‌ها
/tf_ip	IP عمومی سرور
/tf_config	تنظیمات اتصال کلاینت
/tf_uptime	مدت فعالیت سرور
/tf_report	گزارش کامل وضعیت
/tf_help	لیست دستورات

---

سرویس Systemd

تانل‌ها را مقاوم در برابر ریبوت کنید:

tunnelforge service my-tunnel            # تولید فایل سرویس
tunnelforge service my-tunnel enable     # فعال‌سازی و شروع
tunnelforge service my-tunnel status     # بررسی وضعیت
tunnelforge service my-tunnel disable    # غیرفعال‌سازی
tunnelforge service my-tunnel remove     # حذف سرویس

فایل سرویس تولید شده شامل سخت‌سازی امنیتی (ProtectSystem، PrivateTmp، قابلیت‌های محدود) است.

---

پشتیبان‌گیری و بازیابی

# پشتیبان‌گیری
tunnelforge backup

# بازیابی
tunnelforge restore
tunnelforge restore /path/to/backup.tar.gz

شامل: پروفایل‌ها، تنظیمات، کلیدهای SSH و فایل‌های سرویس systemd.

---

سناریوهای واقعی

هر سناریو قابل باز شدن است و مراحل دقیق ویزارد را نشان می‌دهد. هم نسخه SSH معمولی و هم TLS رمزنگاری شده پوشش داده شده.

سناریو ۱: مرور خصوصی با SOCKS5

هدف: ترافیک مرورگر را از طریق VPS مسیریابی کنید تا سایت‌ها IP سرور را ببینند نه IP واقعی شما.

پیش‌نیاز: یک سرور VPS با دسترسی SSH.

مراحل ویزارد (SSH معمولی)

tunnelforge create

مرحله	سوال	چه وارد کنید
1	Profile name	private-proxy
2	Tunnel type	1 — SOCKS5 Proxy
3	SSH host	IP سرور (مثلاً 45.33.32.10)
4	SSH port	22
5	SSH user	root
6	SSH password	رمز عبور (یا Enter برای کلید SSH)
7	Identity key	~/.ssh/id_ed25519 (یا Enter)
8	Auth test	خودکار
9a	Bind address	127.0.0.1
9b	SOCKS5 port	1080
10	Connection mode	1 — Regular SSH
11	Inbound protection	1 — None
12	AutoSSH	y
13	Save & start	y سپس y

مراحل ویزارد (TLS رمزنگاری — برای شبکه سانسور شده)

مانند بالا، اما در مرحله ۱۰:

مرحله	سوال	چه وارد کنید
10	Connection mode	2 — TLS Encrypted
10a	TLS port	443 (شبیه HTTPS)
10b	Setup stunnel now?	y (نصب خودکار روی سرور)

بعد از شروع

Firefox: Settings → proxy → SOCKS Host: 127.0.0.1 Port: 1080

Chrome:

google-chrome --proxy-server="socks5://127.0.0.1:1080"

تست:

curl --socks5-hostname 127.0.0.1:1080 https://ifconfig.me

سناریو ۲: دسترسی به دیتابیس ریموت

هدف: به MySQL/PostgreSQL روی VPS دسترسی پیدا کنید انگار روی سیستم خودتان اجرا می‌شود.

پیش‌نیاز: یک VPS با دیتابیس فعال.

مراحل ویزارد

tunnelforge create

مرحله	سوال	چه وارد کنید
1	Profile name	prod-db
2	Tunnel type	2 — Local Port Forward
3	SSH host	IP سرور (مثلاً 45.33.32.10)
4	SSH port	22
5	SSH user	root
6	SSH password	رمز عبور
7	Identity key	Enter
8	Auth test	خودکار
9a	Bind address	127.0.0.1
9b	Local port	3306 (پورت روی سیستم شما)
9c	Remote host	127.0.0.1 (یعنی "روی خود VPS")
9d	Remote port	3306 (پورت MySQL روی VPS)
10	Connection mode	1 — Regular SSH
11	Inbound protection	1 — None
12	AutoSSH	y
13	Save & start	y سپس y

بعد از شروع

mysql -h 127.0.0.1 -P 3306 -u dbuser -p     # MySQL
psql -h 127.0.0.1 -p 5432 -U postgres        # PostgreSQL
redis-cli -h 127.0.0.1 -p 6379               # Redis

سرویس	پورت محلی	پورت ریموت
MySQL	3306	3306
PostgreSQL	5432	5432
Redis	6379	6379
پنل وب	8080	8080

سناریو ۳: اشتراک‌گذاری سرور توسعه

هدف: وب‌سایت محلی (مثلاً پورت 3000) را از طریق VPS در دسترس اینترنت قرار دهید.

پیش‌نیاز: یک سرویس محلی فعال + VPS با IP عمومی.

مراحل ویزارد

tunnelforge create

مرحله	سوال	چه وارد کنید
1	Profile name	dev-share
2	Tunnel type	3 — Remote/Reverse Forward
3	SSH host	IP سرور (مثلاً 45.33.32.10)
4-8	SSH credentials	مانند سناریوهای قبل
9a	Remote bind	0.0.0.0 (دسترسی عمومی)
9b	Remote port	9090 (پورت روی VPS)
9c	Local host	127.0.0.1
9d	Local port	3000 (اپ شما)
10	Connection mode	1 — Regular SSH
12	AutoSSH	y
13	Save & start	y سپس y

مهم: اگر bind روی 0.0.0.0 است، باید GatewayPorts yes در sshd سرور فعال باشد.

بعد از شروع

# تست از هرجا:
curl http://45.33.32.10:9090

# لینک اشتراک: http://45.33.32.10:9090

سناریو ۴: عبور از چند فایروال (Jump Host)

هدف: به سروری که مستقیماً از اینترنت قابل دسترسی نیست از طریق سرورهای واسط (bastion) دسترسی پیدا کنید.

مراحل ویزارد (SOCKS5 در مقصد)

tunnelforge create

مرحله	سوال	چه وارد کنید
1	Profile name	corp-access
2	Tunnel type	4 — Jump Host
3	SSH host	IP مقصد (مثلاً 10.0.50.100)
4	SSH port	22
5	SSH user	admin (کاربر روی مقصد)
6	SSH password	رمز مقصد
8	Auth test	ممکن است خطا بدهد — ادامه دهید
9a	Jump hosts	root@bastion.example.com:22
9b	Tunnel type at destination	1 — SOCKS5
9c	Bind address	127.0.0.1
9d	SOCKS5 port	1080
10	Connection mode	1 — Regular SSH
13	Save & start	y سپس y

مهم: مراحل ۳ تا ۷ برای سرور مقصد هستند. اطلاعات سرور واسط در مرحله 9a وارد می‌شود.

چند سرور واسط

Jump hosts: user1@hop1.com:22,user2@hop2.com:22

سناریو ۵: عبور از سانسور DPI (یک VPS)

هدف: ISP شما SSH را شناسایی و مسدود می‌کند. SSH را در TLS بپیچید تا مانند HTTPS عادی به نظر برسد.

بدون TLS:  PC ──── SSH (مسدود توسط DPI) ────► VPS
با TLS:    PC ──── TLS/443 (شبیه HTTPS) ────► VPS ──► Internet

مراحل ویزارد

tunnelforge create

مرحله	سوال	چه وارد کنید
1	Profile name	bypass-proxy
2	Tunnel type	1 — SOCKS5 Proxy
3	SSH host	IP سرور خارج از کشور
4-8	SSH credentials	مانند سناریوهای قبل
9a	Bind address	127.0.0.1
9b	SOCKS5 port	1080
10	Connection mode	2 — TLS Encrypted
10a	TLS port	443 (شبیه HTTPS)
10b	Setup stunnel?	y (نصب خودکار)
11	Inbound protection	1 — None
12	AutoSSH	y
13	Save & start	y سپس y

DPI چه می‌بیند

PC ──── HTTPS:443 ──► VPS IP
نتیجه: ترافیک عادی وب. مجاز.

سناریو ۶: زنجیره دو سرور TLS

هدف: پراکسی اشتراکی برای چند کاربر. VPS-A = ورودی (relay). VPS-B = خروجی. هر دو مسیر TLS رمزنگاری شده.

Users ── TLS+PSK:1443 ──► VPS-A ── TLS:443 ──► VPS-B ──► Internet

مراحل ویزارد (اجرا روی VPS-A)

tunnelforge create

مرحله	سوال	چه وارد کنید
1	Profile name	double-hop
2	Tunnel type	1 — SOCKS5
3	SSH host	IP VPS-B
4-8	SSH credentials	اطلاعات VPS-B
9a	Bind address	127.0.0.1
9b	SOCKS5 port	1080
10	Connection mode	2 — TLS Encrypted
10a	TLS port	443
10b	Setup stunnel on VPS-B?	y
11	Inbound protection	2 — TLS + PSK
11a	Inbound TLS port	1443
11b	PSK	خودکار تولید می‌شود
12	AutoSSH	y
13	Save & start	y سپس y

تولید اسکریپت برای کاربران

tunnelforge client-script double-hop    # تولید اسکریپت
tunnelforge telegram share double-hop   # ارسال با تلگرام

کاربران چه می‌کنند

# Linux:
./tunnelforge-connect.sh             # اتصال
./tunnelforge-connect.sh stop        # قطع
# پراکسی مرورگر: 127.0.0.1:1080

# Windows PowerShell:
powershell -ExecutionPolicy Bypass -File tunnelforge-connect.ps1
# پراکسی مرورگر: 127.0.0.1:1080

# Windows Batch (کلاینت مستقل):
tunnelforge-client.bat               # دابل‌کلیک، سرور/پورت/PSK وارد کنید
tunnelforge-client.bat stop          # قطع
tunnelforge-client.bat status        # بررسی
# پراکسی مرورگر: 127.0.0.1:1080

سناریو ۷: اشتراک تانل با دیگران

هدف: تانل TLS+PSK فعال دارید و می‌خواهید دیگران هم استفاده کنند. TunnelForge یک اسکریپت مستقل تولید می‌کند.

پیش‌نیاز: تانل فعال با Inbound TLS+PSK (سناریو ۵ یا ۶).

مرحله ۱ — تولید اسکریپت

tunnelforge client-script my-tunnel

دو فایل تولید می‌شود:

• tunnelforge-connect.sh — برای Linux/Mac
• tunnelforge-connect.ps1 — برای Windows PowerShell

یا از کلاینت مستقل ویندوز استفاده کنید: فایل windows-client/tunnelforge-client.bat را از ریپو به کاربر بدهید — فقط دابل‌کلیک، اطلاعات اتصال وارد، متصل. نیازی به تولید اسکریپت نیست.

مرحله ۲ — ارسال به کاربران

tunnelforge telegram share my-tunnel    # ارسال با تلگرام

یا از طریق واتس‌اپ، ایمیل، فلش و غیره.

برای کاربران ویندوز: فایل windows-client/tunnelforge-client.bat را هم بفرستید (یا فقط فایل bat با اطلاعات PSK کافیست).

مرحله ۳ — اجرا توسط کاربر

# Linux:
chmod +x tunnelforge-connect.sh
./tunnelforge-connect.sh            # اتصال (stunnel خودکار نصب می‌شود)
./tunnelforge-connect.sh stop       # قطع
./tunnelforge-connect.sh status     # بررسی وضعیت
# پراکسی مرورگر: 127.0.0.1:1080

# Windows PowerShell:
powershell -ExecutionPolicy Bypass -File tunnelforge-connect.ps1
powershell -ExecutionPolicy Bypass -File tunnelforge-connect.ps1 stop
powershell -ExecutionPolicy Bypass -File tunnelforge-connect.ps1 status
# پراکسی مرورگر: 127.0.0.1:1080

# Windows Batch (کلاینت مستقل):
tunnelforge-client.bat              # دابل‌کلیک، سرور/پورت/PSK وارد کنید
tunnelforge-client.bat stop         # قطع
tunnelforge-client.bat status       # بررسی
# پراکسی مرورگر: 127.0.0.1:1080

لغو دسترسی کاربر

1. PSK را در پروفایل تغییر دهید
2. اسکریپت جدید تولید کنید: tunnelforge client-script my-tunnel
3. تانل را ریستارت کنید: tunnelforge restart my-tunnel
4. اسکریپت‌های قدیمی دیگر کار نمی‌کنند

---

منوی یادگیری

TunnelForge شامل سیستم آموزشی تعاملی است (کلید l در منوی اصلی):

#	موضوع	توضیح
۱	تانل SSH چیست؟	مبانی کانال رمزنگاری شده
۲	پراکسی SOCKS5	مسیریابی ترافیک با -D
۳	Port Forwarding محلی	دسترسی به سرویس ریموت با -L
۴	Port Forwarding معکوس	نمایش سرویس محلی با -R
۵	Jump Host	عبور از سرورهای واسط با -J
۶	ControlMaster	استفاده مجدد از اتصالات
۷	AutoSSH	بازیابی خودکار تانل
۸	رمزنگاری TLS	پوشش SSH در TLS
۹	احراز هویت PSK	کلید پیش‌اشتراکی

---

مجوز و نویسنده

TunnelForge تحت مجوز GNU General Public License v3.0 منتشر شده است.

حق نشر (C) ۲۰۲۶ SamNet Technologies, LLC