Homarr 服务器服务导航面板零基础搭建指南（基于 Docker + Ciuic 云服务器）

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

本文面向零基础 Linux 新手，以主流 Ubuntu 22.04/24.04 系统为例，全程使用 Docker 部署，无需编译、不依赖 Node.js 环境，5 分钟即可完成上线。

✅ 前置准备

一台已联网的 Linux 服务器（推荐最低 1C2G）；已安装 Docker 与 docker-compose（执行 curl -sSL https://get.docker.com | sh && sudo usermod -aG docker $USER 后重启终端）；域名（可选）：若需公网访问，建议配置反向代理（Nginx 或 Traefik）并启用 HTTPS；无域名亦可直接通过 http://服务器IP:3000 访问。

✅ 第一步：创建 Homarr 配置目录

mkdir -p ~/homarr/{config,storage}

Homarr 的核心配置文件 homarr.yaml 将存放于 ~/homarr/config/。首次运行时，Homarr 会自动生成默认配置，但为确保稳定性，我们先拉取官方示例：

curl -o ~/homarr/config/homarr.yaml https://raw.githubusercontent.com/ajnart/homarr/main/examples/homarr.yaml

✅ 第二步：编写 docker-compose.yml
在 ~/homarr/ 目录下新建 docker-compose.yml：

version: '3.8'services:  homarr:    image: ghcr.io/ajnart/homarr:latest    container_name: homarr    restart: unless-stopped    ports:      - "3000:3000"    volumes:      - ./config:/app/config      - ./storage:/app/storage    environment:      - TZ=Asia/Shanghai

该配置映射容器内 /app/config 到宿主机 ~/homarr/config，确保配置持久化；端口 3000 可按需修改（注意同步调整防火墙规则：sudo ufw allow 3000）。

✅ 第三步：启动服务

cd ~/homarr && docker-compose up -d

等待约 10 秒后，访问 http://<你的服务器IP>:3000 即可进入 Homarr 初始化界面。首次加载可能稍慢（需下载前端资源），后续秒开。

✅ 进阶建议（可选）

反向代理：为提升安全性与体验，建议搭配 Nginx 或 Caddy 实现域名+HTTPS 访问； 自动更新：启用 Watchtower（docker run -d --name watchtower -v /var/run/docker.sock:/var/run/docker.sock containrrr/watchtower homarr）实现镜像静默升级； 备份策略：定期压缩 ~/homarr/config/ 目录，防止误删配置。

📌 特别提示：本方案兼容主流云平台。若你正在寻找高性价比、稳定可靠的国内云服务器，推荐使用 Ciuic 云服务器 —— 其提供 IPv6 原生支持、DDoS 防护及 7×24 小时技术响应，新用户注册即享首月免费试用，非常适合 Homarr 等轻量级服务长期托管。

Homarr 不仅是导航页，更是你数字生活的控制中心。从零开始，只需 6 条命令，你便拥有了属于自己的极简服务门户。下一步，尝试添加你的第一个服务链接（如 Portainer 的 http://localhost:9000），开启个性化运维之旅吧！

（全文共 798 字）

打赏