Joplin 国内使用指南
Joplin 在国内网络环境下的下载、同步与开源协议解读（2026-11-10 更新）。地址清单以 joplinapp.org 与官方 Releases 为准，随版本修订同步更新。
安装包从哪里下
- 官网 joplinapp.org：访问 官方下载页 会自动检测系统并开始下载，国内一般可以直连。
- GitHub Releases（官方渠道）：laurent22/joplin 的 Releases 提供全部历史版本与 SHA256 校验值。直连不稳定时可套 gh-proxy 镜像前缀加速（见下）。
- 安卓 APK：从 Google Play 或 GitHub Releases 下载官方 APK（自带简体中文）。应用商店与 APK 功能一致。
- iOS：直接在 App Store 搜索「Joplin」下载，不受 GitHub 网络影响。
- 国内备用：GitHub 与镜像都不稳定时，可用本站 夸克网盘备用下载（含提取码与二维码）。文件为官方发布版本的转存，装前同样核对文件版本与 SHA256 校验值。
GitHub 下载加速方案
- gh-proxy 镜像前缀：把 Releases 安装包链接套上镜像域名（gh-proxy.com、ghfast.top、ghproxy.net 任选），整条链接形如
https://镜像域名/https://github.com/laurent22/joplin/releases/download/v3.7.22/Joplin-Setup-3.7.22.exe。公共镜像域名换得勤，哪个失效就换名单里的下一个，前缀拼法不变。 - Linux 安装脚本加速：官方一键安装脚本托管在 raw.githubusercontent.com，国内可能超时，可用 gh-proxy 前缀访问，或改用
wget配合镜像下载脚本内容后本地执行。 - 桌面端自动更新：Joplin 桌面端的自动更新走 GitHub Releases，国内若更新慢，可以手动到镜像加速地址下载新版本安装包覆盖安装。
同步方案：不依赖 GitHub 的 WebDAV
Joplin 的同步与下载是两条独立的链路。下载完应用后，多设备同步建议直接用 WebDAV——国内用户最常用的是坚果云（免费额度足够笔记同步）。在 Joplin 设置 → 同步中选择「WebDAV」，填入坚果云生成的第三方应用密码即可。具体步骤见 同步方案对比 与 同步失败排查指南。
开源协议：AGPL-3.0 能商用吗
Joplin 的仓库根目录 LICENSE 明确声明：仓库内所有代码以 AGPL-3.0-or-later 许可发布（子目录若另有 LICENSE 文件则以该文件为准，例如 packages/server 目录）。GitHub 仓库页的 license 字段因多许可结构显示为 NOASSERTION，实际以仓库 LICENSE 声明为准。
- 自用零成本：装机、改代码、备份、多设备同步统统不收费，设备台数随你。
- 可以商用，但有条件：AGPL-3.0 允许自由使用、修改与再分发（包括商用），但如果你修改了代码并以网络服务形式提供给他人使用（例如自建 Joplin Server 对外提供服务），则必须向服务对象提供修改后的完整源码。
- 商标与图标：Joplin® 是 JOPLIN SAS 在欧盟注册的商标；Joplin 的 Logo 与图标版权归 Laurent Cozic 所有，未经许可不得使用。商用前请留意商标与图标条款。
简单对比：Apache-2.0 更宽松（不要求网络服务开源），AGPL-3.0 更强调「服务即发布」的传染性。对绝大多数个人笔记用户来说，两者没有体验差别；只有当你计划基于 Joplin 做商业服务时，才需要认真对待 AGPL 的条款。
常见网络问题速查
- GitHub 下载慢或断流：换 gh-proxy 镜像前缀重下，装前先对一遍 SHA256；镜像也不稳时可用 夸克网盘备用下载。
- 官网打不开：joplinapp.org 偶尔也会被干扰，可稍后重试，或直接到 GitHub Releases / 应用商店下载。
- 自动更新失败：桌面端更新检查走 GitHub，失败时手动下载新版安装包覆盖即可，数据不会丢失。
- 安卓没有 Google Play：到 GitHub Releases 下载官方 APK 手动安装，首次安装允许「未知来源」即可。