SSD Nodes Learn Hosting plans →
Panduan Matt ConnorOleh Matt Connor

Apa Itu PUID dan PGID dalam Docker Compose?

PUID dan PGID bukan tetapan Docker tetapi konvensyen imej linuxserver.io. Ketahui punca fail bind mount menjadi 911:911 dan cara menetapkan ID pengguna yang betul.

Apakah sebenarnya PUID dan PGID

PUID dan PGID ialah dua pemboleh ubah persekitaran yang dibaca oleh imej kontena tertentu semasa permulaan. Docker sendiri tidak pernah melihat pemboleh ubah ini. Ia merupakan satu konvensyen yang digunakan oleh imej linuxserver.io dan beberapa imej lain, jadi imej yang tidak ditulis untuk membacanya akan mengabaikannya secara senyap.

Di dalam imej linuxserver.io terdapat pengguna bernama abc, yang dicipta semasa proses binaan dengan UID (ID pengguna) 911 dan GID (ID kumpulan) 911. Kontena bermula sebagai root, menjalankan skrip initnya, dan salah satu skrip tersebut menukar nombor pengguna itu sebelum aplikasi bermula:

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

Flag -o membenarkan ID yang sudah digunakan di tempat lain. Selepas itu, proses init menggugurkan keistimewaan dan menjalankan aplikasi sebagai abc. Jadi, Docker menghantar PUID=1000 ke dalam kontena seperti mana-mana pemboleh ubah persekitaran lain dan tidak pernah bertindak ke atasnya. Pemboleh ubah ini menukar nombor pengguna di dalam kontena sebelum aplikasi bermula, yang bermaksud pada daemon rootful standard tanpa pemetaan ruang nama pengguna (user namespace remapping), fail yang baru dicipta biasanya akan disimpan pada cakera anda dengan pemilik 1000. Menulis pada fail sedia ada yang boleh ditulis tidak mengubah pemiliknya. Docker tanpa root (rootless) mengalihkan nombor tersebut, seperti yang dijelaskan di bawah. Biarkan PUID tidak ditetapkan dan abc akan mengekalkan 911, itulah sebabnya bind mount yang tidak dikonfigurasikan akan dipenuhi dengan fail yang dimiliki oleh 911:911.

Dapatkan dua nombor anda dengan id

Jalankan arahan ini pada hos, sebagai pengguna yang memiliki direktori data tersebut:

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

uid ialah PUID anda dan gid ialah PGID anda. Untuk skrip, id -u dan id -g akan memaparkan nombor tersebut sahaja. Pada kebanyakan imej VPS baharu, akaun manusia pertama ialah 1000:1000, tetapi jangan buat andaian sedemikian. Peruntukan bergantung pada akaun dan konfigurasi yang sedia ada: pelayan yang dibina semula boleh memperuntukkan 1000 sekali lagi, manakala akaun yang dibuat kemudian akan mendapat ID tersedia yang lebih tinggi. Jika servis anda dijalankan di bawah akaun servis khusus dan bukannya pengguna log masuk anda sendiri, jalankan id thatuser dan ambil nombor daripada situ.

Mengapa fail anda dipaparkan sebagai 911:911

ls -l mencetak ID berangka dan bukannya nama apabila tiada akaun hos yang sepadan dengan ID tersebut. Jika tiada akaun hos sepadan dengan UID 911, tiada nama untuk dicetak. Gunakan ls -ln untuk melihat nombor setiap kali dan menghapuskan kekaburan:

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

Output tersebut sepadan dengan tetapan lalai terbina dalam bekas, namun fail sedia ada sahaja tidak membuktikan pengguna mana yang menjalankan aplikasi tersebut sekarang. config.xml dalam senarai itu juga merupakan fail yang menyimpan tetapan pengesahan, yang penting apabila anda membuka UI web buat kali pertama dan mendapati bahawa Sonarr dan Radarr dihantar tanpa nama pengguna atau kata laluan lalai. Sahkan perkara ini dari dalam bekas dan bukannya meneka:

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

