如何用1条Docker命令部署Rackula：从空仓库到可视化机架的完整教程

【免费下载链接】Rackularack layout designer项目地址https://gitcode.com/gh_mirrors/ra/Rackula点击查看免费下载Rackula 是一款开源免费的机架布局设计工具rack layout designer你可以在浏览器里拖拽真实的服务器、交换机、UPS 等设备图像先画好机架再动手装机。本文带你用一条 Docker 命令从零部署 Rackula5 分钟后即可在本地规划属于自己的 42U 可视化机架。为什么要先建一台虚拟机架搬动一台装满硬盘的 4U 服务器远不如在屏幕上拖动它来得轻松。Rackula 解决的正是这类问题拖拽式布局从内置的真实硬件库中拖出设备放入机架不再是灰色方块而是来自真实设备库的产品图像前后双面视图FRONT 与 REAR 双视图同步显示布线规划一目了然导出与分享布局可导出为 PNG / PDF / SVG也可通过 URL 或二维码分享给团队移动端友好机房现场用手机也能查看和编辑可自托管Docker、Docker Compose 均可数据完全掌握在自己手里如上图所示左侧是设备库分类服务器、网络、电源、存储等中间是机架正反面视图右侧是设备编辑面板——这就是 Rackula 机架布局设计的核心工作区。一条 Docker 命令5 分钟跑起来 前置条件已安装 DockerDocker Desktop 或dockerd均可验证一下docker --version启动命令在任意空仓库目录或任意目录中执行这一条命令docker run -d -p 8080:8080 ghcr.io/rackulalives/rackula:latest三个参数各管一件事参数作用-d后台运行容器-p 8080:8080把宿主机 8080 端口映射到容器内 nginxghcr.io/rackulalives/rackula:latest官方最新前端镜像amd64 / arm64 均支持验证部署docker ps # 应看到 rackula 容器处于 Up 状态 curl -fsS http://localhost:8080/version.json # 返回版本号即成功然后打开浏览器访问http://localhost:8080你的 Rackula 已经跑起来了。⚠️ 这种最简模式是纯前端部署布局保存在浏览器本地IndexedDB换一台电脑或换浏览器看不到之前画的机架。想跨设备同步看下一节。进阶带持久化的 Docker Compose 部署 正式使用的推荐方式是 Compose 部署——前端 API 两个容器机架布局以 YAML 文件形式落盘任意浏览器打开都能看到同一份数据。第 1 步克隆仓库拿到官方 Compose 文件git clone https://gitcode.com/gh_mirrors/ra/Rackula cd Rackula第 2 步创建数据目录API 容器以 UID 1001 运行必须给它写权限mkdir -p data sudo chown 1001:1001 data第 3 步启动整套服务docker compose -f deploy/docker-compose.persist.yml up -d配置文件见 deploy/docker-compose.persist.yml完整原理见 docs/deployment/SELF-HOSTING.md。架构非常简洁浏览器 → nginx (8080) → 提供前端页面 → 代理 /api/* 到 API 容器 API (3001) → 读写 ./data 下的 YAML 机架布局数据会以这样的结构保存在./data/中备份只需打包这个目录./data/ ├── my-homelab-11111111-.../ │ ├── my-homelab.rackula.yaml # 机架布局YAML │ └── assets/{deviceId}/front.png # 自定义设备图部署完成后先画一台机架 1. 新建机架进入应用后会自动创建一台默认机架。选中它右侧 Edit 面板可调整高度12U~48U、宽度10~23与 U 编号方向。首次部署时会看到这样的空机架2. 拖入设备左侧设备库按品牌或分类筛选Generic 类别即包含通用服务器、交换机、PDU 等把设备拖到目标 U 位放置时会自动校验高度与冲突3. 多机架管理点击左侧 Racks 标签可添加第二台、第三台机架整排机柜并排展示适合网络柜 服务器柜 音频柜的组合4. 导入与导出仓库内置了三份 YAML 模板可直接导入体验完整布局static/templates/home-lab.rackula.yamlstatic/templates/media-server.rackula.yamlstatic/templates/network-closet.rackula.yaml完成后通过 Share 功能导出 PNG / PDF / SVG或生成二维码把布局发到手机查看。常用配置速查表 ⚙️生产部署时按需设置这几个环境变量即可更多变量见 docs/deployment/SELF-HOSTING.md 的 Environment Variables 一节变量默认值说明RACKULA_PORT8080宿主机 Web 端口如RACKULA_PORT3000 docker compose up -dCORS_ORIGINhttp://localhost:8080改端口/域名后必须同步为真实浏览器来源RACKULA_STORAGE_MODEserverCompose 持久版前端存储模式browser / serverRACKULA_AUTH_MODEnone认证模式none / local / oidcRACKULA_API_WRITE_TOKEN未设置保护 API 写入路由PUT/DELETE的 Bearer 令牌对外网部署建议至少设置明确的CORS_ORIGIN与写入令牌认证与 TLS 细节可参考 docs/deployment/AUTHENTICATION.md。升级与备份每次升级前必做cp -a data data.bak # 1. 备份数据目录 docker compose -f deploy/docker-compose.persist.yml pull # 2. 拉取新镜像 docker compose -f deploy/docker-compose.persist.yml up -d # 3. 重建容器提示拉取新镜像本身不会触碰/data中的布局风险只在于升级后第一次保存会改写文件格式所以备份是必选项而非可选项。常见问题排查 症状排查方法8080 端口被占用RACKULA_PORT8081 docker compose up -d访问localhost:8081Permission denied保存失败API 以 UID 1001 运行sudo chown -R 1001:1001 ./dataUI 提示 Persistence API unavailabledocker compose logs rackula-api查看 API 容器是否健康确认部署版本curl -fsS http://localhost:8080/version.json前端与/api/version后端两者版本号应一致容器反复重启时优先看日志docker logs rackula与docker logs rackula-api。写在最后回顾一下这条最短路径一条docker run命令即可体验 Rackula加上deploy/docker-compose.persist.yml三个步骤就拥有了带持久化、可备份、可升级的完整自托管部署。布局先画在屏幕上的每一分钟都是机房里少弯一次腰。更多架构细节可查阅 docs/ARCHITECTURE.md项目采用 MIT 协议开源欢迎参与共建。赞分享【免费下载链接】Rackularack layout designer项目地址https://gitcode.com/gh_mirrors/ra/Rackula点击查看免费下载相关推荐如何一条命令部署QQ机器人go-cqhttp Docker容器化部署分步实战教程如何一条命令部署QQ机器人go cqhttp Docker容器化部署分步实战教程 go cqhttp 是 cqhttp 的 Go 语言原生实现轻量且跨平台即时通讯后端3步切换任意游戏的DLSS版本DLSS Swapper新手完全指南3步切换任意游戏的DLSS版本DLSS Swapper新手完全指南 游戏内置的图像增强技术常常锁死在发售时的旧版上你自己既升不上去也换不了。DLSS Swa桌面应用如何用Ansible Semaphore实现Ansible Playbook可视化部署完整教程如何用Ansible Semaphore实现Ansible Playbook可视化部署完整教程 Ansible Semaphore是一个现代化的Ansible后端前端任务调度运维CI/CD认证鉴权创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考