From c8b8026d435f2d54dcc1b192cbdb7a2a96a16fce Mon Sep 17 00:00:00 2001
From: WanWanYun <wanwanyun@example.com>
Date: Mon, 10 Nov 2025 22:56:57 +0800
Subject: [PATCH] =?UTF-8?q?=E6=B7=BB=E5=8A=A0=E4=B8=80=E9=94=AE=E9=83=A8?=
 =?UTF-8?q?=E7=BD=B2=E4=BD=BF=E7=94=A8=E6=8C=87=E5=8D=97?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 INSTALL_GUIDE.md | 230 +++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 230 insertions(+)
 create mode 100644 INSTALL_GUIDE.md

diff --git a/INSTALL_GUIDE.md b/INSTALL_GUIDE.md
new file mode 100644
index 0000000..750fd49
--- /dev/null
+++ b/INSTALL_GUIDE.md
@@ -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. **网络环境**: 需要能够访问外网下载依赖包
+
+---
+
+**祝您使用愉快！** 🎉