Files

WanWanYun 4a38026c07 文档更新: 添加v1.1.3卸载功能详细说明

更新内容:
- INSTALL_GUIDE.md: 完善FAQ第6项卸载说明
- 添加一键卸载命令（3种方式）
- 详细说明卸载特性：双重确认、数据备份、完整清理
- 说明保留系统环境，仅删除项目文件
- 添加智能残留检查说明

2025-11-10 23:49:51 +08:00

6.5 KiB

Raw Blame History

玩玩云 - 一键部署指南

🚀 一键安装命令

在您的服务器上执行以下任意一条命令即可开始安装：

方式1: 使用 curl

curl -fsSL https://gitee.com/yu-yon/vue-driven-cloud-storage/raw/master/install.sh | bash

方式2: 使用 wget

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] 域名模式:

输入您的域名（例如: wwy.example.com）
脚本会自动验证域名解析
选择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. 如何查看部署日志？

pm2 logs wanwanyun-backend

2. 如何重启服务？

pm2 restart wanwanyun-backend

3. 如何修改配置？

编辑配置文件后重启服务：

nano /var/www/wanwanyun/backend/.env
pm2 restart wanwanyun-backend

4. SSL证书过期怎么办？

Certbot: 自动续期，无需手动操作
acme.sh: 自动续期，无需手动操作
手动证书: 需要手动更新证书文件并重启Nginx

5. 忘记管理员密码怎么办？

修改配置文件并重启：

nano /var/www/wanwanyun/backend/.env
# 修改 ADMIN_PASSWORD 的值
pm2 restart wanwanyun-backend

6. 如何卸载？

使用一键卸载命令：

# 方式1: 在线卸载
curl -fsSL https://gitee.com/yu-yon/vue-driven-cloud-storage/raw/master/install.sh | bash -s -- --uninstall

# 方式2: 在线卸载
wget -qO- https://gitee.com/yu-yon/vue-driven-cloud-storage/raw/master/install.sh | bash -s -- --uninstall

# 方式3: 本地卸载（如果已下载脚本）
bash install.sh --uninstall

卸载特性:

双重确认机制，防止误删
可选数据备份到 /root/wanwanyun-backup-YYYYMMDD-HHMMSS
完整清理：
- PM2 进程: wanwanyun-backend
- 项目目录: /var/www/wanwanyun
- Nginx 配置: /etc/nginx/sites-enabled/wanwanyun.conf
- SSL 证书: /etc/nginx/ssl/*
- 临时文件和缓存
保留系统环境：
- Node.js
- Nginx
- PM2
- 编译工具（build-essential、gcc-c++等）
智能残留检查

手动卸载（仅作参考，推荐使用自动卸载）:

# 停止服务
pm2 delete wanwanyun-backend

# 删除项目目录
rm -rf /var/www/wanwanyun

# 删除Nginx配置
rm -f /etc/nginx/sites-enabled/wanwanyun.conf
systemctl reload nginx

7. 端口被占用怎么办？

检查端口占用：

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

📝 注意事项

需要root权限: 脚本需要使用 sudo 或以root用户运行
防火墙设置: 确保80和443端口已开放
域名解析: 使用域名模式前，请先将域名解析到服务器IP
备份数据: 升级前请备份数据库和配置文件
网络环境: 需要能够访问外网下载依赖包

祝您使用愉快！ 🎉

6.5 KiB Raw Blame History Unescape Escape