系统拦截未签名应用怎么办?Prism Browser 在 macOS 与 Windows 上的安装排障清单
系统拦截未签名应用怎么办?Prism Browser 在 macOS 与 Windows 上的安装排障清单
Prism Browser 是一款本地优先的开源多配置指纹浏览器,基于定制 Chromium 内核与 Electron 构建,可为每个"环境"独立管理 Cookie、缓存、扩展和代理。由于 Community 版本与自编译包通常没有商业代码签名,首次启动时容易被 macOS Gatekeeper 或 Windows SmartScreen 拦截。本文给出一份完整的安装排障清单:如何核对 SHA-256、在系统设置中放行应用、区分"官方已签名版本"与"本地构建版本",避免误删文件或被恶意仿冒包误导。
一、先判断:为什么系统会拦截 Prism Browser?
系统拦截不等于软件有毒,绝大多数情况只是签名信任问题:
| 场景 | 拦截来源 | 表现 |
|---|---|---|
| 下载官方 Community / 自编译包 | macOS Gatekeeper | 提示"已损坏"或"无法打开,因为无法验证开发者" |
| 双击安装版 / 可执行文件 | Windows SmartScreen | 蓝色窗口提示"Windows 已保护你的电脑" |
| 使用内部未签名测试更新通道 | 操作系统在更新安装时提示未签名 | 应用内更新提示语明确说明"操作系统仍会提示未签名"(见 src/main/update-manager.ts) |
关键前提:请只从本项目的 Releases 页面下载文件,并在下载页核对发布者提供的 SHA-256(来源说明见 README.zh-CN.md)。任何来源不明的安装包都不应放行。
二、macOS 安装排障:三步放行被拦截的应用
适用版本:macOS Ventura 及以后(Intel 与 Apple Silicon 均适用)
步骤 1:打开"隐私与安全性"
双击 DMG 中的应用或首次点击 ZIP 版应用被拒绝后,进入:
系统设置 → 隐私与安全性
页面底部会显示一条类似 "已阻止使用 Prism Browser" 的记录,旁边有 "仍要打开" 按钮。
步骤 2:输入密码确认
点击"仍要打开",输入系统登录密码 / Touch ID 确认。系统会弹出一个二次对话框,再次点击"打开"。
💡 如果看不到"仍要打开"按钮,可以先在"启动台"或"应用程序"文件夹里右键点击应用 → 打开,选择一次"打开",记录就会出现在隐私与安全性页面中。
步骤 3:验证应用能正常创建环境
打开后进入主界面,按 README.zh-CN.md 的"创建第一个环境"流程新建一个环境并点击"打开",确认 Chromium 内核正常启动、Cookie 与缓存写入对应环境目录。
如果 macOS 提示"已损坏"(damaged):这通常是下载过程破坏了文件属性(quarantine 标记)。优先重新从 Releases 下载并核对 SHA-256,而不是用命令行强行移除属性后使用来路不明的文件。
三、Windows 安装排障:SmartScreen 的正确打开方式
一键操作步骤
- 双击
Prism-Browser-Setup.exe安装版,或运行 Portable 便携版; - 若出现蓝色 SmartScreen 提示窗口,点击 "更多信息";
- 展开后点击 "仍要运行";
- 安装完成前若弹出 UAC(用户账户控制)窗口,点击"是"。
安装后自检清单
- ✅ 管理端窗口完整渲染,13 种界面语言之一正常显示(语言库说明见 docs/localization.md);
- ✅ 浏览器内核页面显示内置的 Chromium 144 指纹内核已可用,普通用户无需自行编译;
- ✅ 新建环境并打开,关闭后数据仍保留在本地用户数据目录。
项目内置了一套 Windows 安装包自动验收脚本(校验安装包哈希、内置内核完整性、多环境数据隔离),其检查项可参考 tools/windows-acceptance/README.md。你可以用同样的思路自检:哈希对得上、界面能渲染、两个环境数据互不串号,安装就是成功的。
四、安全核对:安装前必做的 2 件事
- 只从官方 Releases 下载,不要从第三方下载站、网盘镜像获取安装包;
- 逐字核对 SHA-256:把下载文件的哈希值与 Releases 页面公布值完全一致才算通过。
发布侧的签名与公证流程也是公开可查的:macOS 正式版本会使用 Developer ID 证书 + hardened runtime 签名并做 Gatekeeper 验收,Windows 正式版本使用 Authenticode 证书与 RFC 3161 时间戳(流程文档见 tools/release/README.md)。如果你拿到的是已正式发布的签名版本,理论上不应出现拦截——被拦截时更要先怀疑下载来源。
五、进阶:自编译内核为什么"必然"未签名?
开发者按 README.zh-CN.md 编译 Chromium 144 指纹内核后,可以用 tools/macos-kernel/Sign-Local-Build.sh 对产物做本地 ad-hoc 签名(codesign --sign -)。这类签名只保证完整性校验通过,不具备 Developer ID 身份,所以 Gatekeeper 拦截是预期行为,按上文"三步放行"处理即可。
同样,应用内的更新功能在 internal-unsigned 模式下会显示"内部更新已验证;安装时操作系统仍会提示未签名"——这说明应用层已验证更新完整性,剩下的提示来自操作系统,属于正常现象(逻辑位于 src/main/update-manager.ts)。
六、快速排障速查表
| 症状 | 系统 | 处理动作 |
|---|---|---|
| "无法验证开发者 / 已损坏" | macOS | 系统设置 → 隐私与安全性 → 仍要打开;仍失败则重新下载并核对 SHA-256 |
| "Windows 已保护你的电脑" | Windows | SmartScreen → 更多信息 → 仍要运行 |
| 官方签名版也被拦截 | 双平台 | 极可能是仿冒包,核对 SHA-256 与发布者,删除重下 |
| 自编译包无法启动 | macOS | 用 Sign-Local-Build.sh 完成本地签名后,再按放行流程操作 |
| 更新安装时提示未签名 | 双平台 | 内部未签名测试通道的预期提示,属正常现象 |
小结:Prism Browser 的安装拦截几乎都源于"未签名 / ad-hoc 签名"这一信任模型问题,而不是程序本身异常。记住三条原则:只从 Releases 下载、核对 SHA-256、按系统指引手动放行,你就能在 macOS 与 Windows 上顺利完成安装并开始管理多配置浏览器环境。