Init linuxserver mencetak hasilnya dalam log permulaan sebagai dua baris:

User UID:    911
User GID:    911

Jika baris tersebut membaca 911 selepas anda menetapkan PUID=1000 dalam fail Compose anda, bekas yang sedang berjalan tidak menggunakan nilai yang anda tetapkan. Punca biasa ialah anda menyunting docker-compose.yml dan kemudian menjalankan docker compose restart, yang menggunakan semula bekas sedia ada dengan persekitaran asalnya. Perubahan persekitaran memerlukan docker compose up -d, yang mencipta semula bekas tersebut. Punca lain adalah disengajakan: apabila imej berjalan dalam mod baca sahaja atau bukan root, init melangkau penomboran semula sepenuhnya, walaupun pemboleh ubah tersebut ada dalam bekas. Dalam mod baca sahaja, sepanduk melaporkan ID abc yang tidak berubah; dalam mod bukan root, ia melaporkan pemilik /run.

Mengapa anda tidak boleh memadam fail yang ditulis oleh kontena

Kernel membandingkan nombor, bukan nama. Shell anda berjalan sebagai UID 1000. Fail tersebut dimiliki oleh UID 911. Direktori yang menyimpannya ialah drwxr-xr-x dan juga dimiliki oleh 911, jadi kumpulan dan pengguna lain hanya mendapat kebenaran baca dan laksana tetapi tiada kebenaran tulis. Memadam fail memerlukan kebenaran tulis pada direktori fail tersebut, bukan pada fail itu sendiri, jadi anda mendapat ralat ini walaupun fail itu sendiri kelihatan tidak berbahaya:

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

Kontena yang menulis menghadapi halangan yang sama dari sisi yang berbeza. Jika direktori hos dimiliki oleh pengguna anda dengan mod 755 dan aplikasi berjalan sebagai 911, penulisan pertamanya akan gagal dengan Permission denied dan aplikasi akan melaporkannya dalam bahasa tersendiri. Dalam aplikasi .NET seperti Sonarr atau Radarr, ini muncul sebagai UnauthorizedAccessException: Access to the path '/data/downloads' is denied. Rentetan kebenaran di hadapan fail memberitahu anda set kebenaran yang mana satu yang sebenarnya digunakan untuk menilai anda, dan membaca drwxr-xr-x dengan betul adalah perkara yang mengubah ralat tersebut daripada sesuatu yang misteri kepada sesuatu yang jelas.

Ini merupakan masalah bind mount secara khusus. Apabila Docker mencipta named volume kosong dan melekapkannya pada laluan yang wujud dalam imej, ia menyalin kandungan laluan tersebut ke dalam volume, termasuk hak milik dan bit kebenaran, supaya aplikasi menemui direktori yang sudah dimilikinya. Bind mount tidak menerima layanan tersebut: Docker melekapkan direktori hos anda tepat seperti sedia ada. Perbezaan itu adalah salah satu sebab praktikal untuk mengetahui bila bind mount lebih baik daripada named volume dan bila tidak.

Membaiki direktori yang sudah salah

Menetapkan PUID dan PGID mengubah tindakan aplikasi mulai sekarang. Ia tidak membaiki setiap fail yang sudah sedia ada pada cakera secara retroaktif, walaupun init membetulkan pemilikan pada laluan tertentu seperti yang diterangkan di bawah. Hentikan stack, betulkan pemilikan secara manual, kemudian mulakan semula:

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

Gunakan sudo chown -R "$(id -u):$(id -g)" /srv/appdata/sonarr jika anda tidak mahu menaip nombor tersebut. Lakukan ini semasa container dihentikan, kerana aplikasi yang sedang berjalan dan berada di tengah-tengah proses penulisan semasa chown rekursif boleh menyebabkan pepohon direktori hanya dibaiki separuh dan menimbulkan pusingan ralat kedua yang mengelirukan.

