nexus/wiki/concepts/launchd.md

launchd

macOS 原生服务管理器，用于管理系统级和用户级守护进程（daemons）和代理（agents）。

Overview

launchd 是 macOS 的核心初始化系统和服务管理器，替代了传统的 Unix init (SysV)、BSD rc 和 xinetd。它负责在系统启动时启动系统级服务，并在用户登录时启动用户级服务。

Key Concepts

• Daemon（守护进程）：系统级后台服务，在系统启动时运行，无需用户登录
• Agent（代理）：用户级后台服务，随用户登录启动
• LaunchAgent：用户级代理，存放在 ~/Library/LaunchAgents/
• LaunchDaemon：系统级守护进程，存放在 /Library/LaunchDaemons/
• plist 文件：Property List 格式的配置文件，定义服务参数

launchctl Commands

# 加载服务（启动）
launchctl load ~/Library/LaunchAgents/com.frpc.client.plist

# 卸载服务（停止）
launchctl unload ~/Library/LaunchAgents/com.frpc.client.plist

# 启动服务
launchctl start com.frpc.client

# 停止服务
launchctl stop com.frpc.client

# 列出所有已加载的服务
launchctl list

# 查看服务状态
launchctl print gui/$UID/com.frpc.client

plist Configuration Example

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN"
"http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
    <key>Label</key>
    <string>com.frpc.client</string>

    <key>ProgramArguments</key>
    <array>
        <string>/opt/frp/frp_0.65.0_darwin_arm64/frpc</string>
        <string>-c</string>
        <string>/opt/frp/frp_0.65.0_darwin_arm64/frpc.toml</string>
    </array>

    <key>RunAtLoad</key>
    <true/>

    <key>KeepAlive</key>
    <true/>

    <key>StandardOutPath</key>
    <string>/opt/frp/frp_0.65.0_darwin_arm64/frpc.log</string>

    <key>StandardErrorPath</key>
    <string>/opt/frp/frp_0.65.0_darwin_arm64/frpc.error.log</string>
</dict>
</plist>

Key Properties

属性	说明
Label	唯一标识符
ProgramArguments	要执行的命令及参数数组
RunAtLoad	是否在加载时立即启动
KeepAlive	是否保持持续运行（崩溃后自动重启）
StandardOutPath	标准输出日志路径
StandardErrorPath	错误输出日志路径
WorkingDirectory	工作目录

Comparison with Other Service Managers

特性	launchd	systemd (Linux)	tmux	nohup
系统级服务	✅	✅	❌	❌
用户级服务	✅	✅	❌	❌
开机自启	✅	✅	❌	❌
持久会话	❌	❌	✅	❌
简单后台	❌	❌	❌	✅
崩溃重启	✅	✅	❌	❌

Use Cases in Home Server

• FRP 客户端：开机自启的内网穿透服务
• N8n：自动化工作流服务
• OpenClaw：AI Agent 服务
• Home Assistant：智能家居控制中心

Best Practices

1. 使用 LaunchAgents（而非 LaunchDaemons）：用户级代理更安全，权限更少
2. 配置 KeepAlive：确保服务崩溃后自动重启
3. 设置日志路径：便于故障排查
4. 使用软链接版本路径：便于升级时不修改 plist
5. 定期检查服务状态：确保服务正常运行

Related Concepts

• frp — 内网穿透工具，常用 launchd 管理
• Gatekeeper — macOS 安全机制
• Mac Mini M4 — 常使用 launchd 管理 Home Server 服务

References

• Apple Developer Documentation: Daemons and Services
• man launchd.plist
• man launchctl