black-ant / Ant-Browser

# Ant Browser
> 面向多账号隔离、代理绑定和本地环境管理的桌面浏览器工具（Windows / Linux / macOS unsigned）。
当前版本：`1.8.1` · 2026-09-14
## 推荐内核项目
Ant Browser 当前推荐配套使用的浏览器内核，来源于开源项目 fingerprint-chromium。
如果你正在寻找可直接下载和维护的指纹内核版本，建议先查看它的 Releases 页面：
- 
这个项目为 Ant Browser 的内核准备提供了直接可用的基础来源，这里先对原项目做明确推荐与致谢。
Ant Browser 的目标很明确：在一台桌面设备上，帮助用户稳定管理多个彼此隔离的浏览器实例，并配合代理池、浏览器内核和快捷启动能力完成日常运营或测试工作。
## 目录
- 项目简介
- 近期更新
- 更新日志
- 核心特性
- 界面预览
- Star History
- 快速开始
- 常用操作
- 常见问题
- Roadmap
- 开发与发布文档
- 贡献
- 支持与反馈
- License
## 项目简介
Ant Browser 适合以下场景：
- 多账号环境隔离
- 跨境电商与社媒账号运营
- 需要独立代理出口的本地测试
- 需要统一管理浏览器内核和实例配置的团队
这个项目当前提供的核心价值是：
- 给每个账号分配独立浏览器实例
- 给每个实例绑定独立代理
- 统一管理浏览器内核、标签、关键字和快捷打开码
- 在本地保存配置和运行数据，便于自主控制
## 近期更新
### 1.8.0 · 2026-09-03
- 备份渠道：支持本地、OpenList 和 S3（含兼容服务）三种备份位置。
- 备份范围：支持全量备份，也支持按实例选择性备份；远程历史支持扫描、下载和恢复。
- OpenList 定时备份：支持每日执行时间、最近执行状态和失败反馈；实例仍在运行时跳过本次任务。
- 凭据保护：OpenList Token、S3 访问凭据仅保存到本地敏感配置 `backup.local.yaml`，界面默认脱敏并支持按需显示。
- 恢复安全：备份包增加清单校验、路径校验和解压限制；恢复保留兼容字段，并按当前机器重新映射实例与外部内核路径。
- 代理连接栈：明确区分 `xray` + sing-box 组合栈与独立 `mihomo` 栈，统一代理测速、连通性、预热和运行时下载流程。
- 设置维护：新增系统设置重置，并增加定时备份的配置保护；开发入口整理为 `bat\dev.bat` 和 `scripts/dev.sh`。
### 1.7.0 · 2026-08-17
- 实例窗口标识：Windows 运行实例使用独立窗口图标，右上角显示 1-10 / A-Z 角标，窗口标题左侧同步显示运行码
- 应用图标：统一桌面快捷方式、应用窗口与侧边栏 Logo 的白色背景和蓝色指纹线稿标识
- 全局备份与恢复：覆盖应用配置、数据库和浏览器数据，仅支持保留现有数据的合并导入、进度展示和导出日志
- OpenList 备份渠道：配置归档到 `backup.channels.openlist`，使用 Token 认证；Token 仅保存在本地敏感配置 `backup.local.yaml`
- S3 渠道配置：增加 AWS S3 及兼容服务的 Endpoint、Region、Bucket、对象前缀、Path Style 和访问凭据配置；完整远程备份流程在 1.8.0 完善
- 备份恢复一致性：保留数据库迁移字段，兼容旧版本备份列缺失，按当前机器归一化实例/内核路径并按 `coreId` 映射外部内核
- 维护安全：浏览器停止失败时中止备份导入，避免未完成的维护操作继续写入数据
- 通知中心：支持按全部、未读、错误和警告筛选，批量标记已读、清空通知和跳转相关页面
- 运行稳定性：改善浏览器异常退出、停止状态、托盘操作以及应用启动和关闭阶段的反馈
- 退出诊断：新增应用生命周期日志和 Windows 只读退出诊断监视器，便于定位异常退出问题
- 代理兼容：修复 Clash 配置中 `null` 值导致的导入解析失败
### 1.6.0 · 2026-08-11
- 插件持久化：支持保存插件安装包、安装记录和实例插件配置，实例启动时自动恢复已配置插件
- 插件迁移：实例备份导入后自动修复插件安装目录、安装包和运行备份路径
- 指纹处理：跨平台画像使用宿主真实字体避免中日韩文字缺失，删除实例时同步清理指纹检测缓存
- 窗口启动：保留配置的启动窗口尺寸，仅在超出桌面工作区时收缩
### 1.5.0 · 2026-07-25
- 代理增强：支持 HTTPS 代理桥接，完善代理导入、测速和连接可用性处理
- 实例安全：增加实例删除数据审计，避免误删用户数据目录时缺少确认依据
- 会话恢复：新增实例最近会话恢复配置，创建、复制、更新和启动流程保持一致
- 启动服务：补充启动 API 服务端口设置，设置页可查看当前地址并保存偏好端口
- 界面优化：精简代理池导入流程，新增代理池使用说明入口，减少页面信息堆叠
### 1.4.0 · 2026-07-15
- VPN 优化：完善代理/VPN 检测展示，可直接查看配置代理、认证状态、浏览器出口 IP、ASN/网络、多源归属冲突和来源明细，避免单一 IP 库误判
- 指纹优化：优化指纹检测页的基线、修改前后对比、自动刷新和启动逻辑；Linux / macOS 指纹环境自动切换英文，避免中文字体缺失导致方块字
- 移除控制台栏目，应用启动后直接进入实例列表，减少无用入口
- 增强观测能力：提供指纹识别页面
### 1.3.0 · 2026-06-23
- 自动化增强：完善自动化脚本导入、运行、目标实例选择和执行记录管理，提升多实例自动化编排能力
- 插件管理：新增插件包管理能力，支持插件安装、导入、启停、删除、实例限制和单实例插件配置
- VPN 优化：优化代理/VPN 连接链路，完善 Xray、sing-box、Mihomo 等连接栈的启动、测速、检测和预热能力
- 实例迁移：支持实例导入导出，可将实例配置和完整浏览器用户数据目录打包迁移到新环境
- 代理适配：实例导入时按代理名称匹配本地同名代理，匹配不到或同名不唯一时自动清空代理
- 界面优化：优化实例列表、关键字展示、操作菜单和导入导出入口，减少页面拥挤和无效信息
### 1.2.0 · 2026-05-09
- 重点升级接口调用：Launch API 补齐实例增删改查、按 code / selector 启动、runtime session / status / stop 和统一 CDP 入口，方便外部系统直接调用浏览器能力
- 完善自动化接口链路：脚本执行支持 selector / params 覆盖和 `timeoutMs` 超时控制，双实例 runtime 流程支持超时取消与错误返回
- 增强代理池：新增链式代理导入、编辑和预览能力，支持 HTTP / SOCKS5 两层链路，并优化直连代理批量导入
- 优化代理检测：新增测速目标、IP 健康检测目标和桥接启动超时配置，链式代理也