homelab/PLAN.md

🗺️ 家庭 All-in-One 实施计划与进度追踪 (PLAN)

更新时间：2026-11-06

---

阶段一：Mac mini 服务器底座初始化 (Base Infrastructure)

• 1.1 局域网设备发现与体检：确认 Mac mini (192.168.31.164)、极空间 Z4 (192.168.31.185)、小米路由 (192.168.31.1) 状态。
• 1.2 开启 Mac mini SSH 与免密登录：配置公钥免密认证，并在本机配置 ssh mini 快捷别名。
• 1.3 建立本地基础设施仓库 (~/homelab)：固化架构文档、实施计划与变更日志。
• 1.4 Mac mini 电源与无头模式（Headless）调优：
  • 已配置 sudo 免密权限 (/etc/sudoers.d/ixvii0iv)。
  • 已关闭系统休眠 (sleep 0)、关闭磁盘休眠 (disksleep 0)、开启断电恢复自动开机 (autorestart 1)、开启网络唤醒 (womp 1)。
• 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。
• 1.6 远端目录规范化：已在 Mac mini 上创建 ~/homelab 与 ~/workspace 目录，并与本机仓库结构对齐。

---

阶段二：公网网关、异地组网与 Azure 2C4G 云边联动 (Network & Edge)

• 2.1 路由器固定 IP 与端口映射：
  • 在小米路由器 (192.168.31.1) 中将 Mac mini 固定为静态 IP（建议插网线固定有线 IP）。
  • 转发 1 个高位 HTTPS 端口（10443）和组网端口到 Mac mini。
• 2.2 部署 Lucky 容器（家庭公网瑞士军刀）：
  • 已在 Mac mini 启动 lucky 容器（管理端：http://192.168.31.164:16601，统一 HTTPS 反代入口：10443）。
  • 待配置：Cloudflare DNS API Token、开启 *.home.961504.xyz DDNS 动态解析与 ACME 免费泛域名 SSL 证书。
• 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)

• 3.1 基础开发工具链安装：
  • 安装 git, tmux, btop, ripgrep, fd, jq, gh 等命令行效率工具。
  • 配置 Node.js (fnm/nvm)、Python (uv/miniconda) 等多版本隔离环境。
• 3.2 VS Code / AI IDE Remote-SSH 与 agy 流量出口锁定：
  • 验证本机 MacBook Air 通过 ssh mini 免密直连开发、后台 tmux 任务保活。
  • 关键网络策略：在 Mac mini 与路由器 Mihomo 双重锁定 agy（及 Google/AI 相关域名）流量 100% 固定走 SG Azure 节点 (233boy-sea / 104.43.105.243)，防止因路由器 URLTest (自动选择) 测速波动切到 coco-sea1 或美西节点导致出口 IP 变化。
• 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 安全视频）。