文件夹

新手入门

文件夹只需设置一次，之后下载完的文件会瞬间进入你的媒体库，不用再复制一份。

安装里的例子把 /movies、/tv、/music 和 /downloads 一个一个分别挂载。这样能用，但每次导入都是完整复制。这一页把这四个挂载换成一个共享的上级文件夹。这一步是可选的。

规则

把下载和媒体放在同一个上级文件夹、同一块磁盘下面，再把这个上级文件夹用相同的路径挂载到 HolyArrs 和你的下载器里。

硬链接是同一个文件的第二个名字。它不占额外空间，瞬间就能建好。它只在同一个文件系统内有效，而 Docker 把每个挂载都当成独立的文件系统，所以分开挂载就只能完整复制。

/srv/data                  mounted as /data in HolyArrs and the downloader
├── downloads
│   ├── torrents
│   └── usenet
└── media
    ├── movies
    ├── tv
    └── music

开始设置

在主机上创建文件夹：

mkdir -p /srv/data/downloads/{torrents,usenet} /srv/data/media/{movies,tv,music}

给你的 PUID 用户写入权限：
Terminal window
```
chown -R 1000:1000 /srv/data
```
在 HolyArrs 里挂载上级文件夹：- /srv/data:/data。
在你的下载器里用同样的方式挂载：- /srv/data:/data，并把它的保存文件夹设为 /data/downloads/torrents 或 /data/downloads/usenet。
在 HolyArrs 里，首次运行时用 /data/media/movies、/data/media/tv 和 /data/media/music 作为媒体库文件夹。

你应该不会在 Settings > Library folders 里看到 No hardlink（无法硬链接）警告。

可选项

分开挂载

把 /movies、/tv、/music 和 /downloads 作为四个挂载仍然能用。这样每次导入都会复制文件，花的时间更长，而且在下载器删掉它那一份之前要占双倍空间。

下载器在另一个容器里，路径也不同

如果下载器看到的文件夹是另一个名字，就在 Settings > Downloaders 里这个下载器上填 Downloader’s path（下载器的路径）和 HolyArrs’ path（HolyArrs 的路径），比如 /data/torrents 和 /downloads。路径一致就不需要映射。

如果不成功

你看到	原因	解决
某个媒体库文件夹显示 No hardlink	下载和媒体在不同的挂载或文件系统上	按上面的做法挂载一个上级文件夹
Read only（只读）或 Missing（缺失）	路径不对，或者 `PUID` 没有写入权限	用容器里的路径；修正属主
找不到文件夹	你填的是主机路径	填容器路径，比如 `/data/media/movies`
导入时提示路径不允许	下载文件夹不是已知的位置	设置 `HOLYARRS_SAVE_PATH`，或者在 Settings > Library folders > Extra import folders（额外导入文件夹）里加上它

进阶

文件夹检查测什么

检查	失败时显示
文件夹存在	Missing（不使用这个文件夹）
HolyArrs 能写入一个测试文件	Read only（不使用这个文件夹）
能从每个启用的下载器文件夹建硬链接	No hardlink（警告，导入时改用复制）
至少有 100 MB 可用空间	空间不足提示

测试文件在检查后会删除。Check again（重新检查）会再跑一遍。

媒体库文件夹的规则

必须存在，必须是文件夹，必须是完整路径。
不能位于另一个媒体库文件夹里面，也不能包住另一个媒体库文件夹。每个路径只能用一次。
Rename（重命名）只改显示的名称。Remove（移除）会保留所有文件，如果还有条目在用这个文件夹，就会被拒绝。
Extra import folders：每行一个完整路径，最多 32 个。像 / 或 C:\ 这样的整块磁盘会被拒绝。只有所有者，或者用密码登录的管理员，才能改这个列表。
手动导入还允许媒体库文件夹、HOLYARRS_SAVE_PATH，以及每个下载器路径映射里 HolyArrs 这一侧的路径。带 .. 的路径、网络共享路径和指向外面的链接会被拒绝。

文件夹

规则

开始设置

可选项

分开挂载

下载器在另一个容器里，路径也不同

如果不成功

进阶

相关页面