refactor: Cloudflare Tunnel + frp SSH 中转变更

- 新增 cloudflared Docker 服务替代原 Bandwagon frp 方案 - 新增 frpc 转发 Git SSH 到阿里云 VPS - 为所有服务添加 web entrypoint 路由（兼容 cloudflared HTTP） - HedgeDoc 添加 X-Forwarded-Proto 中间件修复 CSP 登录问题 - Homepage 添加 xiteng.site 根域名路由 - Gitea 配置 SSH_DOMAIN=git.xiteng.site - 更新 README 反映当前架构 - .gitignore: frpc.toml / credentials / letsencrypt
2026-05-25 16:13:02 +08:00
parent 90d7db8782
commit c824e22b53
9 changed files with 173 additions and 46 deletions
@@ -1,56 +1,95 @@
-针对你的硬件资源（一台高性能无公网的本地宿主机 + 一台国内低延迟弱鸡 VPS + 一台免备案海外弱鸡 VPS + 一个域名），我们可以设计一套既能保证私有数据安全、国内访问低延迟，又能对外提供特定 Web 服务的混合架构。
+# Homelab

-以下是一套推荐的重构与部署方案：
+部署在 CachyOS 上的全套家庭服务，通过 Cloudflare Tunnel + 阿里云 VPS SSH 中转向公网开放。

-### 第一阶段：网络架构重构 (FRP + Mesh VPN 混合网络)
+## 架构

-以前你主要用 `frp`，这在暴露单点服务时很好用，但对于全面的 homelab 管理，引入 **Mesh VPN (如 Tailscale 或 ZeroTier)** 会让体验产生质的飞跃。
+```
+公网用户
+  │
+  ├─ Web (443) ──→ Cloudflare Tunnel ──→ cloudflared (Docker) ──→ Traefik (反向代理)
+  │                                                                 │
+  └─ SSH (22)  ──→ 阿里云 VPS (frps) ──→ frpc (Docker) ──→ Gitea  │
+                                                                    │
+                                                    ┌───────────────┤
+                                                    ▼               ▼
+                                                 各 Web 服务      Gitea SSH
+```

-* **私有访问与管理核心 (Tailscale / ZeroTier):** * 在台式机、笔记本、手机上全部安装 Tailscale。这会为你组建一个虚拟大内网。
-    * **发挥国内云服务器的优势：** 阿里云虽然性能弱且不能绑域名建站（没备案会拦截 80/443 端口），但它的**国内网络极佳**。你可以将其配置为 Tailscale 的自定义 DERP 中继服务器（或 ZeroTier 的 Moon 节点）。这样，当你在国内异地访问家里的台式机，且 P2P 打洞失败时，流量会从阿里云高速中转，极其丝滑，非常适合 SSH、大文件拉取或远程桌面。
-* **公共 Web 服务暴露 (Bandwagon + FRP):**
-    * 由于域名没有备案，必须且只能将域名解析到 Bandwagon。
-    * 在 Bandwagon 上部署 `frps` 和反向代理（推荐 Nginx Proxy Manager 或 Traefik）。
-    * 台式机运行 `frpc`，**只把需要对外公开的服务**（比如想分享给他人的文档、你的个人博客等）通过 FRP 穿透到 Bandwagon，再通过域名访问。
-    * 像 MinIO 这类存储重型、或者纯私人的服务，坚决不走 Bandwagon 公网暴露（VPS 带宽太小会成为瓶颈），而是直接通过刚才建好的 Tailscale 大内网用虚拟 IP 访问。
+| 入口 | 域名 | 传输 | 延迟 |
+|------|------|------|:--:|
+| Web | `*.xiteng.site` | Cloudflare Tunnel → Traefik | ~50ms |
+| Git SSH | `git.xiteng.site` | 阿里云 VPS → frp → Gitea | ~5ms |

-### 第二阶段：台式机服务部署规范 (Docker Compose)
+## 服务一览

