[Github] Publii – 可离线编辑并同步发布的开源静态 CMS

Github发现2026-08-21发布 WarpEdit

Publii 是一款运行在 Windows、macOS 与 Linux 桌面的开源静态 CMS：内容在本机编辑，应用负责生成 HTML、CSS 与图片文件，再同步到 GitHub Pages、Netlify、SFTP、Amazon S3 等托管目标。它把传统静态站点生成器常见的命令行、模板和部署配置包进图形界面，适合想保留内容控制权、又不愿维护服务端数据库的博客、作品集与文档站作者。

Publii 本地编辑生成静态文件并同步到托管端的工作流 — Publii 的核心路径是本地编辑、生成静态文件，再同步到托管端；本地站点数据仍需要单独备份。

项目当前状态

截至 2026 年 8 月 21 日，GetPublii/Publii 约有 7,287 Stars、467 Forks，采用 GPL-3.0 License。GitHub API 显示主分支在 8 月 15 日仍有推送，最新正式 Release 为 v0.47.9（build 17481），发布于 7 月 23 日。

这里有一个容易误读的版本差异：官网当前下载入口和 GitHub Release 都指向 0.47.9，但 README 的“Current version”文字仍停留在 0.47.6。下载安装包时应以官网当前下载页与 Release 资产为准，不要只根据 README 中的一行版本号判断。

静态 CMS 如何工作

Publii 与 WordPress、Joomla 这类服务端 CMS 的差别，不只是“页面更快”。传统 CMS 通常在服务器上运行程序与数据库，请求到来时再组合页面；Publii 则把写作、媒体管理、主题设置与站点生成放在本机，访客最终访问的是预先生成的静态文件。服务器不需要运行 Publii，也不需要为文章内容准备数据库。

这条路径降低了常见的数据库与服务端插件攻击面，也允许离线写作，但代价是本机项目才是内容源。托管端上的静态文件主要用于分发，不应被当成完整编辑数据库。换电脑、多人协作或磁盘损坏前，需要把 Publii 的站点备份纳入自己的备份策略。

如果你希望用代码、Git 与构建流水线精细控制主题和部署，可以对比 Hexo 或 Hugo；Publii 的重点不是取代这些工具的开发自由度，而是让非开发者也能完成静态发布。

从新建到同步

安装桌面应用：从官网或 GitHub Release 获取对应系统安装包。官网当前下载区标注 Windows 10+ 64 位、macOS 12+ 与 Linux 64 位。
创建本地站点：选择站点图标，填写网站名称和作者；也可以从 Publii 备份恢复已有项目。
选择主题与编辑器：先确定主题，再用区块、Markdown 或 WYSIWYG 编辑器建立文章、页面、标签和菜单。
配置托管端：填写目标 URL、账号、仓库或服务器信息，保存后先运行连接测试。
预览并同步：本地检查生成结果，再点击同步。首次会上传完整站点，之后通常只比较并上传变化。

Publii 创建新网站时填写网站名称和作者名称的界面 — Publii 官方“创建新网站”界面：站点图标用于本地识别，网站名称和作者会进入项目资料。来源：Publii 用户文档，核验于 2026-08-21。

“同步”不是实时在线编辑。官方文档明确说明，只有点击同步后，Publii 才会生成并上传静态文件；本地修改不会自动出现在网站上。这个边界对希望先审核、再上线的作者很友好，也意味着紧急更正时必须回到保存该项目的电脑完成生成与同步。

三种写作入口

区块编辑器

区块编辑器把段落、标题、图片、相册、视频、代码和目录分别放进独立区块，可移动、复制或单独设置样式。它更适合需要混合图文和可视化排版、但不想直接写 HTML 的作者。

Markdown 编辑器

Markdown 入口适合熟悉标题、列表、链接与代码标记的技术写作者。它保留纯文本式输入效率，同时由 Publii 转换为网页结构；长文、文档和含代码示例的内容通常更顺手。

WYSIWYG 编辑器

