SSD Nodes Learn Hosting plans →
Rehberler Matt ConnorYazan Matt Connor

Docker Compose PUID ve PGID nedir ve nasıl kullanılır?

PUID ve PGID Docker ayarı değildir. linuxserver.io imajlarında dosya izinlerini 911:911 sorunundan kurtarmak için kullanılan bir yöntemdir. Doğru yapılandırmayı öğrenin.

PUID ve PGID kavramları

PUID ve PGID, belirli container imajlarının başlangıçta okuduğu iki ortam değişkenidir. Docker'ın kendisi bunlara bakmaz. Bunlar, linuxserver.io imajları ve diğer bazı imajlar tarafından kullanılan bir gelenektir; dolayısıyla bu değişkenleri okumak üzere yazılmamış bir imaj, bunları sessizce görmezden gelir.

Bir linuxserver.io imajının içinde, derleme zamanında UID (kullanıcı kimliği) 911 ve GID (grup kimliği) 911 ile oluşturulmuş abc adında bir kullanıcı bulunur. Container root yetkileriyle başlar, init betiklerini çalıştırır ve bu betiklerden biri, uygulama başlamadan önce o kullanıcının kimlik numarasını yeniden düzenler:

groupmod -o -g "${PGID}" abc
usermod -o -u "${PUID}" abc

-o bayrağı, halihazırda başka bir yerde kullanımda olan bir kimliğin kullanılmasına izin verir. Bundan sonra init süreci yetkilerini düşürür ve uygulamayı abc kullanıcısı olarak çalıştırır. Özetle Docker, PUID=1000 değişkenini diğer tüm ortam değişkenleri gibi container içine aktarır ve bu değişken üzerinde herhangi bir işlem yapmaz. Değişken, uygulama başlamadan önce container içindeki bir kullanıcının kimlik numarasını değiştirir. Bu durum, user namespace remapping (kullanıcı ad alanı eşleme) özelliği kullanılmayan standart bir rootful daemon üzerinde, yeni oluşturulan dosyaların diskte normalde 1000 sahibiyle görünmesi anlamına gelir. Mevcut ve yazılabilir bir dosyaya yazmak, dosyanın sahibini değiştirmez. Rootless Docker ise aşağıda açıklandığı üzere bu numarayı kaydırır. PUID değişkenini boş bırakırsanız abc değeri 911 olarak kalır; yapılandırılmamış bir bind mount dizininin 911:911 sahibiyle oluşturulmuş dosyalarla dolmasının nedeni budur.

id ile iki numaranızı alın

Bunu, veri dizinlerinin sahibi olan kullanıcı olarak ana makinede çalıştırın:

id
uid=1000(deploy) gid=1000(deploy) groups=1000(deploy),27(sudo),988(docker)

uid sizin PUID değeriniz, gid ise PGID değerinizdir. Bir betik için id -u ve id -g komutları sadece sayıları yazdırır. Çoğu yeni VPS imajında ilk kullanıcı hesabı 1000:1000 değerindedir ancak bunu varsaymayın. Atama, mevcut hesaplara ve yapılandırmaya bağlıdır: yeniden oluşturulan bir sunucu tekrar 1000 değerini atayabilirken, sonraki bir hesap daha yüksek bir boş ID alabilir. Servisleriniz kendi kullanıcı hesabınız yerine özel bir servis hesabı altında çalışıyorsa, id thatuser komutunu çalıştırın ve sayıları oradan alın.

Dosyalarınız neden 911:911 olarak görünüyor

ls -l, o ID ile eşleşen bir ana makine hesabı bulunamadığında isim yerine sayısal bir ID yazdırır. Eğer 911 UID'si ile eşleşen bir ana makine hesabı yoksa, yazdırılacak bir isim de yoktur. Her seferinde sayıları görmek ve belirsizliği gidermek için ls -ln kullanın:

ls -ln /srv/appdata/sonarr
drwxr-xr-x 2 911 911 4096 Aug  7 09:12 Backups
-rw-r--r-- 1 911 911  512 Aug  7 09:12 config.xml

