使用指南

创建项目

访问后台首页，点击「新建项目」按钮。系统会自动生成一个随机 ID（如 a1b2c3d4），你也可以在创建后修改为自定义短名。

项目 ID 规则：

4-16 位小写字母和数字
不能使用系统保留字（如 admin、api 等）

编辑文件

进入项目后，你可以：

在线编写 - 使用内置编辑器直接创建 HTML、CSS、JS 文件
上传文件 - 拖拽或选择本地文件批量上传
创建文件夹 - 支持多级目录结构

文件命名规则

文件路径即访问路径：

index.html      →  https://id.域名/
about.html     →  https://id.域名/about.html
css/style.css  →  https://id.域名/css/style.css
img/logo.png   →  https://id.域名/img/logo.png

index.html 是必需的，作为站点首页。没有它，访问根路径会返回 404。

发布项目

编辑完成后，点击「发布」按钮：

系统将文件上传到 R2 存储
生成项目的访问链接：https://<id>.域名/
链接立即生效，可公开访问

发布后的更改：

修改文件后需重新发布才能生效
未发布的更改仅在编辑器中可见

自定义短名

项目默认使用随机 ID 作为子域名。你可以设置更易记的短名：

短名必须包含 -（如 my-project、hello-world）
短名与 ID 字符集不重叠，系统可自动区分
设置后可通过 https://<短名>.域名/ 访问

在项目设置中点击「短名」按钮即可设置或修改。

绑定主站

将项目绑定到根域名，作为主站展示：

在项目编辑页顶部点击「设为主站」
确认后，访问根域名将显示该项目
子域名链接继续有效

一个域名只能绑定一个主站。绑定新项目会自动解除旧项目的绑定。

管理项目

查看项目列表

后台首页显示所有项目，包括标题、ID/短名、创建时间等信息。

删除项目

删除项目会：

清除项目的所有文件
释放短名别名
如已绑定主站，自动解除绑定

注意：删除操作不可恢复。

技术细节

存储模型

R2 存储 - 文件内容，key 为 sha256(内容).扩展名，相同内容自动去重
KV 存储 - 项目元数据，包含文件列表、标题、短名映射等

域名路由

admin.域名   → 后台管理界面
<id>.域名    → 项目站点（ID 访问）
<alias>.域名 → 项目站点（短名访问）
域名         → 主站（如已绑定）

ID 与短名区别

	ID	短名 (alias)
格式	`[a-z0-9]{4,16}`	必须含 `-`
生成方式	系统随机生成	用户自定义
可修改	否	是
唯一性	全局唯一	全局唯一

常见问题

支持哪些文件类型？

所有静态文件：HTML、CSS、JavaScript、图片、字体、JSON、XML 等。

可以运行后端代码吗？

不可以。gogo 仅支持纯静态文件。如需后端逻辑，可接入第三方服务（如 Cloudflare Workers、API 服务等）。

文件大小有限制吗？

单个文件建议不超过 10MB，总项目大小根据 R2 存储配额决定。

如何使用自定义域名？

当前版本使用系统分配的子域名。自定义域名支持可通过 Cloudflare Workers 路由配置实现。