systemd socket activation怎么配置或排查

想让 Linux 服务“有连接才启动”，关键不是给 service 加一个特殊参数，而是把监听端口交给同名的 .socket 单元，再让 .service 从 systemd 传入的文件描述符接管它。下面用一个最小 Python 回显服务配置 127.0.0.1:9090：socket 负责监听，首次连接负责激活 service，应用从 fd 3 接收监听对象。

先把 .socket 和 .service 配成一对

先准备服务脚本。它不调用 bind()，而是检查 systemd 设置的 LISTEN_PID、LISTEN_FDS，再把 fd 3 包装成 Python socket。这里的 Accept=no 与代码中的 accept() 是配套的。

import os
import socket

# systemd 的第一个监听 fd 从 3 开始；先拒绝手动启动时的错误环境。
if os.environ.get("LISTEN_PID") != str(os.getpid()):
    raise SystemExit("LISTEN_PID 不匹配，请由 systemd 激活")

fd_count = int(os.environ.get("LISTEN_FDS", "0"))
if fd_count != 1:
    raise SystemExit(f"期望 1 个监听 fd，实际得到 {fd_count}")

# 不重新 bind 端口，直接接管 systemd 传入的监听 socket。
listener = socket.fromfd(3, socket.AF_INET, socket.SOCK_STREAM)
while True:
    connection, address = listener.accept()
    with connection:
        connection.recv(1024)
        connection.sendall(b"socket activation ok\\n")

把脚本保存为 /opt/socket-echo/server.py 后，创建两个 unit。文件名必须对应：socket-echo.socket 默认会触发 socket-echo.service。

# /etc/systemd/system/socket-echo.socket
[Unit]
Description=Socket for the demo echo service

[Socket]
ListenStream=127.0.0.1:9090
Accept=no

[Install]
WantedBy=sockets.target

# /etc/systemd/system/socket-echo.service
[Unit]
Description=Demo socket activated echo service
Requires=socket-echo.socket
After=socket-echo.socket

[Service]
Type=simple
ExecStart=/usr/bin/python3 /opt/socket-echo/server.py
Restart=on-failure

用一次连接触发 service

刷新 unit 后只启动 socket，不要先启动 service。这样才能观察按需激活是否成立。

# 重新加载 unit 文件，并让 socket 立即监听、开机自动启用。
sudo systemctl daemon-reload
sudo systemctl enable --now socket-echo.socket

# 端口此时应该已经由 systemd 监听，但 service 可能还没有进程。
sudo systemctl status socket-echo.socket --no-pager
ss -ltnp | grep ':9090'

# 发起一次连接；nc 只负责连接并发送一行测试数据。
printf 'hello\\n' | nc 127.0.0.1 9090

# 连接后再查看被激活的 service。
sudo systemctl status socket-echo.service --no-pager
sudo journalctl -u socket-echo.service -n 30 --no-pager

预期响应是 socket activation ok。判断成功时不要只看 service：第一次连接前，socket-echo.socket 应该是 active/listening；连接后，socket-echo.service 才出现运行状态。若应用退出，socket 仍可保留，下一次连接会再次尝试激活。

用三层检查定位“配置了却不启动”

最容易忽略的是最后一行：Accept=no 是一个长生命周期服务接收监听 fd；Accept=yes 则是每个连接启动一个实例，通常要配合模板 service，并让程序处理已连接的 fd。两种模式不能只改 unit 中的一行就混用。

如果改过 unit，先执行 daemon-reload；如果改过监听地址或怀疑旧状态干扰，执行下面的完整重置，再重新启动 socket：

# 停掉实例和监听端口，避免旧 socket 状态影响下一次测试。
sudo systemctl stop socket-echo.service socket-echo.socket
sudo systemctl daemon-reload
sudo systemctl start socket-echo.socket

# 查看 systemd 实际解析后的关键值，而不是只看磁盘文件。
systemctl cat socket-echo.socket
systemctl show socket-echo.socket -p Listen -p Accept

# 观察下一次激活的实时日志；按 Ctrl+C 退出日志查看。
sudo journalctl -fu socket-echo.service

常见问题

为什么直接运行 Python 脚本会失败？

因为脚本把 systemd 传入的 LISTEN_PID 和 LISTEN_FDS 当作前置条件。直接运行没有 fd 3，也没有匹配的环境变量；测试时应从 socket 单元发起连接。

为什么 systemctl start socket-echo.service 后端口不通？

手动启动 service 不等于启动 socket。应先 systemctl start socket-echo.socket，让 systemd 创建监听端口，再由连接触发 service。

什么时候应该使用 Accept=yes？

只有当程序按“一个连接一个 service 实例”设计时才考虑它。普通常驻服务一般使用 Accept=no，由同一个进程持有监听 socket 并循环 accept()。