添加一键部署使用指南
This commit is contained in:
WanWanYun
230
INSTALL_GUIDE.md
Normal file
230
INSTALL_GUIDE.md
Normal file
@@ -0,0 +1,230 @@
|
|||||||
|
# 玩玩云 - 一键部署指南
|
||||||
|
|
||||||
|
## 🚀 一键安装命令
|
||||||
|
|
||||||
|
在您的服务器上执行以下任意一条命令即可开始安装：
|
||||||
|
|
||||||
|
### 方式1: 使用 curl
|
||||||
|
```bash
|
||||||
|
curl -fsSL https://gitee.com/yu-yon/vue-driven-cloud-storage/raw/master/install.sh | bash
|
||||||
|
```
|
||||||
|
|
||||||
|
### 方式2: 使用 wget
|
||||||
|
```bash
|
||||||
|
wget -qO- https://gitee.com/yu-yon/vue-driven-cloud-storage/raw/master/install.sh | bash
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 📋 系统要求
|
||||||
|
|
||||||
|
### 支持的操作系统
|
||||||
|
- Ubuntu 18.04 / 20.04 / 22.04
|
||||||
|
- Debian 10 / 11 / 12
|
||||||
|
- CentOS 7 / 8
|
||||||
|
- RHEL 7 / 8
|
||||||
|
|
||||||
|
### 硬件要求
|
||||||
|
- **CPU**: 1核心及以上
|
||||||
|
- **内存**: 最低512MB，推荐1GB+
|
||||||
|
- **磁盘**: 最低2GB可用空间，推荐5GB+
|
||||||
|
- **网络**: 需要能访问外网（下载依赖包）
|
||||||
|
|
||||||
|
### 端口要求
|
||||||
|
- **80**: HTTP访问（必须）
|
||||||
|
- **443**: HTTPS访问（可选，如果使用SSL）
|
||||||
|
- **40001**: 后端服务端口（内部使用）
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 🎯 部署流程
|
||||||
|
|
||||||
|
执行安装命令后，脚本会自动引导您完成以下步骤：
|
||||||
|
|
||||||
|
### 1️⃣ 环境检测
|
||||||
|
自动检测系统信息：
|
||||||
|
- 操作系统类型和版本
|
||||||
|
- CPU架构
|
||||||
|
- 内存和磁盘空间
|
||||||
|
- 网络连接状态
|
||||||
|
- 公网IP地址
|
||||||
|
|
||||||
|
### 2️⃣ 选择软件源
|
||||||
|
```
|
||||||
|
请选择软件包安装源:
|
||||||
|
[1] 官方源 (国外服务器推荐)
|
||||||
|
[2] 阿里云镜像源 (国内服务器推荐，速度更快)
|
||||||
|
```
|
||||||
|
**建议**: 国内服务器选择 [2]，国外服务器选择 [1]
|
||||||
|
|
||||||
|
### 3️⃣ 自动安装依赖
|
||||||
|
脚本会自动安装以下环境（如果未安装）：
|
||||||
|
- Node.js 18.x
|
||||||
|
- Nginx
|
||||||
|
- PM2
|
||||||
|
- SQLite3
|
||||||
|
- 其他必要工具
|
||||||
|
|
||||||
|
### 4️⃣ 选择访问模式
|
||||||
|
|
||||||
|
#### 域名模式 (推荐)
|
||||||
|
```
|
||||||
|
请选择访问模式:
|
||||||
|
[1] 域名模式 (推荐，支持HTTPS)
|
||||||
|
[2] IP模式 (仅HTTP，适合测试)
|
||||||
|
```
|
||||||
|
|
||||||
|
**如果选择 [1] 域名模式**:
|
||||||
|
1. 输入您的域名（例如: wwy.example.com）
|
||||||
|
2. 脚本会自动验证域名解析
|
||||||
|
3. 选择SSL证书部署方式
|
||||||
|
|
||||||
|
#### SSL证书方案
|
||||||
|
```
|
||||||
|
请选择SSL证书自动部署方式:
|
||||||
|
|
||||||
|
【推荐方案】
|
||||||
|
[1] Certbot (Let's Encrypt官方工具)
|
||||||
|
- 最稳定可靠，支持自动续期
|
||||||
|
|
||||||
|
【备选方案】
|
||||||
|
[2] acme.sh + Let's Encrypt
|
||||||
|
- 纯Shell脚本，更轻量级
|
||||||
|
[3] acme.sh + ZeroSSL
|
||||||
|
- Let's Encrypt的免费替代品
|
||||||
|
[4] acme.sh + Buypass
|
||||||
|
- 挪威免费CA，有效期180天
|
||||||
|
|
||||||
|
【云服务商证书】
|
||||||
|
[5] 阿里云免费证书 (需提供AccessKey)
|
||||||
|
[6] 腾讯云免费证书 (需提供SecretKey)
|
||||||
|
|
||||||
|
【其他选项】
|
||||||
|
[7] 使用已有证书 (手动上传证书文件)
|
||||||
|
[8] 暂不配置HTTPS (可后续配置)
|
||||||
|
```
|
||||||
|
|
||||||
|
**建议**:
|
||||||
|
- 首选 [1] Certbot
|
||||||
|
- 如果失败，脚本会自动建议尝试 [2] 或 [3]
|
||||||
|
- 测试环境可选 [8] 跳过HTTPS
|
||||||
|
|
||||||
|
### 5️⃣ 配置管理员账号
|
||||||
|
```
|
||||||
|
管理员用户名 [默认: admin]:
|
||||||
|
管理员密码（至少6位）:
|
||||||
|
确认密码:
|
||||||
|
```
|
||||||
|
|
||||||
|
### 6️⃣ 自动部署
|
||||||
|
脚本会自动完成：
|
||||||
|
- ✅ 创建项目目录
|
||||||
|
- ✅ 从Gitee下载项目代码
|
||||||
|
- ✅ 安装后端依赖（npm install）
|
||||||
|
- ✅ 创建配置文件和数据库
|
||||||
|
- ✅ 部署SSL证书（如果选择）
|
||||||
|
- ✅ 配置Nginx反向代理
|
||||||
|
- ✅ 启动后端服务（PM2管理）
|
||||||
|
- ✅ 健康检查
|
||||||
|
|
||||||
|
### 7️⃣ 部署完成
|
||||||
|
```
|
||||||
|
╔═══════════════════════════════════════════════════════════════╗
|
||||||
|
║ ║
|
||||||
|
║ 🎉 部署成功！ ║
|
||||||
|
║ ║
|
||||||
|
╚═══════════════════════════════════════════════════════════════╝
|
||||||
|
|
||||||
|
访问地址: https://wwy.example.com
|
||||||
|
管理员账号: admin
|
||||||
|
管理员密码: ********
|
||||||
|
|
||||||
|
常用命令:
|
||||||
|
查看服务状态: pm2 status
|
||||||
|
查看日志: pm2 logs wanwanyun-backend
|
||||||
|
重启服务: pm2 restart wanwanyun-backend
|
||||||
|
停止服务: pm2 stop wanwanyun-backend
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 🔧 常见问题
|
||||||
|
|
||||||
|
### 1. 如何查看部署日志？
|
||||||
|
```bash
|
||||||
|
pm2 logs wanwanyun-backend
|
||||||
|
```
|
||||||
|
|
||||||
|
### 2. 如何重启服务？
|
||||||
|
```bash
|
||||||
|
pm2 restart wanwanyun-backend
|
||||||
|
```
|
||||||
|
|
||||||
|
### 3. 如何修改配置？
|
||||||
|
编辑配置文件后重启服务：
|
||||||
|
```bash
|
||||||
|
nano /var/www/wanwanyun/backend/.env
|
||||||
|
pm2 restart wanwanyun-backend
|
||||||
|
```
|
||||||
|
|
||||||
|
### 4. SSL证书过期怎么办？
|
||||||
|
- **Certbot**: 自动续期，无需手动操作
|
||||||
|
- **acme.sh**: 自动续期，无需手动操作
|
||||||
|
- **手动证书**: 需要手动更新证书文件并重启Nginx
|
||||||
|
|
||||||
|
### 5. 忘记管理员密码怎么办？
|
||||||
|
修改配置文件并重启：
|
||||||
|
```bash
|
||||||
|
nano /var/www/wanwanyun/backend/.env
|
||||||
|
# 修改 ADMIN_PASSWORD 的值
|
||||||
|
pm2 restart wanwanyun-backend
|
||||||
|
```
|
||||||
|
|
||||||
|
### 6. 如何卸载？
|
||||||
|
```bash
|
||||||
|
# 停止服务
|
||||||
|
pm2 delete wanwanyun-backend
|
||||||
|
|
||||||
|
# 删除项目目录
|
||||||
|
rm -rf /var/www/wanwanyun
|
||||||
|
|
||||||
|
# 删除Nginx配置
|
||||||
|
rm -f /etc/nginx/sites-enabled/wanwanyun.conf
|
||||||
|
systemctl reload nginx
|
||||||
|
```
|
||||||
|
|
||||||
|
### 7. 端口被占用怎么办？
|
||||||
|
检查端口占用：
|
||||||
|
```bash
|
||||||
|
netstat -tunlp | grep :80
|
||||||
|
netstat -tunlp | grep :40001
|
||||||
|
```
|
||||||
|
|
||||||
|
停止占用端口的进程或修改配置文件端口。
|
||||||
|
|
||||||
|
### 8. 域名解析未生效怎么办？
|
||||||
|
- 等待DNS解析生效（通常需要几分钟到几小时）
|
||||||
|
- 暂时选择 [8] 跳过HTTPS配置
|
||||||
|
- 解析生效后可手动配置SSL
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 📞 获取帮助
|
||||||
|
|
||||||
|
- **项目地址**: https://gitee.com/yu-yon/vue-driven-cloud-storage
|
||||||
|
- **问题反馈**: 提交Issue到Gitee仓库
|
||||||
|
- **部署文档**: 查看项目README.md
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 📝 注意事项
|
||||||
|
|
||||||
|
1. **需要root权限**: 脚本需要使用 `sudo` 或以root用户运行
|
||||||
|
2. **防火墙设置**: 确保80和443端口已开放
|
||||||
|
3. **域名解析**: 使用域名模式前，请先将域名解析到服务器IP
|
||||||
|
4. **备份数据**: 升级前请备份数据库和配置文件
|
||||||
|
5. **网络环境**: 需要能够访问外网下载依赖包
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
**祝您使用愉快！** 🎉
|
||||||
Reference in New Issue
Block a user