浏览器扩展连不上 Enpass — "找不到 Enpass"、连接超时、扩展点不开
扩展连接不上的现象
- 点击浏览器工具栏的 Enpass 图标 → 没反应（弹不出界面）
- 弹出界面里显示 "Cannot find Enpass app / 找不到 Enpass 应用"
- 显示 "Enpass app is not running / Enpass 未运行"
- 连接显示 "Not Connected / 未连接"
完整排查步骤
检查一：Enpass 桌面应用在运行吗
这是最常见的原因。 浏览器扩展不能独立工作——它必须通过进程间通信（IPC）和正在运行的 Enpass 桌面应用交换数据。
- 看系统托盘 / 后台（Windows 任务栏右下角、macOS 菜单栏）有没有 Enpass 图标
- 双击图标 → Enpass 主界面出现了吗
- 如果没在运行 → 手动启动 Enpass → 等 3~5 秒 → 刷新浏览器 → 再点扩展图标
Enpass 启动后，扩展通常需要 2~3 秒才能检测到进程。 如果一启动就点击扩展，可能会看到"正在连接中"的加载提示——等一下就好。
检查二：Enpass 已解锁吗
即使 Enpass 正在运行，但如果 Vault 还没解锁：
- 扩展能发现 Enpass 进程 → 会提示"请先解锁 Enpass 应用"
- 在 Enpass 里输入主密码 / 生物识别解锁 Vault → 扩展立即开始工作
检查三：浏览器扩展权限正确吗
Firefox（最严格）
Firefox 对扩展的权限管控最严。如果首次安装时没点"允许"，扩展就无法和 Enpass 通信：
- 地址栏输入
about:debugging#/runtime/this-firefox - 找到 Enpass 扩展 → 查看权限状态
- 如果权限不足 → 卸载扩展 → 重新安装 → 这次弹窗时一定要点"允许所有网站权限"和"与本地应用通信"
Chrome / Edge / Brave
Chromium 内核的浏览器权限相对宽松。检查：
chrome://extensions/（或 Edge 的edge://extensions/）- Enpass 扩展 → 详情
- 站点访问权限：设置为"所有网站"
- 允许访问文件 URL（某些 Enpass 版本需要）
Safari（macOS）
- Safari → 设置 → 扩展
- 确认 Enpass 扩展已开启
- 确认"允许在每个网站上使用"已勾选
检查四：版本兼容吗
扩展版本和 Enpass 应用版本差距太大可能导致通信协议不兼容：
- Enpass 应用 → 设置 → 关于 / About → 看版本号
- 浏览器扩展 → 右键图标 → 管理扩展 → 看版本号
- 两者不要差距超过几个版本 → 同时更新到最新
建议：打开浏览器扩展商店页面 → 更新扩展；同时打开 Enpass 设置里的更新检查 → 更新应用。
检查五：Enpass 的通信端口被挡了
Enpass 扩展和应用之间使用本地 HTTP 通信（通常是 localhost:某个端口）。某些软件可能拦了这个通信：
| 可能拦截的软件 | 解决方案 |
|---|---|
| 杀毒软件（360、火绒、Kaspersky） | 临时关闭试试看；如果关了能连 → 把 Enpass 加白名单 |
| 防火墙 | 允许 Enpass 的入站和出站连接（localhost 通信） |
| 代理软件（Clash、v2ray、Proxy Switchy） | 某些代理会劫持 localhost 通信 → 临时关闭试试 |
| 浏览器隐私插件（uBlock、AdGuard） | 极罕见但可能 → 临时禁用隐私插件试试 |
检查六：重启一切
如果上面都试了还不行：
- 关闭浏览器（所有窗口）
- 关闭 Enpass 应用（确认完全退出，不是最小化到托盘）
- 先启动 Enpass → 等它完全加载
- 再启动浏览器 → 等浏览器完全加载
- 点击扩展图标 → 看是否恢复正常
检查七：手动配对（最后手段）
如果自动发现一直不行：
- Enpass 应用 → 设置 → 浏览器扩展
- 找到"手动配对 / Manual Pair"区域 → 显示一个配对码
- 浏览器扩展界面里 → 找"手动连接 / Manual Connect"选项
- 输入配对码 → 确认
极端情况：完全重装
如果所有办法都试过还不行，可以考虑"彻底清洗"：
- 卸载浏览器扩展
- 卸载 Enpass 应用（Windows 控制面板、macOS 拖拽到废纸篓）
- 清理残留数据（Windows：
%APPDATA%\Enpass；macOS：~/Library/Application Support/Enpass） - 确认 Vault 备份完好（这步做在最前面！）
- 重新安装 Enpass → 从备份恢复 Vault
- 重新安装浏览器扩展
卸载重装前一定要确认 Vault 备份文件存在且能正常解密。如果不确定，先做一份手动备份（File → Backup）。
连接问题 vs 自动填充不工作
有时候扩展能连接但自动填充不触发——这是两个不同的问题：
- 连接问题（扩展点不开 / 显示 Not Connected）→ 本篇解决
- 自动填充不触发 → 参见 表单自动填充
移动端扩展？
移动端（iOS / Android）不支持 Enpass 浏览器扩展。 Enpass 在移动端的自动填充通过操作系统级集成完成（iOS 的密码自动填充、Android 的密码管理器）。如果手机上自动填充不工作：
- iOS：设置 → Safari / 设置 → 密码与账户 → 自动填充密码 → 确认 Enpass 已开启
- Android：设置 → 密码 → 默认密码管理器 → 选 Enpass
下一个：忘记主密码怎么办——参见 主密码遗忘不可逆。