NAS, Synology và Unraid

Chạy HolyArrs trên NAS của bạn với đúng thư mục, chủ sở hữu và tùy chọn khởi động lại. Đọc Cài đặt trước.

Trước khi bắt đầu

• /config đặt trên một volume hoặc pool cục bộ. Không bao giờ đặt trên thư mục chia sẻ mạng.
• Media đặt trong một thư mục chia sẻ chung, bên trong có downloads, movies, tv và music. Mount từng thư mục, hoặc mount thư mục cha một lần để có hardlink (liên kết cứng). Xem Thư mục.

Thiết lập NAS của bạn

::tab[Synology]

1. Trong File Station, tạo docker/holyarrs/config.
2. Tạo một thư mục chia sẻ media với downloads, movies, tv và music bên trong.
3. Trong Container Manager, mở Project > Create và dán tệp Compose từ Cài đặt.
4. Đặt các volume thành /volume1/docker/holyarrs/config:/config, rồi /volume1/media/movies:/movies, /volume1/media/tv:/tv, /volume1/media/music:/music và /volume1/media/downloads:/downloads.
5. Đặt PUID và PGID theo người dùng của bạn, thường là 1026 và 100. Kiểm tra bằng id <user> qua SSH.
6. Cấp cho người dùng đó quyền đọc và ghi trên media: Control Panel > Shared Folder > Edit > Permissions.
7. Đánh dấu Enable auto-restart.
8. Mở http://your-server:6262. Bạn sẽ thấy trình hướng dẫn lần chạy đầu tiên. Thêm /movies, /tv và /music làm các thư mục Thư viện.

::tab[Unraid]

Hiện chưa có mẫu Community Applications, nên hãy thêm container bằng tay.

1. Trong tab Docker, thêm một container với image HolyArrs.
2. Ánh xạ cổng 6262.
3. Ánh xạ /config tới một đường dẫn pool, như /mnt/<pool>/appdata/holyarrs. <pool> là tên pool của bạn. Không dùng /mnt/user/appdata.
4. Ánh xạ các thư mục media của bạn tới /movies, /tv, /music và /downloads, dùng đường dẫn ổ đĩa hoặc pool, ví dụ /mnt/<pool>/media/movies:/movies, /mnt/<pool>/media/tv:/tv, /mnt/<pool>/media/music:/music và /mnt/<pool>/media/downloads:/downloads.
5. Đặt PUID=99, PGID=100 (nobody:users của Unraid) và UMASK=022.
6. Bật tự khởi động cho container, để nó tự khởi động lại.
7. Mở http://your-server:6262. Bạn sẽ thấy trình hướng dẫn lần chạy đầu tiên.

::tab[QNAP]

1. Tạo Container/holyarrs/config và một thư mục chia sẻ media với downloads, movies, tv và music bên trong.
2. Trong Container Station, mở Applications > Create và dán tệp Compose.
3. Dùng /share/Container/holyarrs/config:/config, rồi /share/media/movies:/movies, /share/media/tv:/tv, /share/media/music:/music và /share/media/downloads:/downloads.
4. Đặt PUID và PGID theo chủ sở hữu của thư mục chia sẻ media.
5. Đặt chính sách khởi động lại là unless-stopped.
6. Mở http://your-server:6262. Bạn sẽ thấy trình hướng dẫn lần chạy đầu tiên.

::tab[TrueNAS SCALE]

1. Tạo 2 dataset: apps/holyarrs-config và media, với các thư mục downloads, movies, tv và music bên trong media.
2. Trong Apps, thêm một ứng dụng tùy chỉnh từ YAML bằng tệp Compose.
3. Dùng /mnt/<pool>/apps/holyarrs-config:/config, rồi /mnt/<pool>/media/movies:/movies, /mnt/<pool>/media/tv:/tv, /mnt/<pool>/media/music:/music và /mnt/<pool>/media/downloads:/downloads.
4. Đặt PUID và PGID theo chủ sở hữu của dataset, thường là 568. Cấp cho người dùng đó quyền ghi trong ACL của dataset.
5. Đặt chính sách khởi động lại là unless-stopped.
6. Mở http://your-server:6262. Bạn sẽ thấy trình hướng dẫn lần chạy đầu tiên.

Mọi NAS: cấp cho người dùng PUID quyền đọc và ghi trên thư mục media trong màn hình quyền của NAS; HolyArrs tự lo thư mục cấu hình. Bật tự khởi động lại cho container (chính sách unless-stopped của Docker).

Để có hardlink, vốn không tốn thêm dung lượng và hoàn tất ngay, hãy mount một thư mục media duy nhất thay cho bốn thư mục, và cho trình tải xuống của bạn cùng mount đó ở cùng đường dẫn. Xem Thư mục media.

Lựa chọn

Các mount riêng

