1. Document Overview
This document details the complete steps to install, configure, and initialize 1Panel (a modern open-source Linux server management panel) on Velidc VPS. It supports mainstream Linux systems such as CentOS, Ubuntu, and Debian, and can be directly used for production environment deployment and technical archiving.
2. Environment Requirements
2.1 Hardware and System Requirements
表格
| Item | Requirement |
|---|---|
| Memory | Minimum 512MB, 1GB+ recommended for production |
| Hard Disk | At least 1GB of available space |
| OS | CentOS 7+/Ubuntu 18.04+/Debian 9+ (Brand-new and clean system, no pre-installed Nginx/Apache/MySQL) |
| Permission | Must execute all operations as the root user |
| Network | Server accessible via public network (for downloading installation packages and Docker images) |
2.2 Port Opening (Mandatory for Velidc Security Group)
表格
| Port | Purpose | Note |
|---|---|---|
| 18080 | Default port for 1Panel panel | Recommended to change to a port between 10000-65535 after installation |
| 80 | HTTP web service | Must be opened |
| 443 | HTTPS web service | Must be opened |
| 22 | SSH remote connection | Must be opened |
| 3306 | MySQL database (on demand) | Intranet access only recommended |
3. One-Click Installation
3.1 Execute Installation Script
Run the following unified one-click installation command in the server SSH terminal:
bash
运行
curl -sSL https://resource.fit2cloud.com/1panel/package/v2/quick_start.sh -o quick_start.sh && bash quick_start.sh
3.2 Installation Process
- After executing the script, press Enter to use the default configuration, or customize the panel port and storage directory as prompted.
- Wait for 2-5 minutes. After installation, the unique access information will be output. Be sure to save it:
bash
运行
==============================================
1Panel Installation Successful!
==============================================
External Panel Address: http://VPS_IP:18080/Security_Entry
Internal Panel Address: http://Internal_IP:18080/Security_Entry
Default Username: admin
Default Password: 1panel@Random_Password
==============================================
⚠️ Important: Change the default password immediately after first login to avoid security risks.
4. Panel Initialization Configuration
4.1 First Login
- Access the external panel address (Include the Security_Entry security path, cannot be omitted) in a browser.
- Log in with the default username
adminand the automatically generated password. - Changing the default password is mandatory for first login. Set a strong password (uppercase + lowercase + numbers + special characters).
- You can switch the language to "English" in the upper right corner.
4.2 Deploy Web Environment (Recommended: LNMP)
1Panel deploys environments based on Docker, which is lightweight and isolated. Deploy through the "App Store" or "Websites" module:
- Enter "App Store": Search for and install Nginx, MySQL, and PHP respectively.
- Version Recommendations: Nginx 1.24+, MySQL 5.7/8.0, PHP 7.4-8.3
- Enter "Websites" module: Click "Create Website", select the deployed runtime environment, and complete website creation with one click.
5. Security Hardening (Mandatory for Production Environment)
- Change Panel Port: Go to "Settings → Panel Settings", change 18080 to a port between 10000-65535, and open the new port in Velidc Security Group while closing the old one.
- Enable Panel SSL: Apply for a free Let’s Encrypt certificate in "Panel Settings" to enable HTTPS.
- Configure Firewall: Only open ports 80, 443, panel port, and 22. Close all unnecessary ports.
- Enable Regular Backups: Create backup tasks in the "Backups" module to back up panel configurations, website files, and databases regularly.
6. Common Command Line Management
bash
运行
# Manage 1Panel service
systemctl start|stop|restart|status 1panel
# Manage Docker service (dependency)
systemctl start|stop|restart|status docker
# Manage web applications (Docker containers)
1panel app start|stop|restart nginx
1panel app start|stop|restart mysql
1panel app start|stop|restart php81
# Reset panel password (if forgotten)
1panel cli changepassword <new_password>
7. Common Troubleshooting
- Unable to Access Panel: Check if ports are open in Velidc Security Group and server firewall; restart the 1Panel service (
systemctl restart 1panel). - Installation Failure: Ensure the system is brand-new and clean; test network connectivity (
ping resource.fit2cloud.com); view installation logs (cat /var/log/1panel/install.log). - Service Startup Failure: Locate issues by viewing application logs (
1panel app log <app_name>) or Docker logs (docker logs <container_name>).
