56 lines
4.3 KiB
Markdown
56 lines
4.3 KiB
Markdown
# 🗺️ 家庭 All-in-One 实施计划与进度追踪 (PLAN)
|
||
|
||
> 更新时间：2026-11-06
|
||
|
||
---
|
||
|
||
## 阶段一：Mac mini 服务器底座初始化 (Base Infrastructure)
|
||
|
||
- [x] **1.1 局域网设备发现与体检**：确认 Mac mini (`192.168.31.164`)、极空间 Z4 (`192.168.31.185`)、小米路由 (`192.168.31.1`) 状态。
|
||
- [x] **1.2 开启 Mac mini SSH 与免密登录**：配置公钥免密认证，并在本机配置 `ssh mini` 快捷别名。
|
||
- [x] **1.3 建立本地基础设施仓库 (`~/homelab`)**：固化架构文档、实施计划与变更日志。
|
||
- [x] **1.4 Mac mini 电源与无头模式（Headless）调优**：
|
||
- 已配置 `sudo` 免密权限 (`/etc/sudoers.d/ixvii0iv`)。
|
||
- 已关闭系统休眠 (`sleep 0`)、关闭磁盘休眠 (`disksleep 0`)、开启断电恢复自动开机 (`autorestart 1`)、开启网络唤醒 (`womp 1`)。
|
||
- [x] **1.5 安装核心包管理与容器底座**：
|
||
- 已安装 Xcode Command Line Tools 27.2 与 Homebrew 7.0.12 (`/opt/homebrew`)。
|
||
- 已安装并启动 **OrbStack 2.2.5**（Docker Engine `29.8.2`）与 **Tailscale 1.104.5**。
|
||
- [x] **1.6 远端目录规范化**：已在 Mac mini 上创建 `~/homelab` 与 `~/workspace` 目录，并与本机仓库结构对齐。
|
||
|
||
---
|
||
|
||
## 阶段二：公网网关、异地组网与 Azure 2C4G 云边联动 (Network & Edge)
|
||
|
||
- [x] **2.1 路由器固定 IP 与端口映射**：
|
||
- 已在小米路由器 (`192.168.31.1`) 中将 Mac mini (`c8:80:6d:50:23:b1`) 绑定为静态 IP `192.168.31.164`。
|
||
- 已配置防火墙 DNAT 端口转发：将联通公网 (`124.90.142.21`) 的 `10443` (TCP/UDP) 转发至 Mac mini (`192.168.31.164:10443`)。
|
||
- [x] **2.2 配置 Cloudflare DDNS 与 `*.home.961504.xyz` 泛域名 HTTPS 反代网关**：
|
||
- 已配置 [`scripts/cloudflare-ddns.sh`](file:///Users/ixvii0iv/homelab/scripts/cloudflare-ddns.sh) 并注册 macOS `LaunchAgent` (`com.homelab.cf-ddns.plist`，每 5 分钟自动检测并同步公网 IP 至 `home.961504.xyz` 与 `*.home.961504.xyz`)。
|
||
- 已通过 `acme.sh` + Cloudflare DNS API 自动签发 `home.961504.xyz` 与 `*.home.961504.xyz` 免费泛域名 SSL 证书。
|
||
- 已部署明文 Git 管理的 `home-gateway` ([`stacks/gateway/Caddyfile`](file:///Users/ixvii0iv/homelab/stacks/gateway/Caddyfile))，监听 `10443` 端口反代极空间 Z4 (`https://nas.home.961504.xyz:10443`)、Lucky (`https://lucky.home.961504.xyz:10443`) 与 Clash 面板 (`https://clash.home.961504.xyz:10443`)。
|
||
- [ ] **2.3 部署 Tailscale（打通 MacBook + Mac mini + Azure 2C4G）**：
|
||
- 三端登录同一 Tailnet，开启 Mac mini 的 Subnet Router（子网路由：`192.168.31.0/24`），实现在外网免配置直接用 `192.168.31.x` 访问家里极空间与路由器。
|
||
- [ ] **2.4 配置 Azure 2C4G 联动服务**：
|
||
- 部署 **Uptime Kuma**：从公网外部监控家里公网 IP 与核心服务，断网/掉线立即推送告警。
|
||
- 部署 **Caddy / Nginx 443 免端口反代**：通过 Tailscale/WireGuard 隧道将轻量 Web 服务免端口（标准 `443`）暴露。
|
||
|
||
---
|
||
|
||
## 阶段三：24 小时远程开发工作站 & 本地 AI 算力环境 (Dev & AI Host)
|
||
|
||
- [x] **3.1 基础开发工具链安装**：
|
||
- 已安装 `git`, `tmux`, `btop`, `ripgrep`, `fd`, `jq`, `wget`, `fnm`, `uv` 与 `agy` (`1.5.2`)。
|
||
- [x] **3.2 VS Code / AI IDE Remote-SSH 与 `agy` 流量出口锁定**：
|
||
- 已验证本机 MacBook Air 通过 `ssh mini` 免密直连开发。
|
||
- **已完成底层网络规则固化**：在小米路由器 `/userdisk/ShellCrash/yamls/config.yaml` 中将 `antigravity.google`、`gemini.google.com`、`googleapis.com`、`deepmind.com` 与 `RULE-SET,google` 统一路由至 `Ai平台`，并将 `Ai平台` 首选默认锁定为 `狮城节点`（仅含 `104.43.105.243` SG Azure 双协议节点），不受其他节点测速波动影响。
|
||
- [ ] **3.3 本地 AI 算力服务（可选）**：
|
||
- 利用 M6 24GB 统一内存部署 **Ollama + Open WebUI**，向内网与本机提供私有大模型 API。
|
||
|
||
---
|
||
|
||
## 阶段四：家庭核心应用与极空间 Z4 联动（按需扩展）
|
||
|
||
- [ ] **4.1 统一导航页与密码管理**：部署 **Sun-Panel / Homepage** + **Vaultwarden**。
|
||
- [ ] **4.2 极空间 SMB 自动挂载与影视自动化**：挂载 `192.168.31.185` 共享目录，部署 **MoviePilot + qBittorrent**。
|
||
- [ ] **4.3 智能家居中枢**：部署 **Home Assistant + Scrypted**（摄像头接入 Apple HomeKit 安全视频）。
|