SSD Nodes Learn Hosting plans →
Hướng dẫn Matt ConnorBởi Matt Connor

systemd Type=: chọn đúng simple, forking hay notify

Unit báo active nhưng daemon đã chết? Chọn đúng Type= simple, exec, forking, oneshot hoặc notify và xác định main PID thật thay vì theo dõi shell wrapper.

Vì sao systemd báo unit đang active khi process đã dừng

Với ExitType=main và RemainAfterExit=no mặc định, systemd giữ service unit ở trạng thái active khi process duy nhất mà systemd gọi là main process vẫn còn chạy, còn Type= trong phần [Service] quyết định process đó là process nào. Nếu chọn sai giá trị, systemd sẽ theo dõi một shell wrapper hoặc một process cha tồn tại trong thời gian ngắn, trong khi daemon bạn cần theo dõi lại dừng bên trong cùng unit. Unit đang báo đúng trạng thái của process mà nó được cấu hình để theo dõi.

Thay đổi restart policy sẽ không giải quyết được vấn đề này. Restart= phản ứng với việc process exit và các lỗi như timeout, nhưng không phát hiện daemon chạy nền đã dừng khi main PID (process identifier) thuộc về một process khác vẫn đang chạy. Trước hết, hãy sửa Type=. Việc systemd làm gì sau khi main process thực sự dừng là một quyết định riêng, được trình bày trong hướng dẫn về Restart= và RestartSec=.

Type= thực sự quyết định điều gì

Mỗi giá trị Type= trả lời đồng thời 2 câu hỏi. systemd được phép coi unit này đã khởi động khi nào, và process nào là process chính.

Câu trả lời thứ nhất kiểm soát thứ tự khởi động. Một unit khai báo unit của bạn trong After= sẽ chờ đến khi systemd đánh dấu unit của bạn đã khởi động. Một Type= báo “đã khởi động” quá sớm sẽ cho phép các unit phụ thuộc chạy trước khi service của bạn có thể phản hồi.

Câu trả lời thứ hai kiểm soát việc giám sát. systemd đưa mọi process mà một unit tạo ra vào một cgroup (control group), một tính năng của kernel dùng để nhóm các process để có thể giới hạn và kill chúng cùng lúc. cgroup là cách systemctl stop dọn dẹp: KillMode= mặc định là control-group, nên khi dừng một unit, systemd sẽ gửi signal đến mọi process bên trong unit đó. PID chính có phạm vi hẹp hơn. Với ExitType=main và RemainAfterExit=no mặc định, đây là process duy nhất mà khi thoát sẽ kết thúc unit, đồng thời status khi thoát của nó được tính vào kết quả của unit. Nhầm cgroup với PID chính là nguyên nhân bắt đầu gây ra sự nhầm lẫn.

Type=simple báo started trước khi binary chạy

Type=simple là giá trị mặc định khi ExecStart= được đặt, không có Type= và BusName=, đồng thời unit không sử dụng credential. Unit tải credential, chẳng hạn bằng LoadCredential=, sẽ ngầm dùng Type=exec thay thế. Với simple, systemd tạo process, lập tức xem unit là đã started và coi process đó là main PID. Các unit phụ thuộc sẽ bắt đầu ngay, trước cả khi service binary được thực thi.

Chi tiết này giải thích một lỗi thường gặp. Lỗi gõ sai đường dẫn ExecStart= vẫn tạo ra start job thành công, rồi lỗi mới xuất hiện ngay sau đó khi quá trình thực thi thất bại. systemd ghi nhận trường hợp này bằng exit code 203. Trong bảng của systemd, mã này có tên EXIT_EXEC và được định nghĩa là lỗi thực thi process thực tế. Vì vậy, việc systemctl start trả về không có lỗi không chứng minh binary của bạn tồn tại.

Dùng simple cho chương trình chạy ở foreground và không tự chuyển vào background. Hầu hết daemon hiện đại và gần như mọi chương trình bạn tự viết đều thuộc trường hợp này.

Type=exec chờ đến khi chương trình thực sự khởi động

Type=exec giống simple nhưng có thêm một bước. systemd chỉ xem unit đã khởi động sau khi cả thao tác fork và thực thi binary đều thành công. Binary bị thiếu hoặc User= không thể được resolve sẽ khiến chính start job thất bại ngay lúc đó, thay vì báo thành công rồi âm thầm thất bại một lúc sau.

