快速开始

环境变量（示例）

前置条件

Flux Browser 客户端已运行（否则 8026 无服务）。

本机指纹浏览器服务已就绪（随 Flux 客户端启动；开放 API 在启动/停止时会调用该服务）。

FluxNode 在 localhost:6788 可用（主进程用加密通道校验 apiKey）。

团队为 专业版 且已 生成 API 密钥。

1. 获取分组列表

从响应 data.list 中取分组的 id 作为新增环境的 groupId。

2. 获取环境列表

从响应 data.list 中取环境的 id 作为 envIds。

3. 新增环境（随机指纹）

新增接口填写 groupId、name，并可选填写标准代理 URL proxy（支持 http、https、socks5）；不接收指纹配置。未传或传空 proxy 时使用本地代理，服务端会自动生成随机 Windows 指纹。items 支持一次最多 100 项，单项结果见 data.results。

创建成功后从 data.results[0].id 取得新的环境 ID。底层浏览器 profile 会在首次 launch 时创建。

若需要自定义代理，在每个 items 条目中增加 proxy，例如："proxy":"http://user:password@127.0.0.1:8080"。

4. 更新环境

更新接口只允许传 id、name、groupId、proxy。每项 id 必填，另外三个字段至少传一个；省略的字段保持原值，proxy 传空字符串表示切换为本地代理。items 支持一次最多 100 项。

更新结果见 data.results；名称重复、分组不属于当前团队或代理格式无效时，对应项返回 success: false。

5. 启动浏览器

成功时查看 data.results[0].webSocketDebuggerUrl 与 data.results[0].port，用于 Playwright、Puppeteer 或 Selenium（见同目录对应文档）。
启动次数会在本地启动完成后自动结算：成功启动确认计次，启动失败释放预占次数。

6. 停止浏览器

7. 删除环境

按业务环境 ID 删除，envIds 支持一次最多 100 项。该操作会软删除环境，并尝试清理已经创建的底层 profile；请先停止正在使用的环境。

常见错误

现象	处理
连接 8026 失败	确认 Flux 客户端已打开
404、请求发错端口	开放 API 基址应为 `http://localhost:8026/api/v1`，勿与其它本地服务端口混淆
API 密钥无效	使用客户端复制的真实密钥，勿用 OpenAPI 里的示例 UUID
启动提示缺少内核	打开 Flux Browser 客户端，进入设置 > 版本更新安装浏览器内核后重试
启动返回 4xx	查看 `results[].error` 全文；常见为账号授权 token 失效或该环境已在运行
创建单项失败	查看 `data.results[].error`；确认 `groupId` 属于当前团队、名称未重复且有环境额度

环境变量（示例）#

前置条件#

1. 获取分组列表#

2. 获取环境列表#

3. 新增环境（随机指纹）#

4. 更新环境#

5. 启动浏览器#

6. 停止浏览器#

7. 删除环境#

常见错误#