4.6 KiB
4.6 KiB
快速参考卡片
常用命令
开发
npm install # 安装依赖
npm run dev # 启动开发服务器
npm run build # 打包生产版本
npm run lint # 代码检查
npm run type-check # 类型检查
部署
# 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 # 测试续期
日志查看
# 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/ |
部署位置 |
常见问题速查
页面打不开
# 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 错误
// 在浏览器控制台运行诊断脚本
// 复制 diagnose.js 中的代码
证书过期
# 手动续期
sudo certbot renew
# 检查有效期
openssl x509 -in /etc/letsencrypt/live/api.zzzhengyangtang.cn/fullchain.pem -noout -dates
性能问题
# 检查磁盘空间
df -h
# 检查内存
free -h
# 检查 CPU
top
配置检查清单
- 域名 DNS 已解析
- SSL 证书已安装
- Nginx 配置已更新
- 静态文件路径正确
- API 代理端口正确
- Nginx 配置测试通过
- Nginx 已重启
- HTTPS 访问正常
- 证书自动续期已配置
- 防火墙已配置
性能优化
启用 Gzip
gzip on;
gzip_types text/plain text/css text/javascript application/javascript;
gzip_min_length 1000;
启用缓存
location ~* \.(js|css|png|jpg|jpeg|gif|ico|svg|woff|woff2|ttf|eot)$ {
expires 1y;
add_header Cache-Control "public, immutable";
}
使用 CDN
// vite.config.ts
export default defineConfig({
base: 'https://your-cdn.com/admin/',
})
安全检查
SSL 测试
# 使用 openssl
openssl s_client -connect api.zzzhengyangtang.cn:443
# 使用 curl
curl -I https://api.zzzhengyangtang.cn/admin
# 在线测试
https://www.ssllabs.com/ssltest/
防火墙配置
# 允许 HTTPS
sudo ufw allow 443/tcp
# 允许 HTTP（用于重定向）
sudo ufw allow 80/tcp
# 查看规则
sudo ufw status
监控命令
# 实时监控 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'
备份和恢复
备份
# 备份 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/
恢复
# 恢复 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