Hướng dẫn cách cài đặt proxy cf-worker-telegram để sử dụng Telegram Bot API trên n8n

Việc Telegram chính thức bị chặn ở Việt Nam đã vô tình gây khó khăn cho những bạn sử dụng bot Telegram trong workflow n8n. Chính vì thế, cf-worker-telegram ra đời như một giải pháp giúp bạn vượt qua rào cản mạng bằng cách sử dụng Cloudflare Worker làm proxy trung gian cho Telegram Bot API. Cùng Tino tìm hiểu cách cài đặt proxy cf-worker-telegram qua bài viết dưới đây nhé!

Đôi nét về proxy cf-worker-telegram

cf-worker-telegram là gì?

cf-worker-telegram là một công cụ mã nguồn mở được triển khai trên nền tảng Cloudflare Worker, hoạt động như một proxy trung gian cho Telegram Bot API. Công cụ này cho phép người dùng chuyển tiếp các yêu cầu từ ứng dụng của họ đến API của Telegram thông qua hạ tầng của Cloudflare, giúp vượt qua các rào cản mạng và đảm bảo kết nối ổn định.

Việc chặn Telegram tại Việt Nam theo Công văn số 2312/CVT-CS đã gây ảnh hưởng đến nhiều cá nhân và tổ chức sử dụng nền tảng này cho mục đích hợp pháp, chẳng hạn như tạo worfklow n8n. Trong bối cảnh đó, cf-worker-telegram trở thành một giải pháp hữu ích, giúp người dùng duy trì kết nối với Telegram Bot API một cách an toàn và hiệu quả.

Tính năng nổi bật của cf-worker-telegram

• Proxy trong suốt: Chuyển tiếp các yêu cầu đến API của Telegram mà không bị giới hạn bởi tường lửa hoặc cấm truy cập.
• Không lưu trữ hoặc chỉnh sửa token bot: Công cụ hoạt động như một proxy trung gian, không can thiệp, lưu trữ hay thay đổi token bot của bạn. Điều này đảm bảo rằng token của bạn luôn an toàn và không bị rò rỉ trong quá trình sử dụng.
• Không lưu trữ logs: cf-worker-telegram không lưu trữ nhật ký hoạt động (logs), giúp giảm thiểu rủi ro bị lộ thông tin người dùng hoặc dữ liệu nhạy cảm trong quá trình sử dụng dịch vụ.
• Bắt buộc sử dụng HTTPS: Toàn bộ giao tiếp giữa client và worker đều được mã hóa bằng HTTPS theo mặc định — đây là yêu cầu bắt buộc từ Cloudflare Workers. Điều này giúp đảm bảo mọi thông tin được truyền đi luôn trong trạng thái an toàn và riêng tư.
• Triển khai nhanh chóng: Sử dụng Cloudflare Worker, bạn không cần máy chủ riêng. Công cụ tận dụng sức mạnh của Cloudflare CDN toàn cầu, giúp giảm độ trễ, tăng tốc độ kết nối và đảm bảo tính ổn định kể cả khi Telegram bị hạn chế truy cập tại Việt Nam.
• Chuyển tiếp trực tiếp đến máy chủ API của Telegram: Mọi yêu cầu từ ứng dụng của bạn sẽ được chuyển tiếp trực tiếp đến API Telegram, không qua bất kỳ máy chủ trung gian nào khác. Nhờ đó, dữ liệu không bị can thiệp hay bị thay đổi trong quá trình truyền tải.
• Bảo mật cao: Không lưu trữ hoặc chỉnh sửa token bot, đảm bảo tính bảo mật cho người dùng.
• Hỗ trợ đầy đủ các phương thức HTTP: GET, POST, PUT, DELETE.
• Tương thích với các ứng dụng web: Hỗ trợ đầy đủ CORS, giúp tích hợp dễ dàng vào các ứng dụng web.

Hướng dẫn cách cài đặt proxy cf-worker-telegram

Tải file mã nguồn

Bạn cần tải file telegram-bot-proxy.js, đây là file chứa mã nguồn của Cloudflare Worker dùng để tạo proxy cho Telegram Bot API.

Truy cập vào: https://github.com/tuanpb99/cf-worker-telegram để tải.

Tạo Worker trên Cloudflare

Bước 1: Vào trang quản trị Cloudflare, nhìn bên thanh bên trái → chọn Compute (Worker).

Bước 2: Trong phần Overview, chọn Wokers theo nhu cầu, khuyên sử dụng Start with Hello World!

Bước 3: Đặt tên Worker sao cho dễ nhớ và mang tính mô tả.

Sau khi đặt tên, nhấn Deploy để hoàn tất triển khai.

Bước 4: Nhấn Edit code để thay đổi code của Work

Bước 5: Mở file telegram-bot-proxy.js mà bạn đã tải về từ kho lưu trữ của dự án cf-worker-telegram.

Sao chép toàn bộ nội dung của file này và dán nội dung mã vào phần chỉnh sửa mã của Worker rồi nhấn Deploy.

Sau khi Deploy hoàn tất, bạn sao chép đường link này.

Như vậy, bạn đã hoàn tất tạo proxy cf-worker-telegram để sử dụng Telegram Bot API.

Sử dụng Telegram Bot API

Trong ví dụ này, Tino sẽ hướng dẫn bạn xác thực n8n với Telegram Bot API

Bước 1: Truy cập n8n.

Bước 2: Mở workflow có node Telegram và nhấp đúp để mở cấu hình node này.

Bước 3: Nhấp vào biểu tượng cây bút tại mục Credential to connect with và sửa phần Base URL

Thay thế link https://api.telegram.org thành link proxy cf worker telegram mà bạn vừa tạo ở trên. Sau đó, nhấn Save để lưu lại và sử dụng. Ví dụ: https://abc.baoth.workers.dev/

Lúc này, bạn đã có thể sử dụng node Telegram trên n8n bình thường mà không cần lo ngại về việc ứng dụng bị chặn ở Việt Nam.

Nếu có thắc mắc trong quá trình thực hiện, bạn hãy liên hệ cho Tino qua hotline 1800 6734 để được hỗ trợ nhé! Chúc bạn thành công!