linux systemd 服务管理器的使用

453 字

2 分钟

linux systemd 服务管理器的使用

2026-03-17

笔记

fastapi

/

python

/

环境搭建

/

linux

参考了以下文章, 写得超好!

简要命令#

重载 systemd 配置#

重载所有 unit 文件（常用）

1
sudo systemctl daemon-reload

启动服务并设置开机启动#

1
sudo systemctl start myapp.service
2
sudo systemctl enable myapp.service

查看服务状态与日志#

1
sudo systemctl status myapp
2
sudo journalctl -fu myapp

列出所有服务#

1
systemctl list-units --type=service

systemd 用户模式 (好用!)#

简单说，systemd 不只是给 root 用的。每个登录用户都可以跑自己的 systemd —user 实例，用来管理用户级别的后台服务和定时任务——不需要 sudo。

用户单元文件放在以下目录：

目录	用途
`~/.config/systemd/user/`	用户自定义的服务(推荐!)
`~/.local/share/systemd/user/`	用户安装的服务
`/usr/lib/systemd/user/`	系统提供的用户服务模板

所有操作都带 —user 参数，和系统级的 systemctl 用法几乎一样：

1
systemctl --user start my-app       # 启动
2
systemctl --user stop my-app        # 停止
3
systemctl --user restart my-app     # 重启
4
systemctl --user status my-app      # 查看状态
5
systemctl --user enable my-app      # 开机自启
6
systemctl --user daemon-reload      # 重新加载配置

有一个前提：必须启用 linger，否则用户注销后所有用户服务都会被杀掉：

1
sudo loginctl enable-linger $USER
2
loginctl show-user $USER | grep Linger   # 确认输出 Linger=yes

systemd文件配置示例#

以这个博客的fastapi服务文件为例

1
[Unit]
2
Description=Blog Fastapi Service
3
After=network.target
4

5
[Service]
6
WorkingDirectory=/home/mint/web/blog_backend/app
7
Environment="PATH=/home/mint/web/blog_backend/.venv/bin:/usr/local/bin:/usr/bin"
8
Environment="FASTAPI_DEPLOY=DEPLOY"           # 用于区分测试和部署环境
9
Environment="SMTP_USER=******"                # 以下均是通过环境变量引入敏感数据
10
Environment="SMTP_PASSWORD=******"
11
Environment="SECRET_KEY=******"
12
Environment="DB_USER=******"
13
Environment="DB_PASSWORD=******"
14
Environment="DB_NAME=******"
15
Environment="DB_HOST=******"
16
Environment="DB_SCHEMA=******"
17
ExecStart=/home/mint/web/blog_backend/.venv/bin/gunicorn \
18
          -w 4 \
19
          -k uvicorn.workers.UvicornWorker \
20
          --bind localhost:8051 \
21
          --log-file=- \
22
          main:app
23
StandardOutput=journal                        # 将控制台输出重定向到journal
24
Restart=always                                # 自动重启
25
RestartSec=10
26
LimitNOFILE=4096
27

28
[Install]
29
WantedBy=default.target