-在滚动更新的 CachyOS 上，强烈建议所有服务全部容器化，避免日后系统滚挂或者依赖冲突。
+| 服务 | 地址 | 说明 |
+|------|------|------|
+| Homepage | [xiteng.site](https://xiteng.site) | 导航面板 |
+| Gitea | [gitea.xiteng.site](https://gitea.xiteng.site) | 代码托管, `git clone git@git.xiteng.site:…` |
+| HedgeDoc | [notes.xiteng.site](https://notes.xiteng.site) | Markdown 协作 |
+| Uptime Kuma | [uptime.xiteng.site](https://uptime.xiteng.site) | 服务监控 |
+| MinIO | 内网 | 对象存储（不暴露公网） |
+| Traefik | 内网 | 反向代理 |

-1.  **统一目录结构：**
-    建立一个统一的 `/opt/homelab` 或 `~/homelab` 目录。
-    ```text
-    homelab/
-    ├── compose.yml         # 核心网络和基础代理配置
-    ├── minio/
-    │   ├── compose.yml
-    │   └── data/           # 挂载的持久化数据
-    ├── hedgedoc/           # CodiMD 的社区继承版本，推荐用这个
-    │   ├── compose.yml
-    │   └── data/
-    └── .env                # 统一管理数据库密码、密钥等敏感信息
-    ```
-2.  **网络隔离：** 在 Docker 中创建一个自定义 bridge 网络（比如 `homelab_net`），让相关的服务可以通过容器名互相通信，而无需暴露端口到宿主机。
+## 目录结构

-### 第三阶段：服务推荐与规划
+```
+homelab/
+├── compose.yml            # 共享网络定义 (homelab_net)
+├── .env                   # 统一环境变量（敏感，gitignore）
+├── cloudflared/
+│   ├── compose.yml
+│   └── config.yml
+├── frpc/
+│   ├── compose.yml
+│   └── frpc.toml          # 敏感，gitignore
+├── gitea/
+│   ├── compose.yml
+│   └── data/
+├── hedgedoc/
+│   ├── compose.yml
+│   └── data/
+├── homepage/
+│   ├── compose.yml
+│   └── config/
+├── minio/
+│   ├── compose.yml
+│   └── data/
+├── traefik/
+│   ├── compose.yml
+│   └── letsencrypt/       # gitignore
+└── uptime-kuma/
+    ├── compose.yml
+    └── data/
+```

-除了你提到的基础服务，结合日常的开发需求（比如写代码、开发游戏），你可以考虑部署以下组合：
+## 网络

-**1. 生产力与存储 (你已有的)**
-* **MinIO:** 对象存储。部署时注意挂载你台式机上性能最好、容量最大的硬盘。
-* **HedgeDoc (原 CodiMD):** 实时协作 Markdown 笔记。建议搭配 PostgreSQL 数据库容器一起部署。
+所有服务加入 `homelab_net` 自定义 bridge 网络，通过容器名互访，不暴露端口到宿主机。

-**2. 开发与代码托管 (新服务推荐)**
-* **Gitea / Forgejo:** 非常轻量级的 Git 托管服务。对于开发《Silidox》这种游戏项目，或者管理多线程编程的实验代码，在本地有一个极速的 Git 仓库体验极佳，尤其是 Push/Pull 大量游戏美术资产时，局域网/Tailscale 速度远超 Github。
-* **Gitea Actions 或 Jenkins:** 轻量级 CI/CD 平台。可以用来自动打包你的 C++ 项目或游戏，甚至写脚本自动化执行单元测试。
+## 快速启动

-**3. 运维监控与导航**
-* **Uptime Kuma:** 极简的监控面板。不仅可以监控你的各个服务是否存活，还可以监控你的阿里云和 Bandwagon VPS 的网络状态。
-* **Homepage 或 Dashy:** 一个好看的导航页。把 MinIO、HedgeDoc、路由器后台等全放在上面，设为浏览器主页。
+```bash
+# 按依赖顺序启动
+docker compose -f compose.yml up -d          # 创建网络
+docker compose -f traefik/compose.yml up -d
+docker compose -f gitea/compose.yml up -d
+docker compose -f hedgedoc/compose.yml up -d
+docker compose -f uptime-kuma/compose.yml up -d
+docker compose -f homepage/compose.yml up -d
+docker compose -f cloudflared/compose.yml up -d
+docker compose -f frpc/compose.yml up -d
+```

---
+## 所需外部资源

-**下一步怎么走？**
+| 资源 | 用途 |
+|------|------|
+| Cloudflare DNS | 域名托管 + Tunnel |
+| 阿里云 ECS (上海) | Git SSH 中转 (frps) |
+| Cloudflare Tunnel | Web 流量入口 |

-我们可以先从最核心的基础设施开始。你是想先**把 Tailscale + 阿里云高速中继的网络架构搭起来**，还是想先**在 CachyOS 上把基础的 Docker Compose 环境和目录结构规范好**？我可以为你提供具体的配置文件和步骤。
+## 备案说明
+
+所有 Web 流量走 Cloudflare Tunnel（境外边缘终止 TLS），域名未备案。SSH 通过阿里云 IP 直连，不受备案约束。