群晖 Container Manager 容器化服务搭建全套教程（2026新版）

适用：DSM7.2+，Container Manager（原Docker），全部服务均采用容器部署，含影音、图库、文档、导航、工具、代码仓库等，本文为系列总导读，配套单篇独立部署文档。

前言

群晖DSM7.2之后，官方把Docker套件更名为 Container Manager，底层能力不变，但界面、权限、存储挂载逻辑有改动。很多老Docker教程直接照搬会踩坑，本文梳理一套稳定、可复用的容器服务搭建思路，同时汇总我在搭建过程遇到的坑，每个服务都有独立部署文档，按需查阅。

本文面向：家庭NAS、HomeLab爱好者；基础要求：会使用File Station、会创建共享文件夹、了解基础容器挂载概念。

一、部署前准备（必做，防止90%挂载报错）

1. 存储目录规划

所有容器数据统一放在一个共享文件夹，例如 docker，在File Station手动创建子目录，必须提前建好目录，不要让容器自动生成，否则bind mount会报错。 示例目录结构：

/docker
├─ alist/
├─ gitea/
├─ immich/
├─ navidrome/
├─ miniflux/
├─ stirling-pdf/
├─ it-tools/
├─ homepage/
├─ dozzle/
├─ komga/
└─ pgdata/ # 统一存放Postgres数据库

重点：数据库类容器（Immich、Gitea）单独挂载pgdata，数据持久化，重装容器不会丢失数据。

2. Container Manager 基础设置

  1. 套件中心安装 Container Manager，打开后切换到【项目】，使用compose方式部署（推荐，便于备份配置）
  2. 镜像源替换国内加速源，解决拉取镜像超时问题
  3. 网络：优先使用bridge网络；内网访问不需要额外端口映射，外网访问配合反向代理/端口转发

3. 通用Compose模板规范

所有服务compose统一遵循这套格式，只需要修改镜像名称、挂载路径、端口、环境变量：

services:
  app-name:
    image: 镜像地址
    container_name: app-name
    restart: unless-stopped
    volumes:
      - /volume2/docker/app-name:/config
    environment:
      - TZ=Asia/Shanghai
    ports:
      - "端口:容器内端口"

TZ时区务必配置，否则日志、定时任务时间错乱。

二、服务分类与配套文档索引

🎬 影音媒体类

  1. Jellyfin：家庭媒体影音服务器，配合TVHeadend接收IPTV电视信号
    • 配套文档：Jellyfin TVHeadend插件配置填写教程
    • 拓展：IPTV接入Jellyfin三种方案对比；零Docker，M3U直连Jellyfin直播电视
  2. Navidrome：音乐服务器，自建私人音乐库
    • 配套文档：Navidrome 群晖 Container Manager 部署文档
    • 配套工具：MusicBrainz Picard，批量修复MP3标签，解决未知专辑、中文乱码问题
  3. TinyMediaManager(TMM)：媒体刮削器
    • 配套文档：TinyMediaManager部署文档；TMM与Jellyfin工作逻辑；Jellyfin自带刮削 vs TMM对比

📚 图书/漫画/文档工具

  1. Komga：漫画、绘本、扫描乐谱管理服务
    • 配套文档：Komga 群晖 Container Manager 部署文档
  2. Calibre-Web：电子书图书馆，管理epub/mobi/pdf
    • 配套文档：Calibre-Web 群晖部署教程
  3. Stirling-PDF：全能PDF工具箱，合并、拆分、OCR识别
    • 配套文档：Stirling-PDF完整部署步骤；Stirling-PDF中文tesseract语言包和英文下载地址

🖼️ 相册图库

Immich：开源自托管相册，替代群晖原生相册

  • 配套文档：Immich完整部署文档；Immich vs 群晖原生相册 Synology Photos 完整对比

📰 RSS订阅

Miniflux：RSS阅读器，聚合订阅各类博客、资讯源

  • 配套文档：Miniflux群晖部署教程

🧰 工具集合

  1. IT-Tools：在线小工具合集，编码、格式化、哈希、二维码等
    • 配套文档：IT-Tools群晖Docker部署教程
  2. Dozzle：容器日志实时查看工具，不用进容器看日志
    • 配套文档：Dozzle完整部署步骤；Dozzle vs DockDash对比；Homarr vs Dozzle详细对比
  3. Homepage：HomeLab导航面板，一站式聚合所有服务入口
    • 配套文档：Homepage 群晖 Container Manager部署文档
  4. Sun-Panel：另一款美观的HomeLab导航面板
    • 配套文档：Sun-Panel部署文档；Sun-Panel介绍&与Homarr对比

📦 文件/网盘/代码

  1. Alist：多网盘聚合管理，挂载阿里云盘、本地存储等
    • 配套文档：Alist群晖Container Manager部署文档
  2. Gitea：自建Git代码仓库，用来存放脚本、配置、笔记
    • 配套文档：Gitea部署文档；Gitea在群晖NAS上的工作原理
  3. Kodbox(可道云)：网页文件管理器
    • 配套文档：Kodbox是否值得安装；Kodbox / File Station / Synology Drive三者完整对比&取舍方案
  4. Synology Drive Client：PC同步客户端
    • 科普：Synology Drive Client vs Syncthing vs Duplicati区别

📝 知识库笔记

思源笔记 SiYuan：本地双链知识库

  • 配套文档：思源笔记SiYuan群晖Container Manager部署教程

📺 IPTV电视服务

  1. HDHomeRun 科普，区分M3U与HDHomeRun
  2. xTeVe M3U 踩坑实录：只有一行#EXTM3U的坑
  3. 避坑文章：群晖Docker部署IPTV服务，这10个坑我全踩过了

三、容器运维&进阶

  1. Watchtower：自动更新容器镜像（注意：官方containrrr/watchtower已归档，推荐nickfedor/watchtower分支）
  2. Redis容器缓存说明：部分服务需要Redis做缓存加速
  3. 群晖NAS默认文件夹迁移：系统目录迁移注意事项
  4. 容器更新、备份、迁移最佳实践
    • 备份：把compose yaml文件单独保存；重要数据卷定期快照
    • 更新：优先用项目重建容器，不要直接在容器内修改文件

四、服务选型取舍建议（新手必读）

  • 导航面板：纠结Sun-Panel 和 Homarr，推荐Sun-Panel，界面更现代；简单需求选Homepage，资源占用最低
  • 相册：追求功能、AI识别、手机备份选Immich；简单照片存储、不想折腾就用群晖原生Photos
  • 文件管理：日常使用优先群晖File Station；需要外网网页管理多网盘，选Kodbox+Alist搭配
  • 日志查看：Dozzle轻量，只看日志；DockDash功能更多，资源占用更高

五、常见踩坑汇总