更新

2026-03-13 14:08:52 +08:00
parent 08dd9cd307
commit eb283f008b
667 changed files with 8425 additions and 27053 deletions
@@ -0,0 +1,291 @@
+# 部署指南
+
+## 快速开始
+
+### 1. 本地开发环境
+
+```bash
+# 安装依赖
+npm install
+
+# 启动开发服务器
+npm run dev
+
+# 访问
+http://localhost:5173
+```
+
+### 2. 生产环境打包
+
+```bash
+# 打包
+npm run build
+
+# 输出目录
+dist/
+
+# 文件会自动复制到
+../server/public/admin/
+```
+
+## 部署步骤
+
+### 步骤 1: 配置 HTTPS
+
+TUIKit 视频通话功能需要 HTTPS 环境。
+
+**快速配置（推荐）：**
+
+```bash
+# 使用自动化脚本
+sudo bash setup-https.sh
+
+# 按照提示输入：
+# - 项目路径
+# - API 端口
+```
+
+**手动配置：**
+
+参考 `HTTPS_DEPLOYMENT_GUIDE.md`
+
+### 步骤 2: 配置 Nginx
+
+使用提供的 `nginx-production.conf` 文件：
+
+```bash
+# 复制配置
+sudo cp nginx-production.conf /etc/nginx/sites-available/admin
+
+# 编辑配置（修改路径和端口）
+sudo nano /etc/nginx/sites-available/admin
+
+# 创建软链接
+sudo ln -s /etc/nginx/sites-available/admin /etc/nginx/sites-enabled/
+
+# 测试配置
+sudo nginx -t
+
+# 重启 Nginx
+sudo systemctl restart nginx
+```
+
+### 步骤 3: 验证部署
+
+```bash
+# 检查 HTTPS 连接
+curl -I https://api.zzzhengyangtang.cn/admin
+
+# 检查证书
+sudo certbot certificates
+
+# 查看 Nginx 日志
+sudo tail -f /var/log/nginx/admin_https_error.log
+```
+
+## 文件说明
+
+| 文件 | 说明 |
+|------|------|
+| `nginx-production.conf` | Nginx HTTPS 配置文件 |
+| `setup-https.sh` | 自动化 HTTPS 配置脚本 |
+| `HTTPS_DEPLOYMENT_GUIDE.md` | 详细的 HTTPS 部署指南 |
+| `TROUBLESHOOTING.md` | 故障排查指南 |
+| `diagnose.js` | 浏览器诊断脚本 |
+| `src/utils/checkHttps.ts` | HTTPS 检查工具 |
+
+## 常见问题
+
+### Q: 页面打不开
+
+**A:** 
+1. 检查 Nginx 配置：`sudo nginx -t`
+2. 查看错误日志：`sudo tail -f /var/log/nginx/error.log`
+3. 确保静态文件路径正确
+4. 清除浏览器缓存
+
+### Q: TUIKit 错误
+
+**A:**
+1. 确保使用 HTTPS 协议
+2. 检查浏览器控制台错误
+3. 运行诊断脚本：`diagnose.js`
+4. 查看 `TROUBLESHOOTING.md`
+
+### Q: 视频通话无法连接
+
+**A:**
+1. 检查网络连接
+2. 检查防火墙设置
+3. 确保后端 API 正常运行
+4. 检查签名获取是否成功
+
+### Q: 证书过期
+
+**A:**
+```bash
+# 手动续期
+sudo certbot renew
+
+# 检查自动续期任务
+sudo crontab -l
+```
+
+## 性能优化
+
+### 1. 启用 Gzip 压缩
+
+在 `nginx-production.conf` 中添加：
+
+```nginx
+gzip on;
+gzip_types text/plain text/css text/javascript application/javascript;
+gzip_min_length 1000;
+```
+
+### 2. 启用浏览器缓存
+
+已在 `nginx-production.conf` 中配置
+
+### 3. 使用 CDN
+
+修改 `vite.config.ts`：
+
+```typescript
+export default defineConfig({
+    base: 'https://your-cdn.com/admin/',
+    // ...
+})
+```
+
+### 4. 监控性能
+
+在浏览器控制台运行 `diagnose.js` 查看性能指标
+
+## 监控和维护
+
+### 日志监控
+
+```bash
+# 实时查看 Nginx 访问日志
+sudo tail -f /var/log/nginx/admin_https_access.log
+
+# 查看错误日志
+sudo tail -f /var/log/nginx/admin_https_error.log
+
+# 查看应用日志
+tail -f /path/to/your/app.log
+```
+
+### 证书监控
+
+```bash
+# 查看证书状态
+sudo certbot certificates
+
+# 检查证书有效期
+openssl x509 -in /etc/letsencrypt/live/api.zzzhengyangtang.cn/fullchain.pem -noout -dates
+
+# 测试自动续期
+sudo certbot renew --dry-run
+```
+
+### 系统监控
+
+```bash
+# 检查磁盘空间
+df -h
+
+# 检查内存使用
+free -h
+
+# 检查 CPU 使用
+top
+
+# 检查进程
+ps aux | grep nginx
+```
+
+## 安全建议
+
+1. **启用 HSTS**（已配置）
+   - 强制使用 HTTPS
+   - 防止中间人攻击
+
+2. **定期更新**
+   ```bash
+   # 更新系统
+   sudo apt update && sudo apt upgrade
+   
+   # 更新 Node.js 依赖
+   npm update
+   ```
+
+3. **备份重要文件**
+   ```bash
+   # 备份 SSL 证书
+   sudo tar -czf ssl-backup.tar.gz /etc/letsencrypt/
+   
+   # 备份应用文件
+   tar -czf app-backup.tar.gz /path/to/your/app/
+   ```
+
+4. **配置防火墙**
+   ```bash
+   # 允许 HTTP 和 HTTPS
+   sudo ufw allow 80/tcp
+   sudo ufw allow 443/tcp
+   
+   # 允许 SSH
+   sudo ufw allow 22/tcp
+   
+   # 启用防火墙
+   sudo ufw enable
+   ```
+
+## 故障排查
+
+### 问题：页面加载缓慢
+
+**解决：**
+1. 检查网络连接
+2. 启用 Gzip 压缩
+3. 使用 CDN
+4. 优化资源大小
+
+### 问题：内存占用过高
+
+**解决：**
+1. 检查浏览器扩展
+2. 清除缓存
+3. 重启浏览器
+4. 检查应用内存泄漏
+
+### 问题：连接超时
+
+**解决：**
+1. 检查网络连接
+2. 增加超时时间
+3. 检查防火墙
+4. 检查后端服务
+
+## 获取帮助
+
+1. 查看 `TROUBLESHOOTING.md` 获取详细的故障排查指南
+2. 运行 `diagnose.js` 诊断脚本
+3. 查看 Nginx 和应用日志
+4. 参考 TUIKit 官方文档：https://cloud.tencent.com/document/product/647
+
+## 更新日志
+
+### v1.0.0 (2024-03-12)
+
+- ✓ 初始版本
+- ✓ HTTPS 配置支持
+- ✓ TUIKit 错误处理
+- ✓ 诊断工具
+- ✓ 部署指南
+
+## 许可证
+
+MIT