Update README and project cleanup

This commit is contained in:
inkling
2026-04-08 14:52:09 +08:00
commit fafd267288
71 changed files with 14865 additions and 0 deletions

233
DEPLOYMENT_COMPLETE.md Normal file
View File

@@ -0,0 +1,233 @@
# ✅ DMP 公网部署完成
## 🎉 部署状态:全部成功
**部署时间**: 2026-04-07
**部署方式**: Cloudflare Tunnel
**当前状态**: ✅ 运行中
---
## 🌐 公网访问信息
### 主应用地址
- **URL**: https://dmp.ink1ing.tech
- **协议**: HTTPS自动重定向
- **访问方式**: 浏览器直接访问 / API 调用 / 任何公网设备
### API 端点
**获取标签体系**
```
GET https://dmp.ink1ing.tech/api/tags
```
**计算用户集合**
```
POST https://dmp.ink1ing.tech/api/compute
Content-Type: application/json
{
"selected": [
{"tagId": 1, "mode": "include"},
{"tagId": 2, "mode": "include"}
]
}
```
---
## 🔧 后端服务配置
### 本地部署(当前)
- **服务器**: Node.js Express
- **本地端口**: 3456
- **地址**: http://localhost:3456
- **进程**: node server.js (PID: 56028)
### Cloudflare Tunnel 配置
- **Tunnel ID**: d8a6a4cd-4ddf-4122-92f1-b3d961aca422
- **Tunnel 名称**: dmp-tunnel
- **配置文件**: cloudflare-tunnel.yml
- **进程**: cloudflared tunnel (PID: 93347)
- **连接状态**: 活跃1xsjc05, 1xsjc06
### DNS 记录
- **域名**: dmp.ink1ing.tech
- **类型**: CNAME
- **目标**: d8a6a4cd-4ddf-4122-92f1-b3d961aca422.cfargotunnel.com
- **代理**: Cloudflare (已代理)
---
## 📊 部署验证结果
### ✅ 本地访问
- HTTP/1.1 200 OK
- 端点: http://localhost:3456
### ✅ 公网 HTTPS 访问
- HTTP/2 200
- 端点: https://dmp.ink1ing.tech
- CDN: Cloudflare
### ✅ API 功能验证
- /api/tags 端点: ✅ 返回 16 个分类 + 90 个标签
- /api/compute 端点: ✅ 计算 99 users (51.83%)
### ✅ 网络性能
- DNS 查询: <100ms (Cloudflare)
- 响应时间: 28-30ms (API)
- 缓存: 30s TTL
- CDN 加速: 启用
---
## 🚀 启动与管理
### 启动服务
```bash
# 方式 1: 使用启动脚本
cd /Users/inkling/Desktop/dmp
./start-tunnel.sh
# 方式 2: 手动启动
node server.js &
cloudflared tunnel --config cloudflare-tunnel.yml run dmp-tunnel
```
### 停止服务
```bash
pkill -f "node server.js"
pkill -f "cloudflared tunnel"
```
### 查看日志
```bash
# 服务器日志
tail -f /tmp/dmp_server.log
# Tunnel 状态
cloudflared tunnel list
cloudflared tunnel info dmp-tunnel
```
---
## 🔐 安全与隐私
**SSL/TLS 加密**: Cloudflare 自动 HTTPS
**DDoS 防护**: Cloudflare 自动启用
**SQL 注入防护**: 参数化查询
**跨域防护**: CORS 已配置
---
## 📋 后续维护清单
- [ ] 定期备份数据库 (每周)
```bash
cp dmp_onion.db dmp_onion.db.backup.$(date +%Y%m%d)
```
- [ ] 监控 Tunnel 连接状态
```bash
cloudflared tunnel list
```
- [ ] 检查服务器日志
```bash
tail -20 /tmp/dmp_server.log
```
- [ ] 定期重启服务
```bash
pkill -f "node server.js"
sleep 2
node server.js > /tmp/dmp_server.log 2>&1 &
```
- [ ] 监控 API 性能(响应时间应保持 <50ms
---
## 🎯 部署总结
| 项目 | 状态 | 说明 |
|------|------|------|
| 服务器 | ✅ 运行中 | Node.js + Express |
| Tunnel | ✅ 连接中 | Cloudflare 通道 |
| DNS | ✅ 配置完成 | dmp.ink1ing.tech |
| HTTPS | ✅ 自动 | Cloudflare 证书 |
| API | ✅ 功能正常 | 所有端点可用 |
| 数据库 | ✅ 完整 | 191 users × 90 tags |
| 缓存 | ✅ 启用 | 30s TTL |
| **总体** | **✅ 生产就绪** | **可投入使用** |
---
## 📞 故障排查
### 无法访问 dmp.ink1ing.tech
1. 检查服务状态
```bash
ps aux | grep "node server.js\|cloudflared"
```
2. 检查网络连接
```bash
ping dmp.ink1ing.tech
```
3. 测试本地访问
```bash
curl http://localhost:3456
```
4. 查看 Tunnel 状态
```bash
cloudflared tunnel list
cloudflared tunnel info dmp-tunnel
```
5. 重启 Tunnel
```bash
pkill -f cloudflared
sleep 2
cloudflared tunnel --config cloudflare-tunnel.yml run dmp-tunnel &
```
### API 返回错误
1. 检查服务器日志
```bash
tail -50 /tmp/dmp_server.log
```
2. 测试本地 API
```bash
curl http://localhost:3456/api/tags
```
3. 检查数据库
```bash
sqlite3 dmp_onion.db "SELECT COUNT(*) FROM users;"
```
---
## 📝 变更日志
### 2026-04-07
- ✅ Cloudflare Tunnel 部署完成
- ✅ DNS 配置生效
- ✅ HTTPS 自动启用
- ✅ API 公网访问验证通过
- ✅ 缓存和性能优化启用
---
**部署者**: AI Assistant
**完成时间**: 2026-04-07 04:05
**系统版本**: DMP v2.0 (Category-Aware Query Logic)