Kemas kini

HolyArrs memberitahu anda apabila versi baharu keluar dan tidak pernah memasangnya sendiri. Anda tarik imej baharu apabila sesuai bagi anda.

Lihat jika versi baharu sudah keluar

1. Buka halaman Status (http://your-server:6262/health).
2. Baca Updates (kemas kini). Anda akan nampak salah satu daripada ini:

Mesej	Maksud
“HolyArrs 1.2.0 is out, newer than this one.”	Kemas kini apabila sedia
“This is the newest version.”	Tiada apa-apa untuk dilakukan
“No HolyArrs release is published yet.”	Feed kosong. Tiada yang salah
“The last check did not work: …”	Feed tidak dapat dicapai, selalunya tiada internet
“The update check is off: …”	Dimatikan dalam Tetapan

3. Untuk bertanya sekarang, pilih Check now (semak sekarang) atau Check again (semak semula). Ia memerlukan kebenaran Change settings (ubah tetapan).

Versi yang lebih baharu juga muncul sebagai peringatan kesihatan. Semakan yang gagal hanya muncul di bawah Updates.

Kemas kini

1. Tarik imej baharu dan mula semula: docker compose pull, kemudian docker compose up -d.
2. HolyArrs bermula. Jika versi baharu mengubah cara data disimpan, ia membuat sandaran dahulu, kemudian mengemas kini data. Anda akan nampak app dibuka pada versi baharu.

Tip

Langkah kemas kini yang gagal dibatalkan dan HolyArrs berhenti pada halaman yang menyatakan apa yang berlaku. Data anda sebelum kemas kini kekal sebagai sandaran.

Kembali ke versi lama

HolyArrs tidak dapat menukar imejnya sendiri, jadi anda jalankan imej yang lebih lama dan HolyArrs meletakkan semula data yang lebih lama.

Caution

Apa-apa yang berubah selepas kemas kini, seperti judul baharu, tetapan dan sejarah, tiada dalam sandaran sebelum kemas kini.

1. Tukar teg imej dalam fail compose anda (atau docker run) kepada yang lebih lama, contohnya holyarrs/holyarrs:<older version>.
2. Jalankan docker compose up -d.
3. Jika kemas kini tidak mengubah data, versi lama bermula. Selesai.
4. Jika tidak, versi lama menunjukkan satu halaman dan bukannya app. Pilih Put back the data from before the update (letakkan semula data sebelum kemas kini).
5. Taip kod sekali guna. Cari dengan docker logs <container>; cari “one-time code”.
6. HolyArrs menyemak sandaran, meletakkannya pada tempatnya dan berhenti. Anda akan nampak kontena bermula semula pada data itu melalui polisi mula semula. Tanpanya, mulakan sendiri.

Tanpa halaman itu: docker exec <container> /holyarrs restore --pre-update, kemudian docker restart <container>. Tanpa Docker: hentikan HolyArrs, jalankan holyarrs restore --pre-update, mulakan semula.

Tiada apa yang dipadam. Data yang lebih baharu dialihkan ke backups/before-restore-<time>/, jadi anda boleh membatalkannya. Kembali lebih daripada satu versi memilih sandaran sebelum kemas kini yang terbaharu yang boleh dibaca oleh versi itu.

Pilihan

Semuanya di Settings > Health checks (Tetapan > Semakan kesihatan). Tiga yang terakhir terletak di bawah bahagian lanjutan kad itu.

Tetapan	Lalai	Ubah apabila
Check for a newer HolyArrs	On	Anda mahu tiada permintaan keluar langsung
Check for updates every	hari	Anda mahu semakan lebih jarang: 3, 7, 14 atau 30 hari
Release feed	Kosong (keluaran HolyArrs)	Anda mengehos feed sendiri
Feed may be on the local network	Off	Feed anda berada dalam rangkaian anda sendiri
Include test versions (like 1.2.0-rc1)	Off	Anda mahu notis untuk versi ujian

Jika tidak berfungsi

Gejala: “The last check did not work.” Punca: pelayan tiada internet, atau feed anda sendiri berada dalam rangkaian setempat. Penyelesaian: semak akses internet, atau hidupkan Feed may be on the local network.

Gejala: release feed tidak dapat disimpan. Punca: alamat mengandungi nama, kata laluan, ?query atau #fragment, atau tidak bermula dengan http:// atau https://. Penyelesaian: buang bahagian itu.

Gejala: kemas kini berhenti kerana kekurangan ruang cakera. Punca: tiada ruang untuk salinan dan kemas kini. Penyelesaian: kosongkan ruang di tempat folder konfigurasi berada, kemudian mulakan semula.

Gejala: halaman kembali ke versi lama menolak kod anda. Punca: kod lama, atau 10 kod salah sejak permulaan terakhir. Penyelesaian: salin kod daripada baris log yang terbaharu. Selepas 10 percubaan salah, mulakan semula kontena dan guna kod baharu.

Ciri ditahan

Sesetengah ciri dimatikan secara lalai dalam keluaran ini. Hidupkan atas risiko anda sendiri. Selagi ditahan, halaman dan item menunya disembunyikan, route API ciri itu menjawab “not found” dan tugasnya tidak berjalan. Data yang anda simpan untuk ciri itu kekal.

Untuk menghidupkan satu, tambah suisnya ke HOLYARRS_FLAGS, dipisahkan dengan koma, dan mulakan semula kontena:

environment:
  HOLYARRS_FLAGS: "subtitle_sites,alert_channels_more"

Buang namanya dan mulakan semula untuk mematikannya. Tetapan yang tersembunyi kembali apabila anda menghidupkannya semula.

Suis	Ciri
row_title_stats	Statistik judul baris Explore dalam Appearance
trakt_lists	Kunci Trakt, senarai Trakt dan ulasan Trakt. Senarai TMDB kekal hidup
alert_channels_more	Amaran Telegram, ntfy, Gotify, Pushover dan webhook. Discord dan email kekal hidup
subtitle_sites	Laman sari kata dan carian sari kata. Bahasa sari kata anda kekal hidup
emby_signin	Log masuk dengan Emby. Muat semula Pustaka Emby masih berfungsi
go_back	Panel Go back pada halaman Status. Langkah dalam Kembali berfungsi tanpanya

Tiada apa yang berubah selepas menambah suis? Semak ejaan (huruf kecil, garis bawah) dan mulakan semula kontena, bukan halaman sahaja.

Untuk pakar

Apa yang dihantar oleh semakan

Satu permintaan ke api.github.com untuk keluaran terbaharu, dengan hanya User-Agent: HolyArrs/<version>. Tiada akaun, kunci atau senarai media. Dengan semakan dimatikan, tiada permintaan langsung.

Jawapan terakhir disimpan, jadi mula semula tidak menyemak sebelum tiba masanya. Satu semakan menunggu paling lama 15 s, membaca paling banyak 512 KB dan mengikut paling banyak 3 ubah hala, tidak pernah bertukar antara http dan https. Pautan nota keluaran hanya muncul apabila ia menuju ke halaman keluaran HolyArrs di GitHub; jika tidak, versi itu dipaparkan sebagai teks biasa.

Release feed menerima jawapan keluaran gaya GitHub, senarai keluaran, mana-mana JSON dengan version, atau teks biasa yang mengandungi versi. Alamat metadata awan sentiasa ditolak. Versi ujian dikira lebih lama daripada versi biasa.

Sandaran sebelum kemas kini

Sebelum mengubah data yang disimpan, HolyArrs:

1. Menyemak ada ruang untuk salinan dan kemas kini. Jika tiada, tiada apa yang berubah. Langkau dengan HOLYARRS_SKIP_SPACE_CHECK=yes.
2. Menyalin setiap pangkalan data ke backups, menyemak salinan itu dan menulis fail sha256 di sebelahnya. Selepas 3 salinan gagal, tiada apa yang berubah.
3. Menjalankan setiap langkah kemas kini secara berasingan dan menyemaknya. Langkah yang gagal dibatalkan; langkah yang siap kekal. Mulakan versi yang sama semula untuk menyambung daripada langkah yang gagal dengan salinan yang sama.

Selepas permulaan baik yang pertama, salinan itu menjadi holyarrs-backup-pre-update-<time>.zip, diterangkan seperti “before updating from 1.1.0 to 1.2.0”. Ia muncul dalam Settings > Backups dan holyarrs restore --list. 3 yang terbaharu disimpan; jadual sandaran tidak pernah membuangnya. Pemasangan baharu atau kemas kini yang tidak mengubah data tidak membuat salinan.

Sahkan imej

Mulai 1.0.3, setiap imej di Docker Hub ditandatangani oleh larian keluaran di GitHub. Tiada kunci untuk dimuat turun. Semak imej dengan cosign. Letakkan versi yang anda jalankan, seperti 1.0.3, di tempat tertulis <version>:

cosign verify holyarrs/holyarrs:<version> \
  --certificate-oidc-issuer https://token.actions.githubusercontent.com \
  --certificate-identity-regexp '^https://github.com/HolyArrs/HolyArrs/\.github/workflows/sign\.yml@refs/(tags/[0-9.]+|heads/main)$'

Anda akan nampak The cosign claims were validated. Apa-apa yang lain bermakna imej itu tidak datang daripada larian keluaran HolyArrs: jangan jalankannya.

Imej itu turut membawa rekod cara ia dibina dan senarai isinya (SBOM). Semak dengan GitHub CLI:

gh attestation verify oci://docker.io/holyarrs/holyarrs:<version> --repo HolyArrs/HolyArrs

Fail yang sama ada pada setiap keluaran GitHub: .sigstore.json (tandatangan), .intoto.jsonl (rekod binaan) dan .sbom.spdx.json (kandungan).

Berkaitan

• Sandaran
• Semakan kesihatan
• Bahagian dan mod selamat