Changelog
更新日志
DuckBrowser 每个版本的新增功能、改进和修复。应用会在后台检查新版本,也可以在「设置 → 应用更新」里手动检查。
改进
- 新配置及未保存引导 DNS 字段的配置默认使用
1.1.1.1,通过本机直连 UDP 53 端口解析。系统 DNS 模式下,经代理访问的网站域名也会先按应用 DNS 策略解析。 - 已保存的空引导 DNS 或自定义地址保持不变。留空使用系统 DNS;在系统 DNS 模式且未选仅 IPv4/IPv6 策略时,经代理访问的网站域名仍由代理端解析。
- 更新网络设置中的引导 DNS 说明,提示支持单个 IP 地址及可选端口。
0.2.11
#v0.2.11修复
- 修复 macOS 广告过滤规则文件监听器关闭后文件句柄未释放的问题。
- 代理检测失败时显示内核初始化、延迟检测或出口检测阶段及安全的错误原因,避免泄露代理凭据。
0.2.10
#v0.2.10改进
- 调整复选框勾选及半选标记的对比度,兼顾深浅强调色和系统高对比度设置。
- 统一各页面工具栏及内容区域的边距,改善代理列表和订阅节点的选择控件对齐。
- 调整弹窗位置,避免面板与原生窗口控制按钮重叠。
0.2.9
#v0.2.9修复
- 修复 Surge Hysteria2 节点携带
udp-relay=true时被跳过的问题,保留默认 UDP 能力及显式关闭设置。 - Surge 按策略名称保留有效定义,同连接不同名称不再合并,流量、重置、到期等说明占位条目也完整显示并可分别导入。
- 解析与保存使用一致的定义标识,源文件顺序变化后仍保留候选和已导入代理的关联。
兼容说明
- URI 节点列表(含 Base64)、Clash 和 ProxyBridge 继续沿用原有的说明过滤与连接去重规则。
- 升级后首次刷新 Surge 订阅时,旧记录在同协议、同名称且唯一匹配的情况下保留绑定,旧检测与地区信息需重新获取。
- Surge 策略改名会产生新候选,不会仅按相同地址自动重绑已导入代理。
- 指向
127.0.0.1:9的说明占位条目通常无法连接,检测失败属于正常占位行为,不能作为可用代理使用。
0.2.8
#v0.2.8新增
- 支持导入 Surge 配置的
[Proxy]节点,包括 HTTP/HTTPS、SOCKS5、Shadowsocks、Hysteria2、Trojan、VMess、Snell 和 AnyTLS。 - 支持提取
[Proxy Group]的policy-path链接,按组名创建独立订阅;在添加订阅时可直接粘贴组片段或裸策略组行,自动读取名称和刷新间隔。 underlying-proxy可引用同一配置或已加载来源中的具体节点,单独导入出口及刷新订阅时保留完整代理链,也可继续设置本地前置代理。- 分组图标新增「AI 工具」分类,补充 Anthropic、Gemini、Antigravity、Grok、Kimi、DeepSeek、MiniMax、OpenCode 和 Kiro 等图标预设。
改进
- 订阅统一使用
ProxyBridge标识下载,保存各订阅自己的流量和到期信息;重复来源链接复用已有订阅及其设置。 - 校验并映射 ProxyBridge JSON 的 DNS 解析器引用,保留受支持的查询策略、超时、缓存和客户端子网等参数。
- 图标选择器随窗口宽度调整列数和滚动区域,优化分组编辑弹窗布局。
- 更新 Amazon 图标配色,完善新增品牌资源的来源记录及随包分发的许可文件。
修复
- 本地 REST API 读取代理和环境时,递归脱敏代理链中的入口密码及嵌套协议凭据。
- 修正 Surge VMess 的 ChaCha20 加密算法名称转换,避免导入后连接配置构造失败。
兼容说明
- Surge 只导入受支持节点并提取
policy-path链接,不执行策略组选路、规则、筛选或参数重写;缺失、循环引用和不支持的连接参数会提示并跳过对应节点。 - 外部来源同步失败时保留主配置原有节点;此前已成功同步或新建的独立订阅会保留。文本入口只提取链接,含
[Proxy]的完整配置请通过配置 URL 加载。 - 源配置的 DNS 服务器、路由和入站设置不会直接执行,节点解析使用本应用的系统 DNS 或 DNS Bootstrap。
- VMess 须显式设置
vmess-aead=true。Snell 须指定版本 4、5 或 6;版本 5 按版本 4 兼容导入,不支持其专用 QUIC 模式。
0.2.7
#v0.2.7修复
- 本地 REST API 导出 Cookie 时返回真实来源,避免将尚未注入的配置误标为浏览器快照。待注入配置(包括空列表)优先导出,导出不会消费其待注入状态。
- 尚无浏览器数据目录的环境清理缓存时成功返回空结果,不创建数据目录;重复清理保持相同行为,继续保留 Cookie 和登录态。
- 统一主操作按钮的文字、图标和加载动画颜色,改善蓝色按钮的文字对比度;亮黄色等高亮自定义配色继续使用深色文字。
- 修正环境卡片在启动、停止及等待状态下的按钮配色,标签保存按钮沿用统一的主按钮样式。
改进
- 列表视图切换按钮统一按「表格 → 卡片」排列,保留已保存的视图选择。
接口提醒
- Cookie 导出仍要求环境停止。调用方应检查
source:browser_snapshot是浏览器实际快照,pending_import是下次启动才会注入的配置。两者均不存在时仍返回409 cookies_unavailable。
0.2.6
#v0.2.6新增
- 环境列表的分组筛选、新建和编辑环境的分组选择显示环境数量,优先排列数量较多的分组,同数量时按当前语言自然排序。
- 分组图标新增 GitHub、Discord、WhatsApp,以及 PayPal、Stripe、Payoneer、Wise、Airwallex 等预设。
改进
- 统一界面图标与品牌 SVG,改善品牌标志在不同尺寸和深浅主题下的显示。
- 通知改为可折叠堆叠样式,鼠标悬停或键盘聚焦时展开,统一状态图标和关闭按钮。
- 进入「设置 → 应用更新」时自动检查新版本,保留进行中的下载和安装准备状态,界面重绘不再重复触发检查。
修复
- 环境新增、复制、删除或调整分组后,分组页面重新获取环境数量;本地 API 完成相应变更后也会触发刷新。
- 修复窗口失焦或被遮挡后普通通知滞留、已过期通知重新出现,以及同一通知替换、关闭时的队列处理问题。
升级须知
- 升级前请关闭所有环境浏览器。分组筛选和编辑器中的数量以已加载的环境列表为准。
0.2.5
#v0.2.5新增
- 「设置 → 外观」新增六款浏览器图标配色,默认深青色;图标显示各环境的真实编号,所选配色在下次启动浏览器时生效。
- 强调色支持跟随系统变化,也可保留自定义颜色;切换浅色、深色主题不再重置自定义强调色。
改进
- 优化外观设置页的滚动和布局,改进字体列表及接口参数的展开、收起交互。
- 日期、时间和数字显示统一遵循当前界面语言。
- 升级桌面运行框架,统一剪贴板、打开目录和系统回收站操作;卸载失败时保留或恢复原组件。
修复
- 从分组页面或本地 API 新增、修改、删除分组后,环境列表、筛选器和已打开的编辑器及时同步,保留其他未保存内容。
- 改善原生弹出菜单首次显示时的绘制、定位和尺寸,减少空白或内容裁切。
- 补齐新增图标设置及菜单错误信息的英文翻译。
升级须知
- 升级前请关闭所有环境浏览器。浏览器图标配色是本机设置,运行中的浏览器保持当前图标。
0.2.4
#v0.2.4改进
- 环境列表和卡片在 IP 上方显示代理名称,调整代理与备注列宽,方便区分节点并查看长地址。
- 应用更新页的说明区域随窗口高度调整,长说明可独立滚动,检查更新和安装操作始终保留在可见区域。
- 开发版或无法自动更新的构建也可查看当前版本的本地更新说明。
修复
- 修复 Windows 上数据库版本检查、数据升级和运行中环境查询可能因路径格式失败的问题,兼容包含中文、空格及特殊字符的目录。
- 点击弹窗外部不再意外关闭弹窗或丢失未保存内容;关闭、取消和 Escape 操作仍可正常退出。
- 新建环境切换为自定义浏览器设置时,虚拟摄像头默认关闭,按需开启后才检查 FFmpeg 依赖;已明确保存的设置保持不变。
升级须知
- 升级前请关闭所有环境浏览器。0.2.2 及更早版本升级时会自动备份并迁移数据库,使用本地 REST API 的脚本需按新版接口文档调整指纹字段和内核接口路径。
0.2.3
#v0.2.3新增
- 设置新增「组件管理」,支持按需安装、校验、刷新和卸载 FFmpeg 与 GeoIP 数据库,显示组件来源、版本和下载进度。
- 完善 Chrome 154 及以上内核的自定义虚拟摄像头配置和 FFmpeg 依赖检查;依赖缺失时可前往组件管理安装,并保留环境草稿。
- 指纹配置新增 WebGPU 选项,完善语音列表、浏览器启动参数及原生指纹配置。
- 应用已是最新版本时,设置页仍可查看当前版本的更新说明。
改进
- 浏览器内核拥有独立页面,显示本机版本、最新修订与更新进度;安装和更新前提供确认。
- 本地 REST API 页面重新整理连接配置、快速开始、接口文档和请求日志,侧栏显示接口运行状态及列表数量。
- 新建环境默认匹配当前主机的操作系统;环境编辑器优先显示本地数据,在线目录加载不再阻塞编辑。
- GeoIP 数据统一迁移到组件目录,保留已有安装;FFmpeg 使用签名清单、固定下载地址和 SHA-256 校验,查询失败时可使用已验证缓存或内嵌目录。
修复
- 修复环境操作菜单、托盘面板及下拉选择器首次打开时的尺寸、定位和内容裁切问题。
- 修复重复启动参数合并、WebGPU 选择保存及部分指纹配置传递问题。
- 修复虚拟摄像头依赖检查与组件安装状态变化时的界面布局和加载状态。
升级须知
- 升级前请关闭所有环境浏览器。首次启动会自动备份并升级 0.2.x 数据库;如需回退旧版,应恢复升级前的数据库及配套备份文件。
- 本地 REST API 改用
kernel_family、结构化fingerprint与kernel_settings;内核接口改为/kernel-families/{family}/kernels,现有调用脚本需按新版接口文档调整。 - Chrome 139 及以下环境数据保留,但不再提供启动或内核管理,请重新选择 Chrome 140 及以上内核。桌面应用支持 macOS 和 Windows。
- FFmpeg 组件的下载安装与校验已验证,当前推荐版本的浏览器内音视频效果和 Windows 真机运行仍需进一步验证。
0.2.2
#v0.2.2新增
- 托盘面板:在 macOS 和 Windows 上左键点击托盘图标,可以查看运行中的环境、CPU、内存、网速和当前网络,并直接停止环境;右键仍是原来的菜单。
- 订阅节点列表支持删除已移除的节点:可以单个删除、勾选后批量删除,或一键清除全部。没有环境在用的已导入代理会一起删除。
- 标签筛选按钮直接显示已选的标签名。
改进
- 环境的操作菜单、标签筛选、标签编辑和编辑器里的选择器可以超出窗口边缘显示,窗口较小时不再被遮挡。
- 加载动画统一;网速、延迟、数量等数字变化时平滑滚动;下拉菜单淡入淡出。
- 订阅节点列表的全选恢复到表头,底部恢复"全选筛选结果"。
修复
- 基础字号调大后,环境列表第二行标签被遮住。
- Windows 上标签筛选按钮的文字被截断。
- 未检测的订阅节点"IP / 地区"一栏错位。
- 极少数情况下数据库打开失败。
0.2.1
#v0.2.1修复
- Windows 上「标签」筛选按钮的文字折成两行。
- Windows 上「更换图标」、批量操作栏和代理流量读数的文字可能折行。
0.2.0
#v0.2.0DuckBrowser 改用原生界面重写,保持原有的外观和操作方式。
新增
- 应用内自动更新:后台检查新版本,在更新窗口查看说明、下载并重启安装;可在「设置 → 应用更新」中调整。
- 启动时的更新提示新增「今天不提醒」。
- 环境编辑的「概要」中可以一键随机指纹。
- 菜单栏「DuckBrowser」菜单新增「设置…」(⌘,)。
- 主题和语言默认跟随系统,对比度随浅色、深色主题自动调整。
改进
- 环境列表的列宽随内容自适应:名称和 IPv6 代理地址完整显示,备注最多显示两行。
- 「新建代理」按钮合并了导入、导出代理操作。
- 内核列表只提供 Chrome 140 及以上版本。
- 内核与 GeoIP 数据库改由 DuckBrowser 服务器下载,GitHub 访问不稳定时也能顺利更新。
- 虚拟摄像头注明需要 Chrome 140 及以上版本的内核。
修复
- 流量历史翻页无效;弹窗改为固定高度,默认每页 10 条。
- 新增的代理需要重启后才能在环境中选择。
- 菜单栏多出一个重复的 DuckBrowser 菜单。
- 打开菜单时表格闪动;出现批量操作栏时顶部按钮与搜索框错位。
升级须知
- 0.1.x 版本无法自动升级到此版本,请下载安装包覆盖安装一次,原有环境和数据会保留。