このスクリプトはFiveMサーバー用のCloudflareキャッシュパージスクリプトです。QB Coreフレームワークに対応しており、リソース読み込み時やコマンドの実行でCloudflareのCDNキャッシュをパージします。
謎の需要を満たすために作成されました。
- 自動キャッシュパージ: リソース読み込み時に自動でキャッシュをパージ
- 手動キャッシュパージ: 管理者コマンドでキャッシュをパージ
- プレフィックスパージ: 特定のURLプレフィックスのみをパージ
- 全体パージ: 全てのキャッシュをパージ
- 定期パージ: 指定した間隔で定期的にパージ(オプション)
- デバッグモード: 詳細なログ出力
Cloudflare APIトークンには以下の権限が必要です:
- Zone:Cache Purge - キャッシュパージ権限
- このリポジトリをダウンロードまたはクローン
resources/[standalone]フォルダに配置
config.lua ファイルを編集して設定を行います:
Config = {}
Config.Cloudflare = {
-- Cloudflare API Token (Zone:Cache Purge権限が必要)
apiToken = "your_cloudflare_api_token_here",
-- Zone ID (Cloudflareダッシュボードで確認可能)
zoneId = "your_zone_id_here",
-- パージするプレフィックス (空の場合は全てのキャッシュをパージ)
purgePrefixes = {"example.com/files", "cdn.example.com/assets"},
-- デバッグモード
debug = false
}| 項目 | 説明 | 例 |
|---|---|---|
apiToken |
Cloudflare API Token | "abc123def456..." |
zoneId |
CloudflareのZone ID | "1234567890abcdef..." |
purgePrefixes |
パージするURLプレフィックス | {"example.com/files"} |
debug |
デバッグログの表示 | true または false |
- Cloudflareダッシュボードにアクセス
- 「Create Token」をクリック
- 「Custom token」を選択
- 以下の権限を設定:
- Permissions: Zone:Cache Purge:Edit
- Zone Resources: Include:Specific zone:あなたのドメイン
- 「Continue to summary」→「Create Token」
- Cloudflareダッシュボードでドメインを選択
- 右側のサイドバーに「Zone ID」が表示されます
リソースが読み込まれると自動的にキャッシュパージが実行されます。
以下のコマンドで手動実行できます:
コンソールから:
purgecache
ゲーム内(管理者のみ):
/purgecache
他のリソースから呼び出すことも可能です:
-- キャッシュパージを実行
exports['cloudflare-cache-purge']:purgeCache()
-- 定期パージを開始(30分間隔)
exports['cloudflare-cache-purge']:startPeriodicPurge(30)purgePrefixes = {"example.com/files", "cdn.example.com/images"}purgePrefixes = {}→ {"purge_everything": true} としてAPIに送信
[Cloudflare Cache Purge] [DEBUG] 指定のプレフィックスをパージします:
[Cloudflare Cache Purge] [DEBUG] - example.com/files
[Cloudflare Cache Purge] [SUCCESS] Cloudflareキャッシュのパージが完了しました
[Cloudflare Cache Purge] [ERROR] Cloudflare API Tokenが設定されていません
[Cloudflare Cache Purge] [ERROR] Cloudflare APIリクエストが失敗しました (HTTP 403)
1. API Token エラー
- API Tokenが正しく設定されているか確認
- Zone:Cache Purge権限があるか確認
2. Zone ID エラー
- Zone IDが正しいか確認
- API Tokenが該当ゾーンにアクセス権限があるか確認
3. HTTP 403 エラー
- API Tokenの権限不足
- Zone IDとAPI Tokenの組み合わせが正しくない
4. キャッシュがパージされない
- プレフィックスの設定が正しいか確認
- QB Core Framework
- FiveM Server