Type=exec được upstream đưa vào systemd 240, nhưng các bản backport của distribution hỗ trợ tính năng này trên những phiên bản cũ hơn: RHEL 8 đã bổ sung nó trong systemd-239-15.el8. Các bản phát hành cũ được hỗ trợ vẫn có thể thiếu tính năng này: Ubuntu 18.04 vẫn được ESM đến tháng 4 năm 2028, và manual systemd 237 của nó không liệt kê exec là một type được hỗ trợ. Ubuntu 24.04 đi kèm systemd 255 và Debian 13 đi kèm systemd 257, tính đến tháng 10 năm 2026. Kiểm tra hệ thống của bạn bằng systemctl --version và manual systemd.service của distribution.

Cái giá phải trả là thêm một bước đồng bộ khi khởi động. Lợi ích là exit status chính xác từ systemctl start. Với chương trình chạy foreground, ưu tiên exec thay vì simple.

Type=forking và cách PID chính bị mất

Type=forking cho systemd biết rằng tiến trình trong ExecStart= sẽ fork một tiến trình con rồi chủ động thoát. systemd chờ tiến trình đầu tiên đó thoát, sau đó mới coi unit đã khởi động. Tiến trình con còn lại là daemon. Cách này bắt nguồn từ thời SysV, khi không có cơ chế nào giám sát daemon sau khi init script trả về và PID file là bản ghi duy nhất về tiến trình đang chạy, một hạn chế nằm gần trung tâm của lý do systemd thay thế init script.

Vấn đề nằm ở việc xác định danh tính. Tiến trình do systemd khởi chạy đã kết thúc, nên systemd phải xác định tiến trình còn lại nào là tiến trình chính. Đặt PIDFile= thành file mà daemon ghi vào, thường là một đường dẫn bên dưới /run, rồi systemd sẽ đọc PID từ file đó. Khi file này thuộc sở hữu của một user không có đặc quyền, systemd cũng kiểm tra xem PID trong file có trỏ đến một tiến trình đã thuộc service này hay không. Vì vậy, file cũ hoặc file bị đặt giả chứa PID của một tiến trình không liên quan sẽ bị từ chối thay vì được tin cậy.

Nếu không có PIDFile= thì GuessMainPID= được áp dụng và mặc định là yes. Cách suy đoán này chỉ đáng tin cậy khi service ổn định ở một tiến trình duy nhất. Tài liệu nêu rõ giới hạn này: kết quả có thể sai nếu daemon gồm nhiều hơn một tiến trình; và nếu không xác định được PID chính, việc phát hiện lỗi và tự động restart sẽ không hoạt động đáng tin cậy. Một unit cũng có thể có PID chính bằng 0. Điều đó nghĩa là systemd không theo dõi tiến trình chính nào, dù các tiến trình của daemon vẫn đang chạy trong cgroup của unit.

Hầu hết daemon có fork cũng có một tùy chọn để chạy ở foreground. Dùng tùy chọn đó với Type=exec rồi xóa dòng PIDFile=. Càng ít thành phần cần quản lý thì càng ít khả năng làm mất PID.

Type=oneshot cho tác vụ chạy xong rồi kết thúc

Type=oneshot dành cho tiến trình cần chạy rồi thoát. systemd chỉ xem unit là đã khởi động sau khi tiến trình đó thoát, nên oneshot phù hợp với mọi tác vụ mà unit khác phải chờ. Đây cũng là mặc định ngầm khi unit không khai báo Type= và ExecStart=.

oneshot có hai hành vi riêng. Đây là type duy nhất chấp nhận nhiều dòng ExecStart=, và các dòng đó chạy theo thứ tự. Timeout khởi động của nó cũng mặc định bị tắt. Vì vậy, oneshot bị treo sẽ chờ vô hạn nếu bạn không tự đặt TimeoutStartSec=.

Sau khi tiến trình thoát, unit trở về trạng thái inactive. RemainAfterExit=yes giữ unit ở trạng thái active dù hoàn toàn không có tiến trình đang chạy. Đây là phiên bản có chủ đích của hiện tượng được nêu ở đầu trang và là hành vi đúng khi nhiệm vụ của unit là để lại một trạng thái nào đó thay vì duy trì một tiến trình: nạp ruleset của firewall hoặc khởi động một container stack. Đây là mẫu được dùng trong Docker Compose stack tự khởi động lại sau reboot, trong đó unit chạy lệnh compose, thoát, rồi vẫn giữ trạng thái active vì các container do nó khởi động tiếp tục chạy sau khi unit kết thúc. Unit oneshot cũng phù hợp với các tác vụ được kích hoạt theo lịch. Đây là nửa còn lại của chạy một job bằng systemd timer thay vì cron.

