飞牛OS中影视文件夹默认创建路径是什么？

Question

在使用飞牛OS时，用户常遇到影视文件夹默认创建路径不明确的问题。系统在首次配置媒体服务时，通常会自动创建默认影视目录，但该路径未在界面中显著标注，导致用户难以定位。常见疑问包括：该路径是位于内置存储还是外部挂载点？是否支持自定义更改？修改后是否会引发媒体库扫描失败？尤其在多用户或Docker环境下，权限与路径映射问题更易暴露。因此，明确飞牛OS影视文件夹的默认生成路径（如 /data/media/Movies 或 /storage/emulated/0/Movies）及其底层逻辑，对顺利搭建家庭影音中心至关重要。

Answer 1

一、飞牛OS影视文件夹默认路径的定位机制

在首次配置媒体服务时，飞牛OS会依据系统存储策略自动创建默认影视目录。该路径通常位于：

• /data/media/Movies —— 常见于基于Linux内核的容器化部署环境。
• /storage/emulated/0/Movies —— 多见于类Android架构或移动设备兼容模式。
• /mnt/user/Media/Movies —— 若启用外部挂载点（如NAS或USB设备）则优先使用此路径。

系统通过init_media_dirs()函数在/etc/fn-os/mediadetect.conf中读取预设规则，并结合df -T判断可用块设备类型，决定最终生成位置。

路径	存储类型	可写性	是否支持Docker映射
/data/media/Movies	内置存储	是	高兼容
/storage/emulated/0/Movies	虚拟化存储	受限（需权限提升）	中等
/mnt/user/Media/Movies	外部挂载	依赖挂载选项	需显式绑定

二、底层逻辑与初始化流程分析

飞牛OS在启动媒体服务时调用以下流程：

graph TD
    A[启动媒体服务] --> B{检测是否存在media_root}
    B -- 不存在 --> C[执行find_available_storage()]
    C --> D[遍历/mnt/, /media/, /storage/]
    D --> E[评估各路径IO性能与剩余空间]
    E --> F[选择最优路径并创建Movies/TVShow子目录]
    F --> G[写入config.db: media.default_path]
    B -- 存在 --> H[加载已有路径]
    H --> I[触发媒体库扫描]
    

该过程由systemd服务fn-media-init.service驱动，其Unit文件包含：

[Service]
Type=oneshot
ExecStart=/usr/bin/python3 /opt/fn-os/scripts/init_media.py
RemainAfterExit=yes
StandardOutput=journal

三、自定义路径的可行性与风险控制

用户可通过两种方式修改默认路径：

1. 在Web UI的“媒体设置”中指定新路径（推荐）。
2. 手动编辑/etc/fn-os/settings.json中的media_library_path字段。

但需注意以下潜在问题：

• 若新路径属外部设备，需确保/etc/fstab中设置了nofail,x-systemd.mount-timeout=30以避免启动阻塞。
• Docker容器内运行Plex/Jellyfin时，必须将宿主机路径通过-v /new/path:/media正确映射。
• SELinux或AppArmor策略可能限制非标准路径访问，需执行setfacl -R -m u:mediaserver:rwx /custom/path赋权。

四、多用户与Docker环境下的权限映射难题

在多用户场景下，UID/GID不一致常导致权限冲突。例如：

$ ls -l /data/media/
drwxr-x--- 4 1001 1001 4096 Apr 5 10:20 Movies

此时若Docker容器以UID 1000运行，将无法读取内容。解决方案包括：

方案	实施方式	适用场景
统一UID/GID	usermod -u 1001 mediaserver && groupmod -g 1001 media	单机部署
Docker启动参数注入	docker run -e PUID=1001 -e PGID=1001	Portainer/YAML编排
FUSE层虚拟化	使用mergerfs合并多路径并统一视图	跨设备聚合

五、路径变更后的媒体库重建策略

更改路径后，原有元数据索引可能失效。建议执行以下步骤：

1. 停止媒体服务：systemctl stop fn-media-server
2. 迁移数据：rsync -av /old/path/* /new/path/
3. 更新数据库路径引用：
   sqlite3 /var/lib/fn-media/config.db "UPDATE settings SET value='/new/path' WHERE key='media_root';"
4. 清理缓存：find /var/cache/fn-media -type f -delete
5. 启动服务并强制全量扫描

此外，可在advanced_settings.xml中启用<MonitorPathChanges>true</MonitorPathChanges>实现动态感知。