授權
方案、席次、工作階段、執行個體、網域、簽到、寬限期、離線授權檔,橋接器可能處於的每種授權狀態,以及各狀態的修復方式。
SQLly Embedded 授權說明了同時有多少人可以使用 SQLly、從哪個網域、透過多少個橋接程式,以及使用期限。橋接程式會根據 sqlly.app 簽署的授權來強制執行。此頁面涵蓋規則,然後列出橋接程式可能處於的每種狀態以及對應的處理方式。
方案
| 執行計畫 | 席位 | 每個名額的分頁數 | 橋接數量 | 簽到次數 | 每年 |
|---|---|---|---|---|---|
| SQLly Embedded 試用 | 1 | 1 | 1 | 是 | 免費 3 個月 |
| SQLly Embedded 5 | 5 | 4 | 1 | 是 | $200 |
| SQLly Embedded 25 | 25 | 4 | 1 | 是 | $500 |
| SQLly Embedded 100 | 100 | 4 | 1 | 是 | $2000 |
| SQLly Embedded Offline 5 | 5 | 4 | 無限制 | 永不(授權檔案) | $500 |
| SQLly Embedded Offline 25 | 25 | 4 | 無限制 | 永不(授權檔案) | $1000 |
| SQLly Embedded Offline 100 | 100 | 4 | 無限制 | 永不(授權檔案) | $5000 |
| SQLLY Embedded 5(含終身授權) | 5 | 4 | 1 | 是 | 含於 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。橋接程式每分鐘會重新讀取檔案,所以換照就是換掉檔案。順利啟動後若檔案損壞或消失,會沿用最後一份有效授權並記錄警告;啟動當下就出問題則是致命錯誤,你一定會注意到。
授權金鑰與已連結的安裝
已連線的授權擁有一個 頁面金鑰 你在 Embedded 頁面產生的(重新產生會讓使用舊金鑰的橋接斷線),以及任意數量的 已連結的金鑰,只有它的 Redis 相容等級,SQLly 顯示的也就是這個。 連結流程。每個綁定的安裝都會列在該授權底下,你可以單獨撤銷某個安裝,不影響其他。
授權狀態
GET /manage/status 會將狀態報告為 license.state。只有 ok 和 grace 提供查詢服務並簽發啟動權杖。
| 狀態 | 仍提供服務? | 它的意義 | 要做什麼 |
|---|---|---|---|
ok | 是 | 最近已驗證;一切正常。 | 什麼都沒有。 |
grace | 是 | 期間結束至今還不到寬限天數。使用者會看到倒數計時。 | 續約,或更換離線授權檔。 |
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 分鐘內成功報到。 |