n8n-nodes-telegram-proxy

Telegram nodes with HTTP proxy support for n8n

An enhanced version of the official n8n Telegram node with HTTP/HTTPS/SOCKS proxy support.

Features

✅ All features from the official Telegram node ✅ HTTP/HTTPS/SOCKS proxy support ✅ Proxy authentication (username/password) ✅ Works with all Telegram operations ✅ Compatible with n8n 1.0+

Why This Package?

The official n8n Telegram node doesn't support proxy configuration. This fork adds proxy support while maintaining 100% compatibility with all existing Telegram features.

Installation

Option 1: Install from npm (Recommended)

In your n8n directory:

npm install @sajjadsaharkhan/n8n-nodes-telegram-proxy

Then restart n8n.

Option 2: Install globally (for Docker/Kubernetes)

npm install -g @sajjadsaharkhan/n8n-nodes-telegram-proxy

Option 2: Install from Source

git clone https://github.com/sajjadsaharkhan/n8n-nodes-telegram-proxy.git
cd n8n-nodes-telegram-proxy
npm install
npm run build
npm link
# In your n8n directory:
npm link @sajjadsaharkhan/n8n-nodes-telegram-proxy

Usage

Setting Up Proxy

1. In n8n, create a new credential: Credentials → Telegram API (with Proxy)
2. Fill in your Telegram Bot Token from @BotFather
3. Expand the HTTP Proxy section
4. Configure your proxy:
   • Host: Proxy server hostname or IP
   • Port: Proxy port (default: 3128)
   • Protocol: HTTP, HTTPS, or SOCKS
   • Authentication (optional): Username and password

Example Scenarios

Behind a Corporate Proxy

Host: proxy.company.com
Port: 8080
Protocol: HTTP
Username: your-username
Password: your-password

Using SOCKS Proxy

Host: 127.0.0.1
Port: 1080
Protocol: SOCKS

Using Telegram in Restricted Regions

Configure a proxy in a region where Telegram is accessible:

Host: your-vps-ip.com
Port: 3128
Protocol: HTTP

Available Nodes

• Telegram (with Proxy) - Send messages, media, and interact with chats
• Telegram Trigger (with Proxy) - Receive updates from Telegram

All operations from the official Telegram node are supported:

• Send text messages, photos, videos, documents, audio, stickers
• Edit and delete messages
• Manage chats
• Answer callback queries
• And more...

Kubernetes/Docker Deployment

To use this package in a Docker/Kubernetes environment, build a custom n8n image:

FROM n8nio/n8n:latest

USER root
RUN npm install -g @sajjadsaharkhan/n8n-nodes-telegram-proxy
USER node

Or use the multi-stage build approach for smaller images. See KUBERNETES.md for details.

Development

# Clone the repository
git clone https://github.com/sajjadsaharkhan/n8n-nodes-telegram-proxy.git
cd n8n-nodes-telegram-proxy

# Install dependencies
npm install

# Build TypeScript
npm run build

# Watch for changes
npm run dev

Publishing

Automated Publishing via GitHub Actions

This repository uses GitHub Actions to automatically build and publish to npm when you push a version tag:

# Tag and push (triggers the workflow)
git tag v1.0.0
git push origin v1.0.0

Manual Publishing

1. Set your npm token in GitHub Secrets as NPM_TOKEN
2. Or publish locally:

npm run build
npm publish --access public

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

MIT

Acknowledgments

• Based on the official n8n Telegram node
• Built for the n8n workflow automation platform

Disclaimer

This is an unofficial community package. It is not affiliated with or endorsed by n8n or Telegram.

Made with ❤️ for the n8n community