Telegram proxy on Cloudflare Worker

How to deploy a Telegram Worker Proxy on Cloudflare Workers with a custom domain.

This guide walks you through deploying the telegram-bot-proxy on Cloudflare Workers and connecting it to your custom domain.

📦 Prerequisites

• A Cloudflare account
• A domain added to Cloudflare
• Telegram Bot token and your Telegram secret path (from setWebhook)

🛠️ Create the Worker

1. Go to your Cloudflare dashboard

2. Navigate to Workers & Pages → Create Application

3. Select the “Workers” tab → Create Worker

4. Give your worker a name, e.g. telegram-proxy

5. In the editor window:

   • Replace the default code with the Telegram proxy script from the GitHub repo:

     👉 Paste this code from telegram-bot-proxy.js (Thanks to tuanpb99)

     javascript

     const TELEGRAM_API_BASE = "https://api.telegram.org"
     async function handleRequest(request) {
     const url = new URL(request.url);
     
     if (url.pathname === '/' || url.pathname === '') {
     return new Response(DOC_HTML, {
       headers: {
           'Content-Type': 'text/html;charset=UTF-8',
           'Cache-Control': 'public, max-age=3600',
       },
     });
     }
     
     // Extract the bot token and method from the URL path
     const pathParts = url.pathname.split('/').filter(Boolean);
     if (pathParts.length < 2 || !pathParts[0].startsWith('bot')) {
       return new Response('Invalid bot request format', { status: 400 });
     }
     
     // Reconstruct the Telegram API URL
     const telegramUrl = `${TELEGRAM_API_BASE}${url.pathname}${url.search}`;
     
     let body = undefined;
     if (request.method !== 'GET' && request.method !== 'HEAD') {
       try {
           body = await request.arrayBuffer();
       } catch (err) {
           return new Response(`Failed to read request body: ${err.message}`, { status: 400 });
       }
     }
     
     const proxyReq = new Request(telegramUrl, {
       method: request.method,
       headers: request.headers,
       body,
       redirect: 'follow',
     });
     
     try {
       const tgRes = await fetch(proxyReq);
       const res = new Response(tgRes.body, tgRes); // Clone Telegram response
       res.headers.set('Access-Control-Allow-Origin', '*');
       res.headers.set('Access-Control-Allow-Methods', 'GET, POST, PUT, DELETE, OPTIONS');
       res.headers.set('Access-Control-Allow-Headers', 'Content-Type');
       return res;
     } catch (err) {
       return new Response(`Error proxying request: ${err.message}`, { status: 500 });
     }
     }
     
     // Handle OPTIONS requests for CORS
     function handleOptions(request) {
       const corsHeaders = {
           'Access-Control-Allow-Origin': '*',
           'Access-Control-Allow-Methods': 'GET, POST, PUT, DELETE, OPTIONS',
           'Access-Control-Allow-Headers': 'Content-Type',
           'Access-Control-Max-Age': '86400',
     };
     
     return new Response(null, {
       status: 204,
       headers: corsHeaders,
     });
     }
     
     // Main event listener for the worker
     addEventListener('fetch', event => {
     const request = event.request;
     
     if (request.method === 'OPTIONS') {
       event.respondWith(handleOptions(request));
     } else {
       event.respondWith(handleRequest(request));
     }
     });

6. Click Save and Deploy

🌐 Add Your Custom Domain

1. Back in Cloudflare Dashboard → Websites → Add a Site (if not already added)

2. Choose your domain (e.g. yourdomain.com)

3. Go to DNS → Add DNS Records:

   • Type: A

   • Name: @

   • Value: 192.0.2.1 (placeholder, used for redirecting to Workers)

   • Proxy status: Proxied (Orange cloud ☁️)

   • Type: A

   • Name: *

   • Value: 192.0.2.1

   • Proxy status: Proxied

4. Make sure your nameservers point to Cloudflare’s as shown in your domain setup panel

🔗 Route Domain to the Worker

1. Go to Workers & Pages → Your Worker → Triggers tab

2. Scroll to Routes

3. Add:

   • yourdomain.com/*
   • *.yourdomain.com/*

4. Click Save

✅ Final Test

1. Open your browser and go to https://yourdomain.com/ then you should see a simple HTML page indicating the worker is running.

2. Set your Telegram bot’s webhook to your new URL:

   bash

   curl "https://yourdomain.com/bot<YOUR_BOT_TOKEN>/<action>"

🎯 Conclusion

You’ve now:

✅ Deployed a Telegram proxy on Cloudflare Worker

✅ Routed your domain to the Worker

✅ Secured your proxy with a secret path

✅ Connected your bot to use the new webhook