homelab

admin/homelab

Participating and mentions

Receive notifications from this repository when participating or mentioned.

All activity

Receive notifications for all events.

Ignore

Never receive notifications from this repository.

0 Fork 0

Files

# 🏠 家庭 All-in-One & 云边协同架构仓库 (HomeLab IaC)

本目录用于集中保存、追踪家庭 All-in-One 服务器的**架构设计、实施计划、变更日志（Changelog）、自动化脚本与容器编排配置（Docker Compose）**。所有对设备的修改均在此留档，确保随时可查、可回滚、可一键迁移。

---

## 一、 全局设备与网络拓扑清单

```mermaid
flowchart TB
 Internet["🌐 互联网 / 外部访问"]
 
 subgraph Cloud ["☁️ 公有云层 (SG Azure 104.43.105.243)"]
 Azure["Azure SG (coco-sea1) 固定公网 IP: 104.43.105.243 / Tailscale: 100.115.204.51 职责: 443免端口HTTPS反代 / Uptime Kuma外部哨兵 / AGY固定AI出口"]
 end

subgraph HomeLAN ["🏠 家庭局域网 (192.168.31.0/24 - 联通公网 124.90.142.21)"]
 Router["📡 小米路由器 (192.168.31.1) 职责: PPPoE拨号 / DHCP静态绑定 / ShellCrash(Mihomo)分流 / 10443&41641端口映射"]
 Mini["🖥️ Mac mini M6 (192.168.31.164 / Tailscale: 100.108.205.40) 规格: Apple M6 (12核) / 24GB / 512GB SSD 职责: Caddy网关 / OrbStack容器 / AGY 24h云端工作台 / Vaultwarden密码库"]
 ZSpace["💾 极空间 Z4 (192.168.31.185) 规格: 20TB 存储池 (可用 17TB) 职责: 影视相册存储 / SMB自动挂载至Mac mini / Time Machine & 灾备中心"]
 MBA["💻 MacBook Air M5 (192.168.31.83) 职责: 日常移动主力开发机 (通过 ssh mini / ssh azure 远程管理)"]
 end

| 设备角色 | 设备名称 | 局域网 / 公网 / Tailscale IP | 硬件配置 | SSH 快捷连接 | 核心职责 |
| :--- | :--- | :--- | :--- | :--- | :--- |
| **核心计算/AIO** | **Mac mini** | 内网 `192.168.31.164` Tailscale `100.108.205.40` | Apple M6 (12C) / 24GB / 512G | `ssh mini` `ssh mini-ts` | Caddy 公网网关、Tailscale 子网路由、OrbStack 容器、AGY 云端工作台、Vaultwarden |
| **核心存储/NAS** | **极空间 Z4** | 内网 `192.168.31.185` | 20TB NAS 存储池 | - | 影视/相册/冷备存储，SMB 自动挂载至 Mac mini `~/nas/{共享文件,个人空间}` |
| **主路由/透明网关** | **小米路由器** | 内网 `192.168.31.1` 联通公网 `124.90.142.21` | 已开启 SSH + ShellCrash | `ssh 192.168.31.1` | 宽带拨号、DHCP 绑定、Mihomo 透明分流（锁定 `agy` 走狮城）、端口转发 |
| **云端协同节点** | **Azure SG (`coco-sea1`)** | 公网 `104.43.105.243` Tailscale `100.115.204.51` | 2C / 8GB RAM | `ssh azure` | 443 免端口反代 (`nav`/`agy`/`vw`/`status`)、Uptime Kuma 监控、`agy` 固定出口 IP |
| **日常控制端** | **MacBook Air** | 内网 `192.168.31.83` | Apple M5 (10C) / 16GB / 512G | 本机 | 日常使用、管理本仓库 (`~/homelab`)、Remote-SSH 远程开发 |

---

## 二、 全部服务访问入口速查表 (`961504.xyz`)

---

## 三、 目录结构说明

```text
~/homelab/
├── README.md                           # 全局架构、设备资产与服务入口速查表（本文件）
├── PLAN.md                             # 分阶段实施路线图与任务进度 Checklist
├── CHANGELOG.md                        # 详细操作与配置变更日志（含 17 项变更记录与回滚指令）
├── backups/router/config.yaml.bak      # 小米路由器 ShellCrash 原始配置备份
├── configs/
│   └── router-shellcrash-config.yaml   # 小米路由器 Mihomo 生产分流配置（锁定 AGY 狮城出口）
├── scripts/
│   ├── 01-macmini-init.sh              # Mac mini 防休眠、基础环境与目录初始化脚本
│   ├── cloudflare-ddns.sh              # 每 5 分钟自动更新 *.home.961504.xyz 公网 IP
│   ├── mount-zspace.sh                 # 每 2 分钟巡检并自动挂载极空间 20TB SMB 至 ~/nas
│   ├── start-agy-web.sh                # AGY 云端 Web 工作台 (ttyd + tmux) 常驻启动脚本
│   └── backup-to-nas.sh                # 每天 03:30 自动打包备份核心数据至极空间 Z4
└── stacks/
    ├── gateway/                        # Mac mini 10443 泛域名 HTTPS 网关 (Caddyfile + Let's Encrypt 证书)
    ├── azure-edge/                     # SG Azure 443 免端口 HTTPS 边缘网关与 Uptime Kuma 编排
    ├── sun-panel/                      # 家庭统一导航面板 Docker Compose 与 SQLite 数据
    ├── vaultwarden/                    # Vaultwarden 私人密码保险箱 Docker Compose
    └── wechat-bot/                     # 微信双向控制网关代码（已按需暂停保留）
```

Commit Changes

Add a Signed-off-by trailer by the committer at the end of the commit log message.

Commit directly to the main branch.

Create a new branch for this commit and start a pull request.

Cancel