许可
套餐、席位、会话、实例、域名、签入、宽限期、离线许可证文件、桥接程序可能处于的每种许可证状态,以及每种状态的修复方法。
SQLly Embedded 许可证规定了可以同时使用 SQLly 的人数、来自哪个域、在多少个桥接上用,以及用到什么时候。桥会依据 sqlly.app 签发的授权来强制执行。本页介绍这些规则,然后逐一介绍桥可能处于的每种状态及各自的应对办法。
计划
| 计划 | 席位 | 每席位标签页数 | 桥接 | 签入次数 | 每年 |
|---|---|---|---|---|---|
| SQLly Embedded 试用 | 1 | 1 | 1 | yes | 免费 3 个月 |
| SQLly 嵌入式 5 | 5 | 4 | 1 | yes | $200 |
| SQLly Embedded 25 | 25 | 4 | 1 | yes | $500 |
| SQLly Embedded 100 | 100 | 4 | 1 | yes | $2000 |
| SQLly 嵌入式离线 5 | 5 | 4 | 没有限制 | 从不(许可证文件) | $500 |
| SQLly 嵌入式离线 25 | 25 | 4 | 没有限制 | 从不(许可证文件) | $1000 |
| SQLly 嵌入式离线 100 | 100 | 4 | 没有限制 | 从不(许可证文件) | $5000 |
| SQLly Embedded 5(终身) | 5 | 4 | 1 | yes | 包含在 SQLly 终身版中,永不过期 |
每个 sqlly.app 账户都会自动获得试用。购买计划请到 SQLly Embedded 页面 并在上面管理它们 你的 Embedded 页面。需要不同的条款,比如更多席位、更多桥接器、固定截止日期或更长的宽限期?我们可以签发带自定义条款的许可证。 问我们.
规则
席位
席位是 并发用户 在该许可证的每个桥接上。用户在打开 SQLly 或持有未过期的启动令牌期间占用一个席位,两者都消失的瞬间席位即被释放。每个席位可以同时打开多个标签页(见表格)。你的应用在签发令牌时传入用户 ID,因此由你决定什么算“一个用户”。
域名
每个许可证对应一个域名,其所有子域名都包含在内(example.com 覆盖 app.example.com 和 eu.app.example.com)。桥接只接受其 Origin 匹配项,另外 localhost 当 --allow-localhost-origins 处于开启状态。你可以随时在 Embedded 页面上设置域,也可以让以 --domain 绑定它。没有域名的许可证只能在 localhost 上使用,这对开发来说已经足够。
桥接(实例)
已连接的许可证同时运行的桥接进程数量是固定的,标准方案为一个。使用同一许可证的第二个桥接会被告知未获准入,而第一个桥接继续签到。桥接正常停止(Ctrl-C 或服务停止)时,槽位立即释放;桥接停止签到 40 分钟后,槽位也会释放。离线许可证不统计桥接。
签入(已连接的许可证)
- 在启动时和每次 20 分钟 桥接程序会签入并领取一份新的签名授权,有效期 40 分钟。
- 如果签到失败(sqlly.app 或你的出站网络中断),桥接会继续提供服务,直到 40 分钟 在其最后一次有效授权之后,然后进入 过期 并暂停查询。下一次成功签到后即恢复工作,无需重启或刷新页面。
- 管理员的 立即签入 (
POST /manage/license/checkin)会立即重试。
到期与宽限期
每个许可证可继续使用 15 天 在其有效期结束后(自定义许可证可自行设置宽限期)。宽限期内,每位 SQLly 用户都会看到 “本站点的 SQLly Embedded 许可证将在 N 天后到期。请让管理员续订。” 之后,查询会停止,并显示 “…已过期。” 续订(在线套餐是按年付费,离线套餐则是更换新的许可证文件)无需重启即可让桥接器恢复:在线桥接器会在下次签入时获知,离线桥接器则在一分钟内获知。
离线许可证文件
离线套餐适用于绝不能联系 SQLly 的服务器。先在 Embedded 页面上设置域(许可证文件会带上它),然后 下载许可证文件 并使用以下命令启动桥接 --license-file启动桥接器。桥接器每分钟会重新读取一次该文件,因此续期就是替换文件。顺利启动后文件损坏或丢失,会保留上一个有效许可证并记录一条警告;启动时则视为致命错误,好让你一定能注意到。
密钥和关联安装
一个已连接的许可证有一个 页面密钥 你在你的嵌入页面上生成的(重新生成它会断开使用旧密钥的桥接),加上任意数量的 关联键,每个安装一个,通过 链接流程。每个已关联的安装都会列在许可证下面,你可以单独撤销某个安装而不影响其他。
许可证状态
GET /manage/status 报告状态为 license.state。只有 ok 和 grace 处理查询并签发启动令牌。
| 状态 | 提供服务? | 它的意思 | 该怎么办 |
|---|---|---|---|
ok | yes | 最近已验证;一切正常。 | 无。 |
grace | yes | 期限结束至今还不满宽限天数。用户会看到倒计时。 | 续订,或替换离线许可证文件。 |
stale | 否 | 40 分钟内没有成功签到。 | 检查桥接主机到 sqlly.app 的出站 HTTPS 和主机时钟(NTP),然后 立即签入. |
not_admitted | 否 | 另一个桥接占用了许可证的实例槽。 | 停止其他桥接,或在其停止签到 40 分钟后等待。 |
expired | 否 | 宽限期已过。 | 续订或购买套餐;离线版:下载并替换许可证文件。 |
revoked | 否 | 密钥已重新生成,安装已解除关联,或者许可证已被撤销。 | 使用 Embedded 页面中的当前密钥,或重新关联此安装。 |
domain_mismatch | 否 | 桥接器启动时带有一个 --domain ,而许可证并未绑定到它。 | 更改 SQLLY_EMBEDDED_DOMAIN 或 Embedded 页面上的域名,使两者一致。 |
unlicensed | 否 | 启动时没有密钥或文件,也尚未关联。仍可设置和测试配置文件。 | 从你的管理应用关联,或使用密钥或文件重新启动。 |
在拒绝状态下,已打开的 SQLly 标签页保持连接,每个请求都会得到说明,SQLly 会在状态栏和通知中显示它。新标签页会收到这条说明并被关闭(代码 4503),启动令牌则会 503 license_not_ok 并带有同一句话,位于 message.
故障排除
| 现象 | 原因与解决方法 |
|---|---|
桥接器在启动时退出并报出 unknown license key | 密钥已重新生成或输入有误。请从你的 Embedded 页面复制当前密钥。 |
| 桥接器因许可文件错误而退出 | 文件缺失、损坏、已超过硬性截止日期,或是用其他密钥签名的。请重新下载。 |
| 浏览器在 WebSocket 上收到 HTTP 403 | 页面来源不是已授权的域名、子域名或 localhost。请绑定域名,或检查 --allow-localhost-origins. |
启动失败,出现 seat_limit | 所有席位都已占用。请先释放一个(DELETE /manage/seats/{user})或升级到更大的套餐。 |
| 新标签页会说明该用户已打开的会话数已达上限 | 该用户打开的标签页数已达到其席位允许的上限。请先关闭一个。 |
| SQLly 提示代理会话未连接 | 桥接器重启过,或令牌已过期。请重新加载页面;你的应用会签发一个新令牌。 |
状态显示 fromCache: true | 桥接器启动时 sqlly.app 无法访问,目前靠缓存的授权运行。它需要在该授权签发后的 40 分钟内成功签到一次。 |