Free Archive | 5-in-1 One-Click VPN Installation Script

Free Archive | iwantrun.com One-Click Multi-Protocol VPN Installation Script

One-click multi-protocol VPN / proxy node installation script based on sing-box, supporting VLESS, Hysteria2, AnyTLS, gRPC Reality, and TUIC.

Project Address: https://github.com/iwantruncom/multi-protocol-vpn

Project Acknowledgements: Comrade Zhang Gousheng

🚀 One-Click Installation 🧩 Multi-Protocol Support 📱 Automatic QR Code 👥 User Management ⚙️ sing-box Unified Management ☁️ Suitable for Small VPS

📖 I. Project Concept

In an era where information is blocked by high walls and the truth is selectively concealed, the tool itself can also become a small but concrete form of resistance.

The so-called “foreign forces” should not become a source of fear for people to obtain information; the so-called “prosperous times” should not come at the cost of blocking knowledge and restricting speech.

Allow more people trapped in information cocoons to have the opportunity to access the real world.

🖼️ II. Script Demonstration Diagram

Main Menu and Management Functions

自由档案馆一键多协议VPN脚本演示图

Protocol Selection and Installation Process

一键多协议VPN脚本协议安装演示图

🚀 III. Which protocols are supported?

This script currently supports 5 protocols, all based on sing-box unified management.

Option Protocol Working Principle Anti-Blocking Level Recommended Index
1 VLESS + REALITY + Vision Simulates normal HTTPS/TLS connections, no domain name or certificate required ★★★★★ ★★★★★
2 Hysteria2 Based on QUIC/UDP, biased towards high speed and anti-packet loss ★★★★☆ ★★★★☆
3 AnyTLS A new type of TLS direction protocol, close to ordinary TLS traffic ★★★★☆ ★★★☆☆
4 VLESS + gRPC + REALITY VLESS Reality + gRPC transmission method ★★★★☆ ★★★☆☆
5 TUIC Based on QUIC/UDP, biased towards low latency and high speed ★★★★☆ ★★★★☆
Beginner’s suggestion: If you don’t know which one to choose, prioritize VLESS + REALITY + Vision.

✨ IV. Project Features

One-Click Installation Chinese menu, even beginners can complete the installation according to the prompts.
Multi-Protocol Support One script supports 5 common protocols.
Based on sing-box Unified core, easy to start, stop, restart and update.
Automatic Random Port Reduces port conflicts and also supports manual custom ports.
QR Code Output The node link and QR code are automatically displayed after installation.
User Management Supports adding users, deleting users, and viewing users.

🖥️ V. Recommended Systems and VPS

Recommended System

Beginners are advised to prioritize Ubuntu 22.04 LTS.

Recommended System
Ubuntu 22.04 LTS

The script also supports common Linux systems such as Debian, CentOS, Rocky Linux, and AlmaLinux.

VPS Recommendation

Suitable for deployment on common small VPS, such as Vultr, Linode, Hetzner, DigitalOcean, Oracle Cloud, AWS Lightsail, Google Cloud, etc.

Project Recommended Configuration
CPU 1 core is sufficient
Memory 512MB or more
Hard Disk 5GB or more
System Ubuntu 22.04 / Ubuntu 24.04
For personal use or backup nodes, small VPS is usually enough.

🔐 VI. Preparation Before Use: SSH Login to VPS

Before running the installation command, you need to log in to the VPS via SSH. VPS service providers generally provide the server IP, username, password, or SSH key.

Common Login Commands

root user login
ssh root@your server IP

🪟 VII. Windows / macOS Recommended SSH Tools

Windows Recommendation Windows Terminal, PowerShell, PuTTY, Xshell.
macOS Recommendation The system’s built-in Terminal terminal is sufficient.
Login Method After opening the terminal, enter ssh root@your server IP.

⚙️ VIII. Installation Command

The following provides two installation methods: wget and curl.

Note: Only choose one to execute, do not execute both. If the wget command fails, use the curl command.

Method 1: Install using wget

wget one-click installation command
wget -O vpn.sh https://raw.githubusercontent.com/iwantruncom/multi-protocol-vpn/main/vpn.sh && chmod +x vpn.sh && sudo bash vpn.sh

Method 2: Install using curl

curl one-click installation command
curl -L -o vpn.sh https://raw.githubusercontent.com/iwantruncom/multi-protocol-vpn/main/vpn.sh && chmod +x vpn.sh && sudo bash vpn.sh

📋 IX. Menu Functions

After running the script, you will see the main menu:

Main menu example
1. Install / Reinstall Protocol
2. Manage Current Service
3. User Management
4. View Current Node Link
5. Uninstall
0. Exit
Install Protocol Choose VLESS, Hysteria2, AnyTLS, gRPC Reality, or TUIC.
Manage Service Start, stop, restart, view status, view logs, update sing-box.
User Management Add users, delete users, generate QR codes for specified users.

🔥 X. Firewall Reminder

After installation, the script will prompt the ports that need to be released, for example:

Port release example
Manually release the current port: 12345/TCP
Important: Please manually release the corresponding port in the VPS backend firewall / security group. If the port is not released, the client may not be able to connect.

Common firewalls that need to be checked include Vultr Firewall, Linode Firewall, Hetzner Firewall, DigitalOcean Firewall, AWS Security Group, Google Cloud Firewall, Oracle Cloud Security List, etc.

❓ XI. Frequently Asked Questions

1. Why can’t I connect after the installation is successful?

First check whether the VPS backend firewall / security group has released the port prompted by the script.

2. Do I need a domain name?

A domain name is not required by default. The protocols integrated in this script can be deployed without a domain name.

3. Do I need a certificate?

No need to manually apply for a certificate, the script will automatically handle the relevant configuration according to different protocols.

4. How to view the node QR code?

After running the script, select 4. View Current Node Link to display the node link and QR code.

5. How to add a user?

After running the script, select 3. User Management, then select 2. Add User.

6. How to restart the service?

After running the script, select 2. Manage Current Service, then select 3. Restart sing-box.

📁 12. Common File Locations

File Path
sing-box program /usr/local/bin/sing-box
sing-box configuration /etc/sing-box/config.json
Script management information /etc/freedom-vpn/info.json
systemd service /etc/systemd/system/sing-box.service

🛠️ 13. Manual Common Commands

View service status
systemctl status sing-box
Restart service
systemctl restart sing-box
View real-time logs
journalctl -u sing-box -f --no-pager
Check configuration
sing-box check -c /etc/sing-box/config.json

Discover more from 自由档案馆

Subscribe to get the latest posts sent to your email.