https://github.com/amyrahmady/ssh-telegram-bot
A Telegram bot to manage your SSH users
https://github.com/amyrahmady/ssh-telegram-bot
censorship filtering iran napsternetv ssh ssh-direct ssh-management ssh-tunnel ssh-tunneling ssh-users ssh-vpn
Last synced: 6 days ago
JSON representation
A Telegram bot to manage your SSH users
- Host: GitHub
- URL: https://github.com/amyrahmady/ssh-telegram-bot
- Owner: AmyrAhmady
- License: bsd-3-clause
- Created: 2023-07-06T05:32:14.000Z (almost 3 years ago)
- Default Branch: master
- Last Pushed: 2026-01-26T19:15:17.000Z (2 months ago)
- Last Synced: 2026-01-27T07:02:07.126Z (2 months ago)
- Topics: censorship, filtering, iran, napsternetv, ssh, ssh-direct, ssh-management, ssh-tunnel, ssh-tunneling, ssh-users, ssh-vpn
- Language: TypeScript
- Homepage:
- Size: 33.2 KB
- Stars: 10
- Watchers: 1
- Forks: 4
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# SSH User Management Telegram Bot
This bot allows you to create or delete (edit functionality will be added in future) your server users which can be accessed over SSH.
This can be useful for people who want to create SSH users solely for the purpose of tunneling and using it as a VPN.
### Usage:
1. Clone this repository on your server using git:
```bash
git clone https://github.com/AmyrAhmady/ssh-telegram-bot.git
```
2. Use your desire package manager to install node packages:
```
// if you are using yarn
yarn
// if you are using npm
npm i
// if you are using pnpm
pnpm i
```
3. Edit `.env.example` with the right credentials and info, then rename it to `.env`
4. Run the project with the `start` command:
```
// if you are using yarn
yarn start
// if you are using npm
npm start
// if you are using pnpm
pnpm start
```
### Client Usage:
- Phone
You can use your created users in apps like `NapsternetV` on your phone to use it as a VPN (SSH-Direct method).
Android link: https://play.google.com/store/apps/details?id=com.napsternetlabs.napsternetv
iOS link: https://apps.apple.com/us/app/napsternetv/id1629465476
- PC
On your PC, using `-ND port_number` with your ssh connection would host a socks5 server with the specified port, example:
```bash
ssh user@hostname_or_ip -ND 8080
```
This would create a socks5 on your machine, locally, with the specified port of `8080` to be used however you like
### Support:
Nothing, just leave a star if you like 🙂