English
打开网页版
使用手册同步与数据

自托管授权

私有部署的免费版与全量授权：包含哪些功能、怎么购买和激活、席位与迁移，以及授权的限制。

私有部署的服务端一个程序、一个镜像，基础功能永久免费。需要 AI、内容推送和 MCP 时，按用户购买全量授权。授权在服务端离线验证，激活后断网也能一直使用。

价格与在线购买见 自托管价格。

授权策略

免费版与全量授权

免费版 全量授权
价格 免费，无需授权 按用户（席位）一次买断，含一年免费升级
用户数、笔记数、附件容量 不限 不限
笔记、附件与多端同步，历史版本 ✓ ✓
用户管理（注册、登录、角色、停用、删除）、邮件邀请 ✓ ✓
站点设置、附件策略、S3 服务、邮箱服务 ✓ ✓
笔记分享与公开文件 ✓ ✓
密钥管理 ✓ ✓
定时备份到 S3、导出、导入（Markdown、Joplin、Obsidian） ✓ ✓
任务提醒与日历订阅、API 令牌 ✓ ✓
AI 服务与 AI 功能管理 — ✓ 全站
审计日志 — ✓ 全站
S3 附件库扫描与清理 — ✓ 全站
AI 问答 — ✓ 按席位
内容推送到 WordPress — ✓ 按席位
MCP（让 Claude、Cursor 等 AI 工具读写笔记） — ✓ 按席位
  • 全站功能：激活授权后，整个服务端都可以使用。
  • 按席位功能：只有管理员分配了席位的用户可以使用；其他用户照常使用免费功能，数量不限。
  • 套餐、配额、试用和在线支付只用于官方云服务，不随自托管授权出售。自托管服务端无论有没有授权，都不会限制用户的笔记数和容量。

席位

一个席位对应一个可以使用 AI 问答、内容推送和 MCP 的用户。

  • 购买多少席位，就可以在服务端为多少位用户开通这些功能。
  • 管理员在服务端「管理后台 → 用户」中为用户分配席位或收回席位。
  • 停用、封禁或删除用户会自动释放他的席位。
  • 如果分配的人数超过授权的席位数（例如换成了席位更少的授权），最早分配的席位继续有效，其余的显示为「待生效」，直到有席位空出来。

一次买断与免费升级

  • 授权一次买断，不会过期：购买时已经部署的版本，以及免费升级期内发布的所有版本，都可以永久使用全部付费功能。
  • 免费升级期默认为购买后一年。之后发布的新版本，付费功能会暂停，联系我们续费延长升级期后恢复；继续使用升级期内的版本则不受影响。
  • 判断依据是服务端程序的发布日期，与服务器的系统时间无关，改系统时间不会影响授权。

获取授权

授权码形如 IVY-XXXX-XXXX-XXXX-XXXX，有三种方式拿到：

  1. 在官网购买：登录 我的账户，在「我的授权」中点「购买全量授权」，填写用户数（席位）并付款。付款完成后，授权出现在「我的授权」中，并发送到你的邮箱。
  2. 管理员发放：企业采购或线下付款时，我们会把授权直接发放到你的官网账户，登录即可看到。
  3. 收到授权码：如果拿到的只是一串授权码，在「我的授权 → 绑定授权码」中输入，把它绑定到自己的账户。已经绑定到其他账户的授权码不能再绑定。

需要对公转账、发票或批量采购，请在 自托管价格 页填写「企业采购」表单。

激活授权

一份授权只能激活一台服务端。激活时，授权会与这台服务端的「实例 ID」绑定。

在线激活（推荐）

服务端能访问 ivynote.net 时：

  1. 用管理员账户登录服务端，打开「管理后台 → 站点授权」。
  2. 在「在线激活」中输入授权码，点「激活」。

完成后，页面显示「全量授权」和席位数。

离线激活（内网环境）

服务端不能联网时：

  1. 在服务端「管理后台 → 站点授权」中复制激活请求（以 ivyreq1. 开头）。
  2. 在任意能上网的设备上登录 我的账户，在对应授权下展开「离线激活」，粘贴激活请求，点「生成授权证书」。
  3. 复制或下载授权证书（以 ivylic1. 开头），回到服务端的「站点授权」页粘贴，点「激活」。

用环境变量或命令行配置

