【免费下载链接】RackPeekCLI tool to discover, manage, and document your IT infrastructure and home lab.项目地址https://gitcode.com/gh_mirrors/ra/RackPeek点击查看免费下载RackPeek是一款面向家庭实验室Home Lab和小型 IT 环境的开源基础设施管理工具核心是一个名为rpk的命令行工具CLI配合 Web UI 使用。本文是RackPeek rpk CLI 命令完整手册带你快速掌握150 个子命令用清单化的方式统一管理服务器、交换机、路由器、防火墙等硬件以及系统与服务——数据全部存储在纯 YAML 文件中无数据库、无供应商锁定。5分钟上手安装与第一条 rpk 命令RackPeek 推荐用 Docker 一键部署官方镜像aptacode/rackpeek一条命令即可启动默认监听8080端口所有状态保存在config/config.yaml一个 YAML 文件里。docker volume create rackpeek-config docker run -d --name rackpeek -p 8080:8080 \ -v rackpeek-config:/app/config aptacode/rackpeek:latest部署完成后容器内即可使用rpk命令浏览器中则打开完整的 Web 管理界面CLI 与 Web UI 操作同一份数据。 新手提示任何命令加-h都会打印帮助信息例如rpk servers -h会列出add / get / describe / set / del / rename / tree等全部子命令。全局命令速览rpk顶层共 16 个命令组完整参考见 docs/Commands.md命令组作用summary查看全库资源汇总报告servers/switches/routers/firewalls管理四类网络设备与服务器accesspoints/ups/desktops/laptops管理 AP、UPS、台式机、笔记本systems管理系统Hypervisor、VM、容器支持任意层级嵌套services管理服务应用、网络端点可查询子网ansible/ssh/hosts导出 Ansible 清单、SSH 配置、hosts 文件graph生成 Mermaid 拓扑图tags跨资源检索标签connections管理端口间物理连接掌握一套 CRUD 模式通吃 9 类资源RackPeek 最省心的设计9 类资源共用同一套命令语法。学会rpk servers后rpk switches、rpk routers等命令零成本迁移。每类资源都支持以下基础子命令add name—— 新增资源list—— 列出全部资源get name/describe name—— 查看单个资源describe输出更详细set name—— 更新属性del name—— 删除资源rename name new-name—— 重命名summary—— 输出该类资源的硬件汇总报告label add|remove、tag add|remove—— 标签管理不同资源类型的子资源Sub-Resource支持范围如下子资源命令ServerDesktopLaptopSwitchRouterFirewallcpu/gpu/drive/ram✅✅✅❌❌❌nic✅✅❌❌❌❌port❌❌❌✅✅✅三类子资源命令同样是add / set / del例如给服务器加一块硬盘rpk servers drive add ssd-1 --type ssd --size 2000 rpk servers cpu add cpu-1 --model Intel i5-12400 --cores 6 --threads 12服务器命令详解rpk serversrpk servers共 9 个子命令 4 组子资源cpu/drive/gpu/nic是命令最多的资源组之一源码见 Shared.Rcl/Commands/Servers/。常用流程示例——登记一台 Proxmox 节点rpk servers add pve-01 rpk servers set pve-01 --ram 32 rpk servers describe pve-01 rpk servers tree pve-01 # 查看依赖树其中set支持的关键参数包括--ram、--ram_mts、--ipmi等完整参数见 docs/Commands.md。tree子命令是服务器专属能力配合 Web 端硬件树页面可以直观看到物理机 → 虚拟化平台 → 虚拟机的层级关系。交换机、路由器命令端口管理是核心网络设备的建模重点是端口。rpk switches、rpk routers、rpk firewalls三个命令组结构完全一致均包含port add/set/del子命令源码见 Shared.Rcl/Commands/Switches/。一次登记交换机型号与端口rpk switches add usw-pro-48 rpk switches set usw-pro-48 --Model UniFi USW-Pro-48-PoE --poe rpk switches port add eth --type rj45 --speed 1 --count 48 rpk switches port add sfp --type sfp --speed 10 --count 4路由器同理rpk routers port add同样支持--type、--speed、--count参数参见 docs/Commands.md。端口登记完成后就可以用rpk connections命令把两端端口接线例如把交换机第 3 组第 1 口连到路由器 WAN 口rpk connections add usw-pro-48 0 2 rb5009 0 0connections add还支持--label、--notes参数给这条链路打标注方便日后排障。systems 与 services 命令用 runs-on 串联三层架构RackPeek 将基础设施分为三层详见 resource-levels.mdHardware硬件→ Systems系统→ Services服务由runs-on属性串联。systems 命令支持任意层级嵌套是建模虚拟化平台的关键set参数见 docs/Commands.mdrpk systems add proxmox-ve rpk systems set proxmox-ve --type hypervisor --os Proxmox VE 8.3 --runs-on pve-01 rpk systems add media-vm rpk systems set media-vm --type vm --runs-on proxmox-veservices 命令独有subnets子命令可按 CIDR 前缀筛选服务关联的子网rpk services add jellyfin rpk services set jellyfin --ip 10.0.10.50 --port 8096 --protocol http --runs-on media-vm rpk services subnets --cidr 10.0.10.0/24⚠️ 建模规则服务只能运行在系统上不能直接挂在硬件上系统可以运行在硬件或其他系统上且支持多个runs-on目标例如集群服务。导出命令一份清单喂饱 Ansible、SSH、hostsRackPeek 最大的杀手锏把清单文档直接变成自动化配置。1️⃣ Ansible 清单生成rpk ansible inventory参数详解见 docs/Commands.mdrpk ansible inventory --format yaml --group-tags prod,staging --global-var ansible_useradmin -o inventory.yml支持按 tag / label 分组、注入全局变量、ini 或 yaml 两种格式。2️⃣ SSH 配置导出自动读取资源上的标签作为连接信息rpk ssh export --include-tags prod,linux --default-port 22 -o ssh_config3️⃣ hosts 文件导出生成/etc/hosts兼容文件rpk hosts export --domain-suffix home.local -o hosts三个导出命令都支持--include-tags/-o输出到文件可直接接入 CI 脚本。可视化与检索graph、tags 命令组rpk graph topology—— 输出物理拓扑硬件 连接的 Mermaid 流程图粘贴到任意 Mermaid 渲染器即可看图rpk graph logical—— 输出按子网和主机分组的服务/系统逻辑图rpk tags list—— 列出所有在用标签及引用次数rpk tags show tag—— 反查携带某个标签的全部资源非常适合哪些设备属于生产环境这类快速排查。图形化结果也可以在 Web UI 的 Visualise 页面直接预览仓库中 vhs/webui_screenshots/ 目录下保存了拓扑图等截图示例。数据安全配置即 Git 仓库所有命令修改的都是同一个 YAML 文件因此 RackPeek 原生支持Git 集成启动时自动在配置目录初始化 git 仓库通过环境变量GIT_TOKEN、GIT_USERNAME配置任意 Git 服务GitHub、Gitea、GitLab、Bitbucket 均可详见 git-integration.md。此后每次变更都会自动 commit 并同步到远端——你的基础设施文档从此拥有完整历史版本。新手学习路线三步吃透 150 子命令记语法模板rpk 资源 动作 [名称] [参数]9 类资源完全同构-h随时查参数跑一遍完整建模流程servers add→switches port add→connections add→systems set --runs-on→services set --runs-on把三层架构串起来用上导出能力rpk ansible inventoryrpk graph topology体会文档即代码的闭环。完整命令树可在 CommandIndex.md 中按命令逐条跳转全部 3700 行参考文档收录在 docs/Commands.md。照着上面的模板走一遍150 子命令其实只需要记一套语法。赞分享【免费下载链接】RackPeekCLI tool to discover, manage, and document your IT infrastructure and home lab.项目地址https://gitcode.com/gh_mirrors/ra/RackPeek点击查看免费下载相关推荐XCOM模组管理器AML完整上手指南从安装到冲突检测的终极教程XCOM模组管理器AML完整上手指南从安装到冲突检测的终极教程 晚上十一点你刚在Steam工作坊一口气订阅了四十多个XCOM 2模组满心期待地点了启动游戏桌面应用游戏开发JiuwenSymbiosis CLI命令清单快速掌握机器人任务执行、单步调试与轨迹回放JiuwenSymbiosis CLI命令清单快速掌握机器人任务执行、单步调试与轨迹回放 JiuwenSymbiosis 是一个能懂人话、看得见物理世界、长具身智能人工智能AI Agent机器人计算机视觉Agent 编排Gemini CLI 命令行参考命令、选项与子命令的完整实战手册Gemini CLI 命令行参考命令、选项与子命令的完整实战手册 本文以 Gemini CLI 官方文档中的命令行速查表为骨架系统梳理 gemini 的启动人工智能AI Agent交互助手CLIMCP Clients创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考