Perkara yang tidak diselesaikan oleh PUID dan PGID

Ini adalah bahagian yang sering memerangkap pengguna walaupun mereka telah melakukan segalanya dengan betul. Skrip penyediaan pengguna dalam imej asas linuxserver melakukan chown pada tiga laluan semasa permulaan: /app, /config dan /defaults. Mount media anda tidak termasuk dalam senarai tersebut. /data, /downloads dan /tv diserahkan kepada aplikasi tanpa sebarang perubahan. Oleh itu, jika bahagian hos bagi mount tersebut mempunyai pemilikan yang tidak membenarkan pengguna kontena menulis, kontena akan bermula dengan lancar, memaparkan UID yang betul pada banner, tetapi gagal semasa import pertama.

Ini adalah kelakuan yang betul. Melakukan chown secara rekursif pada pustaka media bersaiz dua belas terabait setiap kali kontena bermula adalah satu bencana. Ini bermakna direktori media adalah tanggungjawab anda, dan ia merupakan mount di mana masalah kebenaran akses sebenarnya berlaku. Memandangkan kegagalan jenis ini muncul secara senyap dalam log aplikasi beberapa jam selepas kontena kelihatan sihat, ujian tulis berkala yang disambungkan ke ntfy pada VPS anda sendiri, menghantar makluman ke telefon anda merupakan cara murah untuk mengetahui mengenainya sebelum anda menyedari episod yang hilang selepas seminggu.

Tiga cara untuk mengawal pengguna, dan bila setiap satunya digunakan

Pemboleh ubah persekitaran PUID dan PGID

Ini hanya berfungsi pada imej yang entrypoint-nya membaca pemboleh ubah tersebut. Ia popular kerana kontena masih bermula sebagai root, melakukan persediaan sendiri, membetulkan /config, dan hanya kemudian melepaskan keistimewaan. Docker Mods dan skrip init tersuai terus berfungsi. Kosnya ialah anda mempercayai konvensyen dan bukannya ciri platform, dan nama pemboleh ubah tidak seragam merentas projek.

Kunci user: dalam Compose

Ini merupakan ciri sebenar Docker dan berfungsi pada setiap imej, kerana runtime kontena mengaplikasikannya sebelum kod imej itu sendiri dijalankan:

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

Proses tersebut tidak pernah berjalan sebagai root, walaupun untuk seketika, yang merupakan peningkatan keselamatan yang tulen. Ia juga merosakkan mana-mana bahagian dalam entrypoint yang memerlukan root. Pada imej linuxserver, projek ini menyokongnya berdasarkan usaha yang munasabah dan hanya untuk imej yang telah diujinya, dan peringatannya adalah khusus: PUID dan PGID berhenti memberi sebarang kesan, Docker Mods tidak akan berjalan, servis tersuai tidak akan berjalan, dan anda bertanggungjawab ke atas keizinan pada setiap volum yang dipasang (mounted). Corak yang didokumenkan oleh mereka menggandingkan flag tersebut dengan /run yang boleh ditulis:

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

Satu kesan sampingan kosmetik mengejutkan orang ramai. user: berangka yang tidak mempunyai entri sepadan dalam /etc/passwd kontena menyebabkan alatan di dalam melaporkan whoami: cannot find name for user ID 1000. ID tersebut adalah sah dan akses fail berfungsi seperti biasa. Hanya carian nama yang gagal.

Rootless Docker

Rootless Docker menjalankan daemon itu sendiri sebagai pengguna tanpa keistimewaan anda, jadi daemon dan kontena berjalan tanpa keistimewaan root hos. Ia mengubah aritmetik pemilikan sepenuhnya. UID 0 kontena dipetakan kepada UID hos pengguna yang menjalankan rootless Docker, dan UID n kontena bagi mana-mana n 1 atau lebih dipetakan kepada subuid + (n - 1), di mana subuid ialah asas julat yang diperuntukkan kepada anda dalam /etc/subuid; ID kumpulan mengikut peraturan yang sama menggunakan /etc/subgid. Docker menjangkakan sekurang-kurangnya 65,536 ID bawahan di sana.