Bu çıktı, container'ın yerleşik varsayılanlarıyla eşleşir ancak mevcut dosyalar tek başına uygulamanın şu anda hangi kullanıcıyla çalıştığını kanıtlamaz. Bu listedeki config.xml, aynı zamanda kimlik doğrulama ayarlarını tutan dosyadır; bu durum, web arayüzünü ilk kez açtığınızda Sonarr ve Radarr varsayılan kullanıcı adı veya parola olmadan gelir gerçeğiyle karşılaştığınızda önem kazanır. Tahmin etmek yerine container içinden doğrulayın:

docker exec sonarr id abc
docker compose logs sonarr | head -n 25

linuxserver init süreci, sonucunu başlangıç günlüğüne iki satır halinde yazdırır:

User UID:    911
User GID:    911

Eğer Compose dosyanızda PUID=1000 değerini ayarlamanıza rağmen bu satırlar 911 değerini gösteriyorsa, çalışan container ayarladığınız değeri kullanmıyordur. Bunun yaygın nedeni, docker-compose.yml dosyasını düzenleyip ardından docker compose restart komutunu çalıştırmanızdır; bu komut, mevcut container'ı orijinal ortam değişkenleriyle yeniden kullanır. Ortam değişkeni değişiklikleri, container'ı yeniden oluşturan docker compose up -d komutunu gerektirir. Diğer neden ise kasıtlıdır: bir imaj salt okunur veya root olmayan modda çalıştığında, değişken container içinde mevcut olsa bile init süreci yeniden numaralandırma işlemini tamamen atlar. Salt okunur modda banner, abc değerinin değişmemiş ID'sini bildirir; root olmayan modda ise /run sahibini bildirir.

Container tarafından yazılan bir dosyanın neden silinemediği

Çekirdek, isimleri değil sayıları karşılaştırır. Kabuğunuz UID 1000 olarak çalışır. Dosya ise UID 911'e aittir. Dosyayı barındıran dizin drwxr-xr-x yolundadır ve o da 911'e aittir; bu nedenle grup ve diğer kullanıcılar okuma ve çalıştırma yetkisine sahip olsalar da yazma yetkileri yoktur. Bir dosyayı silmek için dosyanın kendisine değil, bulunduğu dizine yazma izninizin olması gerekir. Bu yüzden dosya zararsız görünse bile şu hatayı alırsınız:

rm: cannot remove '/srv/appdata/sonarr/config.xml': Permission denied

Yazma işlemi yapan bir container, aynı duvara diğer taraftan çarpar. Eğer ana makinedeki dizin 755 modunda sizin kullanıcınıza aitse ve uygulama 911 kullanıcısı olarak çalışıyorsa, ilk yazma girişimi Permission denied hatasıyla başarısız olur ve uygulama bunu kendi hata mesajlarıyla raporlar. Sonarr veya Radarr gibi bir .NET uygulamasında bu durum UnauthorizedAccessException: Access to the path '/data/downloads' is denied olarak görünür. Dosyanın önündeki izin dizgisi, üç izin kümesinden hangisine göre değerlendirildiğinizi gösterir; drwxr-xr-x ifadesini doğru okumak, bu hatanın gizemli olmaktan çıkıp anlaşılır hale gelmesini sağlar.

Bu durum özellikle bir bind mount sorunudur. Docker, boş bir named volume oluşturup bunu imaj içinde var olan bir yolun üzerine bağladığında, o yolun içeriğini sahiplik ve izin bitleri dahil olmak üzere volume içine kopyalar; böylece uygulama zaten sahip olduğu bir dizin bulur. Bind mount ise bu işlemin hiçbirini görmez: Docker, ana makinedeki dizininizi olduğu gibi bağlar. Bu fark, bind mount yönteminin named volume yönteminden ne zaman daha avantajlı olduğunu bilmenin pratik nedenlerinden biridir.

Hatalı yapılandırılmış bir dizini düzeltme

PUID ve PGID değerlerini ayarlamak, uygulamanın bundan sonraki davranışını değiştirir. Bu işlem, diskte halihazırda bulunan dosyaları geriye dönük olarak düzeltmez; ancak init süreci, aşağıda açıklanan belirli yollardaki sahiplik bilgilerini düzeltir. Stack'i durdurun, sahiplik bilgilerini manuel olarak düzeltin ve ardından tekrar başlatın:

docker compose down
sudo chown -R 1000:1000 /srv/appdata/sonarr
docker compose up -d

