跳到正文

此设备上的 Yave 统一账号登录将会结束,在此设备上使用的其他 Yave 服务也会一并退出登录。

导入 GitHub 仓库,部署成静态网站

最后更新: 2026-11-11

目录 · 6
  1. 1. 确认你的仓库符合条件
  2. 2. 在首页点“从 GitHub 导入”
  3. 3. 确定网址,点“发布”
  4. 4. 修改仓库之后,记得更新网站
  5. 常见问题
  6. 延伸阅读

先说结论:在首页的“从 GitHub 导入”卡片填入公开仓库(owner/repo),确定网址后点“发布”。仓库的文件会原样上传并发布,不会进行构建,所以仓库的根目录必须有 index.html。

要点速览

所需时间
约 2 分钟
所需套餐
免费即可
代码知识
不需要
操作位置
首页的上传卡片

操作步骤

  1. 1

    确认你的仓库符合条件

    必须是公开仓库,而且根目录要有 index.html。HTMLtoSITE 不会帮你构建,只会把仓库里的文件原样上传。像 React、Vite 这种需要构建的项目,请使用根目录就放着构建成果的分支(例如 gh-pages),或把构建输出文件夹压成 ZIP 再上传。私有仓库无法导入。

    owner/repo
    index.htmlabout.htmlstyle.cssimages/logo.png
  2. 2

    在首页点“从 GitHub 导入”

    在 htmltosite.com 首页的三张卡片中,点“从 GitHub 导入”(“只需填入仓库地址”),会打开同名的界面。在“仓库”一栏填入 owner/repo 或 https://github.com/owner/repo。如果想指定分支或标签,填在“分支或标签(可选)”一栏。留空的话会导入默认分支。

    HTMLtoSITE“从 GitHub 导入”界面:仓库栏位、分支或标签(可选)栏位、网址输入栏和发布按钮
    在“仓库”一栏填入仓库,需要的话再填分支或标签。
  3. 3

    确定网址,点“发布”

    在网址栏输入名称后点“发布”,导入到发布一次完成。如果是第一次使用,会出现注册界面(只需邮箱),回来后你输入的网址和仓库还在。完成后,“已发布”界面会显示你的网址。如果有文件无法导入,也会同时出现“有 N 个文件未能上传”的提示。

    myname.html2site.com 已发布

    仓库的文件会在这个网址打开。

  4. 4

    修改仓库之后,记得更新网站

    导入是复制当下的文件,所以导入之后,网站就不再和仓库联动。想带入变更,请在编辑器里直接修改,或把改过的文件夹用 ZIP 上传,再点“发布”。每次发布都会留下一个版本,所以可以在“版本”标签页回到之前的状态。

    HTMLtoSITE 编辑器的“版本”标签页:已发布版本的列表
    在“版本”标签页可以回到之前发布的状态。

常见问题

需要关联 GitHub 账号,或准备服务器、主机账号吗?

不需要。只要填入公开仓库的地址就好。不用登录 GitHub,也不用服务器或主机账号。只要用邮箱注册(无需密码、无需银行卡),就能免费开始。

可以导入私有(private)仓库吗?

不行,只能导入公开仓库,因为文件是单靠地址获取的,没有关联任何 GitHub 账号。私有仓库请先下载到电脑、压成 ZIP,再用“用 ZIP 上传”。

需要构建的仓库(像 React 或 Vue)也能用吗?

不会进行任何构建。只有根目录有 index.html 的仓库或分支,也就是已经放好构建成果的,才能使用。否则请在自己的电脑上构建,再把输出文件夹用 ZIP 上传。

会导入哪个分支?可以指定分支或标签吗?

如果“分支或标签(可选)”留空,会导入仓库的默认分支。填入其他分支或标签名称,就会导入当时的文件。也可以直接粘贴 github.com/owner/repo/tree/分支 这样的地址。

修改仓库后,网站会自动更新吗?

不会。导入之后网站就不再和仓库关联,所以没有自动部署。请在编辑器里修改,或用 ZIP 重新上传,再发布。

仓库很大或导入失败怎么办?

免费套餐有 5 个网站、100MB 存储空间,仓库会在套餐剩余的存储空间内导入,最多 2,000 个文件。.git 这类隐藏文件、服务器代码和可执行文件会被排除,README.md 这类文档也会因“上传保护”被排除,并显示在提示中,对网站没有影响。如果 GitHub 正在限制请求,请稍后再试,或改用 ZIP 上传。

动手比阅读更快 — 粘贴你的 HTML,马上发布。

在当前工作区中查找网站。如需切换工作区,请在侧边栏顶部切换。