问题排查

接入服务器时提示连接失败

提示	可能的原因与办法
地址格式不正确	地址需要以 https:// 或 http:// 开头，例如 https://web.ivynote.net
服务器在 15 秒内没有响应	检查网络；确认选择了正确的数据中心；连接自己的服务器时确认服务已启动、防火墙已放行
请求被拦截了	可能是不支持桌面端的旧版服务器、去掉了 CORS 响应头的反向代理，或网络中的代理拦截了这个地址。升级服务端，或检查反向代理配置
服务器返回了错误（HTTP xxx）	点击「查看详细日志」，复制日志后在 反馈页面 提交

一直显示「同步中」或「同步出错」

1. 检查网络连接，刷新页面或重启客户端。
2. 如果提示「N 条更改被服务器拒绝」，点开查看原因（例如附件超过大小限制）。
3. 仍然不行时，可以在 设置 → 清除本机缓存，重新从服务器下载全部数据。注意：未同步的更改会丢失，请先确认重要内容已同步。

导入失败或部分失败

• 不是 UTF-8 编码的文本：先把文件转换为 UTF-8。
• 本地链接找不到目标：单独选择文件时读不到它们引用的图片，请选择整个目录导入。
• 网络中断：重新导入同一份文件，会从断点继续，已导入的不会重复。
• 导入结束后可以 复制明细 并提交反馈。

图片不显示

• 刚粘贴的图片还在上传时，离线状态下其他设备暂时看不到，联网同步后即可显示。

Linux 上 AppImage 无法启动

• 先执行 chmod +x Ivynote_*.AppImage。
• 提示缺少 FUSE 时安装 libfuse2。
• 也可以改用 .deb 或 .rpm 安装包。

Windows 提示 SmartScreen

点击 更多信息 → 仍要运行。

还是解决不了？

在 反馈与需求 提交问题，附上客户端版本、操作系统和复现步骤，我们会尽快回复。