命令行客户端

运行与诊断

日志配置、退出码、报错信息与停止方式。

日志

默认输出到 stdout,格式为时间、级别、源码位置、固定前缀和消息:

2026-11-17T09:27:49+08:00 INFO <sub/root.go:249> LoliaFRP-CLI: 已获取到配置文件 隧道名称="MC 联机" 使用节点="阿里云杭州-1"
2026-11-17T09:27:50+08:00 INFO <client/control.go:207> LoliaFRP-CLI: [1145141919810] [1.abcdefghijklmnop] 您可通过 cn-frp-1.qwq.fan:11451 访问您的服务

时间为 RFC3339 格式,级别为 trace、debug、info、warn、error。<...> 中是输出该行日志的源码位置,会随版本变化,反馈问题时请提供完整日志。

日志相关配置:

参数类型说明
log.tostring输出目标,console 或文件路径。默认为 console。
log.levelstring日志级别。默认为 info,无法识别的值会退回 info。
log.maxDaysint日志文件保留天数。默认为 3,小于等于 0 时不清理。
log.disablePrintColorbool关闭终端颜色。默认为 false。

log.to 设为文件路径时按天轮转:跨天把当前文件重命名为 <文件名>.YYYY-MM-DD,并删除超过 log.maxDays 的文件。

多实例运行时日志交错输出,可用 [i/N] 前缀与 启动 frpc 服务 [<文件>] 区分实例:

2026-11-17T09:27:49+08:00 INFO <sub/root.go:474> LoliaFRP-CLI: [1/2] 启动 token: abc***xyz (IDs: [10000 10001])

退出码

退出码说明
0正常结束(包括 Ctrl+C)、-v、--help,以及多实例模式下所有实例结束。
1启动阶段错误:-t 格式错误、拉取配置失败、配置文件解析或校验失败、子命令执行失败。

多实例模式下单个实例失败只打印错误,进程最终仍以 0 退出。与节点的连接断开后会自动重连,进程不会因此退出。

报错信息

信息说明
invalid token format '...', expected 'id[,id2,...]:token'-t 缺少冒号,或 token 为空。
invalid token format '...', id list is empty冒号前没有隧道 id。
API returned status code: <code>服务端拒绝请求,token 失效或隧道已删除。
API error: <消息>服务端返回的业务错误。
failed to fetch config from API网络不通、DNS 解析失败或被拦截。
failed to parse config配置字段不合法或缺少必填项。
failed to render template配置中的模板变量无法解析。
web server port should be set if you want to use this feature使用了 status、reload、stop,但配置没有 webServer。
invalid autoTLS options: autoTLS.cacheDir is required when autoTLS.enable is true启用 AutoTLS 但没有填写 cacheDir。

停止

Ctrl+C(SIGINT)或 SIGTERM 触发优雅关闭,约 0.5 秒内断开与节点的连接。多实例模式下每个实例各自响应,进程在所有实例退出后结束。