Language / زبان: English | فارسی

SSH Plus Manager

A terminal-based manager for SSH users and network services on Linux servers. Create and remove users, set passwords and expiration dates, limit simultaneous connections, monitor traffic, and manage OpenSSH, Dropbear, OpenVPN, Squid, SOCKS, SSL tunnel, and SSLH — all from one menu.

---

Features

User management

Feature	Description
Create user	Add SSH users with password, expiration date, and connection limit. Supports OpenVPN (.ovpn) generation.
Remove user	Remove one user or all users; removes the user’s record from the centralized $HOME/users.db and cleans OpenVPN certs.
User info	List all users with password, connection limit, and validity (days left or expired).
Change password	Change a user’s password via the service (chpasswd) and keep $HOME/users.db in sync.
Change expiration	Set or change account expiration date per user.
Change limit	Set max simultaneous connections per user (stored in $HOME/users.db).
Expired users	List accounts past expiration and remove them in one go.

Monitoring and traffic

Feature	Description
Monitor users	Live table: online/offline/expired/expiring, connections, session time, down/up traffic, validity, last seen. Auto-refresh interval configurable (default: 30s).
VPS traffic	Live network traffic view with nload (Ctrl+C to exit).
VPS info	Hostname, IPv4/IPv6, OS, kernel, uptime, RAM/CPU/disk usage, listening ports, SSH/Dropbear/OpenVPN connection counts.

Connection modes and services

Feature	Description
Connections	Submenu: OpenSSH (multi-port), Squid proxy, Dropbear, OpenVPN, SOCKS proxy (SSH + OpenVPN), SSL tunnel (stunnel), SSLH multiplexer. Install, configure ports, and manage each service.
SSH multi-port	Add/remove SSH ports via sshd_config and systemd socket; UFW rules applied.

System and maintenance

Feature	Description
Speedtest	Run download/upload speed test (uses speedtest-cli).
Banner	Set SSH login banner (e.g. IP, welcome text; uses figlet).
Backup	Back up user/list and manager-related data.
Reboot system	Reboot the server (with confirmation).
Restart services	Restart SSH (and related) services.
Root password	Change the root password (with confirmation).

Manager lifecycle

Feature	Description
Auto run	Toggle “run menu on login” (add/remove menu; in /etc/profile).
Update script	Check repo version and update all manager files from the repository.
Remove script	Uninstall manager scripts (with double confirmation).

---

Installation

Run one of these on your server as root (use the first if you have curl, the second if you have wget). The URL must match REPO_URL in the version file.

