Anahtarları dosyadan içe aktar

Kaynaklarını, indiricilerini, medya sunucularını, altyazı sitelerini ve e-postanı tek bir dosyaya doldur, içe aktar ve her anahtarı Ayarlar’da tek tek yazmaktan kurtul.

Başlamadan önce

• HolyArrs Docker’da çalışıyor ve yapılandırması /config içinde.
• Settings > API > API keys (Ayarlar > API > API anahtarları) içinde bir sahip API anahtarı oluşturabilirsin.

Dosyayı içe aktar

1. holyarrs-secrets.template.yaml dosyasını holyarrs-secrets.yaml olarak kopyala.

2. Kullandıklarını doldur. Gerisini boş bırak; boş, atla demektir.

3. Yalnızca senin okuyabileceğin hale getir:

   chmod 600 holyarrs-secrets.yaml

4. Konteynere salt okunur olarak bağla:

   volumes:
     - /srv/holyarrs/config:/config
     - /srv/holyarrs/holyarrs-secrets.yaml:/run/secrets/holyarrs.yaml:ro

5. Settings > API > API keys içinde admin kapsamlı bir sahip API anahtarı oluştur. Dosyanın holyarrs bloğuna, http://127.0.0.1:6262 adresiyle birlikte koy.

6. Önce bir deneme çalıştırması yap. Hiçbir şeyi değiştirmez:

   docker exec holyarrs /holyarrs import-secrets -file /run/secrets/holyarrs.yaml -dry-run

   Öğe başına bir would set satırı görmelisin.

7. Gerçekten çalıştır (aynı komut, -dry-run olmadan). set satırları ve 0 çıkış kodunu görmelisin.

8. Yeni Kaynakları ve indiricileri denetle, sonra devam ettir. Yeni medya sunucularını ve uyarıları dene, sonra aç.

9. Dosyayı host’ta sil (bkz. Dosyayı sil). Artık gerekmiyorsa API anahtarını da sil.

Dikkat

Dosya, sen silene kadar her anahtarı ve parolayı düz metin olarak tutar. Çalıştırma başarılı olur olmaz host’ta sil.

Her blok neye dönüşür

Dosyada	Dönüşür
trakt.client_id	Trakt uygulama anahtarı (Settings > Outside lists, yani Ayarlar > Dış listeler).
tmdb, tvdb	Eski dosyalardan kabul edilir. Metadata için anahtar gerekmez.
opensubtitles, subdl	Hesabınla bir altyazı sitesi.
addic7ed	Bir Addic7ed altyazı sitesi, yalnızca diziler.
indexers	Her girdi için bir Kaynak, paused (duraklatılmış).
jackett, prowlarr	Anahtarları, aynı adreste anahtarı olmayan her indexers girdisini doldurur.
qbittorrent, sabnzbd	Bir indirici, paused.
nzbget, transmission, deluge	Atlanır. İçe aktarma bunları henüz kuramaz; Settings > Downloaders (Ayarlar > İndiriciler) içinde ekle.
jellyfin, emby, plex	Bir medya sunucusu, sen deneyene kadar off (kapalı).
smtp, discord, webhook	Uyarılardaki “Email”, “Discord” ve “Webhook”, sen deneyene kadar off.
radarr, sonarr, lidarr, prowlarr, bazarr, seerr	Move from other apps (diğer uygulamalardan geç) için kaydedilen bir anahtar.
holyarrs	Yalnızca HolyArrs çalışırken ona ulaşmak için kullanılır. Hiç kaydedilmez.

Her anahtar, Ayarlar’da yazılan gibi şifreli kasaya gider.

Seçenekler

Yerel ağ anahtarı

Adresi olan her blok allow_local_network: true alabilir. Bu, o öğenin bu bilgisayara veya ev ağına (192.168.x.x, 10.x.x.x, bir konteyner adı) ulaşmasına izin verir. Bu olmadan öğe yalnızca internete ulaşır, bu yüzden evdeki bir indirici yanıt vermez. HolyArrs bunu adresten asla tahmin etmez. Ayarlar’daki May reach the local network (yerel ağa erişebilir) ile aynı anahtardır.

HolyArrs durdurulmuşken

Aynı yapılandırma üzerinde tek seferlik bir konteyner çalıştır. Doğrudan yapılandırma klasörüne kaydeder ve holyarrs bloğu gerekmez:

docker stop holyarrs
docker run --rm -e PUID=1000 -e PGID=1000 \
  -v /srv/holyarrs/config:/config \
  -v /srv/holyarrs/holyarrs-secrets.yaml:/run/secrets/holyarrs.yaml:ro \
  holyarrs/holyarrs:latest import-secrets -file /run/secrets/holyarrs.yaml
docker start holyarrs

Uygulamayla aynı PUID ve PGID değerlerini kullan, yoksa yapılandırma klasörü 1000:1000’e devredilir. PUID kullanıcısı dosyayı okuyabilmeli. HOLYARRS_MASTER_KEY_FILE kullanıyorsan tek seferlik konteynere aynı değişkeni ve bağlamayı ver.

Yeniden çalıştırma

Yeniden çalıştırmak güvenli. Eşleşen öğeler unchanged der; yalnızca değişenler kaydedilir.

Öğe	Neye göre eşleşir
Kaynaklar	ad
İndiriciler, medya sunucuları	tür ve adres
Uyarılar	ad ve tür
Altyazı siteleri, eski uygulamalar	tür

