systemd 定时器与 Socket 激活：OnCalendar 语法与按需拉起

# /etc/systemd/system/backup.timer
[Unit]
Description=Daily backup trigger
Requires=backup.service

[Timer]
Unit=backup.service              # 默认就是同名 .service，可省略
OnCalendar=*-*-* 02:30:00

[Install]
WantedBy=timers.target

# /etc/systemd/system/backup.service
[Unit]
Description=Run backup script

[Service]
Type=oneshot                    # 一次性任务，执行完即退
ExecStart=/usr/local/bin/backup.sh

# 启用的是 timer，不是 service
sudo systemctl daemon-reload
sudo systemctl enable --now backup.timer
systemctl list-timers --all      # 列出所有定时器及下次触发时间

[Timer]
OnCalendar=Mon..Fri 09:00        # 工作日 9 点
OnCalendar=*-*-* 00/6:00:00      # 每 6 小时（00/6 表示从 0 起每 6）
OnCalendar=*-*-01 03:00:00       # 每月 1 号 3 点
OnCalendar=Sat,Sun 12:00         # 周六日中午

# 用 systemd-analyze 校验并显示接下来的触发时间
systemd-analyze calendar "Mon..Fri *-*-* 09:00"
# 输出包含 Next elapse / Iteration 等，一眼看出是否写错
systemd-analyze calendar --iterations=5 "*-*-* 00/6:00:00"

# 单调定时器：开机 15 分钟后首次，之后每 1 小时
[Timer]
OnBootSec=15min
OnUnitActiveSec=1h
AccuracySec=1min

# 墙上时钟定时器：每天凌晨
[Timer]
OnCalendar=daily
Persistent=true

[Timer]
OnCalendar=*-*-* 03:00:00     # 每天 3 点
OnBootSec=30min               # 或开机 30 分钟后

[Timer]
AccuracySec=1s        # 收紧到 1 秒（更准，但更耗电/更集中）
RandomizedDelaySec=10m # 额外随机延迟，防「惊群」
Persistent=true       # 关机错过的触发，开机后补跑一次

# 查看持久化时间戳
ls -l /var/lib/systemd/timers/
# 手动重置「上次触发」记录
sudo touch /var/lib/systemd/timers/stamp-backup.timer

# 立刻以瞬时服务运行（走 cgroup，可用 systemctl status 查看）
systemd-run --unit=myjob /usr/local/bin/task.sh

# 定时执行：10 分钟后跑一次
systemd-run --on-active=10min --unit=delayed /usr/local/bin/task.sh

# 每天 3 点跑，持久化
systemd-run --on-calendar="*-*-* 03:00:00" --timer-property=Persistent=true \
            --unit=dailyjob /usr/local/bin/task.sh

# 带资源限制的瞬时任务
systemd-run --scope -p MemoryMax=512M -p CPUQuota=50% /usr/local/bin/heavy.sh

# 查看与管理瞬时单元
systemctl list-timers --all | grep run-
systemctl status run-dailyjob.timer
systemctl stop run-dailyjob.timer     # 取消瞬时定时任务

无 socket 激活：  服务进程 bind/listen/accept（重启期间端口不可用）
socket 激活：     systemd 常驻 listen → 连接到达 → 拉起服务 + 传 FD → 服务直接 accept
                  （重启服务时端口始终由 systemd 持有，连接不丢）

#include <systemd/sd-daemon.h>
int n = sd_listen_fds(0);      /* 返回传给本进程的 FD 数量 */
for (int i = 0; i < n; i++) {
    int fd = SD_LISTEN_FDS_START + i;   /* 即 3 + i */
    /* 这个 fd 已经 bind+listen 好了，直接 accept */
}

# /etc/systemd/system/myapp.socket
[Unit]
Description=My app socket

[Socket]
ListenStream=8080                 # TCP 端口
# ListenStream=/run/myapp.sock    # 或 Unix 域套接字
Accept=no                         # 默认：服务自己 accept
Backlog=4096

[Install]
WantedBy=sockets.target

# /etc/systemd/system/myapp.service
[Unit]
Requires=myapp.socket
After=myapp.socket

[Service]
ExecStart=/usr/bin/myapp --listen-fd

Accept=no  （默认）→ 传「监听套接字」给服务，服务自己 accept 循环
                    一个服务实例处理所有连接（常驻、高效）

Accept=yes        → systemd 自己 accept，把「已连接套接字」传给每个新实例
                    每连接一个进程（简单、隔离好、开销大）
                    此时服务用 StandardInput=socket 读写连接

# Accept=yes 时服务模板写法
[Service]
StandardInput=socket
ExecStart=/usr/bin/handler

# 1) 外层 socket 单元
# /etc/systemd/system/proxy.socket
[Socket]
ListenStream=80

[Install]
WantedBy=sockets.target

# 2) 代理服务：把连接转发到真正的后端端口
# /etc/systemd/system/proxy.service
[Service]
ExecStart=/usr/lib/systemd/systemd-socket-proxyd --exit-idle-time=5min 127.0.0.1:8080

sudo systemctl enable --now proxy.socket
# 后端 myapp 可以随时重启，外部 80 端口连接由 proxy 缓存，不丢
sudo systemctl restart myapp

# 定时器为什么不触发？
systemctl list-timers --all
systemd-analyze calendar "..."          # 表达式是否合法
systemctl status myapp.timer            # timer 自身状态
journalctl -u myapp.service --since today

# socket 激活排错
systemctl status myapp.socket
systemctl list-sockets                  # 所有 socket 单元及监听地址
ss -tlnp | grep 8080                    # 确认是 systemd 在 listen
journalctl -u myapp.socket -u myapp.service

# 看服务是否真的拿到了 FD
systemctl show myapp.service -p Environment
cat /proc/<pid>/environ | tr '\0' '\n' | grep LISTEN