BotBrowser Launcher：配置、代理与启动

BotBrowser Launcher 是 BotBrowser 的桌面控制界面。它把配置文件选择、浏览器内核管理、代理设置和常用运行控制集中在一个应用中。对于不希望为每个会话维护一长串命令的团队，这种方式更容易检查，也更适合交接。

Launcher 位于公开的 BotBrowser 仓库，支持 Windows、macOS、Ubuntu 和 Debian。它不会替代加密的 BotBrowser 配置文件，也不会替代浏览器内核。它负责连接这些部分，保存每个命名浏览器配置的设置，并按选定组合启动浏览器。

使用前需要分清三个对象。Launcher profile 是应用列表里保存的工作配置。BotBrowser profile 是定义浏览器身份的 .enc 文件。Kernel 是与该配置文件版本匹配的浏览器可执行程序。三者保持一致，才能获得可预测的启动结果。

Launcher 工作流程

一次标准启动包含五个决定：

1. 为当前计算机安装或选择 BotBrowser 内核。
2. 选择符合目标浏览器家族和版本的 BotBrowser .enc 配置文件。
3. 新建一个有明确名称的 Launcher profile，并关联该文件。
4. 按需添加代理，在启动前检查出口 IP。
5. 检查运行控制，保存配置，然后启动浏览器。

这种分层既适合本地测试，也适合多人协作。开发人员可以保留一个用于交互检查的配置。QA 团队可以克隆它，只修改代理或存储策略。运营人员可以按项目分组，从主列表一次启动多个已选择的 profile。

从公开仓库安装

Launcher 目录为 Windows、macOS、Ubuntu 和 Debian 提供安装脚本。脚本会准备受支持的运行环境、获取公开源码、构建桌面应用并创建相应快捷方式。当前命令和平台要求以 Launcher README 为准。

不要长期保存一份旧安装命令。Launcher 的构建要求可以独立于浏览器配置包变化。每次安装或重装时查看公开 README，可以避免对 Node.js 版本、安装位置或系统架构作出过时假设。

安装后，左侧导航包含三个区域：

• Profiles 保存命名启动配置和运行状态。
• Proxies 保存可复用网络路由。
• Kernels 下载和管理当前平台的 BotBrowser 浏览器版本。

日常工作从 Profiles 开始。Kernel 和代理是供多个 profile 引用的共享资源。安装一个内核或更新一条代理记录，不需要重新创建每个 Launcher profile。

先选择 BotBrowser 配置文件

先确定身份需求，再考虑可选开关。根据需要的平台家族、浏览器家族和浏览器主版本选择 BotBrowser profile。该文件决定配置支持的浏览器身份基线，Launcher 字段在此基础上添加运行策略。

需要持久工作区时，应有意识地固定配置文件。保持 Launcher 名称、用户数据目录和代理分配稳定，网站 cookie 和本地状态才能按预期延续。需要独立测试时，克隆 Launcher profile 或新建配置，并使用不同用户数据目录。并发进程共享一个目录会产生与指纹保护无关的状态冲突。

选择有效文件后，编辑器会显示配置文件信息。保存前检查平台和版本。文件名方便查找，但编辑器解析出的信息更适合确认实际选择的内容。

配置文件与内核版本匹配

浏览器内核与 BotBrowser profile 应使用相同的浏览器主版本。版本 150 的配置文件应与版本 150 的内核配合。主版本对齐可以让浏览器功能范围与配置身份处于同一发布代际。

Launcher 会管理已安装内核，并可在公开版本可用时获取匹配版本。Profile 列表会显示平台与内核信息，应在按下 Start 前完成检查。

建议按以下顺序判断：

问题	建议操作
配置文件能明确识别浏览器主版本吗？	安装并使用同一主版本内核。
匹配内核仍在下载吗？	等待下载和解压完成。
特殊浏览器家族配置无法自动选择预期内核吗？	在 Advanced 中指定 Chromium 主版本。
配置包升级到了新主版本吗？	使用前新建或复查对应 Launcher profile。
多个配置使用同一主版本吗？	它们可以引用当前平台上的同一已安装内核。

手动内核版本是覆盖项，不是日常调节项。标准配置保持自动选择。只有配置家族需要显式 Chromium 主版本，或当前支持文档明确要求时，才使用该字段。

不要通过只改可见浏览器名称、User-Agent 或 profile 标签来处理版本不匹配。这些字段不能把旧配置包转换成新版本。应选择为目标内核代际生成的配置包。

使用 profile 编辑器

编辑器集中组织配置文件、代理和运行设置，便于操作人员在启动前复核一份已保存配置。可用控件会随 BotBrowser 版本调整。

先填写配置文件基本信息：

• 使用能说明用途的名称。
• 多个 profile 属于同一项目时填写 group。
• 描述用于记录负责人、地区或验证目的，不写凭据。
• 选择 BotBrowser profile，并核对显示出的详细信息。

随后只设置会话真正需要的项目。配置文件本身已经提供一致基线。没有明确需求时增加大量覆盖项，会提高维护成本，也会让后续审查更困难。编辑器应记录经过决定的策略，不是展示所有开关的清单。

