云端或本地运行环境
CLI 有两种运行环境,命令完全相同。两者都使用 Gologin 配置文件、指纹和代理,并且由守护进程在多次 CLI 调用之间保持会话存活。
可以通过
--runtime cloud|local|auto 为每条命令选择运行环境,也可以一次性设置 GOLOGIN_AGENT_BROWSER_RUNTIME:
auto),配置文件、runbook 和任务相关命令在本地运行,其余命令在云端运行。打开本地会话后,后续命令也需要传入 --runtime local。有关要求和仅限本地的命令,请参阅本地运行环境。
安装
凭据
获取令牌
- 在 gologin.com 注册或登录
- 在控制台中打开 API & MCP
- 打开 API 标签页
- 点击 新代币
- 复制生成的访问令牌
配置文件
~/.gologin-agent-browser/config.json
架构
由两部分组成:gologin-agent-browserCLI:解析命令、选择运行环境、自动启动对应的守护进程,并输出精简结果- 持久化本地守护进程(每种运行环境一个):持有运行中的浏览器会话,通过 Playwright
connectOverCDP连接到 Gologin Cloud Browser 或本地 Orbita,在内存中保留当前活动页面,生成快照、解析引用,并跟踪会话元数据
- 位于
${TMPDIR:-/tmp}/gologin-agent-browser.sock的 Unix 套接字 - 位于
127.0.0.1:${GOLOGIN_DAEMON_PORT:-44777}的本地主机 HTTP
引用的工作方式
snapshot 会输出精简的页面视图,并为可交互元素分配 @e1、@e2、@e3 这样的引用。你可以直接对它们进行操作:
find 通常比过期的引用更可靠:它会在实时页面上定位元素,并一步完成操作。
快速开始
智能体循环示例
典型的 AI 智能体循环:完整命令参考
诊断
会话管理
页面读取
交互
键盘与滚动
导航
标签页
Cookie 与存储
高级
配置文件、代理和 Gologin API
这些命令使用你的令牌调用 Gologin API,不需要浏览器守护进程。--help 可输出其用法。
仅限本地运行环境
profiles、profile、profile-create、profile-update、profile-import、profile-sync、profile-delete、run、batch、jobs 和 job 用于管理本地配置文件、runbook 和任务历史。请参阅本地运行环境。
别名
使用场景与示例
检查你的网站能否通过反检测测试
登录网页应用并提取仪表板数据
填写多步骤表单
截取竞争对手页面的截图
在屏蔽抓取的网站上搜索
有些网站需要先执行 JavaScript、登录或进行交互才会显示结果。可以使用浏览器进行搜索:保存和恢复会话状态
导出 Cookie 和存储数据,以便在不同会话中复用:并行会话
对于相互独立的云端任务,请使用明确的--session ID。使用 close --all 或 sessions --prune --older-than-ms 进行清理。
代理规则
- 预先配置的配置文件:代理通过 Gologin 控制台或 API 设置在配置文件上,例如
proxy add-gologin <profileId> --country us - 临时云端配置文件:不使用代理,或使用你自己的代理,通过
--proxy-host和--proxy-port设置(另可使用--proxy-mode http|socks4|socks5、--proxy-user、--proxy-pass) - 在云端运行环境中,
open不接受--proxy-country。如需使用某个国家的 Gologin 代理流量,请先为配置文件添加 Gologin 代理,然后使用--profile打开该配置文件 - 在本地运行环境中,
open、profile-create和profile-update接受--proxy-country
相关内容
- Gologin Web Access CLI:统一 CLI(抓取 + 浏览器)
- 本地运行环境:使用此 CLI 运行本地 Orbita 配置文件
- Cloud Browser 快速入门:Puppeteer/Playwright 示例
- AI Skills:适用于 Claude Code 的即插即用技能
npm 包
gologin-agent-browser-cli
源代码
GologinLabs/agent-browser