How To
配置系统服务
将 Sink 配置为开机自启的系统服务
本指南说明如何将 Sink 配置为系统服务，使其在登录时自动启动。
- Linux：systemd 用户服务
- macOS：launchctl 用户代理
安装服务
sink service install
Linux 上会询问是否启用
loginctl linger（允许在无活跃登录会话时运行服务）。
安装后的服务文件位置：
- Linux：
~/.config/systemd/user/sink.service - macOS：
~/Library/LaunchAgents/com.sink.server.plist
启用并启动
Linux：
# 等价于 systemctl --user enable --now sink.service
sink service enable --now
macOS：service install 已通过 launchctl bootstrap
自动加载并启动服务。--now 标志在 macOS 上无效。运行以下命令确认状态：
sink service status
日常操作
sink service status # 查看状态
sink service stop # 停止
sink service start # 启动
sink service restart # 重启
sink service disable # 禁用开机自启（保留服务文件）
sink service uninstall # 卸载（停止、禁用并删除服务文件）
Linux 上也可直接使用 systemctl：
systemctl --user status sink
systemctl --user restart sink
故障排除
Gateway 端口被占用
lsof -i :5000 # 查看占用 5000 端口的进程
在 ~/sink/gateway.json 中修改端口，或启动时指定：
sink gateway start --port 8080