← 返回项目库

AstroBlocks 中文版|Astro 内容管理与区块编辑器

AstroBlocks 是面向 Astro 项目的区块化 CMS 集成,提供页面编辑、媒体库、菜单、SEO、配置、用户角色、备份恢复和公开页面渲染。

本交付绑定上游 astro-blocks 的真实提交版本,补充管理端简体中文目录和可复现的 Basic Playground。Playground 使用仓库内演示数据,展示真实登录、仪表盘、页面编辑、媒体、菜单、设置、用户、语言和备份恢复流程。

真实界面

项目截图

共 9 张

内容运营仪表盘
页面内容库
媒体库
菜单架构
视觉系统与站点数据
管理端访问与角色
内容语言
备份与恢复
新建页面

Capabilities

核心功能

登录保护的 CMS 管理仪表盘
页面区块编辑、SEO 字段与草稿/发布流程
媒体上传、替换、元数据与响应式图片变体
嵌套菜单、重定向和可复用全局区块
站点参数、白标视觉、用户角色与内容语言
站点备份恢复、缓存清理和公开 Astro 页面渲染
管理端 English / Español / 简体中文语言切换

适用场景

为 Astro 内容站点部署自托管页面管理和媒体管理
通过区块 schema 让团队以结构化方式编辑营销页面
以固定上游提交为基础进行中文本地化、部署或二次开发

适合谁

使用 Astro 构建内容站点的开发者、独立产品团队、内容运营人员和需要自托管 CMS 的小型团队。

商业化思路

上游 Business Source License 1.1 源码交付与本地化适配;商业使用、再分发和衍生交付必须遵循上游许可及变更条款。

你会拿到什么

  • 绑定上游提交 6122f3f0bec55b983a00b957a587ac324d50f947 的完整源码包
  • 简体中文管理端目录、测试契约和语言切换器
  • Basic Playground、演示数据、构建日志和真实浏览器截图
  • README、LICENSE.md、NOTICE.md 以及部署与许可证披露

部署流程

  1. 1安装 Node.js >=22.12.0,复制源码包并执行 npm ci。
  2. 2在生产运行环境设置强随机 ASTRO_BLOCKS_JWT_SECRET,配置 Astro Node SSR 适配器。
  3. 3运行 npm run build 或在 Basic Playground 中执行 npm run build:playground。
  4. 4持久化 data/*.json 与 public/uploads/,通过 /cms 登录并完成站点配置。

真实验证结果

已通过固定提交构建、TypeScript 类型检查、1410 项测试、固定 Chrome 运行时证据与受保护发布前审查。9 个中文管理端路由在 1440×900 视口下完成真实登录、数据断言和新建页面交互验证。

部署前须知

上游许可证为 BSL-1.1,商业使用和再分发前必须阅读并遵守许可证条款;演示账号和演示数据仅用于本地验收。生产部署还需自行完成密钥、HTTPS、数据备份、文件存储和反向代理配置。Playground 的 demo 页面为静态示例,不替代真实 /cms SSR 管理端。

部署难度

中等

最低配置

Node.js >=22.12.0、npm、现代浏览器和 Astro Node SSR 适配器;生产环境必须配置 ASTRO_BLOCKS_JWT_SECRET,并持久化 data/ 与 public/uploads/。

开源许可证

Business Source License 1.1 (BUSL-1.1)

最后验证

2026-09-05

技术栈

Astro 7TypeScriptAstro Node SSRnpm workspacesPlaywright 浏览器验收

授权说明

交付包保留上游 LICENSE.md、NOTICE.md、版权信息和许可证标识。源码中的中文适配修改属于本窗口新增内容;使用者须自行核对 BSL-1.1 的许可授权、变更日期、商业使用限制及后续转为 Apache-2.0 的条款。

Release notes

版本记录

2 个已发布版本

v1.0.0-cn.1 当前推荐

新增简体中文管理端目录,覆盖导航、仪表盘、页面编辑、媒体、菜单、设置、用户、语言、备份恢复和 API 错误提示;补齐 Playground 语言演示与回归测试。

部署要求:Node.js >=22.12.0、npm、现代浏览器;生产环境需要 ASTRO_BLOCKS_JWT_SECRET、SSR 适配器和 data/uploads 持久化。

已知问题:演示环境使用仓库内固定用户和内容;生产使用前必须按 BSL-1.1 核对商业许可、密钥、HTTPS、备份和存储配置。

v4.1.3-cn.1 当前推荐

新增简体中文管理端目录,覆盖导航、仪表盘、页面编辑、媒体、菜单、设置、用户、语言、备份恢复和 API 错误提示;补齐 Playground 语言演示与回归测试。

部署要求:Node.js >=22.12.0、npm、现代浏览器;生产环境需要 ASTRO_BLOCKS_JWT_SECRET、SSR 适配器和 data/uploads 持久化。

已知问题:演示环境使用仓库内固定用户和内容;生产使用前必须按 BSL-1.1 核对商业许可、密钥、HTTPS、备份和存储配置。

登录后领取