
Kuroco是成立於2005年,總部位於日本東京都新宿區的Diverta Inc.開發的API-First Headless CMS(無頭內容管理系統),源自Diverta長期開發的企業級CMS RCMS,於2021年4月15日正式推出,其測試版Kuroco β早在2020年就已經發布,旨在通過API將內容管理後端與網站、App等前端分離,讓開發者可以自由選擇技術棧和前端框架。
Diverta旗下的企業級Headless CMS Kuroco提供一項利用CDN技術的靜態空間託管服務——KurocoFront,是日本國內首例與GitHub聯動,且由日本企業提供配備完整CDN功能的託管服務。簡單來說就是日本版的Vercel/CloudFlare Pages,自帶日本節點的CDN加速、支持自定義域名、免費TLS證書、BASIC認證及IP地址限制等各項功能。
官方網站:https://kuroco.app

🎁託管服務與免費額度:
● 純靜態託管:支持HTML、CSS、JS、圖像或者打包好的前端(Hexo/Hugo/Nuxt導出的靜態文件)。
● 免費額度:沒有單獨的“免費套餐”,而是每月最高可享受円1,100日圓免費額度。折算差不多是50GB左右的CDN流量。
● 信用卡問題:註冊初期不需要信用卡,直接開通使用。但根據官方條款,開始用之後的一個月內(或者額度消耗達到70%前)需要補綁信用卡。
● 單文件限制30MB,壓縮包儘量不要超過300MB。
● 託管服務:根目錄必須新建一個專屬配置文件kuroco_front.json。否則即使部署成功訪問顯示也是404 Not Found。
👤註冊賬號:https://kuroco.app/ja/free_trial
サイトキー(Site KEY):xxxx(域名前綴。這個Site KEY很重要,填完之後您的三個地址)
後台:https://xxxx.g.kuroco-mng.app
API端點:https://xxxx.g.kuroco.app
網站前台:https://xxxx.g.kuroco-front.app
點擊「登録する」註冊之後,您會收到後台初始登陸地址和賬號密碼的郵件。
🪝WebHook部署Token:官方教程是怎麼連GitHub倉庫、怎麼運行GitHub Actions。其實Kuroco後台自帶一個WebHook接口,直接一個請求就能拉取Zip壓縮包部署。
儀錶盤左側菜單點擊「Channels」➠「WEB」➠「KurocoFront」,點擊「Add New Token」添加新令牌 ➠「Display」顯示複製保存Token,發部署請求時使用。Delete history that is 90 days old or older(刪除90天或更早之前的歷史記錄)勾選「Enable」啟用。Kuroco每次部署都會按版本存一份歷史文件,要是不開自動清理,老版本的存儲占用會一直疊加,白白浪費免費額度。
本地準備好要上傳的網站文件(例如:index.html、css、圖像等)。重點:根目錄下必須新建一個kuroco_front.json文件,否則服務器不知道怎麼路由。單頁應用或者導航站直接用下面這段最基礎的配置即可:
{
"rewrites": [
{
"source": ".*",
"destination": "/index.html"
}
],
"redirects": [],
"basic": [],
"ip_restrictions": []
}
將所有文件壓縮為.Zip壓縮包,壓縮包名:public。⚠️注意:打開壓縮包第一層必須直接看到index.html和kuroco_front.json文件。
🚀部署網站:
使用官網後台File Manager文件管理器將.Zip壓縮包上傳至KurocoFiles目錄下,獲取直鏈下載鏈接:https://您的域名前綴.g.kuroco-mng.app/files/user/您的壓縮包名.Zip
Kuroco的邏輯是:您給它一個.Zip壓縮包的公網直鏈,然後觸發WebHook,它自己去把.Zip壓縮包下載下來解壓到CDN。打開本地終端或VPS運行下面代碼觸發部署:
# 替換您的SiteKEY、Token和Zip直鏈
SITEKEY="您的域名前綴"
DOMAIN="${SITEKEY}.g.kuroco-front.app"
TOKEN="您的WebHook_Token"
ZIP_URL="https://您的域名前綴.g.kuroco-mng.app/files/user/public.zip"
# 計算域名的 SHA1 哈希值(Kuroco要求的參數)
HASH=$(printf '%s' "$DOMAIN" | sha1sum | awk '{print $1}')
curl -X POST "https://${SITEKEY}.g.kuroco.app/direct/menu/github/" \
-H 'Content-Type: application/json;charset=utf-8' \
-H "X-Kuroco-Auth: token ${TOKEN}" \
-d "{"data":{"domain":"${DOMAIN}","hash":"${HASH}","storage_url":"${ZIP_URL}"}}"
回車發送,只要看到返回:deploy requested!表示部署成功!等待幾分鐘刷新您的網站前台網址查看即可。
🌐自定義域名:點擊「Environment」環境設置 ➠「Custom domain/TLS certificate」自定義域名/TLS證書,Custom Domain:填入您的域名(例如:sub.yourdomain.com,不要帶https://和末尾斜槓)。添加CNAME或A記錄後,等待DNS解析狀態全部變成綠色“OK”之後,點擊「Account settings」賬戶設置 ➠「Front-End Domain」前台域名選擇“Change to https://sub.yourdomain.com”,點擊「Updated」已更新。TLS證書是全自動簽發部署的,不需要手動部署。
365t在線














