常见问题
整理安装与日常使用中的常见疑问，便于自行排查。若仍无法解决，请通过你获取 DevPeek 的官方渠道联系支持。
macOS / Linux 桌面版
DevPeek 桌面端目前仅提供 Windows 版。macOS 与 Linux 版很快到来，敬请关注本站首页下载或更新日志。
为什么调试页一直显示「等待设备连接」？
常见原因：设备未经 DevPeek 代理访问、手机未下载并信任 DevPeek 根 CA（HTTPS 无法解密与注入）、目标域名不在 SSL 白名单、或当前页面不是可注入的一则 HTML 文档响应。请先在抓包页确认该客户端已有可解密的 HTML 响应，再在调试 Tab 选中对应客户端 Tab 并在手机上刷新目标页。
连接异常时，页面上的 DevPeek 调试弹窗会列出候选 WebSocket 地址与连接状态——多网卡环境下便于核对是否连到了正确 IP。
预览里为什么没有某些脚本或样式？
预览始终遵守站点自身 CSP：被策略禁止的执行或加载在镜像中会失败——这不是 DevPeek 「坏了」，而是为了模拟浏览器安全模型；可在真机上对照验证。
SSL 配置了 * 仍然有隧道流量？
检查客户端是否真的把代理指向 DevPeek；以及应用是否勾选启用 SSL 代理。若域名不在白名单、或两端仍走 HTTP/3/QUIC 等未进入当前代理链路，则可能看不到期望的明文。
Mock 为何不生效？
- 是否在菜单「代理 → 启动 Mock」中启用了至少一条规则？侧栏 Mock 开关是否打开？
- 手动 Mock 是否勾选了请求 / 响应阶段；自动 Mock 是否填写了篡改内容。
- 是否开启了代理录制？目标客户端 Tab 是否处于「列表暂停」导致透传？加密参数是否需先配置参数转换？
自动更新不可用？
请确认当前网络可访问软件提供方配置的更新服务；部分内测、企业定制或离线安装包可能未包含自动更新。若应用数据目录无写入权限、磁盘空间不足或安全软件拦截下载，也可能导致更新失败，可按系统提示或向提供方咨询。
浏览器扩展一直无法连上桌面 DevPeek？
先确认本机已启动 DevPeek，且防火墙未拦截本机回环地址上的协作端口。若你曾在桌面应用中修改过协作 HTTP 监听端口，请在扩展弹出页填写相同端口以便探测。仍失败时可通过软件提供方给出的渠道反馈。
合规提示
DevPeek 提供中间人解密、报文改写与局域网转发能力。仅在你有权测试的系统上使用；勿拦截他人通信或窃取凭据。