Sorun giderme

Belirtini bul, nedenini oku, çözümü uygula. Örneklerde konteyner adı olarak holyarrs kullanılıyor; seninki farklıysa kendininkini yaz.

İlk 3 kontrol

1. Günlüğü (log) izle: docker logs -f holyarrs. Gizli bilgiler maskelenir. İzlemeyi bırakmak için Ctrl+C’ye bas; konteyner çalışmaya devam eder.
2. Doctor’ı çalıştır: docker exec holyarrs /holyarrs doctor. Her satırda OK, WARN veya FAIL yazar; her WARN ve FAIL satırı nasıl düzelteceğini söyler.
3. Hâlâ takılıyor musun? Bir destek paketi indir ve yardım iste. Destek al sayfasına bak.

Web sayfasına ulaşılamıyor

Belirti: tarayıcı http://your-server:6262 adresine bağlanamıyor.

Neden: konteyner durmuş, port eşlenmemiş ya da araya bir proxy girmiş.

Çözüm:

1. docker ps çalıştır. 0.0.0.0:6262->6262 ile holyarrs satırını görmelisin.
2. Sürekli yeniden başlıyorsa nedenini görmek için docker logs holyarrs oku.
3. /holyarrs gibi bir yol kullanıyorsan Ters proxy ve URL base sayfasına bak.

İzin hatası (Permission denied)

Belirti: doctor bir klasörün yazılabilir olmadığını söylüyor ya da içe aktarmalar izin hatasıyla başarısız oluyor.

Neden: klasörün host’taki sahibi PUID ve PGID ile uyuşmuyor.

Çözüm: doctor’ın önerdiği chown komutunu çalıştır ya da PUID ve PGID değerlerini klasörün sahibine göre ayarla. NAS’ta, izinler ekranında o kullanıcıya okuma ve yazma izni ver. NAS, Synology ve Unraid sayfasına bak.

Hiçbir şey inmiyor

Belirti: başlıklar eksik kalıyor ve indiricine hiçbir şey ulaşmıyor.

Neden: hiçbir kaynak yanıt vermiyor, indirici bağlı değil ya da hiçbir sürüm adayı seçim kurallarını geçemiyor.

Çözüm:

1. Settings > Downloaders (Ayarlar > İndiriciler) sayfasını aç ve indiricindeki Test (dene) düğmesine bas. Geçmesi gerekir.
2. Settings > Sources (Ayarlar > Kaynaklar) sayfasını aç ve her kaynakta Test’e bas.
3. Başlıkta Choose a release (Sürüm adayı seç) seçeneğini aç; tüm sonuçları ve seçilmeme nedenlerini görürsün.

İndiriciler ve Kaynaklar sayfalarına bak.

İndirildi ama içe aktarılmadı

Belirti: indirme indiricinde bitti ama başlık Kütüphane’nde yok.

Neden: HolyArrs dosyayı aynı yolda göremiyor, Kütüphane klasörüne yazamıyor ya da içe aktarma bir karar bekliyor.

Çözüm:

1. HolyArrs’a ve indiriciye aynı indirme klasörünü aynı yolda ver, örneğin /downloads; ya da indiricide Downloader’s path (indiricinin yolu) ve HolyArrs’ path (HolyArrs’ın yolu) alanlarını doldur.
2. Doctor’ı çalıştır ve indirme ya da Kütüphane klasörlerindeki her FAIL satırını düzelt.
3. İndirmeler listesinde Needs a decision (Karar bekliyor) işaretli öğelere bak ve planı onayla ya da sil.

İçe aktarmalar hardlink değil, kopya

Belirti: doctor hardlink’lerin çalışmadığını söylüyor ya da içe aktarmalardan sonra disk kullanımı ikiye katlanıyor.

Neden: indirme ve Kütüphane klasörleri farklı disklerde ya da bağlama noktalarında.

Çözüm: ayrı ayrı bağlamak yerine konteynere ortak tek bir üst klasör bağla. Klasörler sayfasına bak.

HolyArrs başlamıyor

Belirti: konteyner duruyor ya da hemen yeniden başlıyor.

Neden: günlük bunu söyler. Sık görülenler: /config bir ağ paylaşımında ya da FUSE yolunda olması ya da bozuk bir modül.

Çözüm:

