一键发布到 GitHub Pages——PakePlus 内置免费网站托管
一键建站是什么
PakePlus 内置了一个 GitHub Pages 集成——在项目配置页面右上角更多菜单里有一个"在线网站"按钮。点击后:
- 项目的静态文件(网站地址指向的 URL 或本地 dist 目录)推送到 GitHub 仓库的
gh-pages分支 - 自动启用 GitHub Pages 服务
- 获得一个
你的项目名.pages.dev的免费访问地址
全程不需要打开 GitHub 网页、不需要手动改仓库设置、不需要写任何 CI/CD 配置文件。
前置条件
| 条件 | 说明 |
|---|---|
| 已登录 GitHub(Token 有效) | 没有 Token 无法推送到仓库 |
| 项目有静态文件 | 不管是 URL 抓取还是本地 dist 目录 |
| 项目是公开仓库 | GitHub Pages 对私有仓库有使用限制(公开仓库免费无限) |
操作步骤
- 在 PakePlus 里打开目标项目
- 确保项目已至少保存过一次配置(静态文件已在 GitHub fork 仓库里)
- 点击右上角三条横线图标 → "在线网站"
- 等待几秒钟(PakePlus 自动推送并配置 Pages)
- 成功后会显示 Pages URL,类似 对应的访问地址
能做什么
个人作品集网站
把你的前端作品打包成 PakePlus 项目 → 一键推 GitHub Pages → 获得一个永久可访问的作品集链接。发给 HR、分享给朋友都方便。
文档站
用 Markdown 写好文档 → 构建成静态 HTML → PakePlus 项目指向构建产物 → 一键上线。
演示 Demo
做好一个 Vue/React Demo → 构建 → PakePlus 上线 → 发给同事看效果。不需要租服务器、不需要买域名。
工具网站
做了一个纯前端工具(二维码生成、JSON 格式化、Markdown 预览等)→ 上线 → 免费给大家用。
限制
GitHub Pages 的通用限制
| 限制 | 说明 |
|---|---|
| 带宽 | 每月约 100GB(个人项目足够,超了可能被限流) |
| 构建时间 | 10 分钟超时 |
| 不支持后端 | 只有静态文件,不能跑 Node.js/Python |
| 自定义域名 | ✅ 支持,CNAME 记录 |
| 免费 HTTPS | ✅ 自动配置 |
| 子域 | *.pages.dev 免费无限 |
PakePlus 集成的限制
| 限制 | 说明 |
|---|---|
| 只能推自己 fork 的仓库 | 不能推别人的仓库 |
| 一次性推送 | 每次点"在线网站"覆盖 gh-pages 分支 |
| 不自动更新 | 改了 dist 后需要再点一次 |
| 不支持 Jekyll/Action 构建 | PakePlus 直接推静态文件到 gh-pages |
怎么用好
配合 PakePlus 多平台打包
| 步骤 | 说明 |
|---|---|
| 1. 做一个 Vue/React 工具站 | 本地开发完成 |
2. npm run build | 生成 dist 目录 |
| 3. PakePlus 创建项目,指向 dist | 预览 + 桌面端打包 |
| 4. 云端打包 → 出多平台安装包 | GitHub Release 自动有 |
| 5. 点"在线网站" | 获得免费的在线演示站 |
| 6. 一个项目三个分发渠道 | 在线预览 + 桌面/手机 APP + GitHub Release |
URL 抓取 vs 本地 dist
如果项目的"网站地址"填的是一个在线 URL(如 对应的访问地址),PakePlus 在推 GitHub Pages 时会尝试抓取那个网站的 HTML 和资源,然后推到 Pages。
但 URL 抓取有很多不稳定因素(反爬虫、动态加载、跨域资源等),推荐用本地 dist 目录——完全可控。
和 Cloudflare Pages / Vercel 的对比
| 维度 | GitHub Pages + PakePlus | Cloudflare Pages | Vercel |
|---|---|---|---|
| PakePlus 一键集成 | ✅ | ❌ | ❌ |
| 免费额度 | 100GB/月 | 无限 | 无限(个人版) |
| 构建 | 不支持(只推静态) | 支持(SSR 等) | 支持 |
| 上线速度 | 快(静态直推) | 快 | 快 |
| 全球 CDN | 一般 | 好 | 好 |
| 回源大陆速度 | 较慢 | 快 | 中等 |
如果对中国大陆访问速度有要求,Cloudflare Pages 是更好的选择——但 PakePlus 一键推 GitHub Pages 的方便程度是其核心优势。
实战:快速上线一个工具站
假设你写了一个简单的 JSON 格式化工具:
# 1. 本地开发
cd my-json-tool
npm run build # 生成 dist/
# 2. 打开 PakePlus → 创建项目 → 网站地址选 dist/
# 3. 点预览确认正常
# 4. 点右上角菜单 → 在线网站
# 5. 几秒钟后 → 你的目标地址 上线了
整个流程 5 分钟以内,不需要租服务器、不需要买域名、不需要备案。