66 lines
4.2 KiB
Markdown
66 lines
4.2 KiB
Markdown
# 🏠 家庭 All-in-One & 云边协同架构仓库 (HomeLab IaC)
|
||
|
||
本目录用于集中保存、追踪家庭 All-in-One 服务器的**架构设计、实施计划、变更日志（Changelog）、自动化脚本与容器编排配置（Docker Compose）**。所有对设备的修改均在此留档，确保随时可查、可回滚、可一键迁移。
|
||
|
||
---
|
||
|
||
## 一、 全局设备与网络拓扑清单
|
||
|
||
```mermaid
|
||
flowchart TB
|
||
Internet["🌐 互联网 / 外部访问"]
|
||
|
||
subgraph Cloud ["☁️ 公有云层 (Azure)"]
|
||
Azure["Azure VM (2C4G)<br/>固定公网 IP / 开放 80 & 443<br/>职责: 免端口HTTPS反代 / 外部监控哨兵 / 企微&TG网关"]
|
||
end
|
||
|
||
subgraph HomeLAN ["🏠 家庭局域网 (192.168.31.0/24 - 动态公网 IP)"]
|
||
Router["📡 小米路由器 (192.168.31.1)<br/>职责: PPPoE拨号 / DHCP / ShellCrash(Mihomo)透明分流 / 端口转发"]
|
||
Mini["🖥️ Mac mini M6 (192.168.31.164)<br/>主机名: ixvii0ivdeMac-Mini.local<br/>规格: Apple M6 (12核) / 24GB / 512GB SSD<br/>职责: 公网网关(Lucky) / OrbStack容器中心 / 24h远程开发机 / 本地AI"]
|
||
ZSpace["💾 极空间 Z4 (192.168.31.185)<br/>主机名: Z4-R8WA.local<br/>职责: RAID大容量冷存储 / 极影视 / 手机相册备份 / SMB共享"]
|
||
MBA["💻 MacBook Air M5 (192.168.31.83)<br/>职责: 日常移动主力开发机 (通过 ssh mini 远程连接)"]
|
||
end
|
||
|
||
Internet -->|"标准 443 免端口访问"| Azure
|
||
Internet -->|"高带宽直连 (Lucky HTTPS / WireGuard)"| Router
|
||
Azure <===>|"Tailscale / WireGuard 加密专线"| Mini
|
||
Router --> Mini
|
||
Router --> ZSpace
|
||
Router --> MBA
|
||
Mini <-->|"SMB/NFS 局域网高速挂载"| ZSpace
|
||
```
|
||
|
||
| 设备角色 | 设备名称 | 局域网/公网 IP | 硬件配置 | SSH 快捷连接 | 核心职责 |
|
||
| :--- | :--- | :--- | :--- | :--- | :--- |
|
||
| **核心计算/AIO** | **Mac mini** | 内网 `192.168.31.164`<br/>Tailscale `100.108.205.40` | Apple M6 (12C) / 24GB / 512G | `ssh mini` (或 `ssh mini-ts`) | Caddy/Lucky 公网反代、Tailscale 子网路由、OrbStack 容器、24h 远程开发与 AI 算力 |
|
||
| **核心存储/NAS** | **极空间 Z4** | `192.168.31.185` | 磁盘阵列 NAS | - | 大容量影视/相册/冷备份存储，通过 SMB 挂载给 Mac mini |
|
||
| **主路由/透明网关** | **小米路由器** | `192.168.31.1` (联通公网 `124.90.142.21`) | 已解锁 SSH + ShellCrash | `ssh 192.168.31.1` | 宽带拨号、全屋 DHCP、ShellCrash (Mihomo) 科学上网分流、端口映射 |
|
||
| **云端协同节点** | **Azure SG (`coco-sea1`)** | 公网 `104.43.105.243`<br/>Tailscale `100.115.204.51` | 2C / 8GB RAM | `ssh azure` | 443 免端口反代 (`nav.961504.xyz`)、Uptime Kuma 监控 (`status.961504.xyz`)、企微/agy 固定出口 IP |
|
||
| **日常控制端** | **MacBook Air** | `192.168.31.83` | Apple M5 (10C) / 16GB / 512G | 本机 | 日常使用、管理本仓库 (`~/homelab`)、Remote-SSH 远程开发 |
|
||
|
||
---
|
||
|
||
## 二、 域名与 DNS 规划 (`961504.xyz` @ Cloudflare)
|
||
|
||
- **DNS 托管商**：Cloudflare (`eoin.ns.cloudflare.com` / `tori.ns.cloudflare.com`)
|
||
- **云端节点域名**：`sea.961504.xyz` -> `104.43.105.243` (Azure 2C4G 固定公网 IP)
|
||
- **家庭 DDNS 域名规划**：
|
||
- `home.961504.xyz` / `*.home.961504.xyz` -> 由 Mac mini 上的 **Lucky** 调用 Cloudflare API 动态解析至家庭联通公网 IP（当前 `124.90.142.21`）
|
||
|
||
---
|
||
|
||
## 三、 目录结构说明
|
||
|
||
```text
|
||
~/homelab/
|
||
├── README.md # 全局架构、设备资产与端口规划总览（本文件）
|
||
├── PLAN.md # 分阶段实施路线图与任务进度 Checklist
|
||
├── CHANGELOG.md # 详细操作与配置变更日志（含回滚指令）
|
||
├── scripts/ # 宿主机初始化与运维脚本
|
||
│ └── 01-macmini-init.sh # Mac mini 防休眠、基础环境与目录初始化脚本
|
||
└── stacks/ # Docker Compose 容器编排目录（与 Mac mini 同步）
|
||
├── lucky/ # DDNS 动态域名 + HTTPS 证书 + 反向代理
|
||
├── tailscale/ # 异地组网与内网穿透配置
|
||
└── azure-edge/ # Azure 2C4G 端 Caddy 反代与 Uptime Kuma 监控配置
|
||
```
|