WYSIWYG 的操作更接近普通文字处理软件，输入文字、插入图片后由应用转换成 HTML。它的学习成本最低，但复杂版式仍要受编辑器和主题可用组件限制。三种编辑器不是三个独立站点系统，选择应由内容习惯决定。

托管目标怎么选

目标	需要准备	更适合	主要边界
GitHub Pages	仓库、分支、访问 Token	个人主页、项目文档、公开静态站	凭据权限、API 限流和单次文件规模
Netlify / GitLab Pages	平台账户与站点配置	希望托管平台管理 HTTPS 与部署的人	平台规则、账户与配额会变化
SFTP / FTP / HTTP(S)	服务器地址、目录和登录凭据	已有虚拟主机或自管服务器	路径、权限、证书和备份由用户负责
Amazon S3 / Google Cloud	存储桶、区域与访问凭据	对象存储、CDN 或较大静态资源站	权限策略、流量费用与缓存配置更复杂

Publii 配置 GitHub Pages 仓库、分支和访问 Token 的服务器设置界面 — GitHub Pages 配置会涉及仓库、分支、Token、并行上传和 API 限流。图中为官方文档示例，不包含 WarpNav 凭据。来源：Publii 用户文档，核验于 2026-08-21。

Publii 的 GitHub Pages 教程仍以 classic Personal Access Token 为例，并要求可操作仓库的权限。实际使用时应为发布任务准备可撤销的独立凭据，避免复用高权限个人 Token，并按 GitHub 当前认证方式核对权限范围。官方文档还列出单站超过 1,000 个文件无法上传、GitHub API 每小时 5,000 次请求等限制；该页最后更新于 2024 年 12 月，正式迁移大站前应以当前 Publii 与 GitHub 文档重新验证。

WordPress 迁移边界

Publii 提供 WP Import 工具，可读取 WordPress 导出的 WXR（XML）文件，并导入文章、文章图片、作者，以及标签或分类数据。迁移时必须在“WordPress 标签”和“WordPress 分类”之间选择一种转换为 Publii 标签，不能假设两套分类法和所有插件字段都会原样保留。

官方文档截至 2026 年 8 月仍把 WP Import 标为实验功能。迁移前应保留 WordPress 数据库、uploads 与 WXR 备份，先导入副本，检查文章正文、图片、作者、固定链接与缩略图，再决定域名切换和重定向。它适合搬运内容主体，不等于完整克隆 WordPress 主题、短代码、表单、会员、评论和电商能力。

使用前的限制

本地数据：内容与项目配置保存在桌面端，必须自行安排备份、换机恢复和多设备交接。
动态功能：评论、站内搜索、表单、分析等通常依赖插件或外部服务；静态输出本身不会自动提供服务端业务逻辑。
多人协作：它不是浏览器里的实时协作文档。团队需要额外约定项目文件、备份、发布权限和冲突处理。
主题与更新：更新应用不代表所有主题会自动更新；自定义主题和插件升级前应先备份并预览。
系统信息差异：当前下载区写 macOS 12+，较旧的系统要求文档仍写 macOS 11+；安装前以当期下载页和 Release 说明为准。

谁更适合使用

Publii 更适合个人博客、作品集、活动页、轻量企业站和文档站：内容更新由一人或少数固定编辑负责，动态交互需求有限，并且愿意把本地备份和部署凭据纳入日常维护。它尤其适合不想学习命令行静态生成器、又希望减少服务端维护的人。

如果网站依赖实时多人编辑、会员权限、订单、复杂表单、数据库查询或高频即时发布，Publii 可能需要大量外接服务，甚至不如传统 CMS 直接。正确的选择标准不是“静态一定优于动态”，而是内容生产方式、动态需求、协作人数与维护能力是否匹配。

官方资料

GitHub：https://github.com/GetPublii/Publii
官网：https://getpublii.com/
下载：https://getpublii.com/download/
用户文档：https://getpublii.com/docs/
最新 Release：https://github.com/GetPublii/Publii/releases/latest

信息边界：本文核验于 2026-08-21。Stars、Forks、版本、系统要求、托管接口与平台限制会变化；本文依据官方仓库和文档整理，未声称完成安装、迁移或线上部署实测。