Adresi veya anahtarı değişen bir Kaynak ya da indirici yeniden duraklatılır. Birini kendin devam ettirdikten sonra, yeniden çalıştırma onu çalışır halde bırakır. Bir indexers girdisinde boş api_key, kayıtlı anahtarı korur; kaldırmak için clear_key: true ekle.

Dosyayı sil

-delete ile komut, yalnızca hiçbir şeyin başarısız olmadığı bir çalıştırmadan sonra dosyanın üzerine sıfır yazar ve dosyayı kaldırır. Salt okunur bağlama konteynerin içinden silinemez, bu yüzden host’ta sil:

Sistem	Komut
Linux	shred -u holyarrs-secrets.yaml
macOS	rm -P holyarrs-secrets.yaml
Windows	Remove-Item holyarrs-secrets.yaml, sonra Geri Dönüşüm Kutusu’nu boşalt.

SSD’lerde ve yazarken kopyalayan (copy-on-write) dosya sistemlerinde eski bloklar diskte kalabilir. Anahtarların kendisi artık şifreli kasada.

Çalışmazsa

Belirti	Neden	Çözüm
Dosya diğer kullanıcılar tarafından okunabiliyor	İzinler fazla açık.	chmod 600 çalıştır. Windows’ta yalnızca senin açabileceğin bir klasörde tut.
Bilinmeyen bir anahtar içe aktarmayı durdurdu	Yazım hatası veya adı geçen satırda bir sekme.	O satırı düzelt. Hiçbir şey kaydedilmedi.
Düz http reddedildi	holyarrs adresi bu bilgisayarda değil.	Konteynerin içinde http://127.0.0.1:6262 ile çalıştır veya https kullan.
Evdeki bir indirici yanıt vermiyor	Yerel ağ izni yok.	O bloğa allow_local_network: true koy.
Tek seferlik konteyner klasör sahiplerini değiştirdi	Farklı PUID/PGID.	Uygulamanın PUID ve PGID değerlerini kullan.
-delete hiçbir şey yapmadı	Bir şey başarısız oldu veya bağlama salt okunur.	Host’ta sil.

Uzmanlar için

Bayraklar ve çıkış kodları

Bayrak	Ne yapar	Varsayılan
-file <path>	Anahtar dosyası.	yok
-dry-run	Yalnızca nelerin ayarlanacağını söyler.	kapalı
-config <folder>	Yapılandırma klasörü.	/config
-delete	Hatasız bir çalıştırmadan sonra dosyanın üzerine sıfır yazar ve siler.	kapalı
-forget-move-credentials	Kayıtlı her eski uygulama anahtarını siler, sonra durur.	kapalı
-allow-http-lan	Ev ağı adresine düz http:// izni verir. Uyarı basar.	kapalı
-allow-readable-file	Diğer kullanıcıların okuyabildiği bir dosyayı kabul eder. Windows’taki Docker Desktop her dosyayı okunabilir gösterir.	kapalı

holyarrs adresi https:// olmalı ya da yalnızca bu bilgisayara giden düz http:// olabilir (127.0.0.1, ::1, localhost). Düz http üzerinden sahip anahtarın ve dosyanın tamamı şifresiz gider.

Çıkış kodu	Anlamı
0	Her öğe iyi gitti.
1	Bir öğe başarısız oldu. Dosyayı düzeltip yeniden çalıştır.
2	Hatalı komut satırı veya dosya.

Çıktı

Öğe başına bir satır: set (veya deneme çalıştırmasında would set, bazen bir notla), unchanged, skipped (empty), skipped (why) ya da failed: why. Hiçbir zaman anahtar, parola, token veya adres basmaz. Geçmiş’e yalnızca sayıları içeren tek bir olay düşer. Dosyandaki bir değeri gösterecek bir hata, onun yerine [hidden] gösterir.

Dosya biçimi

YAML’ın küçük ve katı bir kısmı:

• girintiyle bloklar, boşlukla, asla sekmeyle; listeler - ile,
• değerler düz, "double quotes" içinde ya da 'single quotes' içinde (tek tırnak içinde bir ' iki kez yazılır),
• # satır başında veya tırnak dışında bir boşluktan sonra yorum başlatır, bu yüzden # içeren bir parolayı tırnağa al,
• &, *, !, |, >, [, {, %, @ veya bir ters tırnakla başlayan ya da : içeren değeri tırnağa al.

Bilinmeyen bir anahtar ya da 256 KB’ı aşan bir dosya, hiçbir şey kaydedilmeden tüm içe aktarmayı durdurur; mesaj anahtarı ve satırı söyler. Dosyaya giden bir bağlantı reddedilir.

Özel alanlar

Alan	Kural
SABnzbd	Tam api_key gerekir. Bir nzb_key, kullanıcı adı veya parola atlanır ve hiç saklanmaz.
tvdb.api_key, tvdb.unique_user_key, trakt.redirect_urls	Kabul edilir ve atlanır.
smtp.host	Yalnızca sunucu adı, şema veya port yok.
smtp.port	1 ile 65535. Varsayılan 587.
smtp.from	Tek bir düz e-posta adresi.
Eski uygulama blokları	Move from other apps içinde Use the saved key (kayıtlı anahtarı kullan) ile kullanılır. Hiç gösterilmez, yalnızca sahip için, tek başarılı okumadan sonra silinir.

İlgili

• Eski uygulamalarını oku
• Ortam değişkenleri