Homarr 部署与配置文档

一、部署（群晖 Container Manager / Docker Compose）

docker-compose.yml

version: "3.8"
services:
  homarr:
    image: ghcr.io/ajnart/homarr:latest
    container_name: homarr
    restart: unless-stopped
    volumes:
      - ./homarr/configs:/app/data/configs
      - ./homarr/icons:/app/public/icons
      - /var/run/docker.sock:/var/run/docker.sock
    ports:
      - "7575:7575"
    environment:
      - TZ=Asia/Shanghai
  1. 在群晖File Station创建存放目录，新建configs、icons子文件夹
  2. 复制compose配置，在Container Manager项目中创建并启动容器
  3. 访问地址：http://NASIP:7575，首次访问创建管理员账号

二、基础面板搭建

  1. 右上角铅笔图标进入编辑模式，点击「+」添加项目/小组件
  2. 新建分类组，用于归类应用卡片
  3. 添加应用卡片：填写服务名称、内网访问地址、图标，按需配置卡片选项
    • 勾选：在新标签页打开、显示应用名称、显示描述提示
    • 取消：启用状态检查
  4. 应用描述在全局【应用】菜单内填写，卡片开关仅控制是否展示提示

三、推荐小组件

  • 日期和时间：首页时钟展示
  • 天气：填写城市获取气象信息，零配置
  • 笔记：Markdown简易备忘，存放服务器地址、端口、常用命令
  • 当前媒体服务流：Jellyfin实时播放会话监控
  • Docker状态：容器启停状态查看（需Portainer集成）
  • iFrame：网页内嵌，可嵌入其他管理面板

四、集成配置

Jellyfin集成（用于当前媒体服务流组件）

  1. 进入Jellyfin后台 → 控制台 → API密钥，新建密钥，复制密钥
  2. Homarr → 管理 → 集成 → 添加集成，选择Jellyfin
  3. 填写服务内网地址、粘贴API密钥，测试连接保存
  4. 编辑「当前媒体服务流」组件，下拉选中已创建的Jellyfin集成

Navidrome集成（音频统计组件）

  1. Navidrome后台，创建API Token
  2. Homarr集成页面添加Navidrome，填写内网地址与Token，测试连通
  3. 添加音频统计小组件，绑定Navidrome集成

五、面板布局参考

顶部行：日期和时间 | 天气 | 笔记 第二行：当前媒体服务流 下方分组：影音媒体、文档知识库、工具服务，放置各应用卡片

六、使用要点

  1. 所有服务优先使用内网IP访问，避免外网端口依赖
  2. 应用卡片关闭状态检查，防止网络误报异常
  3. 集成需先在全局集成页面创建，小组件再选择对应集成
  4. 数据持久化依赖挂载目录，备份时备份homarr/configs目录