SSD Nodes Learn Hosting plans →
Panduan Matt ConnorOleh Matt Connor

Cara Pilih Type= systemd: simple, forking, notify

Servis systemd aktif tapi daemon mati? Ketahui cara memilih Type= yang betul untuk simple, forking, notify atau oneshot bagi mengelak ralat pemantauan PID utama unit anda.

Mengapa systemd melaporkan unit sebagai aktif sedangkan proses telah mati

Dengan ExitType=main dan RemainAfterExit=no lalai, unit servis systemd kekal active selagi proses yang systemd panggil sebagai proses utama masih hidup, dan Type= dalam bahagian [Service] menentukan proses yang manakah itu. Jika anda memilih nilai yang salah, systemd akhirnya memantau pembungkus shell (shell wrapper) atau proses induk yang berumur pendek, sementara daemon yang anda perlukan mati di dalam unit yang sama. Unit tersebut memberikan maklumat yang tepat tentang proses yang diarahkan untuk dipantau.

Menukar polisi mulakan semula tidak akan membantu dalam situasi ini. Restart= bertindak balas terhadap proses yang keluar dan kegagalan seperti tamat masa, tetapi ia tidak mengesan keluarnya daemon latar belakang selagi PID (pengecam proses) utama dimiliki oleh sesuatu yang masih berjalan. Betulkan Type= terlebih dahulu. Tindakan yang diambil oleh systemd selepas proses utama benar-benar keluar adalah keputusan berasingan, yang diterangkan dalam panduan untuk Restart= dan RestartSec=.

Apakah yang ditentukan oleh Type=

Setiap nilai Type= menjawab dua soalan serentak. Bilakah systemd menganggap unit ini telah bermula, dan proses manakah yang merupakan proses utama.

Jawapan pertama mengawal aturan. Unit yang menamakan unit anda dalam After= akan menunggu sehingga systemd mengisytiharkan unit anda telah bermula. Type= yang melaporkan "started" terlalu awal membolehkan unit yang bergantung (dependent units) berjalan sebelum servis anda bersedia untuk melayan permintaan mereka.

Jawapan kedua mengawal penyeliaan. systemd meletakkan setiap proses yang dijana oleh sesuatu unit ke dalam cgroup (control group), iaitu ciri kernel yang mengumpulkan proses supaya ia boleh dihadkan dan ditamatkan secara serentak. cgroup ialah cara systemctl stop melakukan pembersihan: KillMode= secara lalai menggunakan control-group, jadi menghentikan unit akan menghantar isyarat kepada setiap proses di dalamnya. PID utama adalah lebih khusus. Dengan tetapan lalai ExitType=main dan RemainAfterExit=no, ia merupakan proses tunggal yang mana penamatannya akan menamatkan unit tersebut, dan status keluarannya menyumbang kepada hasil unit itu. Membaca cgroup seolah-olah ia adalah PID utama merupakan punca kekeliruan bermula.

Type=simple melaporkan unit bermula sebelum binari dijalankan

Type=simple ialah tetapan lalai apabila ExecStart= ditetapkan, manakala Type= dan BusName= tidak hadir, dan unit tersebut tidak menggunakan sebarang kelayakan (credentials). Unit yang memuatkan kelayakan, contohnya dengan LoadCredential=, akan mendapat Type=exec secara tersirat. Di bawah simple, systemd mencipta proses tersebut, menganggap unit itu bermula serta-merta, dan melayan proses tersebut sebagai PID utama. Unit susulan akan bermula dengan segera, walaupun sebelum binari servis sempat dilaksanakan.

Perincian terakhir itu menjelaskan situasi yang sering mengejutkan. Kesilapan taip pada laluan ExecStart= masih menghasilkan tugasan mula (start job) yang berjaya, dan kegagalan hanya muncul seketika kemudian apabila pelaksanaan gagal. systemd merekodkan kes tersebut dengan kod keluar 203, yang dalam jadualnya sendiri dinamakan EXIT_EXEC dan ditakrifkan sebagai kegagalan pelaksanaan proses sebenar. Oleh itu, systemctl start yang kembali tanpa ralat tidak membuktikan binari anda wujud.