Profile 列表支持新建、编辑、克隆、导入、导出和分组。大部分设置相同、只有一个维度需要变化时，克隆最合适。例如，先克隆基线，再分配另一个地区代理，或者比较 profile 存储策略与浏览器原生策略。

运行中的 profile 也可以打开编辑器。除非控件明确说明立即生效，否则应把保存的修改视为下次启动策略。身份、网络、内存或存储有重要变化后重新启动，可以让下一会话从清晰状态开始。

用编辑器搜索定位设置

使用编辑器搜索可以快速定位配置文件与运行设置，无需浏览整个表单。搜索只缩小导航范围，不会修改已保存配置，因此也适合复核时使用。

设置 Memory 与 Storage

内存和存储容量可能成为普通网页可见的浏览器信息。BotBrowser 提供基于 profile 的控制，使这些值遵循预期身份策略。Launcher 在编辑器中把相关的堆与存储策略放在一起管理。

• JS Heap Size Limit 控制 JavaScript 堆容量策略。
• Storage Quota 控制存储容量策略。

大多数隐私保护会话应让这些控制与所选 profile 保持一致。只有获得授权的兼容性案例才使用主机原生或自定义测试策略，并记录原因、负责人和回滚计划。

审查时把两个控件放在一起看。堆策略和存储策略的数值不必相同，但选择依据应来自同一份测试需求。不要在带有持久网站状态的日常 profile 上随意试改。

比较不同模式时，应克隆 Launcher profile。保持 BotBrowser profile、内核、代理和用户数据策略不变，只修改本次测试涉及的 Memory 或 Storage 选项。克隆配置会留下明确记录，也能防止临时 QA 设置进入下次正常启动。

添加代理并使用 Check IP

Launcher 支持可复用代理记录和每个 profile 的代理分配。公开 Launcher 支持 HTTP、HTTPS、SOCKS4 和 SOCKS5。编辑器可以选择已保存代理，profile 列表也提供快速代理变更入口。

启动前使用 Check IP 验证路由。结果会显示配置的 IP 服务观察到的出口 IP 与地区信息。这是一项网络预检，可以在浏览器启动前发现主机填写错误、路由不可用或地区不符合预期。

Check IP 不能替代启动后的应用级验证。浏览器流量还可能涉及 DNS、WebRTC、PAC 规则或站点特定路由，需要根据授权测试范围单独检查。预检只确认所填代理能够访问选定 IP 服务，并报告该服务看到的路由。

代理响应过慢或不可用时，可以停止检查。检查进行中，按钮会显示 Stop。编辑代理或切换路由前先取消当前请求。清空代理时 Launcher 也会终止活动检查，避免旧结果随后显示在新配置上。

代理审查顺序如下：

1. 选择或输入代理。
2. 核对协议、主机、端口和凭据。
3. 运行 Check IP。
4. 将显示地区与会话要求比较。
5. 需要复用时保存到代理列表。
6. 保存 Launcher profile，再启动浏览器。

不要把凭据写进 profile 名称、描述、截图或共享 CSV。代理认证信息只放在代理字段，并按照组织的凭据策略限制导出配置的访问权限。

理解启动行为

Launcher 把配置状态、浏览器版本、下载与编辑控件放在同一个桌面界面中。

启动 profile 时，Launcher 会组合所选 BotBrowser 配置、浏览器内核、代理、用户数据位置与已保存运行设置。所需内核尚未安装但有匹配公开版本时，内核流程可以下载它。侧栏下载和解压结束后再重试启动。

主表会区分 Idle 与 Running。可以对选中行执行 Start 和 Stop，适合按组控制。编辑共享资源前查看状态列。相关会话运行时修改或删除代理记录，可能导致保存配置与已经运行的浏览器进程不再相同。

有界面与 headless 启动的反馈方式不同。有界面会话可以显示用户提示。Headless 没有可见窗口，启动提示会写入终端输出。如果 headless profile 没有启动，先检查输出中是否报告配置缺失、无效、过期或版本不匹配，再修改其他控件。

每个并发 profile 使用独立用户数据目录。持久目录会在多次启动间保留 cookie 和网站存储，临时或独立目录用于隔离任务。项目应先决定需要哪种行为，再让 Launcher profile 长期保持一致。

Launcher 与内核的定期更新

Launcher 会定期检查桌面应用与可用浏览器版本。切换维护中的浏览器版本前，应先查看发布说明并确认配置文件兼容性。

Kernel 更新按浏览器主版本管理。同一已安装主版本的新构建可以替换该主版本旧构建。新的浏览器主版本仍是独立兼容性决定，因为它还需要匹配的 BotBrowser 配置包。

生产流程建议保留以下信息：

• 记录侧栏显示的 Launcher 版本。
• 记录通过验证的 profile 集合所使用的 kernel 版本。
• 升级主版本前检查配置包兼容性。
• 更新后、大批量运行前进行一次简短授权验证。
• 长时间运行的会话保持现有已验证进程，等计划维护窗口再重启。

这样可以把常规补丁维护与身份变化分开。更新 Launcher 不会让旧 profile 自动变成新版本，下载新 kernel 主版本也不会生成匹配 profile。

