PakePlus 中文文档 下载 App

一键发布到 GitHub Pages——PakePlus 内置免费网站托管

一键建站是什么

PakePlus 内置了一个 GitHub Pages 集成——在项目配置页面右上角更多菜单里有一个"在线网站"按钮。点击后:

  1. 项目的静态文件(网站地址指向的 URL 或本地 dist 目录)推送到 GitHub 仓库的 gh-pages 分支
  2. 自动启用 GitHub Pages 服务
  3. 获得一个 你的项目名.pages.dev 的免费访问地址

全程不需要打开 GitHub 网页、不需要手动改仓库设置、不需要写任何 CI/CD 配置文件。

前置条件

条件说明
已登录 GitHub(Token 有效)没有 Token 无法推送到仓库
项目有静态文件不管是 URL 抓取还是本地 dist 目录
项目是公开仓库GitHub Pages 对私有仓库有使用限制(公开仓库免费无限)

操作步骤

  1. 在 PakePlus 里打开目标项目
  2. 确保项目已至少保存过一次配置(静态文件已在 GitHub fork 仓库里)
  3. 点击右上角三条横线图标 → "在线网站"
  4. 等待几秒钟(PakePlus 自动推送并配置 Pages)
  5. 成功后会显示 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 + PakePlusCloudflare PagesVercel
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 分钟以内,不需要租服务器、不需要买域名、不需要备案。