快速開始

ScriptVerify 是專業的 FiveM 腳本授權驗證系統。本指南將幫助您快速了解系統的核心功能。

系統功能

• 保護您的腳本代碼
• IP 綁定授權
• 多版本管理
• 即時驗證
• 檔案分發
• Firebase 認證

系統架構

管理員 ←→ Web 後台 ←→ Redis 數據庫
           ↓
       FastAPI 後端
           ↓
       FiveM Server (客戶端)

登入系統

管理員登入

1. 訪問系統網址
2. 點擊右上角「登入」按鈕
3. 使用 Firebase 認證登入
4. 確保您的 Email 已被授權為管理員

管理員權限：

• Email 必須在授權列表中（後端環境變數 AUTHORIZED_ADMIN_EMAILS）
• 默認管理員：[email protected]

客戶登入

客戶賬戶由管理員創建授權時自動生成。

核心概念

License Key（授權金鑰）

授權金鑰包含：

• 唯一識別碼（16位字符）
• 綁定 IP
• 授權腳本列表
• 創建時間

範例：

License Key: ABCD1234EFGH5678
Server IP: 123.45.67.89
Authorized Scripts: sun_carry, esx_society

Protected Scripts（受保護腳本）

• 存儲在 Firebase Storage 或版本管理系統
• 客戶端只能在驗證通過後獲取
• 支持多版本管理

驗證流程

1. FiveM 伺服器啟動
2. 讀取 sv_config.lua（License Key + Script Name）
3. 向 API 發送驗證請求
4. API 驗證：License + IP + Script 授權
5. 驗證通過 → 返回 server.lua 代碼
6. FiveM 執行 load() 載入代碼
7. 腳本正常運行

快速任務

管理員首次設置

1. 登入管理後台
2. 上傳第一個 Protected Script
3. 創建第一個 License Key
4. 授權腳本給該 License
5. 測試下載功能
6. 查看驗證日誌

客戶首次配置

1. 獲取 License Key（管理員提供）
2. 登入客戶面板
3. 下載 FiveM Resource
4. 配置 sv_config.lua
5. 啟動 FiveM 伺服器
6. 驗證授權成功

常見問題

無法登入

檢查 Firebase 配置和管理員權限

驗證失敗

確認 IP 綁定和腳本授權

找不到腳本

檢查 Protected Scripts 是否上傳

版本錯誤

確認 sv_config.lua 中的版本設置

下一步

選擇您感興趣的主題深入學習：