剪藏服务连不上的逐项排查清单

扩展弹"无法连接到 Joplin 服务"是剪藏最高频的问题。按下面的顺序查，绝大多数能在前三步解决。

排查清单（按命中率排序）

1. 桌面应用在运行吗？服务开着吗？

剪藏服务由 Joplin 桌面应用托管——应用没开服务就不在。到 配置 > 网页剪藏 确认服务已启用，桌面应用处于运行状态（托盘最小化也算，但注意 Windows 下关窗口可能只是缩到托盘，真正退出见安装类问题）。

2. 端口被拦了吗？

配置界面的剪藏区块能看到服务端口。本机防火墙、安全软件可能拦截该端口——放行 Joplin 或对应端口后重试。

3. 本机开着代理吗？

系统代理、抓包工具、部分浏览器代理插件会把扩展发往本机端口的请求劫走。把本机地址加入代理白名单，或暂时关代理验证。

4. 重启一次

服务开了但状态异常时，重启 Joplin 桌面应用（彻底退出再开）往往直接解决。

还不行：拿扩展日志

• Chrome：扩展管理页开启开发者模式；右键扩展图标"检查弹出内容"看面板日志；扩展页里"检查视图：服务工作进程/背景页"看后台日志；
• Firefox：打开 about:debugging 勾选启用附加组件调试，找到 Joplin 扩展点"检查"，配合 F12 主控制台。

日志连同复现步骤发到 Joplin 官方论坛，社区响应一直很活跃。

一句话备忘

服务在、端口通、代理让路——三件事齐了剪藏就通。修好后回到剪藏用法继续用。

调试入口名称随浏览器版本略有差异，以官方最新文档为准。