Sayıları yazmak istemiyorsanız sudo chown -R "$(id -u):$(id -g)" /srv/appdata/sonarr kullanın. Bu işlemi container durdurulmuş durumdayken yapın; çünkü recursive chown işlemi sırasında yazma aşamasında olan çalışan bir uygulama, kısmen düzeltilmiş bir dizin ağacı ve kafa karıştırıcı ikinci bir hata döngüsü ile sonuçlanabilir.

PUID ve PGID'nin çözemediği durumlar

Her şeyi doğru yapan kullanıcıların dahi takıldığı nokta burasıdır. linuxserver tabanlı imajların kullanıcı kurulum betiği, başlangıçta üç yolu /app, /config ve /defaults komutlarıyla sahiplendirir (chown). Medya bağlama noktalarınız (mounts) bu listede yer almaz. /data, /downloads ve /tv yolları uygulamaya olduğu gibi aktarılır; dolayısıyla bu bağlama noktalarının ana makine tarafındaki sahiplik bilgisi, container kullanıcısının yazma yetkisi olmayan bir durumdaysa, container sorunsuz başlar, banner kısmında doğru UID değerini gösterir ancak ilk içe aktarma (import) işleminde hata verir.

Bu beklenen davranıştır. On iki terabaytlık bir medya kütüphanesinde her container başlangıcında özyinelemeli (recursive) bir chown işlemi felakete yol açar. Bu durum, medya dizinlerinin yönetiminin sizin sorumluluğunuzda olduğu ve izin hatalarının genellikle bu bağlama noktalarında yaşandığı anlamına gelir. Bu tür hatalar, container sağlıklı göründükten saatler sonra uygulama günlüklerinde sessizce ortaya çıktığından, kendi VPS'inizde ntfy kullanarak telefonunuza bildirim gönderen periyodik bir yazma testi, bir haftalık eksik bölümden haberdar olmaktan çok daha pratik bir yöntemdir.

Kullanıcıyı denetlemenin üç yolu ve her birinin geçerli olduğu durumlar

PUID ve PGID ortam değişkenleri

Bu yöntem yalnızca entrypoint'i bu değişkenleri okuyan imajlarda çalışır. Popülerdir çünkü container hala root olarak başlar, kendi kurulumunu yapar, /config sorunlarını giderir ve ancak o zaman yetkilerini düşürür. Docker Mods ve özel init betikleri çalışmaya devam eder. Dezavantajı, bir platform özelliğinden ziyade bir kurala güveniyor olmanızdır ve değişken isimleri projeler arasında standart değildir.

Compose içindeki user: anahtarı

Bu gerçek bir Docker özelliğidir ve her imajda çalışır; çünkü container çalışma zamanı (runtime), bunu imajın kendi kodu çalışmadan önce uygular:

services:
  sonarr:
    image: lscr.io/linuxserver/sonarr:latest
    user: "1000:1000"

Süreç hiçbir zaman root olarak çalışmaz, bir anlığına bile olsa; bu gerçek bir güvenlik kazanımıdır. Ayrıca entrypoint içinde root yetkisine ihtiyaç duyan her şeyi bozar. linuxserver imajlarında proje bunu makul çabalar kapsamında ve yalnızca test ettiği imajlar için destekler; uyarılar ise spesifiktir: PUID ve PGID artık hiçbir etkiye sahip değildir, Docker Mods çalışmaz, özel servisler çalışmaz ve mount edilen her bir birimin izinlerinden siz sorumlu olursunuz. Belgelenmiş modelleri, bu bayrağı yazılabilir bir /run ile eşleştirir:

user: 1000:1000
tmpfs:
  - /run:uid=1000,gid=1000,exec
security_opt:
  - no-new-privileges=true

Kozmetik bir yan etki kullanıcıları şaşırtabilir. Container'ın /etc/passwd dosyasında karşılığı olmayan sayısal bir user:, içerideki araçların whoami: cannot find name for user ID 1000 rapor etmesine neden olur. Kimlik geçerlidir ve dosya erişimi normal şekilde çalışır. Yalnızca isim çözümleme başarısız olur.

Rootless Docker

