群晖套件不显示新增文件?Photo/Audio Station 与 iTunes Server 完整排查指
南
一、先定位根源:套件不显示新增文件的 5 大核心原因(附自查表)
不同套件(Photo/Audio Station、iTunes Server)不显示文件的诱因高度重合,官方将其归纳为五类,结合 “故障表现” 与 “快速验证方法” 可精准定位问题:
原因类型 | 典型故障表现 | 官方推荐验证方法 |
1. 文件夹未纳入索引范围 | 新增文件存入自定义文件夹(非默认 photo/music),套件中完全不显示 | 1. 进入 DSM【控制面板→索引服务→媒体索引】;2. 查看 “索引文件夹” 列表,确认文件所在文件夹是否在列 |
2. 媒体索引未更新 | 刚上传文件,套件中暂时不显示,等待 10 分钟后仍无踪迹 | 1. 点击 DSM 桌面顶部 “生成进度” 图标,查看索引进度;2. 手动触发重建索引后,观察文件是否出现 |
3. 权限配置不足 | 非 admin 用户上传的文件,仅部分用户能看到或所有人都看不到 | 1. 通过 File Station 右键文件→【属性→权限】;2. 检查套件对应的用户组(如 photo 用户组)是否有 “读取” 权限 |
4. 文件格式不兼容 | 特定格式文件(如 MP4 音频、少见 RAW 格式)单独不显示 | 1. 对照官方格式列表(见下文)核对文件后缀;2. 将文件格式转换为套件支持类型后重试 |
5. 特殊存储位置限制 | 文件存入远程挂载文件夹或外部 U 盘,始终不显示 | 1. 确认文件是否在本地共享文件夹;2. 检查是否为 “远程挂载文件夹”(官方明确此类无法索引) |
二、分套件解决:Photo/Audio Station+iTunes Server 新增文件显示优化方案
三大套件的核心解决逻辑一致(索引 + 权限),但存在格式适配、默认路径的差异,需针对性操作:
(一)通用基础:配置媒体索引服务(所有套件必备步骤)
媒体索引服务是文件在套件中显示的 “桥梁”—— 仅被索引的文件夹内文件,才能被 Photo/Audio Station、iTunes Server 识别。DSM 7.x 与 6.x 操作略有差异,以主流 7.x 为例:
步骤 1:确认默认索引文件夹(快速排查基础配置)
- 登录 DSM 桌面,点击【控制面板】→【索引服务】→【媒体索引】;
- 查看 “索引文件夹” 默认列表:
- 包含photo(Photo Station 默认索引)、music(Audio Station 与 iTunes Server 默认索引)、video(Video Station 默认索引);
- 若新增文件存入这些默认文件夹,直接进入步骤 3 手动更新索引;若存入自定义文件夹(如 “家庭照片 2025”),需先执行步骤 2 添加索引。
步骤 2:添加自定义文件夹到索引范围
- 在 “媒体索引” 页面点击【索引文件夹】→【创建】→【选择】;
- 从文件夹列表中勾选自定义文件夹(如 “家庭照片 2025”),点击【选择】;
- 勾选对应文件类型:
- 供 Photo Station 识别:勾选 “照片”;
- 供 Audio Station/iTunes Server 识别:勾选 “音乐”;
- 若含视频:同时勾选 “视频”(Video Station 适配);
- 点击【确定】→【保存】,系统自动开始首次索引(耗时取决于文件数量,100 张照片约 30 秒)。
步骤 3:手动触发索引更新(解决 “刚上传不显示” 问题)
- 若新增文件后等待超过 5 分钟仍不显示,在 “媒体索引” 页面点击【重建索引】;
- 弹出提示框勾选 “所有索引文件夹”,点击【确定】—— 此时桌面顶部会出现 “生成进度” 图标,可实时查看索引进度;
- 索引完成后(图标消失),刷新对应套件页面,文件即可显示。
DSM 6.x 差异操作:
- 进入【控制面板】→【索引服务】→【媒体文件索引】;
- 点击【索引文件夹】→【添加】,后续步骤与 7.x 一致,但无 “生成进度” 实时显示,需等待 2-10 分钟后检查。
(二)专项适配:各套件特色问题解决(格式 + 权限)
1. Photo Station:解决 RAW 格式不显示、权限异常问题
Photo Station 支持多数主流照片格式,但 RAW 格式兼容性有限,且photo文件夹权限有特殊限制:
(1)格式适配:确保文件在支持列表内
官方明确支持的照片格式包括:BMP、JPEG、GIF、RAW(ARW、CR2、NEF、DNG 等 20 余种)、TIFF、PNG。若遇到不显示的情况:
- 检查文件后缀是否正确(如 “CR2” 不可写为 “CR”);
- 少见 RAW 格式(如 “ORF”“RW2”)需确认 DSM 版本≥7.0(旧版本可能不支持);
- 视频文件仅支持 3G2、MP4、MTS 等格式,RM/RMVB 仅支持下载不显示预览。
(2)权限配置:突破photo文件夹权限限制
photo文件夹为系统默认共享文件夹,无法直接修改子文件权限,需通过用户组控制:
- 进入【控制面板】→【用户与群组】→【群组】;
- 找到 “photo” 用户组(Photo Station 专用群组),点击【编辑】→【权限】;
- 勾选 “photo” 共享文件夹的 “读取” 权限(确保普通用户能查看新增文件),点击【应用】。
2. Audio Station:解决 MP4 不索引、音乐分类不显示问题
Audio Station 对音频格式要求严格,且依赖索引生成分类列表:
(1)格式适配:MP4 文件需手动改后缀
官方明确 MP4 文件不支持索引,需改为 M4A 格式才能显示:
- 通过 File Station 找到 MP4 音频文件,右键【重命名】;
- 将后缀 “.MP4” 改为 “.M4A”(确保文件类型为 “音频文件”);
- 按通用步骤 3 触发重建索引,刷新 Audio Station 即可看到文件。
(2)分类修复:确保音乐文件含元数据
若文件显示但 “按艺术家 / 专辑” 分类为空,需补充元数据:
- 右键音频文件→【属性】→【元数据】;
- 填写 “艺术家”“专辑” 字段(批量操作可选中多个文件统一编辑);
- 重建索引后,分类列表会自动更新。
3. iTunes Server:解决音乐不同步、文件夹不识别问题
iTunes Server 依赖music文件夹索引,且需开启对应服务:
(1)基础配置:启用 iTunes Server 并关联索引
- 进入【套件中心】确认 iTunes Server 已安装并运行;
- 打开 iTunes Server→【设置】→【共享文件夹】;
- 确认已选择music文件夹(或已添加到索引的自定义音乐文件夹),勾选 “共享整个音乐库”;
- 重启 iTunes Server 服务,等待索引完成后同步客户端。
(2)权限检查:确保 iTunes 用户有访问权限
- 进入【控制面板】→【共享文件夹】→music→【权限】;
- 添加 “iTunes” 用户(套件默认用户),勾选 “读取” 权限;
- 若需远程访问,同时勾选 “远程访问” 权限,点击【应用】。
三、验证与排查:确认新增文件正常显示(全套件通用)
优化后需通过 “三步验证法” 确认问题解决,避免遗漏隐患:
步骤 1:基础显示验证
- 打开对应套件(如 Photo Station),点击左侧【按文件夹】分类;
- 找到文件所在文件夹,确认新增文件已列出(无红色叉号或灰色图标);
- 尝试打开 / 播放文件,确认操作正常(排除权限不足导致的 “无法访问”)。
步骤 2:索引完整性验证
- 进入【索引服务】→【媒体索引】;
- 查看 “索引文件夹” 对应的 “状态” 为 “正常”,无 “失败” 提示;
- 点击【日志】,确认无 “权限不足”“格式错误” 等异常记录。
步骤 3:多设备同步验证
- 在手机端打开 Synology Photos/Audio Station APP;
- 登录同一账号,确认新增文件已同步显示;
- iTunes 客户端中查看 “共享音乐库”,确认文件可播放。
四、常见问题解答:优化后仍不显示?官方方案衍生解决
Q1:重建索引后文件仍不显示,提示 “索引失败”?
- 原因:文件所在文件夹为远程挂载文件夹(官方禁止索引);
- 将文件移动到本地共享文件夹(如photo、自定义本地文件夹);
- 按步骤 2 添加该文件夹到索引,重建索引后即可显示。
Q2:权限列表显示 “未知”,文件无法访问?
- 原因:用户 / 群组已删除或 NAS 离开域 / LDAP,导致权限失效;
- 进入【用户与群组】确认对应用户 / 群组存在且启用;
- 右键文件→【属性→权限】,删除 “未知” 权限条目,重新添加有效用户并配置权限。
Q3:外部 U 盘文件不显示,移动到本地文件夹仍不行?
- 原因:外部存储设备重启后需重建索引,且文件可能无权限;
- 进入【存储管理器】确认外部设备已挂载;
- 将文件复制到本地共享文件夹,按步骤 3 重建索引;
- 检查文件权限,确保套件用户有 “读取” 权限。
Q4:DSM 7.x 升级后,原有文件显示但新增文件不显示?
- 原因:升级后索引服务重置,自定义文件夹未重新添加;
- 进入【索引服务】重新添加所有自定义文件夹;
- 勾选对应文件类型,重建全量索引(耗时较长,建议深夜执行)。
五、总结:确保套件显示新增文件的核心原则
要长期维持三大套件的文件显示稳定性,需遵循官方强调的 3 个核心原则:
- 索引优先:任何新增文件的文件夹必须纳入媒体索引,远程挂载文件夹绝对避免;
- 格式适配:严格对照官方格式列表存储文件,MP4 音频及时改 M4A;
- 权限匹配:套件用户组(photo/audio/iTunes)必须拥有文件夹 “读取” 权限。
若你需要针对 “特定文件格式(如罕见 RAW 格式)适配”“多用户权限精细化配置” 或 “DSM 6.x 旧版本深度优化” 补充细节,欢迎随时告知,我会结合官方最新教程提供定制化操作指南。