# 🗺️ 家庭 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`)。 - [x] **2.3 部署 Tailscale（异地组网与家庭子网路由）**： - 已在小米路由器配置 `*.tailscale.com` / `*.ts.net` 免 Fake-IP 直连与 UDP `41641` 端口映射。 - 已在 Mac mini 启动系统级 `tailscaled` 守护进程（分配固定虚拟 IP `100.108.205.40`），开启 `192.168.31.0/24` 子网路由并关闭 `--accept-dns=false` 保护原有分流网络。 - [x] **2.4 配置 Azure SG (`104.43.105.243`) 联动服务**： - 已部署 **Uptime Kuma** 外部监控哨兵（访问地址：`https://status.961504.xyz`，标准 `443` 免端口）。 - 已完成 Azure 节点的 Tailscale 组网绑定（虚拟 IP `100.115.204.51`，与家里 Mac mini `100.108.205.40` 实现 `124.90.142.21` P2P 公网直连）。 - 已打通 `/etc/caddy/sites/homelab.conf` 免端口反向代理：**`https://nav.961504.xyz`**（标准 `443` 免端口直达家里 Mac mini 导航页）。 --- ## 阶段三：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 联动（按需扩展） - [x] **4.1 家庭统一导航总入口 (`https://nav.961504.xyz` / `https://home.961504.xyz:10443`) 与反代安全锁**： - 已部署 **Sun-Panel** ([`stacks/sun-panel/docker-compose.yml`](file:///Users/ixvii0iv/homelab/stacks/sun-panel/docker-compose.yml)) 并预置 **极空间 Z4、Clash 路由面板、小米路由器后台、Lucky 工具箱、Uptime 外部监控** 卡片。 - 已在 [`stacks/gateway/Caddyfile`](file:///Users/ixvii0iv/homelab/stacks/gateway/Caddyfile) 为 `clash.home.961504.xyz:10443` 与 `router.home.961504.xyz:10443` 开启 HTTP Basic Auth 密码锁保护。 - [x] **4.2 个人微信 / 企业微信双向控制与通知网关 (`https://wx.961504.xyz`)**： - 已在小米路由器将企业微信接口 `qyapi.weixin.qq.com` 固定路由至 SG Azure (`104.43.105.243`)，满足企业微信固定可信 IP 白名单要求。 - 已在 Mac mini 部署微信双向网关守护进程 ([`stacks/wechat-bot/server.py`](file:///Users/ixvii0iv/homelab/stacks/wechat-bot/server.py)，监听 `3005`)，并通过 Azure 标准 `443` 端口反代暴露为 `https://wx.961504.xyz/wechat/callback`。 - [ ] **4.2 极空间 SMB 自动挂载与影视自动化**：挂载 `192.168.31.185` 共享目录，部署 **MoviePilot + qBittorrent**。 - [ ] **4.3 智能家居中枢**：部署 **Home Assistant + Scrypted**（摄像头接入 Apple HomeKit 安全视频）。