1. Günlük böyle diyorsa /config klasörünü yerel bir diske taşı. HolyArrs veritabanını bir paylaşımda çalıştırmaz.
2. Değilse güvenli modda başlat, Settings (Ayarlar) üzerinden düzelt ve normal şekilde yeniden başlat.

Bir özellik yok

Belirti: okuduğun bir özellik uygulamada yok.

Neden: bu sürümde bekletiliyor olabilir.

Çözüm: Bekletilen özellikler bölümüne bak.

Sayfalarda isim ve resim yok

Belirti: başlıklar poster ve ayrıntı olmadan görünüyor.

Neden: metadata sunucusuna ulaşılamıyor.

Çözüm: DNS’ini ve güvenlik duvarını kontrol et. Doctor’ın Network bölümü sunucunun yanıt verip vermediğini gösterir.

Uzmanlar için

Doctor kontrolleri ve seçenekleri

Doctor konteynerin içinde, HolyArrs’ın çalıştığı kullanıcıyla çalışır; yani HolyArrs neye takılıyorsa o da ona takılır.

Bölüm	Ne gösterir
App	Sürüm, kullanıcı ve grup, umask, konteynerde çalışıp çalışmadığı.
Config folder	Sahip, izinler, boş alan, yerel diskte olup olmadığı.
Library and download folders	Var mı, sahibi, yazılabilir mi, boş alan, indirme ve Kütüphane klasörleri arasında hardlink.
Network	Metadata sunucusunun adının çözülüp çözülmediği ve yanıt verip vermediği.
Clock	Saat, saat dilimi (TZ), saat belli ki yanlışsa bir uyarı.

Seçenek	Ne yapar
-config <folder>	/config yerine başka bir HolyArrs yapılandırma klasörünü kontrol eder.
-json	Raporu JSON olarak yazdırır.

Çıkış kodu 0 hiçbir şeyin başarısız olmadığı, 1 ise bir satırda FAIL yazdığı anlamına gelir. Rapor anahtarları, parolaları ve token’ları asla göstermez. Yalnızca okur; tek istisna yazıp sildiği küçük bir deneme dosyasıdır. Root olarak başlatılırsa, normal bir başlangıç gibi yapılandırma klasörünü de PUID:PGID kullanıcısına devreder.

HolyArrs sürekli yeniden başlıyorsa docker exec başarısız olur. Doctor’ı aynı klasörlerle yeni bir konteynerde çalıştır:

docker run --rm --volumes-from holyarrs -e PUID=<puid> -e PGID=<pgid> -e TZ=<tz> holyarrs/holyarrs:<tag> doctor

Compose ile: docker compose run --rm holyarrs doctor.

Başlangıç klasör kontrolü

Başlarken HolyArrs klasörlerini kontrol eder ve folders: 4 ok, 1 not writable gibi tek bir özet satırı yazar; ardından sorunlu her klasör için bir çözümle birlikte bir satır daha yazar. Kontrol 3 saniye sonra durur, böylece başlangıç asla takılı kalmaz. Yanıt vermeyecek kadar yavaş bir klasör kontrol edilmemiş sayılır; bu çoğunlukla uykudan uyanan bir disk ya da yavaş bir ağ paylaşımıdır. Doctor aynı kontrolü süre sınırı olmadan yapar. Günlükler sayfasına bak.

İmajda shell yok

İmajda yalnızca HolyArrs programı var; böylece küçük kalır ve bir saldırganın kullanabileceği şey azalır. docker exec holyarrs sh bilerek başarısız olur. Daha yakından bakmak için yanına geçici bir yardımcı başlat:

docker run --rm -it --pid container:holyarrs --network container:holyarrs --volumes-from holyarrs busybox sh

HolyArrs işlemini görür, ağını paylaşır ve aynı klasörlere aynı yollarda sahiptir. Root olarak çalışır, o yüzden sadece bak, değiştirme: root olarak yazılan bir dosyayı HolyArrs okuyamayabilir. HolyArrs kullanıcısı olarak denemek için --user <PUID>:<PGID> ekle.

Sürümü bul

docker inspect --format '{{ index .Config.Labels "org.opencontainers.image.version" }}' holyarrs

Doctor’ın App bölümü de aynısını gösterir.

İlgili

• Destek al
• Günlükler
• Sağlık denetimleri