建立第一个易于审查的 profile

最小可用配置也最容易支持：

1. 打开 Kernels，安装 BotBrowser profile 需要的主版本。
2. 打开 Profiles，选择 New Profile。
3. 填写清晰名称和可选 group。
4. 选择 .enc 文件，核对平台与版本。
5. 会话需要代理时再选择代理，并执行 Check IP。
6. 可选运行覆盖项保持 profile 默认。
7. 保存，选中该行并按 Start。

基线成功后，再为受控变化创建 clone。返回型工作区可添加持久用户数据目录。书面 QA 场景可添加明确的 Memory 与 Storage 模式。只有浏览器在不带自动化脚本时能正确启动后，再加入脚本。

这种顺序可以缩小排错范围。如果基线能启动而 clone 不能，变化字段很容易找到。初始配置包含大量覆盖项时，失败归因困难，也不利于其他操作人员理解。

常见使用方式

持久研究工作区

固定一个 Launcher profile、一个 BotBrowser profile、一个代理和一个专用用户数据目录。保持配置与内核主版本一致。在计划维护窗口检查更新。这适合经过授权的隐私研究，并能保持浏览器身份策略稳定。

地区兼容性检查

为每个地区克隆基线，分配一条经过审查的代理，并在首次启动前执行 Check IP。除非测试要求另一个平台身份，否则保持 BotBrowser 配置家族和内核不变。地区写进 group 或 description，不要写入代理凭据。

内存与存储 QA

为 profile、real 和有文档依据的 Custom 策略分别建立 clone。用编辑器搜索进入 Memory and Storage。其余启动设置保持一致，并在名称或描述中标明策略。未经复查，不要把自定义 QA clone 当作日常浏览配置。

小型 profile 组

将相关 Launcher profile 放进同一 group，选中多个 Idle 行后启动。每个并发 profile 应有独立用户数据目录，并复核代理分配。Kernel 或 Launcher 更新时关注状态列和侧栏进度。

什么情况下适合使用 Launcher

操作人员需要可视化检查和复用配置时，Launcher 很合适。它减少长命令的抄写错误，把 profiles、proxies 和 kernels 放在一个位置，并允许通过界面设置常用运行策略。

容器、远程服务器和自动生成任务仍适合命令行。需要可视化复核本地保存设置时，Launcher 更直接。

评估 BotBrowser 时，以下需求会提高 Launcher 的价值：

• 非开发人员需要启动经过审查的浏览器 profile。
• 启动前需要看见 profile 与 kernel 版本是否匹配。
• 代理需要快速出口 IP 预检。
• 内存和存储策略需要命名并重复使用。
• 本地多个 profile 需要分组、克隆、导入或导出。
• Launcher 与 kernel 维护状态需要集中显示。

Launcher 是本地控制界面。订阅配置包、高级功能与支持服务是单独的产品决定。请根据当前 BotBrowser 仓库、价格页面 和文档 判断工作所需版本与服务级别。

排错

浏览器没有启动

确认 BotBrowser profile 有效，并且已安装同一主版本内核。等待活动下载完成。Headless 模式无法显示可见启动窗口，应查看终端输出中的配置缺失、无效、过期或版本不匹配提示。

选中了错误内核

重新检查 BotBrowser profile 显示的主版本。标准配置通常保持自动选择。只有配置家族需要，或当前支持文档要求时，才使用 Advanced 中的主版本覆盖。

Check IP 等待太久

按 Stop，检查代理主机、端口、协议、凭据和网络可用性，再重试。选择另一个代理前取消旧请求，确保结果属于当前字段。

搜索找不到字段名称

使用概念或区域关键词，例如 quota、heap、proxy、fonts 或 script。搜索过滤的是编辑器区域，不是每个可见标签。清空搜索即可恢复完整导航。

保存的修改没有出现在运行中浏览器

保存身份、网络、内存、存储或启动行为修改后，停止并重启 profile。已经运行的进程可能继续使用启动时读取的设置。

已准备好更新

完成重要工作并按需要停止会话后再应用更新。重启后确认 Launcher 版本，并用生产所需配置文件与内核做一次简短验证。

启动复核清单

新的或修改过的 profile 进入日常使用前，确认：

• BotBrowser profile 来自授权来源。
• 浏览器主版本与所选 kernel 一致。
• Launcher 名称和 group 能说明任务。
• 并发 profiles 不共享用户数据目录。
• 代理分配正确，Check IP 显示预期路由。
• Memory 和 Storage 模式符合书面测试策略。
• 任何自定义内存或存储策略都有负责人、原因和回滚计划。
• 名称、描述和导出内容不包含敏感凭据。
• 启动浏览器前已经完成更新活动。
• 重要变化后通过一次简短隐私与兼容性验证。

BotBrowser Launcher 把这些检查变成可重复的桌面流程。Profile 身份、浏览器版本、网络路由和运行策略始终是可见的独立决定，因此每次启动都更容易审查和维护。

继续阅读 配置文件管理、CLI 实用配方 和公开的 Launcher README。也可以直接下载 BotBrowser或比较方案。