站点托管使用指南

站点托管是 html2.link 的进阶功能，支持上传 ZIP 静态站点并生成可分享链接。 适合多页面项目、相对路径资源和常见前端构建产物。所有登录用户均可使用。

什么是站点托管

html2.link 的核心功能是"粘贴 HTML → 生成链接"，适合单页面分享。 但当你需要发布一个包含多个 HTML 页面、CSS、JS、图片等资源的完整静态站点时， 粘贴单个 HTML 就不够用了。

站点托管解决了这个问题：把整个站点打包成 ZIP 上传，系统自动处理相对路径， 生成一个可访问的 URL，访客可以正常浏览所有页面和资源。

如何准备 ZIP 文件

目录结构要求

ZIP 包中需要包含 index.html 作为入口文件。支持两种结构：

结构 A（推荐）：根目录直接包含文件
my-site.zip
├── index.html      ← 入口
├── about.html
├── assets/
│   ├── app.js
│   ├── app.css
│   └── logo.png
└── contact.html

结构 B：单一顶层文件夹（自动剥离）
my-site.zip
└── my-site/
    ├── index.html  ← 入口
    ├── about.html
    └── assets/...

如果你的 ZIP 所有文件都在同一个顶层文件夹中，系统会自动识别并剥离该文件夹。

支持的文件类型

不支持 .exe、.bat、.php 等可执行文件或服务端文件。如需上传视频/音频， 建议使用外部 CDN 链接。

体积限制

• ZIP 压缩包最大 10MB
• 解压后总大小最大 50MB
• 单文件不超过 10MB
• 最多 500 个文件

如何打包 Vite 构建产物

# 构建项目
npm run build

# 进入构建产物目录
cd dist

# 打包为 ZIP（确保 index.html 在根目录）
# Windows: 选中所有文件 → 右键 → 压缩
# macOS: zip -r site.zip .
# Linux:  zip -r site.zip .

计费规则

站点托管按资源规模分档计费，取"大小档位"和"文件数档位"中的更高档作为最终计费档。

举例：一个 5MB、60 个文件的站点，大小为 S 档（≤2MB 不满足，≤10MB 满足 → M 档），文件数为 M 档（≤100 满足），最终取 M 档 = 4 积分/天。

上传 ZIP 后系统会自动预检并显示预估费用，确认无误后再发布。 支持自动续期和固定天数两种模式。

发布流程

1. 登录账号
2. 进入「站点托管」页面，点击「发布站点」
3. 拖拽或点击上传 ZIP 文件
4. 系统自动解析 ZIP 结构，显示文件数、总大小、预估档位和费用
5. 填写站点标题、选择续期模式和有效期
6. 可选：设置自定义域名、密码保护、角标模式
7. 点击「立即发布」，等待上传完成
8. 获得可分享的站点 URL

如何更新站点内容

在站点编辑页（/sites/[id]），可以重新上传 ZIP 文件覆盖站点资源。 链接和配置保持不变，新内容会替换旧文件。固定时长模式将自动补扣或退回积分差额， 自动续期模式在下次续期时切换新费率。

常见问题

错误排查