Files
homelab/PLAN.md
T

56 lines
3.8 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 🗺️ 家庭 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)
- [ ] **2.1 路由器固定 IP 与端口映射**:
- 在小米路由器 (`192.168.31.1`) 中将 Mac mini 固定为静态 IP(建议插网线固定有线 IP)。
- 转发 1 个高位 HTTPS 端口(`10443`)和组网端口到 Mac mini。
- [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)
- [ ] **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 安全视频)。