Các phần và chế độ an toàn

Tắt các phần bạn không dùng, khởi động ở chế độ an toàn khi có gì hỏng, và khởi động lại HolyArrs từ trình duyệt.

Bật hoặc tắt một phần

HolyArrs có 5 phần: Movies (phim lẻ), TV shows (phim bộ), Music (nhạc), Subtitles (phụ đề) và Requests (yêu cầu). Bạn chọn chúng lần đầu trong trình hướng dẫn lần chạy đầu tiên.

1. Mở Settings > Parts (Cài đặt > Phần).
2. Nhấn Turn on (bật) hoặc Turn off (tắt) bên cạnh một phần. Bạn sẽ thấy các mục menu của nó hiện ra hoặc biến mất.

Không có gì bị xóa. Bật lại một phần và nó tiếp tục từ chỗ đã dừng.

Khởi động ở chế độ an toàn

Chế độ an toàn chỉ khởi động những phần cơ bản, dùng khi có gì đó khiến HolyArrs không khởi động hoặc không hoạt động được. Bạn có thể đăng nhập, xem thư viện, đổi cài đặt và tạo hoặc khôi phục bản sao lưu. Tìm kiếm, thêm, làm mới, tải xuống và nhập sẽ chờ đến lần khởi động bình thường tiếp theo.

1. Mở Settings > Danger zone (Cài đặt > Vùng nguy hiểm).
2. Nhấn Restart in safe mode (khởi động lại ở chế độ an toàn). Bạn sẽ thấy một biểu ngữ trên mọi trang.
3. Sửa vấn đề, rồi nhấn Restart HolyArrs (khởi động lại HolyArrs). Lần khởi động sau là bình thường.

Nếu không vào được trang đó, đặt HOLYARRS_SAFE_MODE=1 trong Compose hoặc khởi động với -safe-mode. Hãy gỡ nó sau khi sửa xong: cả hai đều giữ mọi lần khởi động ở chế độ an toàn.

Lựa chọn

Điều gì dừng khi một phần bị tắt

Phần	Dừng	Vẫn tiếp tục
Phim lẻ	Các trang phim lẻ và mục menu, thêm, tìm kiếm, làm mới	Các lượt tải xuống đã có trong trình tải xuống vẫn được theo dõi. Các tệp vẫn còn.
Phim bộ	Các trang phim bộ, thêm, tìm kiếm, tìm theo mùa, làm mới	Giống Phim lẻ.
Nhạc	Các trang nghệ sĩ và album, cài đặt nhạc, làm mới nghệ sĩ, tìm album	Giống Phim lẻ.
Phụ đề	Cài đặt phụ đề, trang phụ đề còn thiếu, tìm kiếm và kiểm tra	Các tệp phụ đề cạnh video của bạn vẫn còn.
Yêu cầu	Các trang yêu cầu và việc yêu cầu các mục	Các yêu cầu hiện có vẫn còn và trở lại khi bật lại.

Luôn bật: đăng nhập và tài khoản, thư mục Thư viện, nguồn, trình tải xuống và các lượt tải xuống, cảnh báo, lịch sử, sao lưu, kiểm tra tình trạng, cài đặt và API.

• Phụ đề cần Phim lẻ hoặc Phim bộ. Yêu cầu cần Phim lẻ, Phim bộ hoặc Nhạc. HolyArrs từ chối thay đổi làm hỏng điều này và nói cần đổi gì trước.
• Một tác vụ trong hàng đợi của phần đang tắt sẽ chờ và chạy khi phần đó được bật.
• Tắt một phần không tiết kiệm bộ nhớ. Mọi thứ chạy trong một chương trình.

Khởi động lại, tạm dừng và tắt

Settings > Danger zone (chủ sở hữu và quản trị viên) có Restart HolyArrs, Restart in safe mode và Shut down (tắt hẳn), cùng với Pause (tạm dừng), Resume (tiếp tục) và Restart (khởi động lại) cho từng tác vụ nền, như sao lưu hoặc đồng bộ lượt tải xuống.

• Các nút điều khiển làm dừng thứ gì đó sẽ yêu cầu bạn xác nhận trong vòng 60 giây.
• Mỗi nút điều khiển đã dùng được ghi vào Lịch sử kèm tên của bạn.
• Bạn cần đăng nhập bằng mật khẩu. Đăng nhập không mật khẩu trên mạng nội bộ bị từ chối.

Khởi động lại dừng HolyArrs gọn gàng và để Docker khởi động nó lại, nên hãy đặt restart: unless-stopped.

Chính sách khởi động lại	Khởi động lại	Tắt
unless-stopped hoặc always	Tự bật lại	Cũng tự bật lại
on-failure	Tự bật lại	Vẫn tắt
no	Vẫn tắt	Vẫn tắt

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

Triệu chứng	Nguyên nhân	Cách khắc phục
HolyArrs không tắt được một phần	Một phần khác cần nó	Tắt phần kia trước, như thông báo nói.
Khởi động lại làm HolyArrs tắt hẳn	Chính sách khởi động lại là no	Khởi động container và đặt restart: unless-stopped.
Các nút điều khiển bị từ chối	Đăng nhập nội bộ không mật khẩu, hoặc khóa thiếu control	Đăng nhập bằng mật khẩu của bạn.
Một tác vụ cứ ở trạng thái lỗi	Nó cần bạn	Đọc lý do của nó trên /health, sửa, rồi nhấn Restart cho tác vụ đó.

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

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

Các trạng thái tình trạng

/health, Settings > Parts và GET /api/v1/health/states liệt kê từng tác vụ nền, phần và ứng dụng đã liên kết kèm một trạng thái và một lý do.

Trạng thái	Ý nghĩa
off	Đã tắt, tạm dừng, hoặc không được khởi động trong chế độ an toàn.
starting	Đang khởi động, hoặc chưa được kiểm tra.
running	Hoạt động.
retrying	Đã lỗi; HolyArrs thử lại, mỗi lần chờ lâu hơn.
failed	Bị sập, kẹt hoặc cần bạn. Lý do cho biết phải làm gì.

Một tác vụ bị sập hiện failed, rồi retrying, rồi khởi động lại. Đăng nhập, thư viện và sao lưu vẫn hoạt động trong lúc đó. Một tác vụ bị kẹt sẽ được giải phóng khi khởi động lại hoàn toàn.

Bộ nhớ và chế độ ít bộ nhớ

HolyArrs đặt mục tiêu giữ dưới 384 MiB, vừa với giới hạn container 500 MB. Để đặt mục tiêu riêng, đặt GOMEMLIMIT bằng khoảng 80 phần trăm bộ nhớ của container.

Chế độ ít bộ nhớ giữ ít thứ hơn trong bộ nhớ và đọc nhiều hơn từ cơ sở dữ liệu. Một số trang mất thêm chút thời gian, và công việc nền như sao chép danh mục nhạc chạy ít thường xuyên hơn.

Tùy chọn	Tác dụng
(mặc định, Linux)	Tự bật khi bộ nhớ khoảng 2.5 GiB hoặc ít hơn.
HOLYARRS_LOW_MEMORY=1	Luôn bật.
HOLYARRS_LOW_MEMORY=0	Luôn tắt.

Dòng nhật ký đầu tiên cho biết nó có bật không và vì sao.

Phạm vi của khóa API

Tạo khóa trong Settings > API > API keys và gửi nó trong header X-Api-Key.

Phạm vi	Truy cập được
read	Thư viện, tác vụ, lượt tải xuống, lịch sử, tình trạng, cài đặt. Bí mật được che.
health_read	Chỉ các trạng thái tình trạng. Dành cho công cụ giám sát.
write	Mọi thay đổi trừ các route quản trị và các nút điều khiển.
admin	Người dùng, lời mời, giới hạn yêu cầu, khóa API, mật khẩu và xác thực hai yếu tố, cài đặt đăng nhập, sao lưu.
control	Các nút điều khiển trên trang này. Chỉ chủ sở hữu và quản trị viên mới cấp được.
all	read, write và admin. Không gồm control.

Một khóa không bao giờ làm được nhiều hơn người đã tạo ra nó. Không đổi được phạm vi sau này; hãy tạo khóa mới. Mọi route và phạm vi của nó: /api/v1/openapi.json.

Liên quan

• Kiểm tra tình trạng
• Sao lưu
• Các route API