Gunakan simple untuk program yang kekal di latar depan dan tidak mengalihkan dirinya ke latar belakang. Ini merangkumi kebanyakan daemon moden dan hampir apa sahaja yang anda tulis sendiri.

Type=exec menunggu program untuk benar-benar bermula

Type=exec adalah simple dengan satu langkah tambahan. systemd menganggap unit telah bermula hanya selepas proses fork dan pelaksanaan binari berjaya dilakukan. Binari yang tiada atau User= yang tidak dapat diselesaikan kini menyebabkan tugasan permulaan gagal, berbanding melaporkan kejayaan dan kemudian gagal secara senyap.

Type=exec tiba dalam versi hulu (upstream) systemd 240, namun backport pengedaran menyokongnya pada versi yang lebih lama: RHEL 8 menambahnya dalam systemd-239-15.el8. Keluaran lama yang disokong mungkin masih tidak memilikinya: Ubuntu 18.04 kekal di bawah ESM sehingga April 2028, dan manual systemd 237 miliknya tidak menyenaraikan exec sebagai jenis yang disokong. Ubuntu 24.04 menyertakan systemd 255 dan Debian 13 menyertakan systemd 257, setakat Oktober 2026. Semak versi anda dengan systemctl --version dan manual systemd.service pengedaran tersebut.

Kosnya ialah satu langkah penyelarasan tambahan semasa permulaan. Kelebihannya ialah status keluar yang tepat daripada systemctl start. Bagi program latar depan (foreground), utamakan exec berbanding simple.

Type=forking, dan bagaimana PID utama boleh hilang

Type=forking memberitahu systemd bahawa proses dalam ExecStart= akan melakukan fork kepada child dan kemudian keluar dengan sengaja. systemd menunggu proses pertama itu keluar dan hanya selepas itu menganggap unit tersebut telah dimulakan. Child yang ditinggalkan itu ialah daemon. Tabiat tersebut berasal dari era SysV, apabila tiada apa-apa yang menyelia daemon sebaik sahaja skrip init kembali dan fail PID merupakan satu-satunya rekod tentang apa yang sedang berjalan, satu batasan yang terletak berhampiran dengan punca mengapa systemd menggantikan skrip init.

Kesukarannya ialah identiti. Proses yang dilancarkan oleh systemd sudah tiada, jadi systemd perlu menentukan yang mana satu antara yang terselamat adalah proses utama. Tetapkan PIDFile= kepada fail yang ditulis oleh daemon, biasanya laluan di bawah /run, dan systemd akan membaca PID daripadanya. Apabila fail tersebut dimiliki oleh pengguna yang tidak mempunyai keistimewaan (unprivileged), systemd juga akan menyemak sama ada PID di dalamnya merujuk kepada proses yang sudah pun tergolong dalam servis ini, supaya fail lama atau fail yang diletakkan untuk menamakan proses yang tidak berkaitan akan ditolak dan bukannya dipercayai.

Tanpa PIDFile=, GuessMainPID= akan digunakan, dan ia ditetapkan secara lalai kepada yes. Tekaan ini hanya boleh dipercayai apabila servis tersebut stabil dalam satu proses tunggal. Manual menyatakan hadnya dengan jelas: tekaan tersebut boleh membuat kesimpulan yang salah jika daemon terdiri daripada lebih daripada satu proses, dan jika PID utama tidak dapat ditentukan, pengesanan kegagalan dan permulaan semula automatik tidak akan berfungsi dengan boleh harap. Sesuatu unit juga boleh berakhir dengan PID utama 0, yang bermaksud systemd tidak menjejaki sebarang proses utama langsung, walaupun proses daemon masih berjalan dalam cgroup unit tersebut.

Kebanyakan daemon yang melakukan fork juga mempunyai suis yang mengekalkannya di latar depan (foreground). Gunakan suis tersebut dengan Type=exec dan padamkan baris PIDFile=. Lebih sedikit bahagian yang bergerak bermakna lebih sedikit cara untuk kehilangan PID tersebut.

Type=oneshot untuk tugasan yang selesai

