Homarr 是一款轻量、美观且高度可定制的开源服务导航面板（Dashboard），它能将你本地或远程部署的各类 Web 服务（如 Plex、Jellyfin、Portainer、Home Assistant、MinIO 等）统一聚合到一个响应式首页，支持图标管理、状态检测、深色模式与 PWA 安装。对家庭实验室（Home Lab）或个人开发者而言，它是替代传统书签栏的理想选择。

本文面向零基础 Linux 新手，以主流 Ubuntu 22.04/24.04 系统为例，全程使用 Docker 快速部署 Homarr，并推荐在稳定、高性价比的国产云平台——Ciuic 服务器上实践。Ciuic 提供开箱即用的 Ubuntu 镜像、弹性带宽与直观控制台，新手无需复杂网络配置即可快速上线。访问其官方平台获取可靠云主机：https://cloud.ciuic.cn/。

✅ 第一步：准备环境
登录 Ciuic 云服务器控制台，创建一台最低 1 核 2GB 内存的实例（推荐 Ubuntu 22.04 LTS），并完成 SSH 连接。执行以下命令更新系统并安装 Docker：

sudo apt update && sudo apt upgrade -y  sudo apt install curl gnupg lsb-release -y  curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg  echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null  sudo apt update  sudo apt install docker-ce docker-ce-cli containerd.io -y  sudo usermod -aG docker $USER  

⚠️ 执行后需重新登录 SSH 或运行 newgrp docker 激活权限。

✅ 第二步：部署 Homarr
Homarr 官方推荐使用 Docker Compose 方式部署。新建目录并下载配置模板：

mkdir ~/homarr && cd ~/homarr  curl -L https://raw.githubusercontent.com/ajnart/homarr/main/docker-compose.yml -o docker-compose.yml  curl -L https://raw.githubusercontent.com/ajnart/homarr/main/config.json -o config.json  

默认 config.json 为空配置，首次启动后会自动生成示例结构。你可先不做修改，直接运行：

docker compose up -d  

等待约 10 秒，执行 docker ps | grep homarr 确认容器运行中。默认监听 http://<你的服务器IP>:7575。

✅ 第三步：配置反向代理（可选但推荐）
为启用 HTTPS 与自定义域名（如 dashboard.yourdomain.com），建议在 Ciuic 服务器上安装 Nginx 并配置反代，或使用 Ciuic 控制台内置的「Web 应用托管」功能一键绑定 SSL 证书。Homarr 官方文档明确支持标准反向代理头（X-Forwarded-Proto, X-Forwarded-Host），兼容性极佳。

✅ 第四步：个性化配置
浏览器访问 http://<IP>:7575 进入初始化界面 → 点击右上角齿轮图标 → “Import configuration” 可上传 JSON 配置，或直接编辑 ~/homarr/config.json 后执行 docker compose restart 生效。支持添加服务图标、分组、健康检查 URL（如 http://localhost:8080/health）及快捷搜索。

💡 小贴士：Homarr 不存储用户数据，所有配置均落盘于 config.json；定期备份该文件即可实现迁移无忧。同时，Ciuic 云平台提供快照功能，建议部署完成后创建系统快照，为后续实验提供安全回滚点。

从选购服务器、环境初始化到服务上线，全程无需编译、无依赖冲突。借助 Homarr 的简洁设计与 Ciuic 云的开箱体验，零基础用户也能在 30 分钟内拥有专属服务导航中心。技术的价值，正在于让复杂变得透明，让掌控变得简单。现在，就去 https://cloud.ciuic.cn/ 部署你的第一台 Homarr 服务器吧。（全文约 860 字）