Rootless Docker, daemon'ı yetkisiz kullanıcınız olarak çalıştırır; bu sayede daemon ve container'lar ana makine (host) root yetkileri olmadan çalışır. Sahiplik aritmetiğini tamamen değiştirir. Container UID 0, rootless Docker'ı çalıştıran kullanıcının ana makine UID'si ile eşleşir ve 1 veya daha büyük herhangi bir n için container UID n, subuid + (n - 1) ile eşleşir; burada subuid, /etc/subuid içinde size ayrılan aralığın başlangıcıdır; grup kimlikleri (GID) de /etc/subgid kullanılarak aynı kurala tabidir. Docker burada en az 65,536 adet alt kimlik bekler.

Bu eşleştirmeyi tekrar okuyun, çünkü genel tavsiyeyi tersine çevirir. Rootless Docker altında, root olarak dosya oluşturan bir container normalde sizin sahip olduğunuz bir dosya üretir. UID 1000 olarak dosya oluşturan bir container ise normalde, aralık 100000'den başladığında 100999 gibi bir alt kimliğe ait dosya üretir. Shell'inizin erişimi izinlere ve ACL'lere bağlıdır; silme işlemi normalde içinde bulunduğu dizine bağlıdır, bu nedenle o dosyayı kontrol ettiğiniz bir dizinden silebilirsiniz. Dolayısıyla, rootful bir daemon'da doğru olan PUID değeri burada yanlıştır. İki mekanizma sahipliği farklı katmanlarda değiştirir ve bunları kontrol etmeden üst üste kullanmak, mount edilen verilere yazamamanıza neden olabilir. Eğer rootless kullanacaksanız, bir kütüphaneyi taşımadan önce kendi sunucunuzda yazılan bir dosyanın sahipliğini test edin.

Tek bir VPS üzerindeki çoğu self-hosted yığın için, rootful bir daemon üzerinde PUID ve PGID kullanmak pragmatik bir tercihtir; çünkü imajlar bunun için oluşturulmuş ve belgelenmiştir. İmajın README dosyası bu yöntem için test edildiğini belirtiyorsa veya PUID desteği hiç olmayan resmi bir upstream imajı çalıştırıyorsanız user: yöntemine başvurun. Tek bir VPS üzerinde self-hosted AFFiNE örneği gibi bir doküman çalışma alanı bu son duruma girer; çünkü container'larının hiçbiri PUID okumaz ve veritabanı dizini ile yüklenen dosyaların sahipliği ortam bloğundaki herhangi bir şey tarafından değil, çalışma zamanı tarafından belirlenir. Aynı durum self-hosted Chatwoot destek masası için de geçerlidir; Rails container'ı ve Sidekiq çalışanı tek bir yükleme dizinine yazar ve ikisi de PUID okumaz, bu nedenle o dizinin imajın halihazırda çalıştığı kullanıcıyla eşleşmesi gerekir. Yeni bir yığın için de durum değişmez; bu yüzden ekipteki herkese kendi korumalı OneCLI aracısını vermek, kişi başı çalışma dizinlerini ve Postgres veri dizinini imajın halihazırda çalıştığı kullanıcının sahipliğinde bırakır; bu da durumu PUID sorunundan ziyade bir user: ve chown sorununa dönüştürür. Codex, Claude Code ve Hermes'in önüne tek bir self-hosted API koyun ve entrypoint'i birden fazla kimliği yönetsin: container root olarak başlamalı, konsol ve ağ geçidi yetkisiz bir kullanıcı olarak çalışmalı ve her aracı oturumu kendi kullanıcısı olarak çalışmalıdır. O dağıtıma user: eklemeyin; entrypoint'i veri biriminin sahipliğini kendisi yönetir.

Medya yığını örneği: container'lar arasında paylaşılan bir grup

Sonarr, Radarr ve bir indirme istemcisi içeren arr medya yığını, bu konunun teoriden pratiğe geçtiği noktadır. İndirme istemcisi tamamlanan dosyayı /data/downloads dizinine yazar. Sonarr ise bu dosyayı /data/media dizinine hardlink ile bağlar veya taşır. Hardlink işleminin çalışması için her iki container'ın da aynı dizin ağacına yazma erişimine sahip olması gerekir. Eğer indirme istemcisi 1000, Sonarr ise 1001 kullanıcı kimliğiyle çalışıyorsa ve paylaşılan bir grup yazma izni yoksa, dosyanın sahibi olan taraf dışındakiler dosyayı yalnızca okuyabilir.

Çözüm, yığındaki her container'ın PGID olarak kullandığı paylaşılan bir gruptur:

