好久没更新免空相关的内容了。最近那些老牌免费空间要么死掉,要么风控拉满(比如日本那几家基本全要本地手机号验证,根本搞不定)。前两天无意间摸到一个日本服务商的东西,折腾了一圈发现意外地好用,顺手把我的导航站丢上去了,写篇文记录一下。
先说清楚,这玩意不是传统的 PHP 虚拟主机,跑不了 WordPress,没有 cPanel 也没有 FTP。它本质上是日本 Diverta 旗下的企业级Headless CMS Kuroco 带的一个静态托管服务,叫 KurocoFront。
简单来说就是日本版的 Vercel / Cloudflare Pages,自带日本节点的 CDN 加速、免费 SSL 证书,而且能白嫖、能绑自定义域名。
测试地址:https://loli.g.kuroco-front.app/
先说优缺点与免费额度
老规矩,先说坑和限制,省得大家白忙活:
- 纯静态托管:只能丢 HTML、CSS、JS、图片或者打包好的前端(Hexo/Hugo/Nuxt 导出的静态文件都行)。想跑PHP、建数据库的直接可以关掉这篇了。
- 免费额度:Kuroco 没有单独的“免费套餐”,而是每月送 1,100 日元的免费计费抵扣。折算下来差不多是50GB 左右的 CDN 流量,存个几十兆的静态站、小博客,一个月根本用不完。
- 信用卡问题:注册初期不需要信用卡,直接能开通使用。但根据官方条款,开始用之后的一个月内(或者额度消耗达到70% 前)需要补绑信用卡,不过小站基本不会超额扣费。
- 单文件限制 30MB,整包尽量不要超过 300MB。
- 最搞的一点:必须放一个专属配置文件
kuroco_front.json,如果不放,部署成功了访问也是404,后文会讲怎么写。
注册账号
注册地址:https://kuroco.app/ja/free_trial/
打开之后填邮箱和你想用的 Site key(站点标识,填纯英文数字)。
这个 Site key 很重要,填完之后你的三个地址就固定下来了:
后台:https://你的key.g.kuroco-mng.app
API 端点:https://你的key.g.kuroco.app
网站前台:https://你的key.g.kuroco-front.app
比如我填的 loli,前台就是 https://loli.g.kuroco-front.app/。
提交之后等几分钟,邮箱里会收到后台初始登录地址和账号密码。登录进后台之后,如果此时直接去访问前台域名,会看到一个 404 Not Found (DEPLOYMENT NOT FOUND),正常现象,因为还没丢网页上去。
拿 Webhook 部署 Token
官方教程里通篇都在教你怎么连 GitHub 仓库、怎么跑 GitHub Actions。但如果我们只是放个导航站或者纯静态页面,每次改点东西还要开个 GitHub 仓库走Actions 极其麻烦。
其实它后台自带一个 Webhook 接口,直接一个请求就能拉取 ZIP 包部署。
进后台左侧菜单:チャネル(Channels) -> WEB -> KurocoFront設定(KurocoFront Settings)。
这里有两个必做操作:
1. 找到 トークン(Token),点添加生成一个,把这串 Token 复制存好,等下发部署请求全靠它。
2. 下面的 「90日以上前の履歴を削除する」 勾上!Kuroco每次部署都会按版本存一份历史文件,要是不开自动清理,老版本的存储占用会一直叠,白白浪费免费额度。
准备打包文件与踩坑点
本地准备好你要上传的网站文件(比如 index.html、css、图片等)。
重点来了:根目录下必须新建一个
kuroco_front.json,哪怕是单页网站也得放,否则服务器不知道怎么路由。单页应用或者导航站直接用下面这段最基础的配置就行:
{
"rewrites": [
{
"source": ".*",
"destination": "/index.html"
}
],
"redirects": [],
"basic": [],
"ip_restrictions": []
}注意:source 必须写 ".*",不能自作聪明写成 "^.*$",不然 CSS/JS 也会被当成首页重写掉。
然后把所有文件打成一个 .zip 压缩包。
压缩的时候千万注意层级:打开压缩包第一层,必须直接看到 index.html 和 kuroco_front.json,不要把外面那层文件夹一起压进去。
一键部署网站
Kuroco 的逻辑是:你给它一个 ZIP 压缩包的公网直链,然后触发 Webhook,它自己去把 ZIP 下载下来解压到 CDN。
ZIP 包你可以丢到任何能直链下载的地方(比如各种临时网盘、或者对象存储 S3、甚至是 Kuroco 自己的文件管理器里面)。
拿到 ZIP 的下载直链之后,打开终端,跑这一行 curl 就能触发部署:
# 替换你的 sitekey、token 和 zip 直链
SITEKEY="loli"
DOMAIN="${SITEKEY}.g.kuroco-front.app"
TOKEN="你的Webhook_Token"
ZIP_URL="https://你的直链地址/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! 就说明成功了!大概等 10 到 30 秒左右,再去刷新你的
https://你的key.g.kuroco-front.app,网页就已经上线了。
绑定自定义域名
- 进后台 環境設定 -> カスタムドメイン/TLS証明書。
- 填入你的域名(比如
sub.yourdomain.com,不要带https://和末尾斜杠)。 - 添加后系统会给出几条 CNAME 和 ACME 验证解析记录,去你的 DNS 解析商(如 Cloudflare)加进去。
- 等状态全变成绿色 OK 之后,到 アカウント 界面把前台域名切换成你的自定义域名。
SSL 证书是全自动签发部署的,不需要手动折腾。
总结
现在能稳定白嫖的传统免费空间越来越少,如果你只是想挂个个人介绍页、网址导航、或者静态博客,其实真没必要去硬啃那些随时被封、限制奇葩的虚拟主机。
KurocoFront 的优势很明显:日本原生节点,延迟相对欧美免空低得多;CDN 架构,静态资源加载飞快;自带SSL、支持绑定域名、没广告。缺点就是不是给新手建 WordPress用的,并且后期需要绑定信用卡防滥用。拿来做个备用静态节点或者放轻量展示页挺舒服的,有兴趣的可以搞一个玩玩。