Type=notify cho phép service báo khi đã sẵn sàng

Type=notify chuyển việc quyết định sang service. systemd giữ start job ở trạng thái chờ cho đến khi process gửi READY=1 qua Unix socket có đường dẫn được truyền trong biến môi trường NOTIFY_SOCKET. C interface là sd_notify(3), và nhiều server đã hỗ trợ interface này.

Đây là câu trả lời chính xác cho câu hỏi “đã khởi động chưa”. simple và exec báo started trước khi service đọc xong cấu hình hoặc mở listening socket. Vì vậy, unit phụ thuộc có thể khởi động quá sớm và thất bại ở lần kết nối đầu tiên. notify báo started đúng lúc service tự xác nhận đã sẵn sàng.

systemd chỉ chấp nhận message đó từ main process. Đây là ý nghĩa của NotifyAccess=main và cũng là điều Type=notify ngầm yêu cầu. Nếu message đến từ child hoặc helper, hãy đặt NotifyAccess=all. Shell script có thể gọi systemd-notify --ready. Khi có đủ quyền, systemd-notify gửi message với PID của parent. Vì vậy, nếu script tự là main process thì nó truyền NotifyAccess=main; nếu không, nó dùng PID của chính mình và unit cần NotifyAccess=all. Theo mặc định, lệnh này chờ systemd xử lý xong message rồi mới thoát. Vì vậy, hãy bỏ --no-block, tùy chọn này sẽ tắt việc chờ. Service tự triển khai protocol sẽ đáng tin cậy hơn.

Có 2 thiết lập liên quan đáng biết. Type=notify-reload, có từ systemd 253, mở rộng cùng cơ chế handshake cho thao tác reload. Vì vậy, systemctl reload chỉ trả về khi service báo reload đã hoàn tất, thay vì trả về ngay khi signal được gửi. Từ systemd 262, được phát hành vào tháng 9 năm 2026, service notify-reload gửi READY=1 mà không bắt hoặc block reload signal của nó (SIGHUP, trừ khi ReloadSignal= chỉ định khác) sẽ không khởi động và báo lỗi protocol, thay vì bị signal đó kill trong lần reload đầu tiên. WatchdogSec= yêu cầu service dùng notify gửi keep-alive message theo một khoảng thời gian. systemd xem việc bỏ lỡ deadline là một lỗi.

Type=dbus và Type=idle

Type=dbus chờ đến khi service đăng ký một name trên D-Bus, message bus mà các service hệ thống và desktop dùng để trao đổi với nhau. Nó yêu cầu BusName= và trở thành giá trị mặc định ngay khi đặt BusName=. Chỉ dùng nó cho service thực sự đăng ký một bus name.

Type=idle hoạt động giống simple, nhưng trì hoãn việc chạy chương trình cho đến khi các job đang xếp hàng được dispatch, với giới hạn tối đa 5 giây. Tùy chọn này tồn tại để output trên console trong lúc boot không xen vào các status message. Nó không phải công cụ ordering và không nên dùng cho service thông thường.

Vì sao wrapper script khiến systemd theo dõi nhầm PID

Đây là dạng cấu hình gây ra triệu chứng ban đầu.