Type=oneshot menjangkakan proses untuk berjalan dan tamat. systemd menganggap unit telah dimulakan hanya selepas ia tamat, yang menjadikan oneshot bentuk yang sesuai untuk apa-apa sahaja yang perlu ditunggu oleh unit lain. Ia juga merupakan tetapan lalai tersirat apabila unit tidak menyatakan Type= mahupun ExecStart=.

Dua kelakuan adalah khusus untuk oneshot. Ia merupakan satu-satunya jenis yang menerima lebih daripada satu baris ExecStart=, dan baris-baris tersebut berjalan mengikut urutan. Had masa permulaannya juga dinyahdayakan secara lalai, jadi oneshot yang tergantung akan menunggu selama-lamanya kecuali anda menetapkan TimeoutStartSec= sendiri.

Selepas proses tamat, unit kembali kepada status tidak aktif. RemainAfterExit=yes mengekalkannya sebagai active tanpa sebarang proses yang berjalan. Ini merupakan versi sengaja bagi simptom di bahagian atas halaman ini, dan ia adalah betul apabila tugas unit tersebut adalah untuk meninggalkan status tertentu dan bukannya mengekalkan sesuatu agar terus berjalan: memuatkan set peraturan firewall, atau menaikkan tindanan kontena. Ia adalah corak di sebalik tindanan Docker Compose yang kembali selepas but semula, di mana unit menjalankan perintah compose, tamat, dan kekal aktif kerana kontena yang dimulakannya terus berjalan walaupun unit tersebut telah tamat. Unit oneshot juga sesuai untuk tugasan yang dicetuskan mengikut jadual, yang merupakan separuh lagi daripada menjalankan tugasan pada systemd timer dan bukannya cron.

Type=notify membolehkan servis menyatakan apabila ia sudah bersedia

Type=notify memindahkan keputusan tersebut kepada servis. systemd menahan tugasan permulaan sehingga proses menghantar READY=1 melalui soket Unix yang laluannya diterima dalam pemboleh ubah persekitaran NOTIFY_SOCKET. Antara muka C ialah sd_notify(3), dan banyak pelayan sudah menyokongnya.

Ini adalah jawapan yang tepat bagi soalan "adakah ia sudah bermula". simple dan exec melaporkan ia sudah bermula sebelum servis membaca konfigurasinya atau membuka soket pendengar, jadi unit yang bergantung boleh bermula terlalu awal dan gagal pada sambungan pertamanya. notify melaporkan ia sudah bermula pada saat servis itu sendiri menyatakan ia sudah bersedia.

systemd menerima mesej tersebut daripada proses utama sahaja, itulah maksud NotifyAccess=main, dan Type=notify membayangkan perkara tersebut. Jika mesej datang daripada proses anak atau pembantu, tetapkan NotifyAccess=all. Skrip shell boleh memanggil systemd-notify --ready. Apabila ia mempunyai keistimewaan, systemd-notify menghantar mesej di bawah PID induknya, jadi skrip yang merupakan proses utama itu sendiri melepasi NotifyAccess=main; jika tidak, ia akan kembali kepada PID-nya sendiri dan unit tersebut memerlukan NotifyAccess=all. Secara lalai, ia menunggu sehingga systemd memproses mesej tersebut sebelum keluar, jadi abaikan --no-block, yang mematikan fungsi tunggu tersebut. Servis yang menggunakan protokol itu sendiri adalah lebih boleh dipercayai.

Dua tetapan berkaitan yang perlu diketahui. Type=notify-reload, yang tersedia sejak systemd 253, melanjutkan jabat tangan yang sama kepada muat semula (reloads), jadi systemctl reload akan kembali apabila servis melaporkan muat semula selesai dan bukannya kembali apabila isyarat dihantar. Sejak systemd 262, yang dikeluarkan pada September 2026, servis notify-reload yang menghantar READY=1 tanpa menangkap atau menyekat isyarat muat semulanya (SIGHUP melainkan ReloadSignal= menyatakan sebaliknya) akan gagal bermula dengan ralat protokol, dan bukannya dimatikan oleh isyarat tersebut pada muat semula pertamanya. WatchdogSec= meminta servis pemberitahuan untuk menghantar mesej keep-alive pada selang masa tertentu, dan systemd menganggap tarikh akhir yang terlepas sebagai kegagalan.

