# 快速参考卡片

## 常用命令

### 开发
```bash
npm install          # 安装依赖
npm run dev         # 启动开发服务器
npm run build       # 打包生产版本
npm run lint        # 代码检查
npm run type-check  # 类型检查
```

### 部署
```bash
# HTTPS 配置
sudo bash setup-https.sh

# Nginx 操作
sudo nginx -t                    # 测试配置
sudo systemctl restart nginx     # 重启 Nginx
sudo systemctl status nginx      # 查看状态

# 证书管理
sudo certbot certificates        # 查看证书
sudo certbot renew              # 续期证书
sudo certbot renew --dry-run    # 测试续期
```

### 日志查看
```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
```

## 文件位置

| 文件 | 位置 | 说明 |
|------|------|------|
| 源代码 | `src/` | Vue 应用源代码 |
| 打包输出 | `dist/` | 生产环境文件 |
| 配置文件 | `vite.config.ts` | Vite 配置 |
| 环境变量 | `.env.production` | 生产环境变量 |
| Nginx 配置 | `nginx-production.conf` | Nginx 配置文件 |
| SSL 证书 | `/etc/letsencrypt/live/` | SSL 证书位置 |
| 静态文件 | `/path/to/server/public/admin/` | 部署位置 |

## 常见问题速查

### 页面打不开
```bash
# 1. 检查 Nginx
sudo nginx -t

# 2. 查看错误日志
sudo tail -f /var/log/nginx/error.log

# 3. 检查文件权限
ls -la /path/to/server/public/admin/

# 4. 清除浏览器缓存
Ctrl+Shift+Delete
```

### TUIKit 错误
```javascript
// 在浏览器控制台运行诊断脚本
// 复制 diagnose.js 中的代码
```

### 证书过期
```bash
# 手动续期
sudo certbot renew

# 检查有效期
openssl x509 -in /etc/letsencrypt/live/api.zzzhengyangtang.cn/fullchain.pem -noout -dates
```

### 性能问题
```bash
# 检查磁盘空间
df -h

# 检查内存
free -h

# 检查 CPU
top
```

## 配置检查清单

- [ ] 域名 DNS 已解析
- [ ] SSL 证书已安装
- [ ] Nginx 配置已更新
- [ ] 静态文件路径正确
- [ ] API 代理端口正确
- [ ] Nginx 配置测试通过
- [ ] Nginx 已重启
- [ ] HTTPS 访问正常
- [ ] 证书自动续期已配置
- [ ] 防火墙已配置

## 性能优化

### 启用 Gzip
```nginx
gzip on;
gzip_types text/plain text/css text/javascript application/javascript;
gzip_min_length 1000;
```

### 启用缓存
```nginx
location ~* \.(js|css|png|jpg|jpeg|gif|ico|svg|woff|woff2|ttf|eot)$ {
    expires 1y;
    add_header Cache-Control "public, immutable";
}
```

### 使用 CDN
```typescript
// vite.config.ts
export default defineConfig({
    base: 'https://your-cdn.com/admin/',
})
```

## 安全检查

### SSL 测试
```bash
# 使用 openssl
openssl s_client -connect api.zzzhengyangtang.cn:443

# 使用 curl
curl -I https://api.zzzhengyangtang.cn/admin

# 在线测试
https://www.ssllabs.com/ssltest/
```

### 防火墙配置
```bash
# 允许 HTTPS
sudo ufw allow 443/tcp

# 允许 HTTP（用于重定向）
sudo ufw allow 80/tcp

# 查看规则
sudo ufw status
```

## 监控命令

```bash
# 实时监控 Nginx 访问
sudo tail -f /var/log/nginx/admin_https_access.log | grep -v "\.js\|\.css\|\.png"

# 监控错误
sudo tail -f /var/log/nginx/admin_https_error.log

# 监控进程
watch -n 1 'ps aux | grep nginx'

# 监控连接
sudo netstat -tlnp | grep nginx

# 监控磁盘
watch -n 1 'df -h'

# 监控内存
watch -n 1 'free -h'
```

## 备份和恢复

### 备份
```bash
# 备份 SSL 证书
sudo tar -czf ssl-backup.tar.gz /etc/letsencrypt/

# 备份应用
tar -czf app-backup.tar.gz /path/to/your/app/

# 备份 Nginx 配置
sudo tar -czf nginx-backup.tar.gz /etc/nginx/
```

### 恢复
```bash
# 恢复 SSL 证书
sudo tar -xzf ssl-backup.tar.gz -C /

# 恢复应用
tar -xzf app-backup.tar.gz -C /

# 恢复 Nginx 配置
sudo tar -xzf nginx-backup.tar.gz -C /
```

## 故障排查流程

```
问题出现
    ↓
1. 检查浏览器控制台错误
    ↓
2. 运行诊断脚本 (diagnose.js)
    ↓
3. 检查 Nginx 日志
    ↓
4. 检查应用日志
    ↓
5. 查看 TROUBLESHOOTING.md
    ↓
6. 检查网络连接
    ↓
7. 检查防火墙设置
    ↓
8. 重启服务
    ↓
问题解决
```

## 联系方式

- 项目文档：查看 `DEPLOYMENT_README.md`
- 故障排查：查看 `TROUBLESHOOTING.md`
- 部署指南：查看 `HTTPS_DEPLOYMENT_GUIDE.md`
- 解决方案：查看 `SOLUTION_SUMMARY.md`

## 有用的链接

- TUIKit 文档：https://cloud.tencent.com/document/product/647
- Nginx 文档：https://nginx.org/en/docs/
- Let's Encrypt：https://letsencrypt.org/
- SSL 测试：https://www.ssllabs.com/ssltest/
- WebRTC 兼容性：https://caniuse.com/webrtc

---

**最后更新**: 2024-03-12