Baca pemetaan itu semula, kerana ia menyongsangkan nasihat biasa. Di bawah rootless Docker, kontena yang mencipta fail sebagai root biasanya menghasilkan fail yang dimiliki oleh anda. Kontena yang mencipta fail sebagai UID 1000 biasanya menghasilkan fail yang dimiliki oleh ID bawahan, seperti 100999 apabila julat bermula pada 100000. Akses shell anda bergantung pada keizinan dan ACL; pemadaman biasanya bergantung pada direktori yang mengandungi, jadi anda boleh memadam fail tersebut daripada direktori yang anda kawal. Jadi, nilai PUID yang betul pada daemon rootful adalah nilai yang salah di sini. Kedua-dua mekanisme menukar pemilikan pada lapisan yang berbeza, dan menyusunnya tanpa memeriksa boleh menyebabkan anda tidak dapat menulis ke data yang dipasang. Jika anda menggunakan rootless, uji pemilikan satu fail yang ditulis pada pelayan anda sendiri sebelum anda memindahkan pustaka ke dalamnya.

Bagi kebanyakan stack self-hosted pada satu VPS, PUID dan PGID pada daemon rootful adalah pilihan pragmatik, kerana itulah tujuan imej dibina dan didokumenkan. Gunakan user: apabila README imej menyatakan bahawa imej tersebut diuji untuknya, atau apabila anda menjalankan imej hulu (upstream) rasmi yang tidak mempunyai sokongan PUID langsung. Ruang kerja dokumen seperti satu contoh AFFiNE self-hosted pada satu VPS termasuk dalam kes terakhir itu, kerana tiada satu pun kontena miliknya membaca PUID dan pemilikan direktori pangkalan data serta fail yang dimuat naik ditentukan oleh runtime dan bukannya oleh apa-apa dalam blok persekitaran. Perkara yang sama berlaku pada meja bantuan sokongan Chatwoot self-hosted, di mana kontena Rails dan pekerja Sidekiq miliknya kedua-duanya menulis ke dalam satu direktori muat naik dan tiada satu pun daripadanya membaca PUID, jadi direktori tersebut perlu sepadan dengan mana-mana pengguna yang sedia menjalankan imej tersebut. Tiada satu pun daripada itu berubah untuk stack yang lebih baharu juga, jadi memberikan setiap orang dalam pasukan ejen OneCLI terpasir (sandboxed) mereka sendiri menyebabkan direktori ruang kerja setiap orang dan direktori data Postgres dimiliki oleh pengguna yang sedia menjalankan setiap imej, yang menjadikannya masalah user: dan chown dan bukannya masalah PUID. Letakkan satu API self-hosted tunggal di hadapan Codex, Claude Code dan Hermes dan entrypoint-nya menguruskan beberapa identiti: kontena mesti bermula sebagai root, konsol dan gateway berjalan sebagai pengguna tanpa keistimewaan, dan setiap sesi ejen berjalan sebagai penggunanya sendiri. Jangan tambah user: pada deployment tersebut; entrypoint-nya mengendalikan pemilikan volum data.

Kes media stack: satu kumpulan dikongsi merentasi kontena

Arr media stack dengan Sonarr, Radarr dan klien muat turun adalah tempat di mana perkara ini bukan lagi sekadar teori. Klien muat turun menulis fail yang siap ke dalam /data/downloads. Sonarr kemudian melakukan hardlink atau memindahkan fail tersebut ke dalam /data/media. Untuk hardlink berfungsi, kedua-dua kontena memerlukan akses tulis ke pokok direktori yang sama. Jika klien muat turun berjalan sebagai 1000 manakala Sonarr berjalan sebagai 1001 tanpa kebenaran tulis kumpulan yang dikongsi, salah satu daripadanya akan memiliki fail yang hanya boleh dibaca oleh yang satu lagi.