Mount /movies, /tv, /music và /downloads từng cái một vẫn chạy, nhưng mọi lần nhập đều thành một bản sao đầy đủ. Mỗi mount là một hệ thống tệp riêng bên trong container, và hardlink không đi qua được giữa các hệ thống tệp. Các thư mục chia sẻ hoặc dataset riêng dưới cùng một thư mục cha cũng bị sao chép. Settings > Library folders (Cài đặt > Thư mục Thư viện) lưu ý khi HolyArrs phải sao chép.

Cho ổ đĩa được nghỉ

Các tác vụ này đánh thức ổ đĩa media. Đổi tần suất chạy của chúng trên trang Schedules (Lịch chạy).

Tác vụ	Đọc gì
Rescan the Library (quét lại Thư viện)	Mọi thư mục Thư viện. Đánh thức ổ đĩa nhiều nhất.
Check Library folders (kiểm tra thư mục Thư viện)	Thông tin và dung lượng trống của từng thư mục. Bài kiểm tra ghi và hardlink chỉ chạy lúc khởi động, khi nhấn Run now (chạy ngay) và khi các thư mục thay đổi.
Look for missing subtitles (tìm phụ đề còn thiếu), Look for better subtitles (tìm phụ đề tốt hơn)	Thư mục cạnh từng video.

• Đặt /config và thư mục tải xuống trên SSD hoặc cache pool.
• Giữ trống 1 GB trên ổ đĩa chứa /config. Dưới mức đó bạn nhận một lưu ý tình trạng.
• Trên Unraid, plugin Cache Directories giữ danh sách thư mục trong bộ nhớ, nên việc quét không động đến ổ đĩa.
• Nhập, thêm và xóa chỉ đụng đến ổ đĩa mà chúng ghi vào, và chỉ lúc chúng diễn ra.
• Đặt quét lại mỗi 7 ngày hoặc tắt. Khi đó các tệp bạn thêm bằng tay chỉ được tìm thấy khi bạn nhấn Run now ở Rescan the Library.
• Một torrent đang seed đọc tệp của nó. Nếu nó được hardlink vào Thư viện của bạn, ổ đĩa đó cứ thức cho đến khi hết seed.

Nếu không hoạt động

Triệu chứng	Nguyên nhân	Cách khắc phục
Không khởi động, nêu một đường dẫn FUSE, thư mục chia sẻ mạng hoặc user share của Unraid	/config không nằm trên ổ đĩa cục bộ (trên Unraid, nó trỏ tới /mnt/user)	Chuyển /config sang ổ đĩa cục bộ hoặc đường dẫn pool, như /mnt/<pool>/appdata/holyarrs.
Vẫn dừng sau khi khởi động lại hoặc khôi phục	Tự khởi động lại đang tắt	Bật nó lên và khởi động container.
Nhập bị lỗi quyền	Người dùng PUID không ghi được vào media	Cấp quyền đọc và ghi trong màn hình quyền của NAS (trên Synology: Control Panel > Shared Folder > Edit > Permissions).
Các lần nhập là bản sao, không phải hardlink	Tải xuống và Thư viện nằm trên các mount hoặc ổ đĩa khác nhau	Mount một thư mục chia sẻ một lần, trong HolyArrs và trình tải xuống.

Thêm cách khắc phục: Khắc phục sự cố.

Dành cho người dùng nâng cao

Vì sao HolyArrs từ chối một số đường dẫn cấu hình

HolyArrs giữ các cơ sở dữ liệu của nó trong /config. Thư mục chia sẻ mạng và đường dẫn FUSE có thể làm hỏng chúng, nên HolyArrs từ chối khởi động trên đó và nói rõ lý do.

Trên Unraid, /mnt/user là một đường dẫn FUSE. Dùng đường dẫn pool, hoặc đặt appdata thành Exclusive: bật Permit exclusive shares trong Settings > Global Share Settings, rồi đặt Shares > appdata là primary storage trên một pool và secondary storage là none.

Một đường dẫn /config trên pool không tồn tại sẽ nằm trong bộ nhớ và mất khi khởi động lại máy. HolyArrs cũng từ chối điều đó. Tránh /mnt/user cho media nữa; hardlink đi qua nó có thể lỗi.

Vì sao tự khởi động lại quan trọng

Khởi động lại trong ứng dụng, chế độ an toàn và khôi phục bản sao lưu đều dừng HolyArrs và trông chờ Docker khởi động nó lại. Không có tự khởi động lại, nó vẫn dừng. Xem Các phần và chế độ an toàn.

Cổng và cập nhật

• Ánh xạ cổng 6262 chỉ cho mạng ở nhà của bạn. Đọc Bảo mật cơ bản trước khi mở nó cho bất kỳ ai bên ngoài.
• Để cập nhật, kéo image mới và tạo lại container. Dữ liệu của bạn vẫn ở /config. Xem Cập nhật.

Liên quan

• Thư mục
• Thư mục Thư viện
• Lịch chạy