docs(media-core): replace unRaid NFS binds with CIFS

This commit is contained in:
Codex
2026-09-09 23:40:15 -07:00
parent 6d1dcb6a1a
commit e2e7bac4a6
+9 -8
View File
@@ -19,17 +19,18 @@ Sonarr4K 的容器路径 `/mnt/unRaid/downloads` 与 SAB 报告路径一致。
## 宿主机前置条件
- `/mnt/truenas/multimedia`:TrueNAS 可读写 NFS。
- `/mnt/unraid/downloads`:unRaid `/mnt/user/downloads` 可读写 NFS。
- `/mnt/unraid/tv4k`:unRaid `/mnt/user/tv4k` 可读写 NFS。
- `/mnt/unraid/downloads`:unRaid `downloads` User Share,可读写 SMB 3.1.1。
- `/mnt/unraid/tv4k`:unRaid `tv4k` User Share,可读写 SMB 3.1.1。
- `/mnt/unraid/movie4k`:unRaid `movie4k` User Share,可读写 SMB 3.1.1。
- Appdata:`/opt/media-core/appdata/<service>`。
- 备份:`/opt/media-core/backups`,归档文件必须为 `root:root 0600`。
长期运行的 Docker bind 不使用带 idle timeout 的 systemd automount。2026-09-09 已将
`/mnt/unraid/tv4k` 改为常驻 NFS 4.2 mount,并用
`x-systemd.before=docker.service` 保证启动顺序;这是 Sonarr4K 的生产基线。其余仍被
容器 bind 的 NFS 路径,应在无活动下载或导入的维护窗口逐一采用相同策略。遇到
`Stale file handle` 时,先停止占用该挂载的容器,再卸载、重新挂载并重启容器;仅在
宿主机触发 automount 或反复 redeploy 不能构成永久修复。
unRaid `/mnt/user/*` 的 NFS export 在本环境中反复出现 `fileid changed`,即使改为常驻
NFS 也会在次日再次失效。因此,绑定给长期运行容器的 `tv4k`、`movie4k` 和
`downloads` 必须使用 CIFS,不能恢复为 NFS 或 automount。生产参数为 SMB 3.1.1、
guest、`uid=99,gid=100`、`forceuid,forcegid,noperm,noserverino`、
`file_mode=0664,dir_mode=0775`,并用 `x-systemd.before=docker.service` 保证启动顺序。
TrueNAS 路径继续使用 NFS 4.2。
## Sonarr4K 迁移说明