Penyelesaiannya ialah kumpulan dikongsi yang digunakan oleh setiap kontena dalam stack tersebut sebagai PGID masing-masing:

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 {} +

2 di hadapan dalam 2775 ialah bit setgid. Pada direktori, ini bermakna setiap fail dan subdirektori baharu yang dicipta di dalamnya akan mewarisi kumpulan media dan bukannya kumpulan utama penciptanya. Oleh itu, aturan ini kekal untuk muat turun baharu tanpa anda perlu menjalankan chown semula. Log keluar dan masuk semula, atau jalankan newgrp media, sebelum anda menyemak akses anda sendiri: kumpulan yang ditambah dengan usermod -aG tidak akan muncul dalam sesi shell yang sedang dibuka.

Di dalam kontena, groupmod -o -g 13000 abc menukar nombor kumpulan abc kepada 13000, supaya abc menulis dengan GID yang sama seperti kumpulan media pada hos anda. Setiap kontena linuxserver yang mengakses pokok direktori ini mengekalkan PUID masing-masing dan berkongsi satu PGID tersebut. Ini termasuk kontena yang berada lebih jauh dalam rantaian yang hanya membaca pustaka yang telah siap, seperti Jellyfin sendiri. Bahagian hadapan seperti Halcyon, yang menyajikan pustaka tersebut sebagai kedai video 90-an yang boleh dilayari, bersambung ke Jellyfin melalui HTTP menggunakan HALCYON_JELLYFIN_URL; penggunaan standardnya tidak memerlukan PGID media yang dikongsi mahupun mount direktori media.

Kemudian, tetapkan UMASK=002 pada setiap kontena linuxserver dalam stack tersebut. Ini adalah langkah yang sering terlepas pandang. Jika tidak ditetapkan, aplikasi akan mengekalkan umask yang diwarisi melainkan sesuatu yang lain mengubahnya, dan nilai contoh yang ditunjukkan dalam README imej ialah UMASK=022. Dengan umask berkesan 022, aplikasi yang meminta 0666 untuk fail baharu akan mendapat 0644 apabila tiada ACL lalai: bahagian kumpulan yang lain masih boleh membacanya tetapi tidak boleh mengubahnya, yang membatalkan kebanyakan perkongsian yang baru anda konfigurasikan. Dengan 002 dan tanpa ACL lalai, aplikasi yang meminta 0666 untuk fail dan 0777 untuk direktori akan mendapat fail 0664 dan, di dalam pokok direktori setgid, direktori 2775, dan kumpulan tersebut boleh menulis. Umask hanya membuang bit, jadi aplikasi yang meminta 0600 masih mendapat 0600, dan direktori yang membawa ACL lalai akan mengabaikan umask sepenuhnya. Tambahkan pemboleh ubah di sebelah PUID dan PGID:

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

Dua nilai tersebut perlu diletakkan dalam fail .env di sebelah fail Compose, supaya keseluruhan stack membaca satu definisi:

PUID=1000
PGID=13000

Compose membaca fail tersebut secara automatik untuk penggantian gaya ${PUID}, yang merupakan mekanisme yang sama yang anda gunakan untuk kelayakan (credentials). Tabiat mengenai menyimpan nilai di luar docker-compose.yml dan ke dalam fail .env juga terpakai di sini, dengan perbezaan bahawa dua nombor ini bukanlah rahsia.

Sahkan ia dari hujung ke hujung dan bukannya mempercayai konfigurasi semata-mata. Tulis fail baharu sebagai pengguna aplikasi, dengan menggunakan umask yang dikonfigurasikan, dan baca fail tersebut daripada hos. Gunakan nama fail ujian yang belum wujud:

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

