标签:# Homelab

把家庭网络画成 Reddit 头条:解构 homelab-diagram 的声明式拓扑引擎、线宽物理学与 Agent 制图流

在 Reddit 的 r/homelab 社区里,有一类帖子永远占据着全站顶流:那些黑底发光、细节纤毫毕现、信息密度爆炸的家庭实验室全景拓扑图。从最上游的光猫、防火墙、核心交换机,到下游每个物理网口的协商线速,再到 Proxmox 虚拟化集群内的 LXC 容器、Traefik 域名路由,甚至 TrueNAS 存储池中每一块 HDD/SSD 的物理盘位与 VDev 布局——每一张都宛如工业级数据中心的操作手册。然而,绝大多数人为了画出这样一张图,往往需要在 Draw.io、Visio 或 Illustrator 里耗费整整一个周末,手动拖拽成百上千条贝塞尔曲线与矩形,而一旦内网某台虚拟机改了个 IP 或新增了一个 VLAN,整张图的排版维护便瞬间沦为一场灾难。

由开发者 Goblinmine 开源的 homelab-diagram,以极具颠覆性的工程设计打破了这一困境。它既没有选择纯手动作图的繁重,也没有向 Graphviz、Mermaid 等通用算法那混乱不可控的连线妥协,而是开创性地构建了一套 “声明式资产单一真值(YAML)+ 亚像素排版几何引擎(Python)+ AI Agent 闭环审图飞轮(CLAUDE.md)” 的全新制图范式。在这篇文章中,我将结合源码拆解与实战推演,深入剖析它是如何用“线宽物理学”重构网络拓扑表达,并解构其如何通过严苛的几何断言与多模态 Agent 协同,将繁琐的家庭网络资产转化为出版级高保真海报。