sudo groupadd -g 13000 media
sudo usermod -aG media deploy
sudo chown -R deploy:media /srv/media
sudo find /srv/media -type d -exec chmod 2775 {} +
sudo find /srv/media -type f -exec chmod 0664 {} +

2775 içindeki baştaki 2, setgid bitidir. Bir dizin üzerinde bu bit, içinde oluşturulan her yeni dosya ve alt dizinin, oluşturucunun birincil grubu yerine media grubunu miras alması anlamına gelir. Böylece, chown komutunu tekrar çalıştırmanıza gerek kalmadan yeni indirilen dosyalar için yapılandırma korunur. Kendi erişiminizi kontrol etmeden önce oturumu kapatıp tekrar açın veya newgrp media komutunu çalıştırın; usermod -aG ile eklenen bir grup, halihazırda açık olan bir shell oturumunda görünmez.

Container içinde groupmod -o -g 13000 abc, abc grubunu 13000 olarak yeniden numaralandırır; böylece abc, ana makinenizdeki media grubuyla aynı GID ile yazma işlemi yapar. Bu ağaca erişen her linuxserver container'ı kendi PUID değerini korur ve bu tek PGID değerini paylaşır. Buna, tamamlanmış kütüphaneyi yalnızca okuyan Jellyfin gibi zincirin devamındaki container'lar da dahildir. Kütüphaneyi 90'ların video dükkanı gibi gezilebilir kılan Halcyon gibi bir arayüz, HALCYON_JELLYFIN_URL kullanarak Jellyfin'e HTTP üzerinden bağlanır; standart kurulumu ne paylaşılan medya PGID'sine ne de bir medya dizini mount işlemine ihtiyaç duyar.

Ardından, yığındaki her linuxserver container'ı için UMASK=002 değerini ayarlayın. İnsanların gözden kaçırdığı adım budur. Ayarlanmadığı takdirde uygulama, başka bir şey değiştirmediği sürece devraldığı umask değerini korur ve image README dosyalarında gösterilen örnek değer UMASK=022 şeklindedir. 022 değerindeki bir umask ile, yeni bir dosya için 0666 talep eden bir uygulama, varsayılan bir ACL yoksa 0644 sonucunu alır: grubun geri kalanı dosyayı okuyabilir ancak değiştiremez; bu da yapılandırdığınız paylaşım ayarının çoğunu geçersiz kılar. 002 ve varsayılan bir ACL yokken, dosyalar için 0666 ve dizinler için 0777 talep eden bir uygulama 0664 dosyalar ve setgid ağacı içinde 2775 dizinler oluşturur; böylece grup yazma iznine sahip olur. Umask yalnızca bitleri kaldırır, bu nedenle 0600 talep eden bir uygulama yine 0600 alır ve varsayılan ACL taşıyan bir dizin umask değerini tamamen yok sayar. Değişkeni PUID ve PGID yanına ekleyin:

services:
  sonarr:
    image: lscr.io/linuxserver/sonarr:latest
    container_name: sonarr
    environment:
      - PUID=${PUID}
      - PGID=${PGID}
      - UMASK=002
      - TZ=Etc/UTC
    volumes:
      - /srv/appdata/sonarr:/config
      - /srv/media:/data
    restart: unless-stopped

Bu iki değer, Compose dosyasının yanındaki bir .env dosyasında bulunmalıdır; böylece tüm yığın tek bir tanımı okur:

PUID=1000
PGID=13000

Compose, kimlik bilgileri için kullandığınız mekanizmanın aynısı olan ${PUID} tarzı değişken değişimi için bu dosyayı otomatik olarak okur. Değerleri docker-compose.yml dışında tutup bir .env dosyasında saklama alışkanlıkları burada da geçerlidir; tek fark, bu iki sayının gizli olmamasıdır.

Yapılandırmaya güvenmek yerine uçtan uca doğrulama yapın. Uygulamanın kullanıcısı olarak, yapılandırılmış umask değerini uygulayan yeni bir dosya yazın ve ana makineden okuyun. Henüz mevcut olmayan bir test dosya adı kullanın:

docker exec --user abc sonarr sh -c 'umask "$UMASK" && touch /data/downloads/permtest'
ls -ln /srv/media/downloads/permtest

