Problem entry · machine-readable · 编码代理与终端

`herdr server start` 无效 / 后台 server 未拉起(v0.8.2 没有 server start 子命令)

本页嵌入 #trove-entity JSON(本条目全量结构化数据);全库数据见 /agent/trove.json。

元数据

idherdr-1收录2026-09-19
问题域编码代理与终端主题分组Agent 工具·运行与配置
适用工具herdr

症状

输入 `herdr server start` 不启动 server,只打印 server 子命令列表(help 文本);`herdr status` 显示 `server: not running`;`~/.config/herdr/` 下没有 `herdr.sock`。

原因

v0.8.2 命令面里**不存在 `server start` 子命令**。正确启动面有两个:

- `herdr`(TUI 完整客户端)——正常使用路径,自动拉起后台 server;

- `herdr server`(headless)——前台运行 server,脚本化时用 `nohup herdr server &` 放后台;

- 停止面 = `herdr server stop`(经 API socket);确认面 = `herdr status`(server: running / not running)。

解法

1. 交互使用:直接 `herdr` 开 TUI(server 自动拉起),无需显式 start。

2. 脚本化:`nohup herdr server > /tmp/herdr-server.log 2>&1 &`,然后 `herdr status` 确认 running。

3. 停止:`herdr server stop`;再次 `herdr status` 确认 not running。

4. 写面确认:`~/.config/herdr/` 下应出现 `.plugins.lock`、`herdr-client.sock`、`herdr.sock`、`herdr-server.log`。

验证证据

本站实测记录(2026-08-29)

- 2026-08-28:`herdr` 完整客户端启动 12s 验证创建 `~/.config/herdr/`(.plugins.lock、herdr-client.log、herdr-server.log、session.json)+ `~/.local/state/herdr/agent-detection/`(19 个 agent 清单 toml,只读情报文件);工作区(cwd)零写入。

来源与证据

素材来源:本站实测沉淀(2026-08-28)

验证证据:site docs#1;local repro log 2026-08-29;local repro log