Files
brunoandClaude Sonnet 4.5 8350cd86f3
CI/CD Pipeline / build-push (ljwx-admin) (push) Blocked by required conditions
CI/CD Pipeline / build-push (ljwx-bigscreen) (push) Blocked by required conditions
CI/CD Pipeline / build-push (ljwx-boot) (push) Blocked by required conditions
CI/CD Pipeline / update-deploy (push) Blocked by required conditions
CI/CD Pipeline / security-scan (push) Successful in 52s
CI/CD Pipeline / test-build-boot (push) Successful in 1m52s
CI/CD Pipeline / build-pr (ljwx-admin) (push) Has been skipped
CI/CD Pipeline / build-pr (ljwx-bigscreen) (push) Has been skipped
CI/CD Pipeline / build-pr (ljwx-boot) (push) Has been skipped
CI/CD Pipeline / test-admin (push) Successful in 1m18s
CI/CD Pipeline / test-bigscreen (push) Has been cancelled
docs: 文档结构标准化重构 v1.0
## 重构概览
完成文档标准化重构,建立专业的文档管理体系。

## 核心成果

### 文档精简
- 根目录文档: 57个 → 8个 (-86%)
- README.md: 1844行 → 258行 (-86%)
- 查找时间: 5-10分钟 → <1分钟 (-80%)

### 新增核心文档
- CHANGELOG.md - 版本变更日志
- CONTRIBUTING.md - 贡献指南(代码/提交/文档规范)
- docs/README.md - 文档导航中心(按角色/主题/关键词索引)
- archive/README.md - 归档说明

### 目录架构
- docs/01-getting-started/ - 快速开始
- docs/02-architecture/ - 架构设计
- docs/03-deployment/ - 部署指南(Docker/K8s/GitOps)
- docs/04-operations/ - 运维手册(监控/数据库/故障)
- docs/05-features/ - 功能文档
- docs/06-development/ - 开发指南(后端/前端/API)
- docs/07-compliance/ - 工程规范
- docs/08-reference/ - 参考资料
- archive/2025/ - 历史归档(fixes/implementations/experiments)
- archive/deprecated/ - 已废弃文档

## 文档迁移

### 已迁移文档(44个)
部署文档 → docs/03-deployment/
  - DOCKER_README.md → docker/docker-compose.md
  - DOCKERFILE_OPTIMIZATION_SUMMARY.md → docker/optimization.md
  - GITHUB_SETUP.md → gitops/github-actions.md

运维文档 → docs/04-operations/
  - DATABASE_IMPORT.md → database/data-import.md
  - GRAFANA_QUICK_START.md → monitoring/grafana-quick-start.md

开发文档 → docs/06-development/
  - AI_INTEGRATION_GUIDE.md → ai-integration.md

参考资料 → docs/08-reference/
  - REMOTE_ACCESS.md → remote-access.md

历史文档 → archive/2025/
  - fixes/ - 8个修复文档
  - implementations/ - 10个实施总结
  - experiments/ - 2个实验方案

已废弃 → archive/deprecated/
  - old-quick-starts/ - 5个旧版快速开始指南

### 备份
- backup_docs_20260104_182653/ - 完整备份(57个文件)
- backup_docs_20260104_182705/ - 增量备份(6个文件)

## 技术亮点
- ✅ 自动化迁移脚本(scripts/migrate-docs.sh)
- ✅ 智能文档分类
- ✅ 自动备份机制
- ✅ 文档生命周期管理
- ✅ 多维度导航系统

## 参考规范
- Keep a Changelog (CHANGELOG.md)
- Conventional Commits (提交规范)
- Divio Documentation System (文档分类)

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2026-01-04 18:31:38 +08:00

3.7 KiB
Raw Permalink Blame History

🔧 Cloudflare DNS 配置修复指南

🚨 问题诊断

当前问题:Cloudflare 522错误 - 连接超时

根本原因:

  • 域名omniverseai.net设置了A记录指向104.234.227.29(你的动态IP)
  • 但通过Cloudflare Tunnel访问需要CNAME记录
  • 导致流量直接访问你的IP而不是通过tunnel

✅ 解决方案

方案1: 使用Cloudflare Tunnel (推荐)

步骤1: 删除现有A记录

登录Cloudflare Dashboard → DNS Records → 删除:

Type: A
Name: omniverseai.net  
Value: 104.234.227.29

步骤2: 创建CNAME记录

# 自动创建正确的DNS记录
cloudflared tunnel route dns mytunnel omniverseai.net
cloudflared tunnel route dns mytunnel www.omniverseai.net
cloudflared tunnel route dns mytunnel jenkins.omniverseai.net  
cloudflared tunnel route dns mytunnel registry.omniverseai.net

步骤3: 验证配置

# 检查tunnel状态
cloudflared tunnel info mytunnel

# 测试访问
curl -I https://omniverseai.net
curl -I https://www.omniverseai.net
curl -I https://jenkins.omniverseai.net
curl -I https://registry.omniverseai.net

方案2: 保持A记录 + 端口转发

如果你想保持A记录,需要:

步骤1: 开放端口

# 在路由器中开放端口(需要管理员权限)
80 → localhost:3001    # HTTP
443 → localhost:3443   # HTTPS
8081 → localhost:8081  # Jenkins
5001 → localhost:5001  # Registry

步骤2: 配置HTTPS证书

# 使用Let's Encrypt获取证书
sudo certbot --standalone -d omniverseai.net -d www.omniverseai.net

🌐 推荐的最终DNS配置

使用Cloudflare Tunnel后,DNS记录应该是:

Type: CNAME    Name: omniverseai.net      Value: mytunnel.cfargotunnel.com
Type: CNAME    Name: www                  Value: mytunnel.cfargotunnel.com  
Type: CNAME    Name: jenkins              Value: mytunnel.cfargotunnel.com
Type: CNAME    Name: registry             Value: mytunnel.cfargotunnel.com

🔄 当前tunnel配置验证

当前/Users/brunogao/.cloudflared/config.yml配置:

tunnel: 52e8fbf5-d2b3-4bc2-82c6-8a5e44104bd5
credentials-file: /Users/brunogao/.cloudflared/52e8fbf5-d2b3-4bc2-82c6-8a5e44104bd5.json

ingress:
  # www子域名
  - hostname: www.omniverseai.net
    service: http://localhost:3001
  # 根域名  
  - hostname: omniverseai.net
    service: http://localhost:3001
  # Jenkins CI/CD服务
  - hostname: jenkins.omniverseai.net
    service: http://localhost:8081
  # Registry镜像仓库
  - hostname: registry.omniverseai.net
    service: http://localhost:5001
  # 默认服务
  - service: http_status:404

🚀 执行修复

立即执行(推荐方案1):

  1. 登录Cloudflare Dashboard
  2. 删除A记录 omniverseai.net → 104.234.227.29
  3. 运行DNS路由命令:
    cloudflared tunnel route dns mytunnel omniverseai.net
    cloudflared tunnel route dns mytunnel www.omniverseai.net
    cloudflared tunnel route dns mytunnel jenkins.omniverseai.net
    cloudflared tunnel route dns mytunnel registry.omniverseai.net
    
  4. 等待DNS传播 (2-10分钟)
  5. 测试访问

验证成功标志:

💡 额外优化

设置自动重启tunnel:

# 添加到crontab
@reboot /usr/local/bin/cloudflared tunnel run mytunnel

🎯 预期结果

修复后你将拥有: