Bỏ qua để đến nội dung

Biến môi trường

Nâng cao

Mọi biến mà container HolyArrs đọc. Hầu hết bản cài chỉ cần đặt PUID, PGID và TZ.

Biến Tác dụng Mặc định Ví dụ
PUID, PGID Người dùng và nhóm mà HolyArrs chạy bằng. Phải là chủ sở hữu của /config và các thư mục media của bạn. 1000, 1000 PUID=1000
TZ Múi giờ cho lịch chạy và nhật ký. Etc/UTC TZ=Europe/Amsterdam
UMASK Các bit quyền mà tệp mới bỏ đi. Chỉ ảnh hưởng đến tệp mới. 022 UMASK=002
HOLYARRS_SAVE_PATH Thư mục lưu của trình tải xuống, theo đường dẫn mà trình tải xuống nhìn thấy. Được gửi kèm mỗi lượt tải xuống. không có /data/downloads
HOLYARRS_URL_BASE Chạy HolyArrs dưới một đường dẫn phía sau reverse proxy. / bỏ qua đường dẫn đã lưu trong Cài đặt. không có /holyarrs
HOLYARRS_ALLOWED_HOSTS Các hostname bổ sung mà mọi người dùng để vào HolyArrs, cách nhau bằng dấu phẩy. IP và localhost holyarrs.example.com
HOLYARRS_TRUSTED_PROXIES Địa chỉ hoặc mạng của reverse proxy, cách nhau bằng dấu phẩy. Cần để thấy địa chỉ thật của máy khách. không có 172.18.0.0/16
HOLYARRS_MASTER_KEY_FILE Đọc khóa chính của kho khóa từ một tệp riêng. Người dùng PUID phải đọc được tệp này. /config/holyarrs.key /keys/holyarrs.key

Thêm FILE__ phía trước bất kỳ biến nào để đọc giá trị của nó từ một tệp, chẳng hạn Docker secret.

environment:
- FILE__HOLYARRS_ALLOWED_HOSTS=/run/secrets/holyarrs_hosts

HolyArrs bỏ một ký tự xuống dòng ở cuối tệp. Nếu thiếu tệp, HolyArrs dừng lại và nhật ký nêu tên biến và tệp, không bao giờ nêu giá trị.

Khôi phục và khắc phục sự cố

Liên kết tới Khôi phục và khắc phục sự cố
Biến Tác dụng Mặc định Ví dụ
HOLYARRS_SAFE_MODE Chỉ khởi động phần lõi: đăng nhập, Thư viện, cài đặt, bản sao lưu và tình trạng. Hãy xóa biến này sau khi sửa xong. tắt 1
HOLYARRS_LOW_MEMORY 1 ép bật chế độ ít bộ nhớ, 0 ép tắt. Nếu không đặt, chế độ này tự bật khi RAM khoảng 2.5 GiB trở xuống. theo cấu hình máy 1
HOLYARRS_FOLLOW_LINKS 1 cho phép lần quét Thư viện và việc nhập dùng các tệp video và nhạc là symlink (thư viện dựng từ các liên kết trỏ vào một ổ đĩa đã mount (gắn)). Bản tải xuống được liên kết sẽ vào Thư viện dưới dạng liên kết. tắt 1
GOMEMLIMIT Ghi đè mức bộ nhớ mục tiêu mà HolyArrs tự đặt cho mình. do HolyArrs đặt 1GiB
HOLYARRS_SKIP_SPACE_CHECK Bỏ qua bước kiểm tra dung lượng trống trước khi cập nhật cơ sở dữ liệu. tắt yes
HOLYARRS_CONFIG_IN_MEMORY Cho phép đặt /config trên thư mục nằm trong bộ nhớ. Dành cho máy thử; dữ liệu mất khi khởi động lại. tắt yes
HOLYARRS_ALLOW_DESKTOP_FOLDER Khởi động với /config nằm trong thư mục chia sẻ của Docker Desktop trên máy Mac, sau khi bạn đã kiểm tra khóa tệp hoạt động ở đó. HolyArrs lưu ý ở mỗi lần khởi động. tắt 1
HOLYARRS_READONLY_DOWNLOADERS Các trình tải xuống mà HolyArrs không bao giờ được thay đổi, theo id hoặc địa chỉ, cách nhau bằng dấu phẩy. không có 3,http://qbit:8080
HOLYARRS_HEALTH_URL Địa chỉ mà bước kiểm tra tình trạng của container gọi tới. http://127.0.0.1:6262 http://127.0.0.1:6262/holyarrs

Các biến bật/tắt nhận 1, true, yes hoặc on.

Đặt các biến này trước khi khởi động. Nếu HOLYARRS_OIDC_ENABLED có mặt, dù chỉ là false, thì môi trường nắm quyền đăng nhập một lần và Cài đặt chỉ hiển thị. Các biến bật/tắt ở đây chỉ nhận true hoặc false; giá trị khác sẽ làm quá trình khởi động dừng lại.

Biến Tác dụng Mặc định
HOLYARRS_OIDC_ENABLED Bật đăng nhập một lần. false
HOLYARRS_OIDC_ISSUER Issuer HTTPS chính xác của nhà cung cấp. không có
HOLYARRS_OIDC_CLIENT_ID Id máy khách đã đăng ký. không có
HOLYARRS_OIDC_CLIENT_SECRET_FILE Tệp chứa client secret, tối đa 4096 byte. Bỏ trống nếu là máy khách công khai. không có
HOLYARRS_OIDC_REDIRECT_URL Địa chỉ callback chính xác: địa chỉ của bạn, URL base nếu có, rồi /api/v1/auth/oidc/callback. không có
HOLYARRS_OIDC_ALLOW_JOIN Người mới tham gia với vai trò thành viên chỉ có quyền yêu cầu. false
HOLYARRS_OIDC_ALLOW_LOCAL_NETWORK Cho phép nhà cung cấp nằm trong mạng riêng của bạn. false
HOLYARRS_OIDC_ALLOW_LOOPBACK_HTTP Cho phép HTTP thường trên chính máy này, để thử nghiệm. false
HOLYARRS_FORWARD_AUTH_ENABLED Bật đăng nhập qua proxy tin cậy. false
HOLYARRS_FORWARD_AUTH_ISSUER Tên HTTPS ổn định cho proxy. không có
HOLYARRS_FORWARD_AUTH_TRUSTED_PEERS Địa chỉ hoặc dải địa chỉ proxy được phép gửi header danh tính, cách nhau bằng dấu phẩy. không có
HOLYARRS_FORWARD_AUTH_ALLOW_JOIN Tên proxy mới tham gia với vai trò thành viên chỉ có quyền yêu cầu. false

Thiết lập sai sẽ làm HolyArrs không khởi động được. Các bước nằm ở Đăng nhập và mật khẩu.

Metadata
Biến Tác dụng Mặc định
HOLYARRS_METADATA_URL Địa chỉ máy chủ metadata. https://api.holyarrs.com
HOLYARRS_TMDB_KEY Token quyền đọc TMDB của riêng bạn. Khi đặt, việc đọc TMDB đi thẳng tới TMDB thay vì qua máy chủ metadata. không có
HOLYARRS_METADATA_SERVICE_TOKEN_FILE Tệp chứa thông tin xác thực của bản cài này với máy chủ metadata, đọc lại ở mỗi lần gọi. Nếu không đặt, thông tin xác thực nằm trong kho khóa. không có

Những gì vẫn đi qua máy chủ metadata khi bạn dùng khóa TMDB của riêng mình, và mọi địa chỉ bên ngoài khác, nằm trong Địa chỉ bên ngoài.

Lối tắt khi khởi động lần đầu

Mỗi biến thêm một mục khi khởi động. Dùng cho bản demo và thử nghiệm; trình hướng dẫn lần chạy đầu tiên cũng làm đúng như vậy.

Biến Thêm
HOLYARRS_MOVIES Một thư mục Thư viện phim lẻ.
HOLYARRS_QBITTORRENT_URL Một trình tải xuống qBittorrent.
HOLYARRS_SOURCE_URL Một Nguồn Torznab không cần khóa.
Biến dành cho nhà phát triển và thử nghiệm

Các biến này trỏ HolyArrs tới các bản giả lập để thử nghiệm. Hãy để trống trên bản cài thật.

Biến Tác dụng
HOLYARRS_FLAGS Các công tắc cách nhau bằng dấu phẩy cho những tính năng đang tắt theo mặc định ở phiên bản này. Xem Cập nhật.
HOLYARRS_DIRECT_SOURCES 1 cho phép bản cài này tự hỏi các nguồn nhạc và phim bộ thay vì qua máy chủ metadata.
HOLYARRS_METADATA_SERVICE_ALLOW_LOCAL Cho phép máy chủ metadata nằm trong mạng nội bộ.
HOLYARRS_METADATA_COUNT Đếm và ghi nhật ký các yêu cầu metadata.
HOLYARRS_TMDB_TOKEN_FILE, HOLYARRS_TMDB_URL Tệp token TMDB thử nghiệm và địa chỉ giả lập.
HOLYARRS_TVMAZE_URL, HOLYARRS_MUSICBRAINZ_URL, HOLYARRS_DEEZER_URL, HOLYARRS_TRAKT_URL, HOLYARRS_PLEX_URL, HOLYARRS_PLEX_APP_URL, HOLYARRS_PLEX_DISCOVER_URL, HOLYARRS_PUSHOVER_URL, HOLYARRS_TELEGRAM_URL, HOLYARRS_YOUTUBE_URL, HOLYARRS_RELEASE_FEED Địa chỉ giả lập cho các dịch vụ bên ngoài.
HOLYARRS_TRAILER_PASS_FIRST, HOLYARRS_TRAILER_PASS_EVERY Thời điểm chạy lượt quét trailer, tính bằng khoảng thời gian, chẳng hạn 2s.

HolyArrs miễn phí. Nếu nó giúp bạn tiết kiệm thời gian, hãy gắn sao trên GitHub, tài trợ dự án hoặc mời tôi một ly cà phê.