opentunnel-cli 1.0.29 → 1.0.31

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.29");
+    .version("1.0.31");
 // 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;
     }
@@ -1809,7 +1819,15 @@ program
     const isClientMode = mode === "client";
     const isServerMode = mode === "server";
     const isHybridMode = mode === "hybrid";
-    if (!hasDomainConfig && !remote) {
+    // Check if using external provider (cloudflare/ngrok) which doesn't need domain/remote
+    const globalProvider = config.provider || "opentunnel";
+    const isExternalProvider = globalProvider === "cloudflare" || globalProvider === "ngrok";
+    // Also check if all tunnels use external providers
+    const allTunnelsExternal = hasTunnels && tunnelsToStart.every(t => {
+        const provider = t.provider || globalProvider;
+        return provider === "cloudflare" || provider === "ngrok";
+    });
+    if (!hasDomainConfig && !remote && !isExternalProvider && !allTunnelsExternal) {
         console.log(chalk_1.default.red("Missing configuration."));
         console.log(chalk_1.default.gray("\nAdd to your config:"));
         console.log(chalk_1.default.cyan("\n  # Run your own server:"));
@@ -1818,8 +1836,33 @@ program
         console.log(chalk_1.default.cyan("\n  # Or connect to a remote server:"));
         console.log(chalk_1.default.white("  server:"));
         console.log(chalk_1.default.white("    remote: example.com"));
+        console.log(chalk_1.default.cyan("\n  # Or use an external provider:"));
+        console.log(chalk_1.default.white("  provider: cloudflare  # or ngrok"));
         process.exit(1);
     }
+    // External provider mode: skip OpenTunnel server, use cloudflare/ngrok directly
+    if ((isExternalProvider || allTunnelsExternal) && !hasDomainConfig && !remote) {
+        if (!hasTunnels) {
+            console.log(chalk_1.default.red("No tunnels configured."));
+            console.log(chalk_1.default.gray("\nAdd tunnels to your config:"));
+            console.log(chalk_1.default.white("  tunnels:"));
+            console.log(chalk_1.default.white("    - name: web"));
+            console.log(chalk_1.default.white("      protocol: http"));
+            console.log(chalk_1.default.white("      port: 80"));
+            process.exit(1);
+        }
+        console.log(chalk_1.default.cyan(`Starting ${tunnelsToStart.length} tunnel(s) via ${globalProvider}...\n`));
+        try {
+            await startTunnelsFromConfig(tunnelsToStart, "", undefined, true, config);
+            console.log(chalk_1.default.gray("\nPress Ctrl+C to stop"));
+            // Keep running
+            await new Promise(() => { });
+        }
+        catch (error) {
+            console.log(chalk_1.default.red(`Failed to start tunnels: ${error.message}`));
+            process.exit(1);
+        }
+    }
     if (isClientMode) {
         // CLIENT MODE: Connect to remote server
         // Build URL using basePath (default: op) -> wss://op.example.com/_tunnel
@@ -2651,8 +2694,16 @@ async function startTunnelsFromConfig(tunnels, serverUrl, token, insecure, globa
     for (const tunnel of cloudflareTunnels) {
         const spinner = (0, ora_1.default)(`Creating Cloudflare tunnel: ${tunnel.name}...`).start();
         const cfHostname = tunnel.cfHostname || globalConfig?.cloudflare?.hostname;
-        // For Cloudflare: subdomain = tunnel name
+        // For Cloudflare: subdomain = tunnel name (for named tunnels)
         const cfTunnelName = tunnel.subdomain || globalConfig?.cloudflare?.tunnelName;
+        // Validate: named tunnels require cfHostname for public access
+        if (cfTunnelName && !cfHostname) {
+            spinner.fail(`${tunnel.name}: Named tunnel '${cfTunnelName}' requires cfHostname`);
+            console.log(chalk_1.default.gray(`  Add to your config:`));
+            console.log(chalk_1.default.white(`    cfHostname: ${cfTunnelName}.yourdomain.com`));
+            console.log(chalk_1.default.gray(`  Or remove 'subdomain' for a quick tunnel with random URL`));
+            continue;
+        }
         // Merge IP access config: tunnel-specific > global security > none
         const { IpFilter } = await Promise.resolve().then(() => __importStar(require("../shared/ip-filter")));
         const ipAccess = IpFilter.mergeConfigs(globalConfig?.security?.ipAccess, tunnel.ipAccess);
@@ -2664,6 +2715,13 @@ async function startTunnelsFromConfig(tunnels, serverUrl, token, insecure, globa
         });
         try {
             await client.connect();
+            // Auto-route DNS if using named tunnel with hostname
+            if (cfTunnelName && cfHostname) {
+                const routeResult = await CloudflareTunnelClient_1.CloudflareTunnelClient.routeDns(cfTunnelName, cfHostname);
+                if (!routeResult.success && !routeResult.error?.includes("already exists")) {
+                    spinner.warn(`${tunnel.name}: DNS routing failed: ${routeResult.error}`);
+                }
+            }
             const { tunnelId, publicUrl } = await client.createTunnel({
                 protocol: tunnel.protocol,
                 localHost: tunnel.host || "localhost",
@@ -2823,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({