selfhost.directory

The index of self-hostable projects — ranked, categorized and served with live updates.
Own your data and stop giving it to big tech.

GitHub
socks5-proxy-server logo

Self-host socks5-proxy-server

v1.20.0

Self-hosted SOCKS5 proxy with Telegram admin bot

ReleaseOpen SourceApache-2.0
Docker ComposeCompose file & guide
docker compose up -d
Updated7 months ago
LanguageJavaScript
Setup difficultyModerate
Stars
145
Ports
54321 (SOCKS5 proxy server), 8443 (Telegram bot webhook server)
Requires
Redis

What is socks5-proxy-server?

Socks5 proxy server is a self-hosted SOCKS5 proxy written in Node.js that runs via Docker Compose. It provides a SOCKS5 proxy service on a configurable port with optional username/password authentication. User accounts are managed through CLI commands executed inside the container. An optional Telegram bot allows administrators to create and delete users, view usage statistics, and generate passwords. The stack includes a Redis database for storing user data and statistics. The project is open source under the Apache-2.0 license.

Should you self-host socks5-proxy-server?

socks5-proxy-server scores 43/100 on selfhost.directory (how scoring works) and ranks #5 of 10 in Network. It has 145 GitHub stars.

It shipped 1 stable release in the past year. The latest, v1.20.0, came out on 29 November 2025.

Setup is moderate: expect some configuration beyond a single command. It is Apache-2.0-licensed and written mostly in JavaScript.

Its closest alternative on selfhost.directory is scanopy (64/100, 5 913 stars). It scores higher overall, so compare the two before you pick. See socks5-proxy-server vs scanopy side by side.

Features

  • Password generation
  • SOCKS5 Proxy
  • Telegram admin botOptional; requires bot token and webhook/polling configuration
  • Usage statistics
  • User Authentication
  • User management via CLI

socks5-proxy-server README

How to install socks5-proxy-server

Install socks5-proxy-server with Docker Compose

Environment variables
APP_PORT, LOG_LEVEL, REQUIRE_AUTH, PUBLIC_URL, TELEGRAM_API_TOKEN, TELEGRAM_WEBHOOK_URL, TELEGRAM_USE_WEBHOOKS, BOT_APP_PORT, NTBA_FIX_319
  • Copy .env.example file: cp .env.example .env
  • Fill in configuration: nano .env. Fields:
    • APP_PORT - proxy server port (default: 54321),
    • LOG_LEVEL - log level (default: INFO),
    • REQUIRE_AUTH - if set to 1, anonymous users are not allowed.
  • Start application: docker compose up -d

Requires Docker and Docker Compose installed

How to configure socks5-proxy-server

  • APP_PORT54321Proxy app config

    Proxy app config

  • BOT_APP_PORT8443
  • LOG_LEVELINFO
  • NTBA_FIX_3191
  • PUBLIC_URLTelegram bot app config

    Telegram bot app config

  • REQUIRE_AUTH0
  • TELEGRAM_API_TOKEN
  • TELEGRAM_USE_WEBHOOKS0
  • TELEGRAM_WEBHOOK_URL/webhook

socks5-proxy-server releases & version history

More in Network

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…