opentunnel-cli 1.0.30 → 1.0.32

package/README.md

@@ -18,6 +18,7 @@
   - [Server Mode](#server-mode-config)
   - [Hybrid Mode](#hybrid-mode-config)
 - [CLI Commands](#cli-commands)
+- [Streaming Large Files / Video](#streaming-large-files--video)
 - [Documentation](#documentation)
 - [Architecture](#architecture)
 - [Troubleshooting](#troubleshooting-quick)
@@ -144,6 +145,13 @@ tunnels:
     protocol: http
     port: 4000
     subdomain: api
+
+  - name: media
+    protocol: http
+    port: 8080
+    subdomain: media
+    streaming: true        # Enable streaming mode (10 min timeout)
+    # requestTimeout: 0    # Or no timeout (use with caution)
 ```
 
 ### Server Mode Config
@@ -219,6 +227,42 @@ tunnels:
 - `-t, --token <token>` - Auth token
 - `-n, --name <name>` - Custom subdomain
 - `--insecure` - Skip SSL verification
+- `--streaming` - Enable streaming mode (10 min timeout for video/large files)
+- `--timeout <ms>` - Custom request timeout in milliseconds (0 = no timeout)
+
+---
+
+## Streaming Large Files / Video
+
+For tunneling video streams or large file downloads, use the streaming options:
+
+```bash
+# Enable streaming mode (10 minute timeout)
+opentunnel http 8080 -s example.com --streaming
+
+# Custom timeout (5 minutes = 300000ms)
+opentunnel http 8080 -s example.com --timeout 300000
+
+# No timeout (use with caution - high memory usage)
+opentunnel http 8080 -s example.com --timeout 0
+```
+
+**In configuration file:**
+
+```yaml
+tunnels:
+  - name: media-server
+    protocol: http
+    port: 8080
+    subdomain: media
+    streaming: true          # 10 min timeout
+    # requestTimeout: 300000 # Or custom timeout in ms
+```
+
+> **Note:** HTTP tunnels buffer the entire response in memory before forwarding. For very large files (>500MB), consider using TCP tunnels which stream byte-by-byte:
+> ```bash
+> opentunnel tcp 8080 -s example.com
+> ```
 
 ---
 

package/dist/cli/index.js

@@ -238,7 +238,7 @@ program
     .name("opentunnel")
     .alias("ot")
     .description("Expose local ports to the internet via custom domains, ngrok, or Cloudflare Tunnel")
-    .version("1.0.30");
+    .version("1.0.32");
 // Helper function to build WebSocket URL from domain
 // User only provides base domain (e.g., fjrg2007.com), system handles the rest
 // Note: --insecure flag only affects certificate verification, not the protocol
@@ -279,6 +279,8 @@ program
     .option("-h, --host <host>", "Local host to forward to", "localhost")
     .option("-t, --token <token>", "Authentication token (if server requires it)")
     .option("--insecure", "Skip SSL certificate verification (for self-signed certs)")
+    .option("--streaming", "Enable streaming mode (longer timeouts for video/large files)")
+    .option("--timeout <ms>", "Custom request timeout in milliseconds")
     .option("--local-server", "Start a local server before connecting")
     .option("--server-port <port>", "Port for the local server (default: 443)", "443")
     .action(async (port, options) => {
@@ -377,6 +379,8 @@ program
             localHost: options.host,
             localPort: parseInt(port),
             subdomain: options.subdomain,
+            streaming: options.streaming || false,
+            requestTimeout: options.timeout ? parseInt(options.timeout) : undefined,
         });
         return { client, tunnelId, publicUrl };
     };
@@ -579,6 +583,8 @@ program
             localHost: options.host,
             localPort: parseInt(port),
             subdomain: options.subdomain,
+            streaming: options.streaming || false,
+            requestTimeout: options.timeout ? parseInt(options.timeout) : undefined,
         });
         spinner.succeed("Tunnel established!");
         console.log("");
@@ -642,6 +648,8 @@ program
     .option("--server-port <port>", "Server port", "443")
     .option("--https", "Use HTTPS for local connection")
     .option("--insecure", "Skip SSL verification (for self-signed certs)")
+    .option("--streaming", "Enable streaming mode (longer timeouts for video/large files)")
+    .option("--timeout <ms>", "Custom request timeout in milliseconds")
     .option("--ngrok", "Use ngrok instead of OpenTunnel server")
     .option("--region <region>", "Ngrok region (us, eu, ap, au, sa, jp, in)", "us")
     .option("--cloudflare, --cf", "Use Cloudflare Tunnel instead of OpenTunnel server")
@@ -687,6 +695,8 @@ program
             serverUrl,
             token: options.token,
             insecure: options.insecure,
+            streaming: options.streaming,
+            requestTimeout: options.timeout ? parseInt(options.timeout) : undefined,
         });
         return;
     }
@@ -2871,6 +2881,8 @@ async function createTunnel(options) {
             localPort: options.localPort,
             subdomain: options.subdomain,
             remotePort: options.remotePort,
+            streaming: options.streaming,
+            requestTimeout: options.requestTimeout,
         });
         spinner.succeed("Tunnel established!");
         printTunnelInfo({