Hasil yang sihat menunjukkan PUID anda sebagai pemilik, 13000 sebagai kumpulan, dan -rw-rw-r-- sebagai mod. Jika kumpulan membaca 1000, jalankan ls -ldn /srv/media/downloads: sama ada bit setgid (s dalam drwxrwsr-x) tiada pada direktori tersebut, atau direktori itu sendiri masih milik kumpulan 1000 dan bukannya media, dan arahan chown serta chmod 2775 di atas akan membetulkan kedua-duanya. Jika mod membaca -rw-r--r--, semak nilai UMASK kontena dan ACL lalai direktori; cipta semula kontena jika persekitarannya sudah lapuk. Ujian ini menyemak penciptaan sebagai abc dengan mask yang dikonfigurasikan; mod penciptaan aplikasi itu sendiri dan umask berkesan masih menentukan failnya. Buang fail ujian dengan rm /srv/media/downloads/permtest apabila anda selesai.

Imej mana yang menggunakan pemboleh ubah yang mana

Imej linuxserver.io menggunakan PUID, PGID dan UMASK. Paperless-ngx menggunakan nama yang berbeza untuk konsep yang sama: USERMAP_UID dan USERMAP_GID, kedua-duanya ditetapkan kepada 1000 secara lalai, dan dokumentasinya mengarahkan anda untuk membacanya daripada id -u dan id -g. Pelayan foto menunjukkan kepelbagaian yang sama: PhotoPrism mempunyai pasangan PHOTOPRISM_UID dan PHOTOPRISM_GID miliknya sendiri, manakala Immich tidak menyertakan setara dan membiarkan pengguna kontena kepada kunci user: Docker, jadi memilih antara PhotoPrism dan Immich juga menentukan mekanisme mana yang akan anda selenggara untuk pustaka terbesar pada pelayan tersebut. Banyak imej huluan rasmi, termasuk imej pangkalan data dan pelayan web yang biasa, menyertakan pengguna binaan dalam yang tetap dan menjangkakan anda menggunakan user: atau membiarkannya begitu sahaja. Penempatan aplikasi tunggal yang kecil menimbulkan persoalan yang sama, jadi apabila anda menyediakan penjejak senaman openGym yang dihoskan sendiri, adalah berbaloi untuk menyemak pengguna mana yang sebenarnya menjalankan kontena tersebut sebelum anda menghalakan bind mount kepadanya, kerana direktori yang menyimpan pangkalan datanya akan mewarisi jawapan tersebut sama ada anda menetapkan PUID atau tidak. Geganti akses jauh jatuh ke dalam kategori yang sama, jadi apabila anda menjalankan pelayan geganti RustDesk sendiri, pasangan kunci Ed25519 yang ditulis oleh hbbs pada permulaan pertama akan tiba dalam bind mount anda dengan pemilikan oleh pengguna yang digunakan oleh imej tersebut. Anda boleh membetulkannya kemudian dengan chown pada sisi hos, atau memilih identiti lebih awal dengan kunci user:, kerana imej tersebut tidak menetapkan pengguna sendiri, selagi direktori yang dilekap boleh ditulis oleh ID yang anda pilih. Perkara yang sama terpakai kepada infrastruktur yang anda tambah kemudian, jadi meletakkan Authentik di hadapan aplikasi anda untuk log masuk tunggal bermakna menjalankan imej authentik dan Postgres rasmi yang tidak membaca PUID langsung, dan pemilikan volumnya datang daripada pengguna yang menjalankan proses tersebut serta tetapan yang dilakukan oleh entrypoint masing-masing. Authentik telah membuang kebergantungan Redis dalam keluaran 2025.10.

