授權管理
完整教學：如何創建和管理客戶授權
授權管理完整教學
授權管理是 ScriptVerify 系統的核心功能。本教學將教您如何創建、配置和管理客戶授權金鑰。
授權系統概述
什麼是 License Key？
License Key（授權金鑰）是客戶使用您的腳本的憑證，包含：
┌────────────────────────────┐
│ 授權金鑰 │
├────────────────────────────┤
│ Key: ABC123DEF456 │ ← 唯一識別碼
│ IP: 123.45.67.89 │ ← 綁定的伺服器IP
│ 創建: 2025-10-04 │ ← 創建時間
│ 腳本: │ ← 授權的腳本列表
│ - sun_carry │
│ - vehicle_shop │
│ 備註: VIP客戶 │ ← 管理備註
└────────────────────────────┘授權驗證流程
FiveM 啟動
↓
sv_config.lua (License Key + Script Name)
↓
API 驗證請求
↓
檢查 License Key 是否存在
↓
檢查 IP 是否匹配
↓
檢查 Script 是否授權
↓
全部通過 → 返回 server.lua
任一失敗 → 拒絕存取創建新授權
基本創建流程
步驟1：進入授權管理頁面
左側導航欄 → 授權管理 (License Management)步驟2：點擊「創建新授權」
+ 創建新授權步驟3：填寫授權資訊
彈出表單包含以下欄位：
┌─────────────────────────────────┐
│ 創建新授權 │
├─────────────────────────────────┤
│ 授權金鑰（選填） │
│ [自動生成] │
│ 或輸入自訂金鑰... │
├─────────────────────────────────┤
│ 伺服器 IP * │
│ [123.45.67.89] │
├─────────────────────────────────┤
│ 備註（選填） │
│ [VIP客戶 - 永久授權] │
├─────────────────────────────────┤
│ 授權腳本（選填） │
│ sun_carry │
│ vehicle_shop │
│ esx_society │
├─────────────────────────────────┤
│ [取消] [創建授權] │
└─────────────────────────────────┘欄位說明
授權金鑰
選項1：自動生成（推薦）
留空 → 系統自動生成
格式：16位隨機字符
範例：ABC123DEF456GHI7選項2：自訂金鑰
自己輸入金鑰
規則：
- 長度：8-32 字符
- 可用字符：A-Z, a-z, 0-9, @, -
- 必須唯一
範例：
CUSTOMER_VIP_2025
TESTKEY_001
SUN-CARRY-PERM最佳實踐：
使用自動生成（安全、唯一）
避免簡單的金鑰（如 123456）
避免包含敏感資訊伺服器 IP
必填欄位，輸入客戶的 FiveM 伺服器 IP：
格式：
123.45.67.89 ← IPv4 地址
2001:0db8:85a3:: ← IPv6 地址（支援）
獲取 IP 方式：
1. 客戶提供
2. 查詢客戶伺服器 IP
3. 使用 https://ipv4.icanhazip.com/重要：
IP 必須完全匹配
動態 IP 會導致驗證失敗
IP 變更後需要更新授權備註
選填，用於管理備註：
好的備註範例：
- "VIP客戶 - 永久授權"
- "測試伺服器 - 2025/12/31 到期"
- "sun_carry v2.0 專用"
- "客戶ID: CUST-001"
用途：
區分不同客戶
記錄授權類型
標記到期日
客戶聯繫資訊授權腳本
選填，可以在創建時立即授權腳本：
創建時授權：
sun_carry
vehicle_shop
esx_society
或者：
創建後再授權完整範例
範例1：標準客戶授權
目的：為新客戶創建 sun_carry 授權
填寫：
┌─────────────────────────────┐
│ 授權金鑰：[自動生成] │
│ 伺服器 IP：123.45.67.89 │
│ 備註：John - sun_carry │
│ 授權腳本： │
│ sun_carry │
└─────────────────────────────┘
結果：
金鑰：XYZ789ABC123DEF456
客戶帳號自動創建
登入憑證自動生成
客戶收到郵件通知範例2：VIP 客戶授權
目的：為 VIP 客戶創建多腳本授權
填寫：
┌─────────────────────────────┐
│ 授權金鑰：VIP_PREMIUM_2025 │
│ 伺服器 IP：99.88.77.66 │
│ 備註：VIP客戶 - 全腳本授權 │
│ 授權腳本： │
│ sun_carry │
│ vehicle_shop │
│ esx_society │
│ all_others │
└─────────────────────────────┘
優勢：
容易識別的金鑰
一次授權所有腳本
清楚標記 VIP 身份範例3：測試授權
目的：創建測試用授權
填寫：
┌─────────────────────────────┐
│ 授權金鑰：TEST_2025_10_04 │
│ 伺服器 IP：127.0.0.1 │
│ 備註：測試用 - 30天後刪除 │
│ 授權腳本： │
│ sun_carry_dev │
└─────────────────────────────┘
注意：
使用測試專用腳本
記錄到期日
定期清理測試授權編輯現有授權
修改伺服器 IP
情境：客戶更換了伺服器 IP
步驟：
- 在授權列表中找到目標授權
- 點擊 ** 編輯圖標**
- 修改 IP 欄位：
舊 IP：123.45.67.89 新 IP：111.222.333.444 - 點擊 ** 確認**
- 系統會：
- 更新 Redis 數據
- 清除快取
- 3-5分鐘後生效
重要提醒：
IP 更新需要時間（3-5分鐘）
告知客戶稍後重啟伺服器
確認新 IP 正確無誤修改備註
步驟：
- 找到授權
- 點擊備註旁的 ** 編輯**
- 輸入新備註
- 保存
用途：
更新客戶狀態：
"測試中" → "已付款"
"30天試用" → "永久授權"
"待確認IP" → "IP已確認"授權腳本管理
為授權添加腳本
方法1：在授權詳情中添加
1. 點擊授權卡片查看詳情
2. 找到「授權腳本」區塊
3. 點擊「+ 添加腳本」
4. 選擇腳本：
┌────────────────────┐
│ 可用腳本： │
│ sun_carry │
│ vehicle_shop │ ← 新添加
│ esx_society │
└────────────────────┘
5. 保存方法2：批量授權
1. 選擇多個授權（勾選複選框）
2. 點擊「批量操作」
3. 選擇「授權腳本」
4. 選擇要授權的腳本
5. 確認移除腳本授權
步驟：
1. 進入授權詳情
2. 找到已授權的腳本
3. 點擊腳本旁的 按鈕
4. 確認移除效果：
移除後：
客戶無法再使用該腳本
FiveM 驗證會失敗
可以隨時重新授權查看授權的腳本
在列表視圖：
┌────────────────────────────────┐
│ ABC123DEF456 │
│ IP: 123.45.67.89 │
│ 腳本: sun_carry, vehicle... │ ← 縮略顯示
└────────────────────────────────┘在詳情視圖：
┌────────────────────────────────┐
│ 授權腳本： │
│ sun_carry │
│ vehicle_shop │
│ esx_society │
│ │
│ [+ 添加更多] │
└────────────────────────────────┘驗證日誌查看
什麼是驗證日誌？
記錄所有授權驗證請求的詳細資訊：
每次 FiveM 請求驗證時記錄：
授權金鑰
請求 IP
腳本名稱
驗證結果（成功/失敗）
失敗原因
時間戳查看日誌
進入驗證日誌頁面：
左側導航欄 → 驗證日誌 (Verification Logs)日誌列表：
┌─────────────────────────────────────────────┐
│ 2025-10-04 14:30:25 │
│ ABC123DEF456 │
│ 123.45.67.89 │
│ sun_carry │
│ 成功 │
├─────────────────────────────────────────────┤
│ 2025-10-04 14:25:10 │
│ XYZ789... │
│ 99.88.77.66 │
│ vehicle_shop │
│ 失敗：IP 不匹配 │
│ 授權IP: 123.45.67.89 │
│ 請求IP: 99.88.77.66 │
└─────────────────────────────────────────────┘篩選日誌
可用篩選條件：
時間範圍：
[今天] [昨天] [最近7天] [最近30天] [自訂]
狀態：
[全部] [成功] [失敗]
授權金鑰：
[搜索金鑰...]
腳本：
[全部腳本] [sun_carry] [vehicle_shop] ...分析日誌
成功驗證：
正常情況
→ 定期出現成功記錄
→ 同一 IP 和金鑰
→ 授權的腳本失敗驗證 - IP 不匹配：
常見原因：
1. 客戶更換了伺服器
2. 使用了錯誤的金鑰
3. IP 設置錯誤
解決方法：
→ 確認客戶的正確 IP
→ 更新授權 IP
→ 等待 3-5 分鐘生效失敗驗證 - 腳本未授權：
原因：
客戶嘗試使用未授權的腳本
範例：
授權腳本：sun_carry
請求腳本：vehicle_shop ← 未授權
解決方法：
→ 確認客戶是否應該有此授權
→ 添加腳本授權
→ 或告知客戶未購買該腳本失敗驗證 - 無效金鑰：
原因：
1. 金鑰輸入錯誤
2. 金鑰已刪除
3. 金鑰不存在
解決方法：
→ 確認金鑰是否存在
→ 檢查客戶的 sv_config.lua
→ 重新創建授權（如果刪除了）刪除授權
刪除單個授權
步驟：
1. 找到要刪除的授權
2. 點擊 刪除圖標
3. 確認刪除對話框：
┌────────────────────────┐
│ 確認刪除 │
│ │
│ 授權金鑰：ABC123... │
│ 伺服器IP：123.45.67.89│
│ │
│ 此操作無法復原！ │
│ │
│ [取消] [確認刪除] │
└────────────────────────┘
4. 點擊「確認刪除」會發生什麼：
立即效果：
授權金鑰失效
客戶無法驗證
FiveM 伺服器會報錯
客戶帳號被標記為無效
數據：
Redis 中的授權數據刪除
腳本授權關聯刪除
驗證日誌保留（供查詢）批量刪除
用途：清理過期或測試授權
步驟：
1. 勾選要刪除的多個授權
2. 點擊「批量操作」→「刪除」
3. 確認刪除前檢查清單
確認客戶已到期
確認不再需要此授權
已備份重要資訊
已通知客戶（如果需要）
確認沒有誤選其他授權搜索和篩選授權
快速搜索
搜索框：
搜索授權...
可搜索：
- 授權金鑰
- IP 地址
- 備註內容
- 授權腳本搜索範例：
輸入：ABC123
結果：所有包含 ABC123 的金鑰
輸入：123.45.67.89
結果：此 IP 的所有授權
輸入：VIP
結果：備註包含 VIP 的授權
輸入：sun_carry
結果：授權了 sun_carry 的所有授權高級篩選
篩選選項：
┌─────────────────────────┐
│ 創建日期： │
│ 今天 │
│ 最近7天 │
│ 最近30天 │
│ ● 全部 │
├─────────────────────────┤
│ 授權腳本： │
│ [全部腳本 ] │
├─────────────────────────┤
│ 排序： │
│ [最新創建 ] │
│ - 最新創建 │
│ - 最早創建 │
│ - 金鑰 A-Z │
│ - IP 地址 │
└─────────────────────────┘組合搜索
範例1：找出特定客戶的所有授權
搜索：CUST-001
篩選：全部時間
結果：該客戶的所有授權範例2：找出過期的測試授權
搜索：TEST
篩選：最近30天
結果：近期創建的測試授權
→ 檢查備註日期
→ 刪除過期的實戰案例
案例1：新客戶完整流程
背景：
- 客戶 John 購買了 sun_carry
- 伺服器 IP：123.45.67.89
- Email：[email protected]
完整步驟：
步驟1：創建授權
點擊「創建新授權」
填寫：
- 金鑰：[自動生成]
- IP：123.45.67.89
- 備註：John - sun_carry - 永久授權
- 腳本： sun_carry
保存 步驟2：記錄生成的資訊
系統生成：
授權金鑰：XYZ123ABC456
客戶帳號：customer_xyz123
客戶密碼：TempPass789步驟3：授權檔案（可選）
進入檔案中心
找到：
- sun_carry_v2.0.zip
- sun_carry_config.lua
- sun_carry_manual.pdf
授權給：customer_xyz123步驟4：發送通知給客戶
Email 內容：
主旨：ScriptVerify 授權已創建
親愛的 John，
感謝您購買 sun_carry！
您的授權資訊：
License Key：XYZ123ABC456
用戶名：customer_xyz123
密碼：TempPass789
系統：https://verify.example.com
伺服器配置：
1. 下載 FiveM Resource（檔案中心）
2. 解壓到 resources/sun_carry/
3. 編輯 sv_config.lua：
licenseKey = "XYZ123ABC456"
4. 啟動伺服器：ensure sun_carry
需要幫助？請查看使用手冊或回覆此郵件。
祝使用愉快！步驟5：客戶設置確認
24小時後檢查：
1. 查看驗證日誌
2. 確認有成功記錄
3. 如果沒有 → 聯繫客戶協助排查案例2：客戶更換伺服器
背景：
- 客戶更換了主機商
- 新 IP：99.88.77.66
- 舊 IP：123.45.67.89
處理流程：
1. 收到客戶通知：
"您好，我們更換了伺服器，新IP是 99.88.77.66，
請幫忙更新授權。謝謝！"
2. 找到客戶授權：
搜索：customer_xyz123
或：123.45.67.89（舊IP）
3. 編輯 IP：
舊IP：123.45.67.89
新IP：99.88.77.66
保存
4. 回覆客戶：
"已更新您的授權 IP。請等待 3-5 分鐘後重啟
您的 FiveM 伺服器。如有問題請隨時聯繫我們。"
5. 10分鐘後確認：
檢查驗證日誌
確認新 IP 的成功驗證記錄案例3：追加腳本授權
背景：
- 現有客戶購買了新腳本
- 已有授權：sun_carry
- 新購買：vehicle_shop
處理流程：
1. 找到現有授權：
搜索客戶金鑰或備註
2. 添加腳本：
進入授權詳情
→ 添加腳本
→ vehicle_shop
→ 保存
3. 授權相關檔案：
檔案中心
→ vehicle_shop_v1.0.zip
→ vehicle_shop_config.lua
→ 授權給客戶
4. 通知客戶：
"已為您的授權添加 vehicle_shop。
請登入客戶面板下載相關檔案。"
5. 更新備註：
舊：John - sun_carry - 永久授權
新：John - sun_carry + vehicle_shop - 永久授權最佳實踐
授權命名規範
好的備註範例：
客戶名 - 腳本 - 授權類型：
"John Smith - sun_carry - 永久授權"
"VIP-001 - 全腳本 - 年度訂閱"
"TEST_SERVER - sun_carry - 試用30天"
包含重要資訊：
"客戶ID:C001 - 到期:2025/12/31"
"Discord:john#1234 - sun_carry v2.0"不好的備註：
太簡單：
"客戶1"
"測試"
"temp"
無意義：
"aaa"
"新的"
"123"安全管理
保護授權資訊：
應該做：
- 定期檢查授權列表
- 刪除過期的測試授權
- 記錄重要變更
- 備份授權資料
- 使用強密碼保護管理後台
不應該做：
- 分享授權金鑰
- 在公開論壇發布完整金鑰
- 允許 IP 跨地區使用（除非正常）
- 忽略異常驗證日誌客戶服務
響應時效：
IP 更新請求：
1小時內處理
處理後立即通知客戶
提供預估生效時間
腳本授權：
2小時內處理
同時授權相關檔案
提供配置指南
問題排查：
4小時內回應
提供詳細日誌分析
必要時提供遠程協助故障排除
問題1：驗證持續失敗
症狀：
驗證日誌顯示持續失敗
客戶無法啟動腳本診斷步驟：
1. 檢查授權是否存在
在列表中搜索金鑰
確認未被刪除
2. 檢查 IP 是否匹配
查看驗證日誌中的 IP 對比
確認授權 IP 設置正確
3. 檢查腳本是否授權
查看授權詳情中的腳本列表
確認客戶請求的腳本已授權
4. 檢查客戶配置
確認 sv_config.lua 中的金鑰正確
確認腳本名稱拼寫正確問題2：IP 更新不生效
症狀：
更新了 IP 但驗證仍然失敗
顯示舊 IP 不匹配解決方法：
1. 等待快取清除（3-5分鐘）
2. 手動清除快取：
進入授權管理
→ 點擊「清除快取」
3. 確認 IP 已更新：
重新查看授權詳情
確認顯示新 IP
4. 客戶端操作：
重啟 FiveM resource
或重啟整個伺服器
5. 最後檢查：
查看新的驗證日誌
確認新 IP 的驗證請求問題3：創建授權失敗
可能原因：
1. IP 格式錯誤
解決：檢查 IP 格式（XXX.XXX.XXX.XXX）
2. 金鑰重複
解決：使用自動生成或更換金鑰
3. 網絡問題
解決：重試或稍後再試
4. 權限不足
解決：確認管理員權限延伸學習
完成本教學後，您可以繼續學習：
恭喜！您已經掌握了完整的授權管理！
現在您可以高效地管理客戶授權，提供優質的服務了。有任何問題都可以查看其他文檔或聯繫技術支援。