# 🎉 Soul 项目部署完成报告

## 📋 部署信息

**部署时间**: 2026-01-15 06:03  
**项目名称**: soul  
**项目类型**: Next.js 16.0.10  
**服务器**: 42.194.232.22  

---

## ✅ 部署状态

### 1. 项目部署
- ✅ 项目文件已上传（3.70 MB）
- ✅ 依赖安装成功（使用 pnpm）
- ✅ Next.js 项目构建成功
- ✅ 项目已启动（PM2 管理）

### 2. 服务配置
- **部署目录**: `/www/wwwroot/soul`
- **运行端口**: `3006`
- **进程管理**: PM2
- **进程状态**: online ✅

### 3. 域名配置
- **域名**: soul.quwanzhi.com
- **Nginx 反向代理**: 已配置 ✅
- **Nginx 状态**: 运行中 ✅
- **访问测试**: HTTP 200 OK ✅

---

## 🌐 访问方式

### 域名访问
```
http://soul.quwanzhi.com
```

### IP 直接访问
```
http://42.194.232.22:3006
```

---

## 📊 项目路由

项目共包含 **42 个路由**，主要路由如下：

### 用户端路由
- `/` - 首页
- `/about` - 关于页面
- `/login` - 登录页面
- `/chapters` - 章节列表
- `/read/[id]` - 章节阅读
- `/match` - 匹配功能
- `/my` - 个人中心
- `/my/purchases` - 我的购买
- `/my/referral` - 推荐奖励

### 管理后台
- `/admin` - 管理后台首页
- `/admin/login` - 后台登录
- `/admin/users` - 用户管理
- `/admin/content` - 内容管理
- `/admin/payment` - 支付管理
- `/admin/settings` - 系统设置
- `/admin/site` - 站点配置
- `/admin/qrcodes` - 二维码管理
- `/admin/withdrawals` - 提现管理

### API 接口
- `/api/admin/*` - 后台管理接口
- `/api/book/*` - 书籍相关接口
- `/api/payment/*` - 支付相关接口
- `/api/wechat/*` - 微信相关接口
- `/api/content` - 内容接口
- `/api/config` - 配置接口
- `/api/orders` - 订单接口

---

## 🛠️ 管理命令

### PM2 进程管理

```bash
# 查看项目日志
pm2 logs soul

# 重启项目
pm2 restart soul

# 停止项目
pm2 stop soul

# 查看项目状态
pm2 status soul

# 查看详细信息
pm2 show soul

# 删除项目
pm2 delete soul
```

### Nginx 管理

```bash
# 测试配置
nginx -t

# 重载配置
nginx -s reload

# 重启 Nginx
systemctl restart nginx

# 查看 Nginx 状态
systemctl status nginx
```

### 项目文件管理

```bash
# 进入项目目录
cd /www/wwwroot/soul

# 查看项目文件
ls -la

# 查看项目日志
tail -f logs/error.log
tail -f logs/out.log

# 查看 Nginx 日志
tail -f /www/wwwlogs/soul.quwanzhi.com.log
tail -f /www/wwwlogs/soul.quwanzhi.com.error.log
```

---

## 🔄 更新部署

如需更新项目，可以重新运行部署脚本：

```bash
cd /Users/karuo/Documents/开发/4、小工具/服务器管理
python3 部署soul项目.py
```

脚本会自动：
1. ✅ 停止旧进程
2. ✅ 上传新代码
3. ✅ 安装依赖
4. ✅ 构建项目
5. ✅ 启动新进程

---

## 🔧 技术栈

### 前端框架
- **Next.js**: 16.0.10
- **React**: 19.2.3
- **TypeScript**: 5.9.3

### UI 框架
- **Tailwind CSS**: 4.1.18
- **Radix UI**: 组件库
- **Framer Motion**: 动画库
- **Lucide React**: 图标库

### 其他依赖
- **Zustand**: 状态管理
- **Playwright**: 测试工具
- **docx**: 文档生成
- **gray-matter**: Markdown 解析

---

## 📝 配置文件

### PM2 配置
位置: `/www/wwwroot/soul/ecosystem.config.json`

```json
{
  "apps": [{
    "name": "soul",
    "cwd": "/www/wwwroot/soul",
    "script": "node_modules/next/dist/bin/next",
    "args": "start",
    "env": {
      "NODE_ENV": "production",
      "PORT": "3006"
    },
    "instances": 1,
    "exec_mode": "fork"
  }]
}
```

### Nginx 配置
位置: `/www/server/panel/vhost/nginx/soul.quwanzhi.com.conf`

主要配置：
- 反向代理到 `127.0.0.1:3006`
- WebSocket 支持
- 静态资源缓存优化
- 日志记录

---

## 🎯 性能优化

### Next.js 配置
- ✅ Standalone 输出模式（减小体积）
- ✅ 图片优化（unoptimized）
- ✅ TypeScript 构建错误忽略

### Nginx 配置
- ✅ HTTP/1.1 长连接（keepalive）
- ✅ 代理缓冲优化
- ✅ 静态资源缓存（60分钟）
- ✅ 客户端上传限制（50MB）

---

## 🔐 安全建议

1. **建议配置 SSL 证书**
   - 使用宝塔面板一键申请免费 SSL
   - 配置 HTTPS 访问

2. **建议设置环境变量**
   - 数据库连接信息
   - API 密钥
   - 敏感配置

3. **建议配置防火墙**
   - 仅开放必要端口（80, 443）
   - 限制管理端口访问

---

## 📞 故障排查

### 项目无法访问

1. 检查 PM2 进程状态
   ```bash
   pm2 status soul
   ```

2. 查看项目日志
   ```bash
   pm2 logs soul --lines 100
   ```

3. 检查端口监听
   ```bash
   netstat -tuln | grep 3006
   ```

### Nginx 错误

1. 测试配置
   ```bash
   nginx -t
   ```

2. 查看错误日志
   ```bash
   tail -f /www/wwwlogs/soul.quwanzhi.com.error.log
   ```

3. 重启 Nginx
   ```bash
   nginx -s reload
   ```

---

## 🎊 部署成功！

你的 Soul 项目已成功部署到服务器，现在可以通过以下方式访问：

**🌐 主域名**: http://soul.quwanzhi.com

项目已在 PM2 中运行，并配置了自动重启。服务器重启后会自动恢复运行。

---

**部署脚本位置**: `/Users/karuo/Documents/开发/4、小工具/服务器管理/部署soul项目.py`
