How dkanil/vpn_bot works
This repository implements a Telegram bot for managing VPN clients in a 3x-ui panel. Users request access, await admin approval, and can then obtain a subscription link; administrators manage approvals and payment actions. The bot also synchronizes panel client data, checks payment periods in the background, and supports broadcasts and database export. The graph follows documented capabilities, but several handler details were not sampled, so those links rely on the README rather than inspected handler code.
Main entry points: main.py Bot runtime · db.py User records · auth.py 3x-ui API access · filter.py User filtering
Components 18
Telegram workflows
- Bot runtime
main.py - Access approval
main.py - Setup guidance
main.py - Broadcasts
main.py
VPN client management
- Subscription link
main.py - Client provisioning
main.py - 3x-ui API access
auth.py
Payment operations
- Client synchronization
main.py - Payment monitoring
main.py - Payment actions
main.py
Shared services
- Database export
main.py - User records
db.py - User filtering
filter.py - Bot configuration
config.py - Message templates
messages.yaml
Other components
- VPN user
- Administrator
- 3x-ui panel
Connections 25
- VPN user → Bot runtime: sends commands
README.md - Administrator → Bot runtime: sends commands
README.md - Bot runtime → Access approval: routes requests
README.md - Access approval → Administrator: requests approval
README.md - VPN user → Setup guidance: requests help
README.md - Bot runtime → Subscription link: routes request
README.md - Subscription link → Client provisioning: gets credentials
main.py - Client provisioning → 3x-ui API access: requests client operations
main.py - 3x-ui API access → 3x-ui panel: calls panel API
README.md - Bot runtime → Client synchronization: runs synchronization
main.py - Client synchronization → 3x-ui API access: requests client list
main.py - Client synchronization → User records: updates client records
main.py - Bot runtime → Payment monitoring: starts background check
main.py - Payment monitoring → Client synchronization: refreshes client data
main.py - Payment monitoring → User records: reads payment records
main.py - Payment monitoring → Administrator: sends reminders
README.md - VPN user → Payment actions: requests renewal
README.md - Administrator → Payment actions: manages payments
README.md - Payment actions → User records: updates payment records
README.md - Administrator → Broadcasts: starts broadcast
README.md - Administrator → Database export: requests database
README.md - Bot runtime → User filtering: installs middleware
main.py - User filtering → User records: checks user status
filter.py - Bot runtime → Bot configuration: uses settings
main.py - Bot configuration → Message templates: loads templates
config.py