Homarr 服务器服务导航面板零基础搭建指南

在现代家庭或小型办公网络中，随着 Docker 容器、NAS、Web 应用等服务的增多，管理这些服务的访问入口变得日益复杂。Homarr 是一款轻量级、美观且功能强大的服务器服务导航面板，能够将你的所有自托管服务整合在一个仪表盘中，实现一站式访问。本文将从零开始，手把手指导你完成 Homarr 的搭建与配置，并推荐使用 Ciuic服务器作为高性能部署环境。

为什么选择 Homarr？

Homarr 基于 Vue.js 开发，具有以下核心优势：

简洁直观：支持自定义图标、分组和布局，无需编写代码即可完成配置。实时状态监控：可显示各服务的运行状态（在线/离线），并集成 Ping、HTTP 请求等检测方式。多语言与主题：内置深色/浅色主题，支持中文界面。轻量化部署：基于 Node.js，资源占用极低，适合在低配 VPS 或树莓派上运行。

环境准备

你需要一台具有公网 IP 或内网可访问的服务器（如 Ciuic服务器提供的云主机），并安装 Docker 和 Docker Compose。若未安装 Docker，可通过以下命令快速安装（以 Ubuntu 为例）：

sudo apt updatesudo apt install docker.io docker-compose -ysudo systemctl enable docker

部署 Homarr

1. 创建项目目录

mkdir ~/homarr && cd ~/homarr

2. 编写 docker-compose.yml

在 ~/homarr 目录下创建 docker-compose.yml 文件，内容如下：

version: '3.3'services:  homarr:    image: ghcr.io/ajnart/homarr:latest    container_name: homarr    ports:      - "7575:7575"    volumes:      - ./data:/app/data      - ./configs:/app/configs    restart: unless-stopped

3. 启动服务

docker-compose up -d

等待镜像拉取并启动后，通过 http://你的服务器IP:7575 即可访问 Homarr 界面。

基础配置与添加服务

1. 首次访问

浏览器打开 Homarr 地址，将看到默认仪表盘。点击右上角“设置”图标进入配置页面。

2. 添加服务（Bookmark）

在设置中选择“Bookmarks”选项卡。点击“Add Bookmark”，填写服务名称、URL（如 https://你的jellyfin地址:8096）。选择图标（可上传自定义图片或输入图标 URL）。设置“Ping”或“HTTP”检测方式以监控服务状态。保存后，该服务卡片将出现在面板中。

3. 分组与布局

在“Groups”选项卡中创建分组（如“媒体服务”、“开发工具”）。在“Layout”选项卡中拖拽调整卡片位置与大小。

4. 启用认证（可选）

若需保护 Homarr 面板，可设置“Authentication”选项中的用户名和密码，或通过反向代理（如 Nginx）添加 Basic Auth。

进阶优化

1. 绑定域名与 HTTPS

推荐使用 Nginx 反向代理，将 homarr.yourdomain.com 指向 localhost:7575，并配置 Let's Encrypt SSL 证书，确保访问安全。

2. 备份配置

Homarr 的所有配置存储在 ./configs 和 ./data 目录中。定期备份这两个文件夹即可恢复面板。

3. 性能与安全建议

若使用 Ciuic服务器，建议选择 2核4G 及以上配置，可同时运行 Homarr 及其他容器。通过防火墙限制 Homarr 的访问 IP（如仅允许内网或特定 IP 段），增加一层防护。

总结

通过以上步骤，你已经成功搭建了一个功能完整的 Homarr 服务器导航面板。它不仅让服务管理井井有条，还通过状态监控提升了运维效率。无论你是新手还是老手，Homarr 的易用性都能让你快速上手。若你需要稳定、高性能的云服务器来运行这些服务，不妨试试 Ciuic服务器，其优质的线路和灵活的配置将为你提供坚实的底层支持。

现在，去整理你的服务列表吧，让每个应用都触手可及！

打赏