RackVisual 是一款自托管的 3D 机柜可视化规划工具，适合家庭实验室、小型机房和数据中心资产规划。应用可以在浏览器中创建多个机柜，添加服务器、交换机、配线架、UPS、PDU 等设备，并维护设备端口、网线、电源线、VLAN、供电回路和硬件信息。 ## 适用场景 - 规划 10 英寸或 19 英寸机柜的设备摆放。 - 记录每台设备所在 U 位、IP、系统、硬件配置和备注信息。 - 可视化网络端口和电源端口的连接关系。 - 管理每个机柜对应的 VLAN 和电源回路。 - 上传 GLTF / GLB 设备模型，补充内置模型库没有的设备。 ## 快速开始 1. 打开应用后，点击顶部工具条的 `+ New`。 2. 输入机柜名称，选择机柜宽度 `19"` 或 `10"`，填写机柜高度 U 数。 3. 点击 `Create` 创建机柜。创建成功后，应用会自动切换到这个机柜。 4. 点击左侧 `LIB` 展开设备库。 5. 选择一个设备型号，输入要放置的起始 Slot，然后点击 `OK`。 6. 设备会出现在 3D 机柜中；如果目标 U 位已经被占用，应用会提示 `Slot occupied`。 ## 界面说明 顶部工具条用于管理机柜： - `+ New`：新建机柜。 - 机柜名称按钮：切换当前机柜。 - `e`：重命名机柜。 - `x`：删除机柜以及其中的设备和线缆。 左侧 `LIB` 是设备库： - 点击设备条目后，输入 Slot 即可添加到当前机柜。 - 有 3D 模型的设备可以选择 `Front` 或 `Back` 放置方向。 - `GLTF / GLB Upload` 可上传自定义设备模型。 底部工具条用于切换操作模式： - `Select`：选择设备并查看详情。 - `Move`：拖动设备到其他空闲 U 位。 - `Cable`：连接端口，适合记录网线和电源线。 - `Delete`：删除选中的对象。 - `Front` / `Back` / `Free`：切换查看正面、背面或自由视角。 右侧详情面板会在选中设备后出现： - `Info`：编辑名称、OS、IP、VLAN 和电源回路。 - `Hardware`：记录 CPU、RAM、GPU 和存储。 - `Ports`：查看端口数量、正反面位置和占用状态。 右上角 `Net` 用于维护网络和电源数据： - `VLANs`：添加或删除 VLAN，并设置颜色。 - `Circuits`：添加或删除电源回路，并记录电流规格。 ## 常用操作 ### 新建设备摆放 先在左侧 `LIB` 选择设备，再输入起始 Slot。Slot 是从机柜底部开始的 U 位编号。比如 2U 设备放在 Slot 5，会占用 Slot 5 和 Slot 6。 ### 移动设备 切换到底部 `Move` 模式，在 3D 视图里拖动设备到目标 U 位。目标位置必须有足够的连续空位。 ### 连接线缆 切换到底部 `Cable` 模式，依次点击两个端口。网络端口会生成网络连接，电源端口会生成电源连接。 ### 编辑设备信息 在 `Select` 模式下点击设备，右侧会出现详情面板。点击 `Edit` 后可以修改设备名称、OS、IP、VLAN、电源回路和硬件信息，完成后点击 `Save`。 ### 上传自定义模型 展开左侧 `LIB`，在 `GLTF / GLB Upload` 区域点击 `Choose file...`，选择 `.gltf` 或 `.glb` 文件。上传成功后，新模型会出现在设备库中。 上传只是把模型加入左侧设备库，不会自动放入机柜。上传完成后，先在设备库中点击新模型，再输入 Slot 并点击 `OK`，模型才会出现在 3D 机柜里。 可用于测试上传的 GLB 文件： | 文件 | 大小 | 下载链接 | |---|---:|---| | Box | 1.6 KB | https://raw.githubusercontent.com/KhronosGroup/glTF-Sample-Assets/main/Models/Box/glTF-Binary/Box.glb | | Duck | 120 KB | https://raw.githubusercontent.com/KhronosGroup/glTF-Sample-Assets/main/Models/Duck/glTF-Binary/Duck.glb |