socks5-proxy-server

socks5-proxy-server is a minimal Node.js implementation of a SOCKS5 proxy that supports authenticated users, per-user usage statistics, and administration via CLI or a Telegram bot.

Key Features

• SOCKS5 proxy implementation with configurable listening port and log level
• Optional authentication support (REQUIRE_AUTH toggle) and per-user credentials
• Docker Compose first-class deployment with environment-based configuration
• CLI scripts for creating/deleting users and viewing usage statistics
• Optional Telegram bot for administration (create/delete users, stats, password generation)
• Supports webhook or polling modes for Telegram; webhooks require SSL certificates
• Simple logging and usage accounting per user

Use Cases

• Provide authenticated outbound SOCKS5 proxy access for teams or services
• Manage proxy users and track per-user bandwidth or usage via CLI or Telegram bot
• Rapidly deploy a small-scale proxy in Docker-based environments for development or small production needs

Limitations and Considerations

• Administration is via CLI scripts or Telegram bot only; there is no web-based admin UI
• Webhook-based Telegram administration requires valid TLS/SSL certificates
• Repository targets single-node deployments; clustering, high-availability, or built-in persistent database backends are not provided out of the box

socks5-proxy-server is a practical, lightweight option for teams that need a simple, self-hosted SOCKS5 proxy with basic user management and remote administration via Telegram. It is optimized for quick Docker deployments and straightforward operation rather than enterprise-scale proxy features.