Clarify metadata.db must be on local filesystem, not FUSE mount

SQLite WAL depends on POSIX file locks and shared memory (-shm),
which FUSE/network filesystems cannot support correctly.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
This commit is contained in:
grabbit 2026-02-16 21:38:08 +08:00
parent aaf947859f
commit 7fd1934be5

View File

@ -779,7 +779,9 @@ flowchart TD
metadata.db 会被多个进程/线程并发访问Write-back Controller、轮询线程、SD 卡导入进程、CLI 管理工具。 metadata.db 会被多个进程/线程并发访问Write-back Controller、轮询线程、SD 卡导入进程、CLI 管理工具。
**要求**metadata.db 必须以 **WALWrite-Ahead Logging模式**运行: **要求**metadata.db 必须存放在**本地文件系统**SSD 的 ext4/btrfs/ZFS**严禁放在 rclone FUSE 挂载目录中**。SQLite WAL 依赖 POSIX 文件锁和共享内存(`-shm` 文件FUSE/网络文件系统无法正确支持这些语义,会导致数据库损坏。
metadata.db 必须以 **WALWrite-Ahead Logging模式**运行:
```sql ```sql
PRAGMA journal_mode=WAL; PRAGMA journal_mode=WAL;