Hoppscotch Desktop
Hoppscotch Desktop 是基于 Tauri 的跨平台 API 开发客户端，可创建和保存请求，支持 REST、GraphQL、WebSocket、SSE、Socket.IO、MQTT 与客户端证书。
适合做什么
Hoppscotch Desktop 适合需要轻量跨平台界面来组织 API 请求、集合、环境和实时连接的开发者。与网页端相比，桌面应用不受同样的浏览器 CORS 限制，并能直接处理客户端证书与本地网络。需要复杂团队治理时应连接云端或自建实例；只为网页端中继请求的用户则应区分 Agent，而不是重复安装完整客户端。
发布与平台说明
当前发布页的标签为 26.7.0 对应系列，部分资产标签带构建后缀。官方文档说明桌面应用内部用两位年份作为主版本，因此 26.7.0 与 2026.7.0 是同一命名规则的不同展示。平台包含 Windows 64 位、macOS Intel 与 Apple 芯片，以及 Linux DEB 和 AppImage。
本地、同步与证书边界
独立模式把集合、环境、历史和凭据保存在本机；连接云端或自建实例时，会同时存在本地副本和服务器数据。Secret 环境变量明确排除同步。客户端证书和关闭 TLS 校验都属于高风险配置，应限制到具体域名；添加自建实例还会让桌面端加载该实例的应用包，只有可信部署地址才应加入。
维护记录
本页于 2026-08-06 根据 Hoppscotch 26.7.0 发布资产、桌面安装、版本编号、连接实例、客户端证书与安全策略复核。
选择下载方式
下载前请核对资源版本和授权范围。本站不提供破解软件及未经授权的资料。
Hoppscotch Desktop 安装与首次 API 请求教程
下面以 26.7.0 为例，完成跨平台安装、独立模式中的第一条请求、环境变量和本地安全检查。
安装前准备
- macOS 按 Intel 或 Apple 芯片选择 DMG，Windows 使用 64 位 MSI 或便携版，Linux 选择 DEB 或 AppImage。
- 准备一个无破坏性的测试接口，不要一开始就使用生产写入、删除或支付接口。
- 涉及内网、自签名证书或客户端证书时，先向管理员确认信任链和最小权限做法。
安装步骤
- 01
选择系统对应的发布包
Windows 安装版与便携版按管理需求选择；Linux AppImage 需要执行权限；macOS 首次打开的安全提示应先核对签名和文件来源。
- 02
选择独立或连接实例
个人本地调试可先使用独立模式；只有需要云同步、团队空间或自建服务时才添加实例。添加实例会加载其应用包，是一项明确的信任决策。
- 03
设置本地数据保护
确认设备已启用磁盘加密和账号锁屏，避免多人共用系统账户。令牌和密钥放入环境变量，并将敏感项标记为 secret。
快速上手
- 01
新建并发送 GET 请求
选择 HTTP 请求，填写测试地址和方法后发送，检查状态码、响应头、正文与耗时，不要只根据页面是否出现内容判断成功。
- 02
保存集合与环境变量
将请求保存到命名清晰的集合，把主机和测试令牌提取为环境变量。切换环境后再次发送，确认变量解析到预期值。
- 03
测试证书或实时协议
需要时再添加 PEM、PFX/PKCS#12 客户端证书，或新建 WebSocket、SSE、Socket.IO、MQTT 连接。不要为排错全局关闭 TLS 验证。
使用建议
- 独立模式的集合、环境、历史和凭据存入本地应用数据，并依赖操作系统访问控制和磁盘加密。
- 连接云端或自建实例后，普通数据可能同步到服务器；secret 环境变量保留在本地，不应把真实密钥硬编码到共享请求中。
- 应用默认会写本地调试日志，分享日志前检查其中是否出现主机名、参数或错误上下文。
故障排查与卸载方法
请求在浏览器能成功，桌面端却失败怎么办？
对比代理、DNS、VPN、证书和请求头，确认桌面端是否访问到相同网络。内网接口还要检查系统防火墙和企业代理，而不是直接关闭 TLS 校验。
自建实例无法连接桌面端怎么办？
检查实例地址、证书和服务端允许来源配置。自建部署需要把桌面应用协议对应的来源加入白名单，并按部署方式启用桌面包访问。
- 导出集合并撤销凭据保存需要的集合、环境和测试脚本，删除或轮换本地保存的 API 令牌，确认云端或自建实例没有仍在使用的会话。
- 卸载并处理本地数据卸载应用后，根据保留需求清理应用数据、调试日志和版本备份。客户端证书和私钥若不再使用，应从存储位置与系统钥匙串中一并移除。
常见问题
Hoppscotch Desktop 不登录账号能用吗？
独立模式可以在本机创建请求、集合、环境和历史；连接 Hoppscotch Cloud 或自建实例后才会引入同步与团队能力。敏感环境变量应标记为 secret，避免进入服务器同步。
桌面版和 Hoppscotch Agent 是同一个程序吗？
不是。Desktop 是完整的 Tauri 客户端；Agent 是为网页端提供本地网络、客户端证书和绕过浏览器 CORS 限制的本地中继服务。普通桌面使用无需同时安装 Agent。
为什么官网发布页显示 2026.7.0，应用里却是 26.7.0？
官方桌面版本把年份缩写为两位，应用信息显示 26.x.x，发布页可能使用 2026.x.x 或带构建后缀的标签，两者对应同一发布周期。
下载时需要提取码吗？
夸克网盘无需提取码；百度网盘所需的四位提取码会直接显示在下载入口旁。