Oleh itu, semak README bagi setiap imej sebelum anda menyalin blok persekitaran antara projek. Docker akan menghantar sebarang pemboleh ubah persekitaran yang anda tetapkan ke dalam mana-mana kontena, sama ada sesuatu di dalamnya membacanya atau tidak, dan PUID yang tidak digunakan oleh apa-apa tidak akan menghasilkan ralat, amaran atau kesan. Kontena bermula sebagai pengguna yang dipilih oleh tetapan user: Docker atau Dockerfile, dan entrypoint-nya kemudian boleh menurunkan keistimewaan sebelum memulakan aplikasi. Lakukan pembacaan tersebut sebelum anda menambah apa-apa yang baharu pada pelayan, termasuk stak pengimbasan keselamatan open-kritt yang dihoskan sendiri, di mana fail Compose memberitahu anda sama ada imej tersebut mematuhi PUID atau sama ada pemilikan direktori yang anda lekap ditetapkan oleh imej itu sendiri.

FAQ

Mengapakah fail Docker saya dimiliki oleh 911:911?

911 ialah UID dan GID bagi pengguna abc yang dibina ke dalam imej linuxserver.io. Melihat nombor ini bermakna ia sepadan dengan tetapan lalai terbina, namun fail boleh mengekalkan pemilikan tersebut selepas anda menukar PUID dan PGID bekas. ls -l memaparkan nombor mentah apabila tiada akaun pada hos anda yang sepadan dengan ID tersebut, jadi tiada nama untuk dipaparkan. Tetapkan PUID dan PGID kepada output id, cipta semula bekas dengan docker compose up -d, kemudian betulkan fail sedia ada dengan sudo chown -R 1000:1000 pada direktori yang terjejas.

Adakah PUID dan PGID berfungsi pada setiap imej Docker?

Tidak. Ia bukan ciri Docker dan Docker tidak pernah membacanya. Ia hanya berfungsi pada imej yang entrypoint-nya membaca pemboleh ubah tersebut dan memanggil usermod serta groupmod sebelum memulakan aplikasi, iaitu keluarga linuxserver.io dan beberapa projek lain yang meniru corak tersebut. Projek lain menggunakan nama berbeza, seperti USERMAP_UID dan USERMAP_GID dalam paperless-ngx. Pada imej yang tidak membaca kedua-duanya, pemboleh ubah tersebut diterima dan diabaikan tanpa sebarang amaran.

Patutkah saya menggunakan PUID dan PGID atau kunci user: dalam Docker Compose?

Gunakan PUID dan PGID apabila imej menyokongnya, kerana entrypoint masih berjalan sebagai root untuk tempoh yang cukup bagi membetulkan /config dan memulakan servisnya sendiri dengan betul. Gunakan user: apabila imej mendokumentasikan sokongan untuk pengguna yang dipilih; ketiadaan sokongan PUID sahaja tidak bermakna entrypoint-nya berfungsi tanpa root. Pada imej linuxserver, menetapkan user: menjadikan PUID dan PGID tidak aktif, menghalang Docker Mods dan servis tersuai daripada berjalan, serta menjadikan kebenaran setiap volum yang dipasang sebagai tanggungjawab anda.

Sonarr mempunyai PUID yang betul tetapi masih tidak boleh mengalihkan fail. Apakah masalahnya?

Semak tiga perkara mengikut urutan. Pertama, pemasangan media itu sendiri: skrip tetapan pengguna imej asas melakukan chown pada /app, /config dan /defaults, jadi /data atau /downloads mengekalkan apa jua pemilikan yang ada pada hos. Kedua, kumpulan kongsi: berikan bekas yang mengakses pepohon media PGID yang sama dan kebenaran tulis kumpulan. Ketiga, umask: topeng berkesan 022 menghasilkan fail 0644 apabila aplikasi meminta 0666 dan tiada ACL lalai digunakan, jadi bekas lain dalam kumpulan tersebut boleh membacanya tetapi tidak boleh mengubah suainya. Membiarkan UMASK tidak ditetapkan tidak menjamin topeng atau mod fail tertentu. Tetapkan UMASK=002 dan tetapkan bit setgid pada direktori dengan chmod 2775 supaya fail baharu mewarisi kumpulan tersebut. Aplikasi yang meminta 0600 masih mencipta fail peribadi, dan ACL lalai mengubah cara kebenaran penciptaan diberikan.

Adakah artikel ini berguna?