Homarr：专为极客玩家打造的开源服务器中控台工具

Homarr是什么？

Homarr是一款专为家庭服务器和NAS用户设计的轻量级导航面板，通过简洁的可视化界面集中管理各类自托管服务。它通过聚合常用服务和应用的小部件，帮助用户在一个简洁界面中集中管理和监控各类工具，提升操作效率。Homarr特别适合拥有多个Docker服务的NAS用户、喜欢自定义可视化面板的极客玩家以及需要为家人提供简化入口的服务器管理员。

作为一个"服务器中控台"，Homarr能将Plex影库、qBittorrent下载器、Portainer管理入口等各种服务集中展示，解决多服务地址记忆困难的问题。其名称"Homarr"可能源自"Home"与"Arr"（常见媒体管理工具后缀，如Sonarr/Radarr）的组合，体现了其主要应用场景。

功能特色

Homarr的核心价值在于其高度集成化和可定制化的设计理念，下表概括了其主要功能特点：

Homarr的界面采用左中右三栏布局，用户可将不同功能分区部署。进入编辑模式后，所有组件的位置和尺寸都可自由调整，这种"所见即所得"的操作方式大大降低了配置门槛。项目内置了超过10,000个服务图标，当用户添加常见服务(如Sonarr、Plex等)时，系统能自动识别并匹配对应图标，无需手动上传。

值得一提的是，Homarr不仅是一个静态导航页，它还通过API集成实现了动态数据展示。例如在媒体管理方面，用户只需配置Sonarr/Radarr的API密钥，面板就能实时显示下载队列和媒体库状态。版本v0.14.0后还增加了多用户权限管理功能，区分管理员和普通用户角色，增强了安全性。

技术架构与部署方式

Homarr采用现代Web技术栈开发，主要技术组成包括：

• 前端：基于TypeScript构建，使用tRPC实现类型安全的客户端-服务器通信

• 后端：利用Node.js运行环境，支持WebSocket实时数据传输

• 数据层：可选用Redis作为实时数据存储和更新机制

• 安全：集成BCrypt和AES-256-CBC加密算法，支持OIDC/LDAP单点登录

项目提供多种部署方式，最简单的是通过Docker容器运行。以下是典型的docker-compose配置示例：

services:
  homarr:
    container_name: homarr
    image: ghcr.io/ajnart/homarr:latest
    restart: unless-stopped
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock # Docker集成(可选)
      - ./configs:/app/data/configs # 配置文件
      - ./icons:/app/public/icons # 自定义图标
    ports:
      - '7575:7575' # 默认端口

部署完成后，访问 http://服务器IP:7575即可进入初始化设置。首次使用需创建管理员账户，密码要求包含大小写字母、数字和特殊字符。建议立即在"User Preferences"中将语言切换为中文，并根据需要开启匿名访问功能以避免频繁登录。

对于进阶用户，也可选择从源码构建Homarr。这需要先克隆GitHub仓库，然后使用npm或yarn安装依赖并构建项目：

git clone https://github.com/homarr-labs/homarr.git 
cd homarr
npm install
npm run build
npm start

使用场景与配置指南

Homarr特别适合以下三类用户群体：

1. 拥有5+服务的Docker重度用户：集中管理分散的容器服务

2. 喜欢折腾可视化面板的极客党：高度自由的定制空间

3. 需要给家人提供简化入口的NAS管理员：友好界面降低使用门槛

配置Homarr主要包括三个步骤：

1. 添加基础服务

• 进入设置 → Services → Add Service

• 填写服务名称、地址(如 http://内网IP:9000)

• 系统自动匹配图标或手动上传

2. 配置媒体库集成

• 在Sonarr/Radarr后台获取API密钥

• 将API Key粘贴到Homarr设置页

• 开启状态监控显示实时数据

3. 个性化界面调整

• 通过主题商店选择暗黑/赛博朋克等风格

• 添加CPU监控、天气预报等小组件

• 拖拽组件形成专属工作流布局

对于外网访问需求，建议配合Nginx Proxy Manager进行反向代理并开启HTTPS。常见问题处理包括：图标丢失时可手动上传至/app/public/icons目录；数据迁移时备份/opt/docker/homarr/config目录；版本更新后检查多用户权限设置。

相关链接

安全注意事项与漏洞历史

虽然Homarr设计初衷是作为内网管理工具，但在实际使用中仍需注意以下安全事项：

1. 外网暴露风险：若需公网访问，必须配合Nginx等反向代理并启用HTTPS

2. API密钥保护：填入的Sonarr/Radarr等API密钥在早期版本无额外保护

3. 漏洞修复：v0.14.0之前版本存在Notebook widget的存储型XSS漏洞(CVE-2023-45908)

特别需要注意的是，在v0.6.0之前的版本中，Homarr没有内置认证机制，所有面板内容完全公开。因此旧版本用户务必升级到最新版本，或至少添加基础认证层如Authlia等解决方案。

同类产品对比

与类似工具如Heimdall、Organizr相比，Homarr在以下方面展现出独特优势：

这一对比显示，Homarr在保持易用性的同时，提供了更专业的媒体服务器集成和更灵活的界面定制选项，特别适合中国用户和技术入门者。

总结

Homarr是一款集服务聚合、状态监控和个性化布局于一体的轻量级服务器导航面板，通过直观的拖拽界面和丰富的集成功能，帮助用户高效管理家庭服务器上的各类Docker服务和应用；其开源特性、活跃社区和持续更新使其成为自托管爱好者简化工作流的理想选择，特别适合需要集中管理多个服务入口但又不愿复杂配置的NAS用户。