GitHub Issue
QR login in headless/remote env is hard to scan (need image output / longer TTL)
你好,感谢项目!我在远程 Linux 服务器(无 GUI / 无 XServer)使用 `python -m xhs_cli login --qrcode` 时遇到一个实际问题:
1) 默认会优先走 browser-assisted(camoufox/playwright headed),在无 DISPLAY 的环境直接失败;
2) 即使切到纯 HTTP flow(终端字符二维码),远程扫码也很难:字符画二维码在聊天工具里容易压缩/换行,手机端识别率低,而且有效期只有约 4 分钟,经常来不及确认。
能否考虑增加几个能力来更适配 headless/remote:
- `--qrcode-image /path/to.png`:把二维码保存成 PNG(或输出 base64),方便远程传输扫码
- `--prefer-http` 或 `--no-browser`:明确禁用 browser-assisted(避免在 server 上拉 700MB 浏览器依赖)
- `--timeout` 可配置(默认 4 分钟太短)
- 或者在输出里同时打印 `QR URL`(方便转成图片/在其他设备打开)
如果需要我可以提供报错堆栈和环境信息。
View Raw Thread
Developer & User Discourse
MiracleXYZ • Mar 21, 2026
Same issue here. Headless login is almost unusable.
tools-only • Apr 7, 2026
+1
AldrinL • May 9, 2026
或者提供一个把本机浏览器cookie 导入到 服务器命令行的方式也可以。有个插件EditThisCookie可以很方便的导出cookie,但是不知道怎么导入到服务器。
浏览器和xiaohongshu-cli运行的服务器不是一起的
浏览器和xiaohongshu-cli运行的服务器不是一起的
SaaS Metrics