Type=dbus dan Type=idle

Type=dbus menunggu sehingga servis mengambil nama pada D-Bus, iaitu bas mesej yang digunakan oleh servis sistem dan desktop untuk berkomunikasi antara satu sama lain. Ia memerlukan BusName=, dan ia menjadi lalai sebaik sahaja BusName= ditetapkan. Gunakannya hanya untuk servis yang benar-benar mendaftarkan nama bas.

Type=idle berkelakuan seperti simple, tetapi ia melengahkan pelaksanaan program sehingga tugasan yang beratur telah dihantar, dengan had masa lima saat. Ia wujud supaya output konsol semasa but tidak bercampur dengan mesej status. Ia bukan alat penyusunan, dan ia tidak sesuai digunakan pada servis biasa.

Mengapa skrip pembungkus menyebabkan systemd tersalah mengesan PID

Berikut adalah bentuk yang menghasilkan simptom asal.

[Service]
Type=simple
ExecStart=/opt/app/run.sh
#!/bin/bash
export APP_ENV=production
/opt/app/bin/server --config /etc/app.yaml &
/opt/app/bin/exporter --port 9101

systemd merekodkan shell sebagai PID utama. Shell kekal hidup sementara exporter berjalan di latar depan. Jika server mati, shell tidak menyedarinya, jadi PID utama masih hidup, unit masih dianggap active, dan Restart= tidak mempunyai apa-apa untuk diambil tindakan. Kedua-dua proses kekal dalam cgroup unit sepanjang masa, jadi systemctl stop masih melakukan pembersihan dengan betul. Penyeliaan yang terjejas, bukan pembersihan.

Penyelesaiannya bergantung pada berapa banyak proses yang berjalan lama dalam unit tersebut.

Jika hanya ada satu, gantikan shell dengan proses tersebut.

#!/bin/bash
export APP_ENV=production
exec /opt/app/bin/server --config /etc/app.yaml

exec menggantikan shell dengan program yang dinamakan dan mengekalkan PID yang sama, jadi PID yang direkodkan oleh systemd kini milik daemon tersebut. Lebih baik lagi, buang pembungkus itu. Environment= dan EnvironmentFile= membawa pemboleh ubah, dan ExecStartPre= membawa langkah penyediaan, supaya systemd boleh melancarkan daemon secara terus dan mengetahui PID-nya melalui pembinaan.

Jika ada dua, tiada PID tunggal yang mewakili unit tersebut. Pecahkan kepada dua unit dan susun mengikut urutan dengan After= dan Wants=. Satu unit bagi setiap proses adalah aturan yang diselia dengan baik oleh systemd, dan ia merupakan satu-satunya cara setiap proses mendapat gelagat mulakan semula (restart) yang tersendiri.

Perubahan ExitType=cgroup

ExitType= telah ditambah dalam systemd 250. Nilai lalai ialah main: unit dianggap berhenti apabila proses utama tamat. Dengan ExitType=cgroup, unit dianggap berjalan selagi mana-mana proses dalam cgroup tersebut masih hidup.

[Service]
Type=simple
ExitType=cgroup
ExecStart=/opt/app/launcher

Ini menyelesaikan satu masalah khusus. Pelancar yang memulakan kerja sebenar dan kemudian keluar akan menyebabkan systemd menganggap unit tersebut telah berhenti dan mematikan proses yang masih hidup di bawah ExitType=main. Dengan ExitType=cgroup, unit tersebut mengikuti keseluruhan kumpulan sebaliknya.

Fahami perkara yang tidak diselesaikan oleh tetapan ini. ExitType=cgroup mengekalkan unit aktif selagi sekurang-kurangnya satu proses hidup, jadi unit yang memegang dua daemon akan kekal aktif selepas salah satu daripadanya mati. Ia membetulkan kes pelancar. Ia tidak mengubah satu unit menjadi penyelia bagi beberapa proses bebas. ExitType=cgroup juga tidak boleh digabungkan dengan Type=oneshot.

