feat: rename proxy files and make CLOUDFLARE_PROXY_URL required

OUTBOUND_PROXY_GUIDE.md → CLOUDFLARE_PROXY_GUIDE.md

@@ -1,8 +1,8 @@
-# 🌐 Outbound Proxy Guide
+# 🌐 Cloudflare Proxy Guide
 
 Hugging Face Spaces officially blocks outgoing connections to specific services like **Telegram**, **WhatsApp**, and **Discord** on the free tier.
 
-Hugging8n includes a built-in **Transparent Outbound Proxy** that allows you to bypass these restrictions using a single Cloudflare Worker.
+Hugging8n includes a built-in **Transparent Cloudflare Proxy** that allows you to bypass these restrictions using a single Cloudflare Worker.
 
 ---
 
@@ -13,20 +13,20 @@ Hugging8n includes a built-in **Transparent Outbound Proxy** that allows you to
 1. Log in to [dash.cloudflare.com](https://dash.cloudflare.com/).
 2. Go to **Workers & Pages** -> **Create Worker**.
 3. Name it (e.g., `h8n-proxy`).
-4. Paste the code from [outbound-proxy-worker.js](./outbound-proxy-worker.js) into the editor.
+4. Paste the code from [cloudflare-worker.js](./cloudflare-worker.js) into the editor.
 5. Click **Deploy**.
 6. Copy your Worker URL (e.g., `h8n-proxy.yourname.workers.dev`).
 
 ### Step 2: Configure Hugging8n
 
-Go to your Space **Settings** -> **Variables** and add:
+Go to your Space **Settings** -> **Variables** (or Secrets) and add:
 
-1. **`CLOUDFLARE_PROXY_URL`**:
+1. **`CLOUDFLARE_PROXY_URL`** (Required):
    - Value: `h8n-proxy.yourname.workers.dev` (You can omit the `https://`).
 
-2. **`OUTBOUND_PROXY_DOMAINS`** (Optional):
+2. **`CLOUDFLARE_PROXY_DOMAINS`** (Optional):
    - **Default**: Proxies Telegram and Discord only.
-   - **Wildcard Mode**: Set this to `*` to proxy **every single request** n8n makes to the outside world. This is the most reliable way to ensure no node ever gets blocked.
+   - **Wildcard Mode**: Set this to `*` to proxy **every single request** n8n makes to the outside world.
 
 ### Step 3: Restart Space
 

Dockerfile

@@ -30,10 +30,10 @@ WORKDIR /home/node/app
 
 COPY --chown=node:node health-server.js /home/node/app/health-server.js
 COPY --chown=node:node dns-fix.js /opt/dns-fix.js
-COPY --chown=node:node outbound-fix.js /opt/outbound-fix.js
+COPY --chown=node:node cloudflare-proxy.js /opt/cloudflare-proxy.js
 
 # Set NODE_OPTIONS after preload scripts are copied
-ENV NODE_OPTIONS="--require /opt/dns-fix.js --require /opt/outbound-fix.js"
+ENV NODE_OPTIONS="--require /opt/dns-fix.js --require /opt/cloudflare-proxy.js"
 COPY --chown=node:node n8n-sync.py /home/node/app/n8n-sync.py
 COPY --chown=node:node setup-uptimerobot.sh /home/node/app/setup-uptimerobot.sh
 COPY --chown=node:node start.sh /home/node/app/start.sh

README.md

@@ -11,7 +11,7 @@ secrets:
   - name: HF_TOKEN
     description: HuggingFace token with write access (Settings > Tokens). Used for automatic backup.
   - name: CLOUDFLARE_PROXY_URL
-    description: Your Cloudflare Worker URL to bypass platform blocks (Telegram/Discord).
+    description: Your Cloudflare Worker URL to bypass platform blocks (Telegram/Discord). Required for most external services.
 ---
 
 # 🔗 Hugging8n
@@ -55,8 +55,8 @@ You can customize Hugging8n using Environment Variables (Settings > Variables):
 | `SYNC_INTERVAL` | `180` | Backup frequency in seconds. |
 | `GENERIC_TIMEZONE` | `UTC` | Timezone for n8n. |
 | `N8N_LOG_LEVEL` | `error` | Set to `info` for more verbose logs. |
-| `CLOUDFLARE_PROXY_URL` | - | Your Cloudflare Worker URL (to bypass Discord/Telegram blocks). |
-| `OUTBOUND_PROXY_DOMAINS` | (default) | Comma-separated list of domains to proxy. Use `*` to proxy everything. |
+| `CLOUDFLARE_PROXY_URL` | (Required) | Your Cloudflare Worker URL (to bypass Discord/Telegram blocks). |
+| `CLOUDFLARE_PROXY_DOMAINS` | (default) | Comma-separated list of domains to proxy. Use `*` to proxy everything. |
 | `SPACE_HOST_OVERRIDE` | - | Override the detected host if using a custom domain. |
 
 ## 🔐 Authentication & Security
@@ -79,7 +79,7 @@ Hugging8n automatically creates and maintains a private dataset in your Hugging
 **External Connectivity (Telegram/Discord/WhatsApp)**
 Hugging Face officially blocks outgoing connections to specific services on Free Tier Spaces. Hugging8n includes a transparent proxy system to bypass this automatically.
 
-👉 **[Read the Outbound Proxy Guide](./OUTBOUND_PROXY_GUIDE.md)**
+👉 **[Read the Cloudflare Proxy Guide](./CLOUDFLARE_PROXY_GUIDE.md)**
 *(Upgrading to a paid Space removes this firewall restriction entirely).*
 
 ## 🏗️ Architecture

outbound-fix.js → cloudflare-proxy.js

@@ -1,5 +1,5 @@
 /**
- * Outbound Fix: Transparent Proxy for Blocked Domains
+ * Cloudflare Proxy: Transparent Fix for Blocked Domains
  * 
  * Patches https.request to redirect traffic for Telegram/Discord
  * through a Cloudflare Worker proxy.
@@ -14,10 +14,10 @@ if (PROXY_URL && !PROXY_URL.startsWith("http://") && !PROXY_URL.startsWith("http
   PROXY_URL = `https://${PROXY_URL}`;
 }
 
-const DEBUG = process.env.OUTBOUND_PROXY_DEBUG === "true";
+const DEBUG = process.env.CLOUDFLARE_PROXY_DEBUG === "true" || process.env.OUTBOUND_PROXY_DEBUG === "true";
 
 // Allow user to define what to proxy. Use "*" to proxy everything except internal HF traffic.
-const PROXY_DOMAINS = process.env.OUTBOUND_PROXY_DOMAINS || "api.telegram.org,discord.com,discordapp.com,gateway.discord.gg,status.discord.com";
+const PROXY_DOMAINS = process.env.CLOUDFLARE_PROXY_DOMAINS || process.env.OUTBOUND_PROXY_DOMAINS || "api.telegram.org,discord.com,discordapp.com,gateway.discord.gg,status.discord.com";
 const BLOCKED_DOMAINS = PROXY_DOMAINS.split(",").map(d => d.trim());
 const PROXY_ALL = PROXY_DOMAINS === "*";
 
@@ -65,7 +65,7 @@ if (PROXY_URL) {
         const alreadyProxied = options._proxied || (headers && headers["x-target-host"]);
 
         if (shouldProxy && !alreadyProxied) {
-          if (DEBUG) console.log(`[outbound-fix] Redirecting ${hostname}${path} -> ${proxy.hostname}`);
+          if (DEBUG) console.log(`[cloudflare-proxy] Redirecting ${hostname}${path} -> ${proxy.hostname}`);
 
           // 3. Create fresh options for the proxied request
           const newOptions = (typeof options === "string" || options instanceof URL)
@@ -105,13 +105,13 @@ if (PROXY_URL) {
 
     if (DEBUG) {
       if (PROXY_ALL) {
-        console.log(`[outbound-fix] Transparent proxy active in WILDCARD mode (Proxying ALL except HF internal)`);
+        console.log(`[cloudflare-proxy] Transparent proxy active in WILDCARD mode (Proxying ALL except HF internal)`);
       } else {
-        console.log(`[outbound-fix] Transparent proxy active for: ${BLOCKED_DOMAINS.join(", ")}`);
+        console.log(`[cloudflare-proxy] Transparent proxy active for: ${BLOCKED_DOMAINS.join(", ")}`);
       }
-      console.log(`[outbound-fix] Target proxy: ${proxy.hostname}`);
+      console.log(`[cloudflare-proxy] Target proxy: ${proxy.hostname}`);
     }
   } catch (e) {
-    if (DEBUG) console.error(`[outbound-fix] Failed to initialize: ${e.message}`);
+    if (DEBUG) console.error(`[cloudflare-proxy] Failed to initialize: ${e.message}`);
   }
 }