LoveDoLove VPS Management Toolkit

A comprehensive, modular VPS management toolkit with bilingual (Chinese/English) support. Features a Docker App Store, firewall & WAF security, SSL certificate management, kernel & BBR tuning, LDNMP web stack, FRP tunneling, system benchmarks, and more.
Explore the docs »

View Demo · Report Bug · Request Feature

Table of Contents

1. About The Project
   • Built With
2. Getting Started
   • Prerequisites
   • Installation
3. Usage
4. Contributing
5. License
6. Contact
7. Acknowledgments

About The Project

LoveDoLove VPS Management Toolkit is a modular, all-in-one server operations toolbox. The original monolithic scriptbase was completely refactored into a modular architecture with full bilingual (Traditional Chinese / English) support.

Key highlights:

• Modular architecture — each feature lives in its own script under scripts/, loaded on demand from a central main.sh menu or remotely via bash <(curl ...).
• Bilingual by default — the interface auto-detects your system language ($LANG) and renders all menus and messages in Chinese or English.
• One-command deployment — run the toolkit directly from GitHub without downloading anything.
• Cross-distro compatible — verified on Debian/Ubuntu (apt), RHEL/Rocky/Alma/CentOS (dnf/yum), Alpine (apk), Arch (pacman), openSUSE (zypper), and more.
• Docker App Store — deploy MySQL, Redis, phpMyAdmin, Nginx Proxy Manager, Portainer, 1Panel, WordPress, Postgres + pgAdmin, standalone Nginx, Vaultwarden, and sandboxed Node.js/Python environments — all with built-in port collision detection.
• Network-resilient — configurable GitHub proxy (GH_PROXY) for users in mainland China, strict curl timeouts to prevent hanging, and IPv4 preference toggle.

(back to top)

Built With

• 
• 
• 

(back to top)

Getting Started

To get a local copy up and running, follow these simple steps.

Prerequisites

• Root access — most operations require root privileges.
• curl or wget — for remote module loading and API calls.
• Docker (optional) — required for the App Store and LDNMP web stack features.

Installation

Option 1 — Direct remote execution (no download required):

bash <(curl -fsSL https://raw.githubusercontent.com/LoveDoLove/vps-scripts/main/main.sh)

Option 2 — Clone and run locally:

1. Clone the repo

   git clone https://github.com/LoveDoLove/vps-scripts.git

2. Make scripts executable

   cd vps-scripts && chmod +x main.sh scripts/*.sh lib/*.sh

3. Launch the toolkit

   bash main.sh

Option 3 — Specify language on first run:

bash main.sh cn    # Force Chinese interface
bash main.sh en    # Force English interface

(back to top)

Usage

The toolkit presents an interactive numbered menu. Enter the number of the module you want to load:

#	Module	Description
1	System Tools	Hostname, timezone, DNS, SSH port, swap, BBR, Fail2ban
2	Firewall & WAF	Port management, IP blacklist/whitelist, DDoS limits, geo-blocking (ipset)
3	Kernel & BBR	Native BBR, XanMod kernel (BBRv3), ELRepo upgrades
4	SSL Certificates	Let's Encrypt auto-renew, custom cert import, crontab integration
5	LDNMP Web Stack	Docker-based Nginx + MySQL + PHP + Redis, site management with WAF/Brotli/Zstd
6	Docker Management	Docker installation, container monitoring, image cleanup
7	Docker App Store	One-click deploy MySQL, Redis, phpMyAdmin, NPM, Portainer, 1Panel, WordPress, Postgres, Nginx, Vaultwarden
8	FRP Tunneling	FRP client/server setup with port forwarding and monitoring (Grafana/Prometheus)
9	Backups & Cron	/home/web backup/restore, scheduled tasks
10	Benchmarks	YABS performance test, speedtest, streaming unlock check, nexttrace routing
11	Network Tools	Cloudflare WARP, DNS optimization, IPv4 preference
12	DD Reinstall	One-click OS reinstall (Linux/Windows)
13	Oracle Cloud	Open iptables ports, remove Oracle monitoring agents, growpart disk resize

For more details, refer to each script's embedded help text or the source code.

(back to top)

See the open issues for a full list of proposed features (and known issues).

(back to top)

Contributing

Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement". Don't forget to give the project a star! Thanks again!

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes (git commit -m 'Add some AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

Development guidelines

• All scripts must source lib/common.sh for colors, package management, and translations.
• Add new UI strings to get_msg() in lib/common.sh (or the module-level translation function).
• The GH_PROXY variable in lib/common.sh should be respected by all modules fetching remote resources.
• Use check_port_taken() before binding container ports in App Store deployments.
• Test across at least Debian/Ubuntu and Alpine before submitting.

Top contributors:

(back to top)

License

Distributed under the MIT License. See LICENSE for more information.

(back to top)

Contact

LoveDoLove - @LoveDoLove

Project Link: https://github.com/LoveDoLove/vps-scripts

(back to top)

Acknowledgments

• Best-README-Template — README template
• othneildrew — README template author
• Thanks to kejilion for the original inspiration
• Docker — container runtime
• Let's Encrypt — free SSL certificates
• Cloudflare WARP — network privacy gateway

(back to top)