gflowd 参考
gflowd 用于管理本地 gflow 守护进程。
用法
bash
gflowd [options] [command]
gflowd completion <shell>常见示例
bash
# 交互式初始化配置
gflowd init
# 使用默认值无交互初始化
gflowd init --yes
# 启动守护进程
gflowd start
# 只使用部分 GPU，并启用随机分配策略
gflowd start --gpus 0,2 --gpu-allocation-strategy random
# 更快检测 GPU 占用变化
gflowd start --gpu-poll-interval-secs 3
# 安装可选的 systemd user service（开机自启 + 崩溃拉起）
gflowd service install
# 无停机热重载
gflowd reload
# 重启并更新 GPU 限制
gflowd restart --gpus 0-3
# 查看状态或停止守护进程
gflowd status
gflowd stop全局选项
-c, --config <path>：使用自定义配置文件--cleanup：清理配置文件-v/-vv/-vvv/-vvvv：提高守护进程日志级别-q：降低守护进程日志级别
子命令
gflowd init
通过向导创建或更新配置文件。
bash
gflowd init [--yes] [--force] [--advanced] [--gpus <indices>] [--host <host>] [--port <port>] [--timezone <tz>] [--gpu-allocation-strategy <strategy>] [--gpu-poll-interval-secs <seconds>]选项：
--yes：接受所有默认值，不进入交互--force：覆盖已存在的配置文件--advanced：配置通知等高级选项--gpus <indices>：限制调度器可见的 GPU，例如0,2或0-2--host <host>：守护进程地址，默认localhost--port <port>：守护进程端口，默认59000--timezone <tz>：写入配置的时区，例如Asia/Shanghai或UTC；传local表示保持未设置--gpu-allocation-strategy <strategy>：sequential或random--gpu-poll-interval-secs <seconds>：每隔 N 秒轮询一次 NVML 检查 GPU 占用变化（默认10，最小1）
gflowd start
启动守护进程。托管方式自动选择：已安装 systemd user service 则走 systemd， 否则用 tmux，否则直接以独立进程方式启动。
bash
gflowd start [--gpus <indices>] [--gpu-allocation-strategy <strategy>] [--gpu-poll-interval-secs <seconds>]保留 up 作为 start 的别名。
gflowd reload
无停机重载守护进程。
bash
gflowd reload [--gpus <indices>] [--gpu-allocation-strategy <strategy>] [--gpu-poll-interval-secs <seconds>]适合在不中断服务的情况下刷新正在运行的守护进程。
gflowd restart
先停止，再重新启动守护进程。
bash
gflowd restart [--gpus <indices>] [--gpu-allocation-strategy <strategy>] [--gpu-poll-interval-secs <seconds>]适合可以接受完整重启的场景。
gflowd status
显示守护进程是否在运行，以及当前托管方式（systemd user service、tmux 或 直接进程），并展示从运行中的守护进程获取的摘要（版本、PID、运行时长、 执行器、GPU 可用情况）。
bash
gflowd status以 systemd user service 方式托管时的示例：
text
Status: Running
Hosting: systemd user service (gflowd.service).
Version: 0.4.17
PID: 3628801
Uptime: 25h57m21s
Executor: tmux
GPUs: 8 total, 8 availablegflowd stop
停止守护进程。
bash
gflowd stop保留 down 作为 stop 的别名。
gflowd service
管理可选的 systemd user service，提供开机自启与崩溃自动拉起。
bash
gflowd service install [--gpus <indices>] [--gpu-allocation-strategy <strategy>] [--gpu-poll-interval-secs <seconds>]
gflowd service uninstallinstall 会写入 ~/.config/systemd/user/gflowd.service、重载 systemd 并执行 enable --now。需要 systemd user manager；在没有 systemd 的系统上会给出明确 提示并回退到 tmux/直接进程托管。
gflowd completion <shell>
生成 shell 自动补全脚本。
bash
gflowd completion bash
gflowd completion zsh
gflowd completion fish说明
--gpus控制调度器为新任务分配哪些 GPU。--gpu-allocation-strategy可选sequential或random。--gpu-poll-interval-secs控制检测非 gflow GPU 占用变化的速度。start、reload、restart三个子命令都支持相同的 GPU 相关覆盖参数。- 在直接进程托管模式（无 systemd、无 tmux）下，daemon 会在运行时目录对
gflowd.lock持有排他flock。该锁既是互斥信号（重复up会被拒绝）， 也是崩溃安全的存活信号：daemon 退出时锁会自动释放，因此status不会误报 残留实例。锁文件同时记录 daemon 身份（pid+pgid+ 进程启动时间）；down/restart在发信号前会校验身份，从而绝不会对已被复用的 PID 误发 SIGTERM/SIGKILL。这取代了旧的纯 PIDgflowd.pid，后者不再写入或读取。