Sağlıklı bir sonuç; PUID değerinizi sahip, 13000 değerini grup ve -rw-rw-r-- değerini mod olarak gösterir. Eğer grup 1000 olarak görünüyorsa ls -ldn /srv/media/downloads komutunu çalıştırın: ya setgid biti (drwxrwsr-x içindeki s) o dizinde eksiktir ya da dizinin kendisi media yerine hala 1000 grubuna aittir; yukarıdaki chown ve chmod 2775 komutları her ikisini de düzeltir. Eğer mod -rw-r--r-- olarak görünüyorsa, container'ın UMASK değerini ve dizinin varsayılan ACL ayarını kontrol edin; ortam değişkenleri güncel değilse container'ı yeniden oluşturun. Bu test, yapılandırılmış maske ile abc olarak oluşturmayı kontrol eder; uygulamanın kendi oluşturma modu ve etkin umask değeri dosyalarını belirlemeye devam eder. İşiniz bittiğinde test dosyasını rm /srv/media/downloads/permtest ile kaldırın.

Hangi imaj hangi değişkeni kullanıyor

linuxserver.io imajları PUID, PGID ve UMASK değişkenlerini kullanır. Paperless-ngx aynı işlev için farklı isimler kullanır: USERMAP_UID ve USERMAP_GID; her ikisi de varsayılan olarak 1000 değerini alır ve dokümantasyonu bunları id -u ve id -g üzerinden okumanızı önerir. Fotoğraf sunucuları da benzer bir çeşitlilik gösterir: PhotoPrism kendi PHOTOPRISM_UID ve PHOTOPRISM_GID çiftine sahipken, Immich buna eşdeğer bir değişken sunmaz ve container kullanıcısını Docker'ın user: anahtarına bırakır; bu nedenle PhotoPrism ve Immich arasında seçim yapmak, sunucudaki en büyük kütüphane için bu mekanizmalardan hangisini yönetmeniz gerektiğine de karar vermenizi sağlar. Yaygın veritabanı ve web sunucusu imajları dahil olmak üzere birçok resmi upstream imajı, sabit bir yerleşik kullanıcı ile gelir ve sizden user: kullanmanızı veya ayara dokunmamanızı bekler. Küçük, tek uygulamalı kurulumlar da aynı soruyu gündeme getirir; bu nedenle kendi kendine barındırılan bir openGym antrenman takipçisi kurarken, bind mount tanımlamadan önce container'ın hangi kullanıcıyla çalıştığını kontrol etmek gerekir. Çünkü veritabanını tutan dizin, PUID ayarı yapıp yapmadığınıza bakılmaksızın bu kullanıcı kimliğini devralır. Uzaktan erişim rölesi de aynı kategoriye girer; bu yüzden kendi RustDesk röle sunucunuzu çalıştırdığınızda, hbbs'nin ilk başlatmada yazdığı Ed25519 anahtar çifti, bind mount dizininize imajın varsayılan kullanıcısı tarafından oluşturulmuş olarak gelir. Bunu daha sonra host tarafında bir chown komutuyla düzeltebilir veya user: anahtarı ile kimliği en başta seçebilirsiniz; çünkü imaj kendi içinde bir kullanıcı tanımlamaz, yeter ki bağladığınız dizin seçtiğiniz ID tarafından yazılabilir olsun. Aynı durum daha sonra eklediğiniz altyapılar için de geçerlidir; örneğin uygulamalarınızın önüne tek bir giriş noktası için Authentik koymak, PUID değişkenini hiç okumayan resmi authentik ve Postgres imajlarını çalıştırmak anlamına gelir. Bu imajların volume sahipliği, süreçlerinin çalıştığı kullanıcılardan ve entrypoint'lerinin yaptığı kurulumlardan kaynaklanır. Authentik, 2025.10 sürümünde Redis bağımlılığını kaldırmıştır.

