【免费下载链接】RackPeekCLI tool to discover, manage, and document your IT infrastructure and home lab.项目地址https://gitcode.com/gh_mirrors/ra/RackPeek点击查看免费下载RackPeek 是一款面向家庭实验室Home Lab与小型 IT 基础设施的 CLI Web 工具用于发现、管理和文档化你的 IT 基础设施。它的核心是一套清晰的三层资源模型Hardware硬件、Systems系统、Services服务通过runs-on关系把「金属—操作系统—应用」层层串联起来。读完这篇新手入门指南你将学会如何把真实环境建模成一份可版本化、可自动化例如导出 Ansible 清单的 YAML 配置。上图是 RackPeek 首页仪表盘左侧 TOTALS 面板一眼汇总三层资源数量Hardware 14 / Systems 25 / Services 42右侧即由这些资源自动生成的物理拓扑图。为什么需要三层资源模型 对新手来说最容易犯的错误是「把所有东西都塞进同一个列表」。RackPeek 用三个互不重叠的层级来回答一个问题这个东西属于哪一层Hardware硬件你能摸到、通电就工作的真实设备——服务器、交换机、路由器、防火墙、无线 AP、UPS、台式机、笔记本。Systems系统提供「执行环境」的软件层——操作系统、虚拟机、容器、裸机安装、云平台实例。Services服务真正对外提供能力的端点——Web 应用、数据库、DNS、流媒体服务等。一句话概括硬件是金属系统是跑在上面的东西服务是用户真正连接的东西。官方对这三层的权威解释见 resource-levels.md底层建模规则则实现在 Resource.cs。第一层Hardware 硬件8 种物理设备类型Hardware 是整个模型的底座。它不运行在任何东西之上——硬件只是「存在」。RackPeek 支持 8 种硬件类型类型含义示例Server机架/塔式服务器Dell PowerEdge R730、自组 Proxmox 节点Switch网络交换机UniFi USW-Pro-48Router路由器MikroTik RB5009Firewall专用防火墙Netgate SG-3100、pfSense 盒子Access Point无线接入点UniFi U6-ProDesktop台式工作站自组主机、Mac MiniLaptop笔记本ThinkPad T14sUPS不间断电源APC SMT1500其中 Server、Desktop、Laptop 还支持记录内部子资源CPU、磁盘、GPU、网卡、内存让硬件档案足够精确。硬件详情页长这样详情页展示了proxmox-node01这台 Server 的 CPUAMD EPYC 7302P / 16 核 32 线程、RAM128 GB、两块 SSD 以及 RJ45 / SFP 端口下方还自动列出了运行在它上面的子系统。用 CLI 添加硬件非常简单rpk servers add pve-01 rpk switches add usw-pro-48 rpk ups add apc-1500第二层Systems 系统可无限嵌套的执行环境Systems 是「提供执行环境」的一切。每个 System 都有一个runs-on属性指向它运行在哪里——可以是硬件也可以是另一个系统。RackPeek 定义了 8 种系统类型baremetal裸机、hypervisor虚拟机平台、vm虚拟机、container容器/LXC、embedded嵌入式固件、cloud云实例、cluster集群、other。模型字段见 SystemResource.cs。最强大的特性是系统可以嵌套到任意深度这正好用来还原真实的虚拟化栈pve-01 (Server) ← Hardware └── proxmox-ve (System: hypervisor) ← runs-on pve-01 ├── media-vm (System: vm) ← runs-on proxmox-ve └── pihole-lxc (System: container) ← runs-on proxmox-veSystems 列表页会直接展示每个系统的类型、OS、核数、内存以及它Runs On的父级卡片中proxmox-cluster-node01被标记为 HypervisorOS 为 Proxmox并通过Runs On → proxmox-node01明确指向其物理宿主机。rpk systems add proxmox-ve rpk systems set proxmox-ve --type hypervisor --os Proxmox VE 8.3 --runs-on pve-01第三层Services 服务跑在系统之上的应用端点Services 是模型的最上层也是用户真正访问的对象。它只有两条铁律服务只能跑在 System 上不能直接挂到硬件。每个服务记录一组网络属性IP、Port、Protocol、URL见 Service.cs。Services 列表页会为每个服务展示这些网络字段并用Runs On标明它所在的系统plex服务记录了 IP192.168.10.20、端口32400、协议TCP与 URL并通过Runs On → vm-media-server挂到对应虚拟机上。rpk services add plex rpk services set plex --runs-on vm-media-server --ip 192.168.10.20 --port 32400 --url http://plex.lan:32400runs-on贯穿三层的「胶水」 runs-on是 RackPeek 里唯一连接各层的关系它决定了一个资源依赖谁。规则非常固定由 Resource.cs 中的CanRunOn校验资源可以 runs-onHardware无硬件是底层SystemHardware或另一个 SystemService只能 System在 Web UI 的Hardware 树视图中三层结构会像目录树一样层层展开——硬件之下挂系统、系统之下挂服务树中proxmox-node01下的lxc-network、vm-monitoring等系统各自展开出 AdGuard Home、Grafana、Prometheus 等服务直观体现了三层模型的真实嵌套。快速上手用 Docker 三步跑起来 理解三层模型后先把环境跑起来。所有状态都保存在单个 YAML 文件config/config.yaml里没有数据库docker volume create rackpeek-config docker run -d --name rackpeek -p 8080:8080 \ -v rackpeek-config:/app/config aptacode/rackpeek:latest打开http://localhost:8080即可进入 Web UI同一镜像里也内置了 CLI可docker exec rackpeek rpk ...直接操作。完整命令树见 Commands.md一份贴近真实环境的示例配置参考 config.yaml。如果你更喜欢敲命令Web UI 里内置了一个控制台模拟器无需另开终端如何选对层级3 个问题搞定判断 ✂️拿不准某个东西该放哪一层时问自己三个问题问题回答层级我能摸到它吗是Hardware它提供执行环境吗会开机、跑进程是System它监听某个端口 / 提供网络端点吗是Service几个高频场景的建模结论Proxmox / ESXi / Hyper-V→ Systemtype:hypervisorruns-on 物理服务器Docker 容器→ Systemtype:container容器/VM 里的应用→ ServiceTrueNAS→ Systembaremetal或vm其 SMB/NFS 共享是 ServiceOPNsenseNetgate 盒子→ 盒子是 HardwarefirewallOPNsense 是 Systemembedded可视化你的三层模型 建模完成后RackPeek 的Visualise页面能一键把runs-on关系渲染成 Mermaid 图形Physical物理拓扑展示硬件之间的连线由 BuildPhysicalTopologyUseCase.cs 构建。Logical逻辑视图展示 System 与 Service 的层级可导出 PNG 或 Mermaid 源码。可视化实现见 VisualisePage.razor。配合 overview.md 的设计哲学RackPeek 把「文档即代码、数据归自己」贯彻到底。小结Hardware 是金属、Systems 是执行环境、Services 是用户连接的对象runs-on把三者串成一条清晰的依赖链。掌握这套三层资源模型你就掌握了 RackPeek 建模的核心——从一份config.yaml出发把整个 Home Lab 变成可读、可版本化、可自动化的基础设施文档。赞分享【免费下载链接】RackPeekCLI tool to discover, manage, and document your IT infrastructure and home lab.项目地址https://gitcode.com/gh_mirrors/ra/RackPeek点击查看免费下载相关推荐go-admin多命令模式入门server、migrate、config六大命令一次讲透go admin多命令模式入门server、migrate、config六大命令一次讲透 go admin 是一个基于 Gin Vue 的前后端分离权限管后端认证鉴权RLS 一节课讲透Supabase 权限模型入门到进阶别再裸奔RLS 一节课讲透Supabase 权限模型入门到进阶别再裸奔 如果你的 Supabase 应用在浏览器里直接用 anon key 连数据库而表上又没有开后端前端数据库RookieAI_yolov8 全部25个参数一次讲透新手自瞄灵敏度调优终极指南RookieAI_yolov8 全部25个参数一次讲透新手自瞄灵敏度调优终极指南 RookieAI_yolov8 是一款基于 YOLOv8 目标检测的 AI人工智能计算机视觉深度学习创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考