# With curl:
bash <(curl -Ls https://raw.githubusercontent.com/techamateur/SSH-Plus-Manager/main/install.sh)

# With wget:
wget -qO- https://raw.githubusercontent.com/techamateur/SSH-Plus-Manager/main/install.sh | bash

Requirements: Root, curl or wget, and a Debian/Ubuntu-style system. The installer installs dependencies (e.g. wget, curl, screen, nano, python3, nload, figlet, speedtest-cli).

---

Usage

After installation, run:

menu

Or the short alias:

h

In submenus, 0 = back, 00 = exit.

---

Project structure

SSH-Plus-Manager/
├── install.sh          # One-line installer: deps, download Install/list, run bootstrap
├── version              # Version string (e.g. 1.0.0) for update checks
├── Install/
│   └── list             # Bootstrap: download Modules, dirs, hosts, crontab, version
├── Modules/
│   ├── menu             # Main loop; sources colors, shows dashboard, dispatches to scripts
│   ├── colors           # UI: msg_ok/msg_err/msg_warn/msg_info, banner_info/banner_danger, color_echo, menu_option, c(), hr, kv
│   ├── createuser       # [01] Create SSH user + optional OpenVPN
│   ├── removeuser       # [02] Remove one or all users
│   ├── sshmonitor       # [03] Live user/connection/traffic monitor
│   ├── changeexpiration # [04] Change user expiration date
│   ├── changelimit      # [05] Change connection limit per user
│   ├── changepassword   # [06] Change user password
│   ├── expiredusers     # [07] Remove expired users
│   ├── connections      # [08] OpenSSH/Squid/Dropbear/OpenVPN/SOCKS/SSL/SSLH
│   ├── multiport       # Called from connections: SSH multi-port (sshd + systemd + UFW)
│   ├── speedtest       # [09] speedtest-cli
│   ├── bannersetup      # [10] SSH banner
│   ├── vpstraffic       # [11] nload
│   ├── userbackup       # [12] Backup
│   ├── vpsinfo          # [13] System info
│   ├── rebootsystem     # [14] Reboot
│   ├── restartservices  # [15] Restart SSH
│   ├── rootpassword     # [16] Root password
│   ├── autorun          # [17] Menu on login
│   ├── updatescript     # [18] Update from repo
│   ├── removescript     # [19] Uninstall
│   ├── open.py          # SOCKS over OpenVPN (used by connections)
│   └── proxy.py         # SOCKS over SSH (used by connections)
├── docs/                # USAGE, TROUBLESHOOTING, SSH-MULTIPORT (+ Persian)
└── README.md

Installed layout (after install.sh + Install/list):

• Scripts in /bin/ (e.g. /bin/menu, /bin/createuser).
• colors, db, open.py, proxy.py in /etc/SSHPlus/.
• User DB (single source of truth): $HOME/users.db (8 fields per user).
• Session audit log (append-only): $HOME/sessions.log.

---

Documentation

• docs/USAGE.md — All menu options and behavior.
• docs/TROUBLESHOOTING.md — Common issues and fixes.
• docs/SSH-MULTIPORT.md — SSH multi-port setup (systemd + UFW).

فارسی: README.fa.md · راهنما · رفع مشکلات · چند پورت SSH

---

Contributing

Contributions are welcome. Follow the conventions below so the project stays consistent and easy to maintain.

Conventions

1. Scripts

   • Bash: #!/bin/bash, use [[ ]] and quoted variables ("$var"). Prefer print_header " Title " and color_echo / menu_option from colors instead of raw tput or \033.
   • Python: Use Python 3; print() and bytes for socket I/O where appropriate.

2. Module layout

   • First line: shebang.
   • Second block: short comment # scriptname – one-line description (menu option [NN] LABEL).
   • Then: load colors from /etc/SSHPlus/colors, /bin/colors, or $(dirname "$0")/colors.
   • Use msg_err, msg_ok, msg_warn, msg_info for feedback.

3. User lists

   • Build list with awk -F: '$3>=1000 {print $1}' /etc/passwd (and filter e.g. grep -v nobody). Use idx and display index i with [[ $idx -le 9 ]] && i=0$idx || i=$idx. Build _userPass as _userPass+="\n${i}:${username}". Resolve option to user with:
     awk -v o="$option" -F: 'NF>=2 && $1+0==o+0 {print $2; exit}' so that typing 1 or 01 both select the first user.

4. Paths

   • User DB: $HOME/users.db. Sessions: $HOME/sessions.log. Version: /etc/SSHPlus/version or /bin/version.

5. Exit codes

   • 0 = back to menu, 99 = exit entirely (menu handles this and exits).

Adding a new menu option

1. Add the script under Modules/ with the header and color loading as above.
2. In Modules/menu, add a line in the menu block (e.g. [20] MY FEATURE) and a case) that runs your script (and handles exit 99 if needed).
3. In Install/list, add the script name to the _mdls array (or equivalent) so it is downloaded and installed.
4. In Modules/updatescript, add the script to the for spec in ... list so updates overwrite it.
5. Update docs/USAGE.md (and optionally Persian docs) with the new option.

Before submitting

• Run your script on a test VM (e.g. Debian/Ubuntu as root).
• Prefer no extra dependencies; if you add one, document it and add it to install.sh dependency list if it must be installed for the feature to work.
• Keep changes minimal and consistent with existing style (no trailing whitespace, no expr where (( )) or [[ ]] is enough).

Pull requests

• Describe what the change does and which menu option or file it affects.
• If you add a feature, mention it in README (features table) and/or docs/USAGE.md.

---

License

This project is licensed under the MIT License — see the LICENSE file for details.