Cgroup juga merupakan tempat perakaunan sumber dilakukan, jadi had seperti MemoryMax= dan CPUQuota= terpakai kepada setiap proses yang dijana oleh unit tersebut, tidak kira apa yang Type= nyatakan mengenai PID utama. Bahagian tersebut diterangkan dalam mengehadkan memori dan CPU perkhidmatan dengan systemd.

Cara mencari proses yang sebenarnya dipantau oleh systemd

Lakukan langkah ini pada unit yang sedang anda nyahpepijat, mengikut urutan. Baca fail unit, kemudian baca perkara yang dijejaki oleh systemd, dan bandingkan dengan jadual proses.

systemctl cat app.service
systemctl show -p Type,ExitType,GuessMainPID,PIDFile,MainPID,RemainAfterExit app.service

systemctl cat mencetak fail unit bersama setiap drop-in yang terpakai padanya daripada cakera; ini mungkin berbeza daripada apa yang dimuatkan oleh systemd jika fail telah diubah tanpa daemon-reload. systemctl show mencetak nilai berkesan, termasuk nilai lalai yang tidak pernah anda tulis. Catatkan nilai MainPID sebelum meneruskan.

systemd-cgls --unit=app.service
ps -o pid,ppid,stat,etime,args -p "$(systemctl show -p MainPID --value app.service)"

systemd-cgls menyenaraikan setiap proses dalam cgroup unit tersebut. Baris ps menerangkan proses tunggal yang diselia oleh systemd. Baca kedua-duanya bersama-sama. MainPID bernilai 0 bermakna systemd tidak menjejaki sebarang proses utama, walaupun systemd-cgls masih menyenaraikan proses dalam cgroup unit tersebut. MainPID yang merujuk kepada shell sementara cgroup juga mengandungi daemon anda adalah kes wrapper di atas. Cgroup dengan lebih banyak proses daripada yang dijangkakan bermakna terdapat pelancar atau daemon forking yang terlibat.

systemctl status app.service
journalctl -u app.service -b

systemctl status mencetak baris status dan pepohon cgroup bersama-sama, jadi ia sering menjawab kedua-dua soalan serentak. journalctl -u yang dihadkan kepada but semasa dengan -b menunjukkan peristiwa mula dan henti yang direkodkan oleh systemd untuk unit tersebut, berserta kod keluar yang dilihatnya. Jika daemon menulis ke fail lognya sendiri dan bukannya journal, baca fail tersebut juga, kerana systemd hanya boleh merekodkan apa yang sampai kepadanya.

Apabila anda menukar Type=, muat semula dan mulakan semula.

systemd-analyze verify /etc/systemd/system/app.service
sudo systemctl daemon-reload
sudo systemctl restart app.service

systemd-analyze verify menghuraikan fail dan melaporkan tetapan yang tidak dapat diterimanya. daemon-reload menyebabkan systemd membaca semula fail unit daripada cakera. Type= yang diubah tidak terpakai pada unit yang sedang berjalan, jadi mulakan semula adalah wajib, bukan pilihan.

Kemudian uji perubahan tersebut. Ambil PID proses yang sebenarnya anda pedulikan daripada systemd-cgls dan tamatkannya. Jalankan systemctl is-active app.service serta-merta selepas itu. Dengan ExitType=main dan RemainAfterExit=no, menamatkan proses utama akan menamatkan tika yang sedang berjalan itu, walaupun polisi mulakan semula mungkin membawanya kembali sebelum anda sempat menyemak. Jika ia kekal aktif tanpa dimulakan semula, semak sama ada systemd sedang memantau sesuatu yang lain atau unit tersebut menggunakan ExitType=cgroup atau RemainAfterExit=yes.

Jenis Type= perkhidmatan systemd yang manakah perlu digunakan

  • Program yang kekal di latar depan: Type=exec.
  • Program yang menyokong pemberitahuan kesediaan: Type=notify, dan notify-reload jika ia turut mengesahkan muat semula (reload).
  • Daemon yang perlu beralih ke latar belakang: Type=forking dengan PIDFile=, atau suis latar depannya dengan Type=exec.
  • Skrip yang melaksanakan tugas dan keluar: Type=oneshot, ditambah RemainAfterExit=yes apabila tujuannya adalah untuk meninggalkan status (state) di belakang.
  • Pelancar yang keluar sementara anak prosesnya terus berjalan: Type=simple dengan ExitType=cgroup.

