hunvreus/pagescms

这是什么？

核心功能

• 01通过网页界面编辑内容和媒体，修改直接提交到 GitHub 仓库。
• 02支持 Jekyll、Hugo、Astro、Next.js 等静态站点生成器。
• 03通过 GitHub App 进行身份验证。
• 04可借助 PostgreSQL 和 GitHub App 配置脚本在本地自行部署。

适用场景

• 让非开发人员无需直接操作 Git 即可更新博客或文档站点。
• 在浏览器中管理 Jekyll、Hugo 或 Astro 站点的内容。
• 为静态站点仓库自建一个内容编辑界面。

快速上手

1. 1

   克隆代码仓库

   git clone https://github.com/pagescms/pagescms.git
2. 2

   用 Docker 启动本地 PostgreSQL 数据库

   docker run --name pagescms-db -e POSTGRES_USER=pagescms -e POSTGRES_PASSWORD=pagescms -e POSTGRES_DB=pagescms -p 5432:5432 -d postgres:16
3. 3

   安装依赖

   npm install
4. 4

   创建 .env.local、运行数据库迁移并完成 GitHub App 设置后，启动应用

   npm run dev

使用前须知

• !本地运行需要 PostgreSQL、一个 GitHub App 以及手动创建的 .env.local 文件。
• !如果不想自行部署，可以直接使用托管版 app.pagescms.org，这是最简单的选择。

标签

常见问题

pagescms 是什么？

开源 CMS，可直接在 GitHub 仓库中编辑内容和媒体，适用于 Jekyll、Hugo、Next.js、Astro 等静态站点。 Pages CMS 是一个基于 GitHub 仓库运行的内容管理系统。内容和媒体文件直接保存在仓库中，编辑者可以通过网页界面修改文章和图片，修改会以提交的形式写回 Git。

pagescms 可以免费使用吗？用的什么许可证？

pagescms 以 MIT 许可证开源。用于商业产品前，请先确认许可证条款。

pagescms 还在维护吗？

活跃维护中。pagescms 最近一次提交是在 2026年10月16日。

pagescms 适合用来做什么？

让非开发人员无需直接操作 Git 即可更新博客或文档站点。 在浏览器中管理 Jekyll、Hugo 或 Astro 站点的内容。 为静态站点仓库自建一个内容编辑界面。

pagescms 怎么安装和运行？

克隆代码仓库: git clone https://github.com/pagescms/pagescms.git 用 Docker 启动本地 PostgreSQL 数据库: docker run --name pagescms-db -e POSTGRES_USER=pagescms -e POSTGRES_PASSWORD=pagescms -e POSTGRES_DB=pagescms -p 5432:5432 -d postgres:16 安装依赖: npm install 创建 .env.local、运行数据库迁移并完成 GitHub App 设置后，启动应用: npm run dev

在哪里获取 pagescms？

源代码和安装说明在 GitHub 上：https://github.com/hunvreus/pagescms