1. 文档概述
本文档详细说明在 Velidc VPS 上安装、配置并初始化 1Panel（现代化开源 Linux 服务器运维面板）的完整步骤。适用于 CentOS、Ubuntu、Debian 等主流 Linux 系统，可直接用于生产环境部署与技术归档。
2. 环境要求
2.1 硬件与系统
表格
| 项目 | 要求 |
|---|---|
| 内存 | 最低 512MB，生产环境推荐 1GB+ |
| 硬盘 | 至少 1GB 可用空间 |
| 系统 | CentOS 7+/Ubuntu 18.04+/Debian 9+（全新干净系统，无预装 Nginx/Apache/MySQL） |
| 权限 | 必须使用 root 用户执行所有操作 |
| 网络 | 服务器可访问公网（用于下载安装包与 Docker 镜像） |
2.2 端口放行（Velidc 安全组必开）
表格
| 端口 | 用途 | 备注 |
|---|---|---|
| 18080 | 1Panel 面板默认端口 | 安装后建议修改为 10000-65535 区间 |
| 80 | HTTP 网站服务 | 必须开放 |
| 443 | HTTPS 网站服务 | 必须开放 |
| 22 | SSH 远程连接 | 必须开放 |
| 3306 | MySQL 数据库（按需） | 建议仅内网访问 |
3. 一键安装
3.1 执行安装脚本
在服务器 SSH 终端执行以下统一一键安装命令：
bash
运行
curl -sSL https://resource.fit2cloud.com/1panel/package/v2/quick_start.sh -o quick_start.sh && bash quick_start.sh
3.2 安装流程
- 执行脚本后，按提示按下 Enter 采用默认配置，或自定义面板端口、存储目录。
- 等待 2-5 分钟，安装完成后会输出唯一访问信息，务必保存：
bash
运行
==============================================
1Panel 安装成功！
==============================================
外网面板地址: http://VPS_IP:18080/Security_Entry
内网面板地址: http://Internal_IP:18080/Security_Entry
默认用户名: admin
默认密码: 1panel@Random_Password
==============================================
⚠️ 重要：首次登录后立即修改默认密码，避免安全风险。
4. 面板初始化配置
4.1 首次登录
- 浏览器访问安装输出的外网面板地址（包含 Security_Entry 安全路径，不可省略）。
- 使用默认用户名
admin和自动生成的密码登录。 - 首次登录强制要求修改默认密码，建议设置强密码（大小写 + 数字 + 特殊字符）。
- 可在右上角切换语言为「简体中文」。
4.2 部署 Web 环境（推荐 LNMP）
1Panel 基于 Docker 部署，轻量隔离。通过「应用商店」或「网站」模块部署：
- 进入「应用商店」：分别搜索安装 Nginx、MySQL、PHP。
- 版本推荐：Nginx 1.24+、MySQL 5.7/8.0、PHP 7.4-8.3
- 进入「网站」模块：点击「创建网站」，选择已部署的运行环境，一键完成网站创建。
5. 安全加固（生产环境必做）
- 修改面板端口：进入「设置 → 面板设置」，将 18080 改为 10000-65535 之间的端口，并在 Velidc 安全组放行新端口、关闭旧端口。
- 开启面板 SSL：在「面板设置」中申请 Let’s Encrypt 免费证书，启用 HTTPS。
- 配置防火墙：仅开放 80、443、面板端口、22 端口，关闭所有不必要端口。
- 启用定期备份：在「备份」模块创建任务，定期备份面板配置、网站文件与数据库。
6. 常用命令行管理
bash
运行
# 管理 1Panel 服务
systemctl start|stop|restart|status 1panel
# 管理 Docker 服务（依赖）
systemctl start|stop|restart|status docker
# 管理 Web 应用（Docker 容器）
1panel app start|stop|restart nginx
1panel app start|stop|restart mysql
1panel app start|stop|restart php81
# 重置面板密码（忘记时）
1panel cli changepassword <新密码>
7. 常见问题排查
- 无法访问面板：检查 Velidc 安全组与服务器防火墙端口是否放行；重启 1Panel 服务 (
systemctl restart 1panel)。 - 安装失败：确保系统为全新干净系统；测试网络连通性 (
ping resource.fit2cloud.com)；查看安装日志 (cat /var/log/1panel/install.log)。 - 服务启动失败：查看应用日志 (
1panel app log <应用名>) 或 Docker 日志 (docker logs <容器名>) 定位问题。
8. 卸载 1Panel
若需卸载，执行以下官方一键脚本：
bash
运行
curl -sSL https://resource.fit2cloud.com/1panel/package/v2/uninstall.sh -o uninstall.sh && bash uninstall.sh
9. 官方资源链接
- 1Panel 官网：https://1panel.cn/
- 1Panel 文档：https://1panel.cn/docs/
