在线演示
只读的 Atelier 站点。示例企业与内容均为虚构;演示站不开放后台,也不收集询盘。
01快速上手
需要 Node.js 22 或更新版本(含 npm),以及一个能使用 Workers、D1 和 R2 的 Cloudflare 账号。以下步骤针对已发布的 0.1.0-rc.10 候选版。
这一步安装依赖、构建项目并检查部署配置,不会创建任何云资源。
npx mallok create my-site --no-deploy
cd my-site先确认 whoami 显示的是你要用的账号。创建过程会在该账号里开通一个 Worker、一个 D1 数据库和一个 R2 存储桶。想在首次部署时就绑定自己的域名,加上 --domain site.example.com。
npx wrangler login
npx wrangler whoami
npx mallok create . --slug my-site已经登录,想一步到位?npx mallok create my-site 会一次完成生成、校验和部署。
打开 CLI 输出的初始化地址,填入一次性的 setup key。向导会创建管理员、设置站点名称和语言,并可导入示例内容——示例只是占位,正式对外之前请替换成你自己的内容。
边缘缓存需要自定义域名;workers.dev 地址只用于预览。想让修改及时生效,还要把清缓存令牌(Zone → Cache Purge → Purge)和 zone id 配成 Worker secrets。没有它们,访客要等缓存过期才能看到新内容。
在 /_mallok/app 后台修改示例产品或新建内容,然后发布,不需要重新构建。也可以在终端或 CI 里,用分权限的 API 令牌直接发布整个内容包目录:
npx mallok publish ./content正式依赖之前: 目前是候选版。还没有“Deploy to Cloudflare”按钮,真实询盘邮件送达也尚未完成端到端验收。 查看发布状态
02文档导览
下面的链接都会打开 GitHub 上的文档。英文是主要文档语言;入门指南和发布状态有中文翻译,其余技术参考暂为英文。
03其他入口
只读的 Atelier 站点。示例企业与内容均为虚构;演示站不开放后台,也不收集询盘。
源码、issue、更新日志和文档本身,采用 Apache-2.0 许可。
只有一个包:mallok。latest 是 0.1.0-rc.10,next 是 0.1.0-rc.11。