In category: ← Proxy

About socks5-proxy-server

SOCKS5 proxy server with built-in authentication and Telegram-bot for user management and user statistics on data spent (handy when you pay per GB of data). It is dockerised and simple to install.

Github stats:

Commits: 63
53
12
Latest commit: May 2, 2023

Deploy this app to Linode with a free $100 credit!

Languages/Platforms/Technologies:

Nodejs

Lincenses:

Apache-2.0

More about socks5-proxy-server

Socks5 proxy server

Prerequisites

Docker (Install Docker)

How to run

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

CLI commands

In all commands you need to call js-script in app docker container.
So you need to find out container name with proxy application by running the following command:

docker compose ps

For example, it will be socks5-proxy-server-proxy-1.

In all the following commands you need to replace socks5-proxy-server-proxy-1 with the yours container name.

Create user

docker exec -it socks5-proxy-server-proxy-1 sh -c 'exec node scripts/create-user.js'

Delete user

docker exec -it socks5-proxy-server-proxy-1 sh -c 'exec node scripts/delete-user.js'

Show users statistics

docker exec -it socks5-proxy-server-proxy-1 sh -c 'exec node scripts/users-stats.js'

Telegram bot for administration

Configuration

Initialize bot at @botfather, get API token
Set params in .env:
PUBLIC_URL - URL to server. E.g. http://proxy.domain.com:8443
TELEGRAM_API_TOKEN - API token from BotFather
TELEGRAM_WEBHOOK_URL - default: /webhook
TELEGRAM_USE_WEBHOOKS - 1 - use webhooks, 0 - use polling. To use webhooks you need to generate ssl certificates

Create admin:

docker exec -it socks5-proxy-server-telegram_bot-1 sh -c 'exec node scripts/create-admin.js'

You also can delete admin via script, if you need:

docker exec -it socks5-proxy-server-telegram_bot-1 sh -c 'exec node scripts/delete-admin.js'

Available commands

/users_stats - show data usage statistics per user
/create_user - create new proxy user
/delete_user - delete proxy user
/get_users - get list of proxy users
/generate_pass [length] - generate random password with specified length (10 by default)