Bu nedenle, projeler arasında bir environment bloğunu kopyalamadan önce her imajın README dosyasını kontrol edin. Docker, ayarladığınız her ortam değişkenini, içerideki uygulama okusun ya da okumasın, container'a aktarır. Hiçbir şeyin kullanmadığı bir PUID değişkeni hata veya uyarı üretmez, hiçbir etkisi de olmaz. Container, Docker'ın user: ayarı veya Dockerfile tarafından belirlenen kullanıcı ile başlar; entrypoint ise uygulamayı başlatmadan önce yetkilerini düşürebilir. kendi kendine barındırılan bir open-kritt güvenlik tarama yığını dahil olmak üzere, sunucuya yeni bir şey eklemeden önce bu okumayı yapın. Compose dosyasının içeriği, imajların PUID değişkenini dikkate alıp almadığını veya bağladığınız dizinlerin sahipliğinin imajların kendisi tarafından sabitlenip sabitlenmediğini size gösterecektir.

FAQ

Docker dosyalarımın sahibi neden 911:911 olarak görünüyor?

911, linuxserver.io imajlarının içine gömülü olan abc kullanıcısının UID ve GID değeridir. Bu değerin görülmesi, yerleşik varsayılanlarla eşleştiği anlamına gelir; ancak siz container'ın PUID ve PGID değerlerini değiştirdikten sonra dosyalar bu sahiplik bilgisini koruyabilir. Ana makinenizde bu kimliklerle eşleşen bir hesap bulunmadığında ls -l komutu isim yerine ham sayıları gösterir. PUID ve PGID değişkenlerini id komutunun çıktısına göre ayarlayın, container'ı docker compose up -d ile yeniden oluşturun ve ardından etkilenen dizin üzerinde sudo chown -R 1000:1000 komutunu çalıştırarak dosya sahipliklerini düzeltin.

PUID ve PGID her Docker imajında çalışır mı?

Hayır. Bunlar bir Docker özelliği değildir ve Docker tarafından okunmazlar. Yalnızca giriş noktası (entrypoint) bu değişkenleri okuyan ve uygulamayı başlatmadan önce usermod ile groupmod komutlarını çalıştıran imajlarda işe yararlar; linuxserver.io ailesi ve bu yapıyı kopyalayan birkaç proje buna örnektir. Diğer projeler, paperless-ngx içindeki USERMAP_UID ve USERMAP_GID gibi farklı isimler kullanır. Bu değişkenleri okumayan bir imajda, değişkenler kabul edilir ancak hiçbir uyarı verilmeden görmezden gelinir.

Docker Compose içinde PUID ve PGID mi yoksa user: anahtarı mı kullanmalıyım?

İmaj destekliyorsa PUID ve PGID kullanın; çünkü giriş noktası, /config dizinini düzeltmek ve kendi servislerini doğru şekilde başlatmak için yeterli süre boyunca root yetkileriyle çalışmaya devam eder. İmaj, seçilen kullanıcı için destek sağladığını belgeliyorsa user: kullanın; PUID desteğinin olmaması, giriş noktasının root olmadan çalışabileceği anlamına gelmez. Bir linuxserver imajında user: ayarını yapmak, PUID ve PGID değişkenlerini etkisiz hale getirir, Docker Mods ve özel servislerin çalışmasını durdurur; ayrıca bağlanan tüm birimlerin (volume) izin sorumluluğunu tamamen size yükler.

Sonarr doğru PUID değerine sahip olmasına rağmen dosyaları taşıyamıyor. Sorun nedir?

Sırasıyla üç noktayı kontrol edin. Birincisi, medya bağlama noktasıdır: temel imajın kullanıcı kurulum betiği /app, /config ve /defaults dizinlerinde sahiplik değişikliği (chown) yapar, bu nedenle /data veya /downloads ana makinedeki mevcut sahiplik bilgisini korur. İkincisi, paylaşılan gruptur: medyaya erişen container'lara aynı PGID değerini verin ve grup yazma izinlerini tanımlayın. Üçüncüsü, umask değeridir: uygulama 0666 talep ettiğinde ve varsayılan bir ACL uygulanmadığında, 022 değerindeki bir umask, 0644 izinlerine sahip dosyalar üretir; bu durumda gruptaki diğer container'lar dosyaları okuyabilir ancak değiştiremez. UMASK değişkenini boş bırakmak, belirli bir maske veya dosya modu garanti etmez. UMASK=002 değerini ayarlayın ve yeni dosyaların grubu devralması için dizinlerde setgid bitini chmod 2775 ile etkinleştirin. 0600 talep eden bir uygulama yine de özel dosyalar oluşturur ve varsayılan bir ACL, oluşturma izinlerinin nasıl atanacağını değiştirir.

Bu yazı işinize yaradı mı?