PakePlus 完整指南:把任意网页打包成 5MB 以下的跨端应用
【免费下载链接】PakePlusTurn any webpage/HTML/Vue/React and so on into desktop and mobile app under 5M with easy in few minutes. 轻松将任意网站/HTML/Vue/React等项目构建为轻量级(小于5M)多端桌面应用和手机应用仅需几分钟. https://ppofficial.netlify.app项目地址: https://gitcode.com/GitHub_Trending/pa/PakePlus
你有一个只希望团队内部使用的网页,或者一个 Vue/React 项目不想为它单独买服务器,想把它变成桌面应用又嫌流程麻烦?PakePlus 就是为这类需求做的:它面向新手,把网页或静态项目包装成桌面与手机应用,一次产出 Windows、macOS、Linux、Android、iOS 版本,包体约 5MB,云端打包约 8 分钟,本地打包只要 30 秒,全程不需要你装 Rust 或 Node 环境。
两种打包方式:云端和本地怎么选
开始之前先想清楚用哪种方式,因为它决定了后面要不要配置账号。云端打包依托 GitHub Actions 作为编译环境,需要一个免费的 GitHub Token,支持包括安卓、iOS 在内的所有主流平台,产物体积约 5MB,缺点是每次要等约 8 分钟且有次数限制。本地打包则不需要 Token、不需要联网、不需要任何环境,约 30 秒出包,文件数量和大小也不设限;代价是只能打出本机系统的版本(Windows x64 与 macOS),不支持移动端、单例模式和窗口状态保持,包体约 10MB,官方文档也提示它不够稳定,正式分发优先用云端。
⚠️ 提示:云端打包当前有两条硬限制:最多创建 3 个项目、每小时发布 1 次,详见 docs/zh/question/limit.md。
如果只是自己试一下,选本地最快;要分发给别人,直接用云端。
云端打包怎么配:三步拿到 GitHub Token
本地打包用户跳过本节即可。
- PakePlus 桌面端首页直接点 GitHub 授权登录,自动完成 Token 获取,不用手动操作。
- 用移动端网页版时,登录 GitHub 进入 设置 → Developer settings → Personal access tokens (classic),新建令牌,只勾选 repo、workflow、user 三个权限。
- 把 Token 粘贴到 PakePlus 右上角设置入口,点测试;网络正常时校验加初始化约 20 秒,提示“Token 可用”即完成。
⚠️ 提示:Token 只显示一次,粘贴后仅存储在你电脑本地;验证成功后会在你的账号下 fork 一个模板仓库,后续所有项目都靠它编译,请不要删除。
创建并配置第一个项目
回到首页点“+”按钮,填入项目名后确定。命名规则比较严格:只能含字母、数字、下划线、短横线,不能以数字开头,也不能与已有项目重名。确认后自动跳到配置页。
四个必填项:
- 应用名称:桌面和菜单里显示的名字,支持中英文,但不允许空格。
- 目标地址:http/https 开头的网址,或本地 html 文件、Vue/React 打包后的 dist 文件夹;单个文件建议不超过 10M(编译平台限制),视频、大图这类资源最好改用外链。
- APP 标识:区分不同应用的唯一 ID,只允许小写字母、数字、下划线,不能以数字开头,不能与别的项目重复。
- 版本号:区分每次发布的版本,建议每次递增。
同屏还有这些可选项:应用图标(可上传本地图,不填则用默认图标)、窗口模式(桌面/iPhone/iPad/Android/自定义预设)、单例模式(防止多开)、窗口保持(二次启动记住窗口大小和位置)、开发调试(预览窗口里可调试页面)、TauriApi(允许 JS 调用系统接口,API 清单见 docs/zh/guide/desktopapi.md)、脚本注入(自定义 JS 在启动时执行)、过滤元素(用 CSS 选择器隐藏广告、弹窗)。
预览、发布并下载安装包
配置完成后点“预览”,会弹出一个临时窗口展示最终效果;如果开启了调试模式,可以右键页面打开开发者工具,顺便验证注入脚本是否生效。
确认没问题点“发布”:云端方式选择目标平台(Windows、macOS、Linux、安卓、iOS)并填发布说明,等待约 8 分钟,成功后跳转到发布页直接下载;本地方式先设置保存路径(不设则存到下载目录),约 30 秒完成。
产物按后缀区分:exe/msi 是 Windows(文件名里注意 x64 与 arm 的差别)、dmg 是 macOS、deb 是 Linux、apk 是安卓(支持 Android 7.0+)、ipa 是 iOS(支持 iOS 15.6+)。拿不准就按自己系统架构选,桌面端默认优先 x64。
值得顺手用的进阶功能
- JS 注入 + TauriApi:启用 TauriApi 后,注入的脚本能调用写文件、系统对话框、进程执行等系统能力,做自动登录、隐藏元素之类的定制。
- 过滤元素:填一个 CSS 选择器,就能把页面里的广告和弹窗永久隐藏。
- 静态项目直出:Vue/React 项目先执行自己的构建命令,把 dist 文件夹指给 PakePlus,不需要服务器也能变成桌面应用。
高频问题速查
- macOS 提示“应用已损坏”:应用未购买官方签名所致,在终端运行
sudo xattr -r -d com.apple.quarantine /Applications/PacBao.app后重新打开;自己打包出的应用提示时把路径换成对应应用名。 - 打开后白屏或异常:先确认目标网址可访问、本地路径没变,再开启调试模式看控制台报错。
- 发布失败:右上角出现红色警告图标,点开看具体错误,按提示修改后重试。
- 旧版本行为怪异:2025 年前的版本基于 Tauri v1,现在已升级 v2,有问题先下载最新版再试。
下一步
想继续深入,可以看 官方指南 里的窗口配置、移动端安装等章节。想参与开发,先装好 Rust(>=1.63)和 Node(>=16),然后:
git clone https://gitcode.com/GitHub_Trending/pa/PakePlus cd PakePlus pnpm i pnpm run devpnpm run dev在本地打开调试窗口,pnpm run build出安装包;过程中遇到报错,直接提交 issue 或到交流群提问。
【免费下载链接】PakePlusTurn any webpage/HTML/Vue/React and so on into desktop and mobile app under 5M with easy in few minutes. 轻松将任意网站/HTML/Vue/React等项目构建为轻量级(小于5M)多端桌面应用和手机应用仅需几分钟. https://ppofficial.netlify.app项目地址: https://gitcode.com/GitHub_Trending/pa/PakePlus
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考