# 🗺️ 家庭 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 部署 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)

- [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 安全视频）。