[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 ghi nhận shell là PID chính. Shell vẫn chạy trong khi exporter chạy ở foreground. Nếu server dừng, shell không phát hiện được. Vì vậy PID chính vẫn còn, unit vẫn ở trạng thái active, và Restart= không có gì để xử lý. Cả hai process luôn nằm trong cgroup của unit, nên systemctl stop vẫn dọn dẹp đúng cách. Phần bị hỏng là cơ chế giám sát, không phải việc dọn dẹp.

Cách sửa phụ thuộc vào số process chạy lâu mà unit thực sự có.

Nếu chỉ có một process, hãy thay shell bằng process đó.

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

exec thay shell bằng program được chỉ định và giữ nguyên PID. Vì vậy PID mà systemd đã ghi nhận giờ thuộc về daemon. Tốt hơn nữa là bỏ wrapper. Environment= và EnvironmentFile= truyền các biến, còn ExecStartPre= thực hiện bước thiết lập. Nhờ đó systemd có thể khởi chạy daemon trực tiếp và biết PID của daemon ngay từ đầu.

Nếu có hai process, không có một PID duy nhất đại diện cho unit. Hãy tách chúng thành hai unit và sắp xếp thứ tự bằng After= và Wants=. Mỗi process một unit là cách bố trí mà systemd giám sát tốt nhất. Đây cũng là cách duy nhất để mỗi process có cơ chế restart riêng.

Thay đổi của ExitType=cgroup

ExitType= được thêm vào systemd 250. Mặc định là main: unit được xem là đã dừng khi process chính thoát. Với ExitType=cgroup, unit được xem là đang chạy chừng nào còn bất kỳ process nào trong cgroup của nó.

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

Điều này giải quyết một vấn đề cụ thể. Một launcher khởi chạy công việc thực rồi thoát sẽ khiến systemd xem unit là đã dừng và kill các process còn lại khi dùng ExitType=main. Với ExitType=cgroup, unit theo dõi toàn bộ group thay vì chỉ process launcher.

Cần hiểu rõ những gì tùy chọn này không giải quyết. ExitType=cgroup giữ unit ở trạng thái active khi còn ít nhất một process đang chạy, nên unit chứa hai daemon vẫn active sau khi một daemon bị dừng. Nó xử lý trường hợp launcher. Nó không biến một unit thành supervisor cho nhiều process độc lập. ExitType=cgroup cũng không thể dùng cùng với Type=oneshot.

cgroup cũng là nơi ghi nhận việc sử dụng tài nguyên. Vì vậy, các giới hạn như MemoryMax= và CPUQuota= áp dụng cho mọi process do unit khởi chạy, bất kể Type= quy định thế nào về main PID. Phần này được trình bày trong giới hạn memory và CPU của service bằng systemd.

Cách tìm tiến trình mà systemd thực sự đang giám sát

Thực hiện lần lượt các bước này trên unit bạn đang debug. Đọc các unit file trước, sau đó xem systemd đang theo dõi gì, rồi đối chiếu với process table.

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

systemctl cat in unit file cùng với mọi drop-in áp dụng cho unit đó trên disk. Các file này có thể khác với nội dung systemd đã load nếu chúng bị thay đổi mà không có một lần daemon-reload. systemctl show in các giá trị hiệu dụng, bao gồm cả những giá trị mặc định bạn chưa ghi rõ. Ghi lại giá trị của MainPID trước khi tiếp tục.

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

systemd-cgls liệt kê mọi process trong cgroup của unit. Dòng ps mô tả process duy nhất mà systemd giám sát. Đọc hai kết quả này cùng nhau. Giá trị MainPID bằng 0 nghĩa là systemd không theo dõi main process nào, ngay cả khi systemd-cgls vẫn liệt kê các process trong cgroup của unit. Nếu MainPID trỏ đến một shell trong khi cgroup cũng chứa daemon của bạn, đó là trường hợp wrapper nêu trên. Nếu cgroup có nhiều process hơn dự kiến, một launcher hoặc daemon chạy theo kiểu fork đang được sử dụng.

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

systemctl status in state line và cây cgroup cùng nhau, nên thường trả lời được cả hai câu hỏi. Giới hạn journalctl -u vào lần boot này bằng -b sẽ hiển thị các sự kiện start và stop mà systemd ghi nhận cho unit, cùng với exit code mà nó thấy. Nếu daemon ghi vào log file riêng thay vì journal, hãy đọc cả file đó, vì systemd chỉ có thể ghi nhận những gì đã truyền đến nó.

Khi thay đổi Type=, hãy reload rồi restart.

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

systemd-analyze verify phân tích file và báo cáo các setting mà nó không chấp nhận. daemon-reload yêu cầu systemd đọc lại unit file từ disk. Type= đã thay đổi không áp dụng cho unit đang chạy, vì vậy restart là bắt buộc.

Sau đó kiểm tra thay đổi. Lấy PID của process bạn thực sự cần theo dõi từ systemd-cgls rồi kill process đó. Chạy systemctl is-active app.service ngay sau đó. Với ExitType=main và RemainAfterExit=no, việc kill main process sẽ kết thúc instance đang chạy, mặc dù restart policy có thể khởi động lại nó trước khi bạn kiểm tra. Nếu unit vẫn active mà không restart, hãy kiểm tra xem systemd có đang theo dõi một process khác không, hoặc unit có dùng ExitType=cgroup hay RemainAfterExit=yes không.

Nên dùng Type= nào cho service systemd

  • Chương trình chạy ở foreground: Type=exec.
  • Chương trình hỗ trợ thông báo readiness: Type=notify, và notify-reload nếu chương trình cũng xác nhận việc reload.
  • Daemon bắt buộc chuyển sang background: Type=forking với PIDFile=, hoặc dùng tùy chọn chạy foreground của nó với Type=exec.
  • Script thực hiện công việc rồi thoát: Type=oneshot, thêm RemainAfterExit=yes khi mục đích là để lại state.
  • Launcher thoát trong khi các tiến trình con vẫn tiếp tục chạy: Type=simple với ExitType=cgroup.

Nếu không chắc daemon của bên thứ ba cần loại nào, trước tiên hãy đọc unit file đi kèm package. Chạy systemctl cat trên unit do distribution cung cấp sẽ hiển thị lựa chọn Type= trong package cùng các override cục bộ.

FAQ

Vì sao unit systemd của tôi vẫn ở trạng thái active khi tiến trình đã dừng?

Với ExitType=main và RemainAfterExit=no mặc định, nguyên nhân là tiến trình mà systemd xem là tiến trình chính vẫn còn chạy. Theo các mặc định này, systemd theo dõi một PID chính duy nhất cho mỗi service, được chọn theo Type=. Script wrapper được khởi động bằng Type=simple là nguyên nhân thường gặp: shell là PID chính, nên unit vẫn ở trạng thái active khi daemon do shell khởi động ở background đã thoát. Chạy systemctl show -p MainPID app.service, sau đó liệt kê cgroup của unit bằng systemd-cgls --unit=app.service và so sánh hai kết quả.

Type=simple và Type=exec khác nhau thế nào?

Type=simple xem unit đã khởi động ngay khi systemd tạo tiến trình, trước khi binary được thực thi. Vì vậy, đường dẫn sai trong ExecStart= vẫn tạo ra một start job thành công, rồi mới báo lỗi. Type=exec chờ đến khi việc thực thi thành công, nên start job tự báo lỗi đó. Cả hai đều xem cùng một tiến trình là PID chính. Type=exec được giới thiệu upstream trong systemd 240, nhưng các bản phân phối có thể backport tính năng này vào các phiên bản cũ hơn, như RHEL 8 đã làm trong systemd-239-15.el8.

Tôi còn cần PIDFile= khi dùng Type=forking không?

Có, nếu daemon ghi file PID. Nếu không có file này, systemd chuyển sang GuessMainPID=. Đây chỉ là một phỏng đoán và chỉ đáng tin cậy với service ổn định ở một tiến trình duy nhất. Khi phỏng đoán sai hoặc không thể thực hiện, việc phát hiện lỗi và tự động restart không hoạt động đáng tin cậy với unit đó. Trỏ PIDFile= đến đúng đường dẫn mà daemon ghi, thường nằm dưới /run.

Khi nào nên dùng RemainAfterExit=yes?

Dùng khi mục đích của unit là thay đổi trạng thái hệ thống thay vì duy trì một tiến trình chạy. Một unit Type=oneshot tải các rule của firewall hoặc khởi động một container stack sẽ thoát ngay khi hoàn tất công việc. Nếu không có RemainAfterExit=yes, unit chuyển thẳng từ trạng thái starting sang stopping. Vì vậy, mọi hoạt động cleanup bằng ExecStop= sẽ chạy ngay sau khi công việc hoàn tất thay vì chạy khi bạn chủ động stop unit, và systemctl stop không còn gì để dừng. Khi có tùy chọn này, unit vẫn ở trạng thái active dù không có tiến trình nào. Đây là hành vi được mong muốn trong trường hợp này.

Thay đổi Type= có cần daemon-reload không?

Có, đồng thời cũng cần restart unit. systemctl daemon-reload yêu cầu systemd đọc lại các unit file trên disk, nhưng instance đang chạy vẫn giữ Type= mà nó đã khởi động cùng. Chạy sudo systemctl daemon-reload rồi sudo systemctl restart app.service trước khi kiểm tra. Nếu không, bạn vẫn đang theo dõi hành vi supervision cũ.

Bài viết này có hữu ích không?