first commit
This commit is contained in:
Your Name
@@ -0,0 +1,249 @@
|
||||
# 快速参考卡片
|
||||
|
||||
## 常用命令
|
||||
|
||||
### 开发
|
||||
```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
|
||||
Reference in New Issue
Block a user