# 玩玩云 - 部署指南

## 🚀 快速部署（3分钟完成）

### 第一步：上传项目到服务器

```bash
# 方法1: 使用scp上传
scp -r ftp-web-manager root@服务器IP:/var/www/

# 方法2: 使用FTP工具上传到 /var/www/ 目录
```

### 第二步：SSH登录服务器

```bash
ssh root@服务器IP
```

### 第三步：一键部署

```bash
cd /var/www/ftp-web-manager
bash deploy.sh
```

部署脚本会自动：
- ✅ 检查Docker环境
- ✅ 创建必要目录
- ✅ 构建Docker镜像
- ✅ 启动所有服务
- ✅ 显示访问信息

### 第四步：访问系统

打开浏览器访问：
```
http://服务器IP:8080
```

使用默认账号登录：
```
用户名: admin
密码: admin123
```

**⚠️ 重要：首次登录后立即修改密码！**

---

## 📋 环境要求

- Docker 20.10.0+
- Docker Compose 2.0.0+
- 最低 1GB 内存（推荐 2GB+）
- Linux 系统（Ubuntu/Debian/CentOS）

---

## 🔧 手动部署（如果自动脚本失败）

```bash
# 1. 进入项目目录
cd /var/www/ftp-web-manager

# 2. 创建必要目录
mkdir -p certbot/conf certbot/www backend/uploads

# 3. 构建并启动
docker-compose up --build -d

# 4. 查看日志
docker-compose logs -f
```

---

## ✅ 部署验证

检查容器状态：
```bash
docker-compose ps
```

应该看到3个容器都是 "Up" 状态：
- wanwanyun-backend
- wanwanyun-frontend
- wanwanyun-certbot

查看后端日志：
```bash
docker-compose logs backend
```

应该看到：
```
数据库初始化完成
默认管理员账号已创建
玩玩云已启动
```

---

## 🛑 停止服务

```bash
cd /var/www/ftp-web-manager
docker-compose down
```

---

## 🔄 重启服务

```bash
cd /var/www/ftp-web-manager
docker-compose restart
```

---

## 📦 更新代码

```bash
cd /var/www/ftp-web-manager
git pull  # 或重新上传文件
docker-compose up --build -d
```

---

## ❓ 常见问题

### Q: 端口8080被占用怎么办？

修改 docker-compose.yml 中的端口映射：
```yaml
ports:
  - "8081:80"  # 改为8081或其他端口
```

### Q: Docker容器启动失败？

```bash
# 查看详细日志
docker-compose logs backend

# 重新构建
docker-compose down
docker-compose up --build -d
```

### Q: 忘记管理员密码怎么办？

删除数据库文件重新初始化：
```bash
docker-compose down
rm backend/ftp-manager.db
docker-compose up -d
```

### Q: 如何配置HTTPS？

参考主README.md中的SSL配置章节。

---

## 📞 获取帮助

- 查看详细文档: README.md
- 查看部署检查报告: 桌面上的检查报告文件
- 查看对话历史: 桌面上的对话总结文件

---

**部署成功后，记得：**
1. ✅ 修改admin密码
2. ✅ 配置SFTP连接
3. ✅ 设置JWT密钥（backend/.env）
4. ✅ 配置HTTPS（生产环境）
5. ✅ 定期备份数据库

祝您使用愉快！☁️