适合用 Docker、Kubernetes 或自动化脚本部署：

# 二选一：直接传入证书，或指向保存证书的文件
IVY_LICENSE=ivylic1.…
IVY_LICENSE_FILE=/run/secrets/ivynote-license

由环境变量提供的证书优先于后台粘贴的证书，后台不能修改。服务端也提供命令行：

ivynote license status      # 查看当前版本、实例 ID、席位和问题
ivynote license request     # 输出激活请求（离线激活用）
ivynote license set @证书文件  # 安装授权证书
ivynote license clear       # 移除授权，回到免费版

如果希望授权有问题时服务端拒绝启动、而不是悄悄降为免费版，设置 IVY_REQUIRE_EDITION=pro。

绑定域名

设置了 IVY_PUBLIC_URL 的服务端，激活请求会带上它的域名，证书也会绑定这个域名。之后修改服务端域名时，需要先解绑授权再重新激活。

日常管理

增加席位

在 我的账户 的对应授权下点「增加席位」并付款。

  • 能联网的服务端每天会与官网核对一次授权，自动领取新的席位数，不需要任何操作。
  • 想立即生效，在「站点授权」页点「立即核对」。
  • 离线服务端需要重新执行一次离线激活，换上新证书。

迁移到另一台服务器

  1. 在 我的账户 中找到授权，点「解绑」。
  2. 在新服务端上重新激活（在线或离线均可）。
  • 每份授权每年最多自助解绑 3 次；需要更多次数请联系我们。
  • 解绑后，原服务端会在下一次联网核对时停用付费功能。

如果新服务器是用原服务器的数据备份恢复的（实例 ID 随数据一起迁移），则不需要解绑，授权继续有效。

联网核对

激活了全量授权的服务端，每天会访问一次 ivynote.net 核对授权状态：

  • 发送的信息只有：授权编号、实例 ID、服务端域名、版本号和构建日期，不包含任何笔记或用户数据。
  • 连不上官网时不影响使用，授权照常有效。
  • 官网返回「已撤销」（例如退款）或「已解绑」时，这台服务端的付费功能停用。
  • 席位或升级期有变化时，自动换上新的授权证书。

不希望服务端访问官网时，设置 IVY_LICENSE_SERVER=off，在线激活和联网核对都会关闭，只能离线激活。

授权失效时会怎样

以下情况，服务端会回到免费版：

  • 移除了授权，或证书无法验证（格式错误、被改动过）；
  • 证书属于另一台服务端，或绑定的域名与 IVY_PUBLIC_URL 不一致；
  • 运行的版本发布于免费升级期之后；
  • 联网核对得知授权已被撤销或已解绑。

此时只是隐藏付费功能：笔记、同步、登录、分享与导出始终可用，不会丢失任何数据。AI 服务、推送博客等配置会保留，重新激活后全部恢复。「站点授权」页会显示具体原因。

限制

  • 一码一机：一份授权同时只能激活一台服务端。在多台服务端上使用，需要购买多份授权。
  • 自助解绑次数有限：每年 3 次。
  • 离线环境无法实时撤销或解绑：完全不联网的服务端感知不到授权在官网的变化（例如退款撤销、已解绑），会继续按证书运行，直到免费升级期结束后升级新版本。
  • 升级期：免费升级期结束后，只能继续使用升级期内发布的版本，或联系我们续费后升级（目前不支持在线续费）。
  • 不包含官方云服务的计费功能：套餐、配额、试用和在线支付不随自托管授权提供。
  • 授权与服务端绑定：重新安装且没有保留数据（实例 ID 改变）时，需要先在官网解绑再重新激活。

常见问题

免费版有用户数或时间限制吗？ 没有。免费版不限用户数、笔记数和容量，也没有试用期。

席位是按注册用户算的吗？ 不是。只有被分配了席位、需要使用 AI 问答、内容推送和 MCP 的用户才占席位。

授权会过期吗？ 不会。免费升级期结束只影响升级到之后发布的新版本，已部署的版本可以一直使用全部功能。

授权码丢了怎么办？ 登录 我的账户，在「我的授权」中随时可以查看和复制。

激活时提示「已在另一台服务端激活」？ 先在「我的授权」中解绑，再到新的服务端激活。

有疑问？提交反馈 反馈与需求