Jika anda tidak pasti jenis yang diperlukan oleh daemon pihak ketiga, baca fail unit yang dibekalkan terlebih dahulu. Menjalankan systemctl cat pada unit yang dibekalkan oleh pengedaran (distribution) akan memaparkan pilihan Type= yang ditetapkan bersama-sama dengan pengubahsuaian tempatan (local overrides).

FAQ

Mengapa unit systemd saya kekal aktif apabila proses telah mati?

Dengan ExitType=main dan RemainAfterExit=no lalai, perkara ini berlaku kerana proses yang dianggap sebagai proses utama oleh systemd masih hidup. Di bawah tetapan lalai tersebut, systemd mengikuti satu PID utama bagi setiap servis, yang dipilih mengikut Type=. Skrip pembungkus (wrapper script) yang dimulakan dengan Type=simple biasanya menjadi punca: shell tersebut merupakan PID utama, jadi unit kekal aktif walaupun daemon yang dilancarkan oleh shell di latar belakang telah tamat. Jalankan systemctl show -p MainPID app.service, kemudian senaraikan cgroup unit tersebut dengan systemd-cgls --unit=app.service, dan bandingkan kedua-duanya.

Apakah perbezaan antara Type=simple dan Type=exec?

Type=simple menganggap unit telah bermula sebaik sahaja systemd mencipta proses tersebut, sebelum binari dilaksanakan, jadi laluan yang salah dalam ExecStart= masih memberikan status permulaan yang berjaya diikuti dengan kegagalan. Type=exec menunggu sehingga pelaksanaan berjaya, supaya kegagalan dilaporkan oleh tugasan permulaan itu sendiri. Kedua-duanya menganggap proses yang sama sebagai PID utama. Type=exec diperkenalkan di peringkat hulu (upstream) dalam systemd 240, tetapi pengedaran (distributions) boleh melakukan backport ke versi yang lebih lama, seperti yang dilakukan oleh RHEL 8 dalam systemd-239-15.el8.

Adakah saya masih memerlukan PIDFile= dengan Type=forking?

Ya, pada bila-bila masa daemon menulis fail tersebut. Tanpanya, systemd akan kembali kepada GuessMainPID=, yang merupakan satu tekaan dan hanya boleh dipercayai untuk servis yang menetap dalam satu proses tunggal. Apabila tekaan tersebut salah atau mustahil, pengesanan kegagalan dan permulaan semula automatik tidak akan berfungsi dengan boleh harap untuk unit tersebut. Halakan PIDFile= ke laluan tepat yang ditulis oleh daemon, biasanya di bawah /run.

Bilakah saya perlu menggunakan RemainAfterExit=yes?

Apabila tujuan unit tersebut adalah untuk mengubah keadaan sistem dan bukannya untuk memastikan sesuatu proses terus berjalan. Unit Type=oneshot yang memuatkan peraturan firewall atau memulakan timbunan kontena akan tamat sebaik sahaja tugasnya selesai. Tanpa RemainAfterExit=yes, unit tersebut terus beralih daripada memulakan kepada menghentikan, jadi sebarang pembersihan ExecStop= akan dijalankan sebaik sahaja kerja selesai dan bukannya apabila anda memilih untuk menghentikan unit tersebut, dan systemctl stop tidak mempunyai apa-apa lagi untuk dihentikan. Dengan tetapan ini, unit kekal aktif tanpa sebarang proses, dan itulah yang dimaksudkan di sini.

Adakah menukar Type= memerlukan daemon-reload?

Ya, dan juga perlu memulakan semula unit tersebut. systemctl daemon-reload menyebabkan systemd membaca semula fail unit pada cakera, tetapi tika (instance) yang sedang berjalan mengekalkan Type= yang digunakan semasa ia bermula. Jalankan sudo systemctl daemon-reload dan kemudian sudo systemctl restart app.service sebelum melakukan ujian, jika tidak, anda masih memerhatikan gelagat penyeliaan yang lama.

Adakah artikel ini berguna?