資料夾

新手入門

資料夾只要設定一次，下載完成的檔案就會立即出現在你的媒體庫，不會多出第二份檔案。

安裝的範例把 /movies、/tv、/music 和 /downloads 一個一個掛載。這樣可以運作，但每次匯入都是完整複製。這一頁會把那四個掛載換成一個共用的上層資料夾。這是選用的。

規則

把下載和媒體放在同一個上層資料夾底下，且在同一顆磁碟上，然後把這個上層資料夾以相同的路徑掛載到 HolyArrs 和你的下載器。

hardlink（硬連結）是同一個檔案的第二個名稱。它不佔額外空間，建立也是立即完成。它只能在同一個檔案系統內運作，而 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（沒有 hardlink）警告。

選項

分開掛載

/movies、/tv、/music 和 /downloads 這四個分開的掛載仍然可以用。但每次匯入都會複製檔案，花的時間較長，而且在下載器刪除它那一份之前，會用掉兩倍的空間。Usenet 下載也是如此，就算在同一個磁碟上也一樣：檔案只有在同一個掛載之內才能瞬間移動，所以請使用上面的共用上層資料夾。

下載器在另一個 container，路徑也不同

如果下載器看到的資料夾名稱不同，請到 Settings > Downloaders，在該下載器上填入 Downloader’s path 和 HolyArrs’ path，例如 /data/torrents 和 /downloads。路徑相同時不需要對應。

如果沒有成功

你看到	原因	解決方式
媒體庫資料夾上出現 No hardlink	下載和媒體在不同的掛載或檔案系統上	如上所述，掛載同一個上層資料夾
Read only（唯讀）或 Missing（缺少）	路徑錯誤，或 `PUID` 無法寫入	使用 container 內的路徑；修正擁有者
找不到資料夾	你輸入的是主機上的路徑	輸入 container 內的路徑，例如 `/data/media/movies`
匯入顯示不允許這個路徑	下載資料夾不是已知的位置	設定 `HOLYARRS_SAVE_PATH`，或把它加到 Settings > Library folders > Extra import folders

給進階使用者

資料夾檢查會測試什麼

檢查	失敗時顯示
資料夾存在	Missing（不會使用這個資料夾）
HolyArrs 能寫入測試檔案	Read only（不會使用這個資料夾）
從每個使用中的下載器資料夾建立 hardlink	No hardlink（警告，匯入會改為複製）
至少 100 MB 可用空間	空間不足的附註

測試檔案在檢查後會移除。Check again（再檢查一次）會重新執行檢查。

媒體庫資料夾規則

必須存在、是資料夾，而且是完整路徑。
不能位於另一個媒體庫資料夾之內或之外。每個路徑只能使用一次。
Rename（重新命名）只會變更顯示的名稱。Remove（移除）不會動任何檔案，而且只要還有作品在使用該資料夾，就會被拒絕。
Extra import folders：每行一個完整路徑，最多 32 個。像 / 或 C:\ 這樣的整顆磁碟會被拒絕。只有擁有者，或以密碼登入的管理員，可以變更這份清單。
手動匯入也允許媒體庫資料夾、HOLYARRS_SAVE_PATH，以及每個下載器路徑對應中屬於 HolyArrs 那一側的路徑。含有 .. 的路徑、網路共用資料夾路徑，以及指向外部的連結都會被拒絕。

資料夾

規則

設定

選項

分開掛載

下載器在另一個 container，路徑也不同

如果沒有成功

給進階使用者

相關頁面