ghcr.io/corebunch/instatic

ghcr.io/corebunch/instatic:0.0

ghcr.iolinux/amd640.0大小: 135.81 MB更新于 2026年11月20日

Instatic

全权掌控你的网站。畅快构建你的内容。

这是一款自托管 CMS,可视化编辑器、内容引擎与发布器全部集成在单个 Bun 服务器中,它最终输出的页面代码干净到你直接查看页面源代码也能轻松读懂。

一键部署 · 快速入门 · 文档 · 插件 · 路线图

可前往 *** 观看 Instatic 介绍视频。

现代网站的搭建通常需要拼凑一整套技术栈:无头 CMS、前端框架、托管服务、表单服务、数据分析服务商、图片 CDN,每一项都有单独的账单、独立的控制台,还都可能在凌晨两点触发故障。Instatic 走的是完全相反的路线:单个 Bun 服务器就承载了全部功能——画布编辑器、内容引擎、媒体资源、身份认证、表单、插件和发布器,你可以在任意自己偏好的环境中运行它,后端支持 SQLite 或 Postgres。

它最终产出的成果,恰恰是大多数开发者悄悄妥协的部分:完全纯净的语义化 HTML 和精简的 CSS,页面里不会残留任何编辑器相关的冗余代码。没有框架运行时、没有生成器属性、没有嵌套混乱的 div 面条代码。网站加载体验和静态文件完全一致,因为绝大多数场景下,它本身就是静态文件。

基于 MIT 协议开源。完全自托管。完完全全属于你。

一键部署

Railway 是让 Instatic 快速上线的最快途径。选择对应模板,点击部署按钮,等待大约两分钟即可完成全部流程。平台会自动生成密钥、挂载存储卷、配置健康检查,全程无需打开终端操作。

一分钟即可上线,无额外人工干预。

服务提供商数据库适用场景部署入口
Railway · 推荐选项SQLite单个站点,如博客、作品集展示、小型企业官网立即部署 →
RailwayPostgres多作者协作、需要托管备份功能、有后续扩展需求的场景立即部署 →
RenderSQLite 或 Postgres偏好 Render 提供的服务、磁盘存储和托管 Postgres 的团队部署指南 →
Docker / 自建 VPSSQLite 或 Postgres使用自有服务器、配置 Caddy TLS、自定义备份策略的用户部署指南 →

对于绝大多数站点,SQLite 都是合适的默认选择。当你有多名内容协作者,或是希望使用托管数据库备份功能时,再切换为 Postgres 即可。

更新操作仅需重新部署

当 Instatic 发布新版本时,你只需重新部署最新镜像即可完成更新。你的数据库和上传的资源都保存在独立挂载的存储卷中,因此替换应用容器时无需从头重建整个站点。

如果你更倾向于使用自己的硬件环境,Instatic 仅提供单个 Docker 镜像即可部署:

INSTATIC_IMAGE=ghcr.io/corebunch/instatic:latest docker compose -f compose.prod.yml -f compose.sqlite.yml up -d

关于 VPS 部署、Postgres 配置、使用 Caddy 启用 HTTPS、Render 部署以及备份方案的完整指南,请查阅 docs/deployment。

单一工具,覆盖网站全生命周期

市面上大多数工具都只负责单一环节,完成后就需要你切换到其他工具继续后续流程:你在一个地方设计界面,在另一个地方编写代码,把内容存放在别处,还要再接入第四方工具来添加数据分析功能。而 Instatic 可以一次性完成所有工作,以下是它内置的全部核心功能。

🎨 设计

它的编辑器是真正的画布式编辑界面,绝非那种把表单控件和预览窗格强行拼接在一起的半成品。你可以并排摆放多个断点的视图框,同时对它们进行编辑。修改桌面端布局时,同界面内的移动端视图会实时同步响应。当你想要直接操作完整页面时,只需切换到实时模式,就可以在全尺寸页面中直接就地编辑。

其他同类产品都不具备的独有特性:内置集成了 Core Framework。这是成千上万 WordPress 专业从业者日常都在使用的设计令牌引擎,在 Instatic 中它是原生核心系统,不需要你自行安装插件后再费尽心思调优兼容。

  • 自动生成色阶的颜色令牌:只需定义一个品牌主色,系统就会自动生成一整套经过校准的明色调和暗色阶。
  • 遵循数学规则的流畅排版比例:一套随视口尺寸自动缩放的字号序列,替代了四十多个需要手动逐一调整、还得随时保持同步的零散字号设置。
  • 统一间距比例:确保每个页面在所有断点下的间距节奏完全一致。
  • 实用类生成器:会把所有生成好的锁定类名输出到单个精简的 framework.css 文件中。没有冗余代码、没有重复规则、完全不会生成任何你不需要的内容。

你的整套设计系统都以结构化数据形式存储。只需修改一个令牌,所有使用该令牌的页面都会自动同步更新。

🧱 构建

  • 模块是最基础的构建单元:包含容器、文本、图片、按钮、视频、列表、链接、SVG、表单等元素。你可以把它们拖拽到画布上,随意嵌套组合。
  • 可视化组件是支持复用的内容块,带有类型定义的参数和命名插槽。参数可以是字符串、数字、布尔值、颜色、图片、URL、富文本、枚举类型,甚至是一整块内容插槽。你只需编辑一次组件,网站上所有对应的实例都会同步更新。系统会主动阻断自引用组件的生成,避免出现无限循环引用的问题。
  • 模板用于处理全站共享的页面框架。你可以为整个站点设置统一布局,也可以为每种内容类型单独设置布局,还能自定义设计完全属于自己的 404 页面。内容会自动流入预留的输出槽,因此页眉和页脚只需编写一次,就能包裹全站所有页面。
  • 循环功能可以基于集合重复渲染指定布局:适用于文章列表、页面集合、媒体库资源,或是任何插件对外暴露的数据源。你可以为循环设置多个变体样式,循环渲染时系统会自动交替切换样式,非常适合用来实现文章列表、产品网格、图片画廊等场景。
  • 完全归属你的 CMS 原生表单:使用语义化字段构建表单后,所有提交的数据都会直接存入你自己的数据表中。Instatic 会自动识别你放置的表单字段,为你创建对应的数据表。无需接入第三方表单服务、无需嵌入外部代码、联系表单这类基础功能完全不需要支付月度费用。
  • 真正可直接编辑页面的 AI 助手:你只需描述想要实现的效果,它就会在画布上生成真实可编辑的节点,而非返回一张截图或是大段无法直接使用的代码。它通过和你粘贴标记语言时完全相同的导入流程,生成语义化的 HTML 结构和对应的 CSS 样式。拥有 35 项工具权限的「站点模式」可用于快速搭建页面,拥有 15 项工具权限的「内容模式」专门用于编辑内容条目。你可以自行对接偏好的大模型:Claude、OpenAI、OpenRouter 或是本地运行的 Ollama 都支持。API 密钥、选用的模型、产生的费用完全由你掌控。
  • 稳定可靠的导入功能:粘贴原始 HTML 即可转换为可编辑节点。你甚至可以上传一整个静态站点的全部资源——HTML、CSS、图片、字体,「超级导入」功能会把它们全部转换为 Instatic 中的页面、样式规则、设计令牌和媒体资源。任何可能的内容冲突都会在写入操作前明确展示给你,而且整个导入操作支持一键撤销。

🗂 管理

  • 所有内容共用一套统一模型。页面、文章、组件、自定义集合,以及你自行创建的任意结构化数据表,都统一存储在 data_tables 和 data_rows 中。不存在任何特殊化处理的独立"页面表"。Schema、原始数据行、导入、导出与表单提交内容全部存放在同一个一致的位置。
  • 专属数据工作区,支持自主设计集合。在 /admin/data 路径下,你可以创建带自定义字段的自定义文章类型和自定义数据表,并以电子表格风格的网格界面操作数据行:支持搜索、排序、筛选、批量发布、批量导出。自定义文章类型内置完整的编辑工作流——草稿、定时发布、已发布,同时保留已发布版本的历史记录。普通数据表则是可以对接任意场景的简洁网格:表单提交数据、产品目录、轻量 CRM、用户评价列表。你创建的每一张数据表都是可通过循环渲染的内容源。只需定义一次"团队成员"表,就可以在关于页面通过循环直接渲染完成。
  • 专注创作的内容工作区。为撰写文章和管理集合提供了聚焦的操作界面,同时支持实时模式,让创作者可以在站点真实设计效果中直接编辑,而非在灰色的文本域中操作。
  • 媲美文件管理器的媒体工作区。提供文件夹与智能文件夹、批量操作、使用追踪功能,你可以清晰获知文件的实际引用位置,支持替换工作流,当本地磁盘存储无法满足需求时,还可使用可插拔的存储适配器扩展。
  • 真正可用而非摆设的访问控制。基于 38 项权限构建自定义角色,支持令牌化会话、TOTP 双因素认证(密钥静态加密),多次登录失败后启用带退避策略的账户锁定,在执行删除用户、踢出所有设备这类高风险操作前触发二次确认提示。
  • 全功能 ⌘K 命令面板。覆盖整个管理后台的模糊搜索命令面板,无需鼠标即可跳转到任意页面、执行任意操作。
  • 草稿绝对隔离。未发布的编辑内容永远不会泄露给访问者,你未主动发布的内容,访客完全无法查看。

📊 分析

  • 自定义编排的仪表盘。采用 12 列网格布局的小组件,支持拖拽、调整大小和重新排列。你可以在自定义模式下添加需要的组件,布局配置按用户独立保存。插件也可以自定义组件并接入该网格。
  • 永不丢失的审计日志。所有重要的管理操作都会写入日志行:登录、内容变更、角色编辑、插件生命周期操作。日志为仅追加模式,是完全可追溯的操作记录,不会被任何人暗中篡改操作人和操作时间。
  • 完全属于你的表单数据。所有提交内容都存储在你自己的数据表中,你可以自由查询、导出、基于这些数据做二次开发,不会有第三方厂商中途拦截数据。

目前的分析功能定位偏向运维场景:覆盖仪表盘状态、审计历史和自有表单数据,暂不包含第三方访客追踪功能。

🔌 扩展

所有 CMS 都支持插件,但本项目的差异在于后端插件代码的运行方式。

Instatic 插件是一个附带清单文件的 zip 包,其服务端入口运行在独立的每个插件专属 Worker 中,该 Worker 托管 QuickJS-WASM 沙箱:默认无文件系统访问权限、无环境变量读取权限、无任何网络权限,所有权限必须由站点所有者单独授予,同一时间仅在单台主机运行。编辑器扩展和应用类管理页面则有所区别:这类扩展运行在管理后台窗口中,安装前需要明确授予 editor.code 权限。

通过 SDK,插件可扩展以下能力:

  • 新增 HTTP 路由和独立的管理后台页面
  • 新增存储能力与定时后台任务
  • 新增循环数据源,让你的内容循环可以从任意来源拉取数据
  • 新增 Canvas 模块——即出现在编辑器中的全新内容块
  • 新增媒体存储适配器与前端资源
  • 新增安装、激活等全生命周期钩子

可从插件系统文档和模板插件开始学习开发。

近乎零额外加载,所以速度极快

已发布的 Instatic 页面本质上就是磁盘上的静态文件。无需启动任何框架,没有注水步骤,常规访问路径下完全不会触发数据库往返请求。浏览器直接加载语义化 HTML 和精简的 CSS 包,加载过程一步完成。访客与内容之间几乎没有中间层,页面响应体感瞬时可达。

这种极速表现并非可调优的配置项,而是发布机制天然带来的结果,由三层完全无需你手动干预的逻辑保障:

  • 发布时静态页面直接生成到磁盘,通过原子操作替换上线。向访客返回的是静态文件,而非实时渲染的结果。
  • 存在变更需求的动态路由 由带版本标识的内存缓存提供服务。发布操作会更新版本号,旧缓存条目会延迟失效,完全不会出现旧页面残留的问题。
  • 极少数真正按访客差异化展示的内容 会被自动识别,由体积仅约 1.1 kB 的运行时懒加载。该运行时比本段文字的字符体积还小。

最终输出的内容自始至终都是纯 HTML 和精简 CSS。编辑器相关的代码完全不会进入公网页面:你的公开站点中不存在 React、编辑器运行时,标记中也不包含任何框架残留代码。也正因为输出内容只有 HTML 和 CSS,你的站点完全不受任何绑定:你可以自由读取内容、在任意位置托管,随时迁移导出全部数据。完整设计说明详见发布器。

快速开始

你需要安装 https://bun.sh 1.4.1 或更高版本(如果版本过旧请执行 bun upgrade 升级;bun run dev 会拒绝旧版本运行,因为其 Vite 代理需要该版本支持编辑器 WebSocket 转发)。除此之外无需其他依赖。默认开发环境基于 SQLite 运行,无需额外部署其他服务。

git clone https://github.com/corebunch/instatic.git
cd instatic
bun install
bun run dev

打开 http://localhost:5173,首次访问会引导你完成站点初始化和所有者账号创建。

想体验正式发布后的运行效果?执行 bun run start 即可构建管理后台,并通过 Bun 服务在 http://localhost:3001/admin 路径下提供服务。

备份操作一句话说明:备份数据库(Postgres 导出 dump 或直接备份 SQLite 文件)和 uploads 文件夹,就完成了整个站点的备份——详情。

开发团队背景

我们是 Motion.page 和 Core Framework 的开发团队——这两款工具被数千名开发者用于日常建站工作,大多服务于 WordPress 生态。

多年以来我们一直在优化其他建站平台的使用体验,直到某个时刻我们萌生了一个无法忽视的想法:如果底层系统从一开始就是完全合理的呢?没有需要迁就的历史遗留问题,没有禁止你修改的标记,也没有依赖锁死你的站点、才能盈利的商业模式。

于是我们开发了 Instatic,并且将 Core Framework 深度集成作为核心系统,让我们的用户早已习惯使用的色值规范、字体层级、间距体系和工具类直接成为产品的内置能力,而不是需要自行安装、稳定性未知的附加插件。

有意保持早期版本状态

在此坦诚说明:当前版本为 0.0.x 版本。

前文提到的所有功能——画布编辑器、Core Framework、统一内容模型、沙箱插件、AI 代理、表单、循环、模板、媒体、多因素认证、审计日志、一键部署、轻量发布器——都只是起点,远非最终成品,后续还会持续迭代新增更多能力。

  • 真实分析能力。完全自研、注重隐私,进一步完善「分析」核心模块。
  • 更丰富的模块与插件生态。更多官方区块、更完善的 SDK 覆盖面、更多可直接参考复用的示例。
  • 更智能的 AI 代理。提供更多工具,对您实际站点的感知深度更强。
  • 整体体验更精简。我们刻意选择在 1.0 正式版前迭代,现阶段是剔除冗余思路、保持架构整洁成本最低的时期。

1.0 正式版发布前,API 和工作流仍有可能调整。如果这一点让您有所顾虑,可以等 1.0 版本再使用——我们完全理解。如果您愿意参与塑造未来二十年的站点自主掌控模式,现在正是加入的最佳时机。

面向开发者

单 Bun 服务端、基于 Vite 构建的 React 管理后台,搭配一个能生成高质量页面的发布器,输出的页面完全达到手写水准。

模块说明
运行时服务端和工具链均基于 Bun
开发语言全栈 TypeScript
管理后台应用React 19(已启用 React Compiler)、Vite、Zustand + Mutative、CodeMirror、dnd-kit
服务端基于 Bun.serve 搭配自研手写路由
数据库支持 SQLite 或 Postgres,统一 DbClient 接口,通过 DATABASE_URL 自动选择数据库类型
校验逻辑所有非类型安全边界均使用 TypeBox 校验,以 Schema 作为唯一可信数据源
插件系统基于 QuickJS-WASM 后端沙箱运行,采用所有者授权权限机制,管理窗口代码通过显式的 editor.code 执行
AI 能力基于原生 HTTP/SSE 实现与提供商无关的驱动,不依赖任何厂商官方 SDK
输出产物语义化 HTML、精简 CSS,预构建静态文件搭配自动检测的动态占位槽

该代码库有明确的技术选型倾向,且所有规范都已通过代码落地实现。架构规则全部以实际测试用例的形式存放在 src/__tests__/architecture/ 目录下,能保障输出产物整洁的代码结构不会在迭代中悄然腐化。

bun run build # tsc -b && vite build
bun test
bun run lint

深入探索:文档索引 · 架构说明 · 编辑器 · 服务端 · 发布器 · 插件系统

致谢

Instatic 的界面使用了 Gerrit Halfmann 创作的 Pixelarticons 图标库。感谢 Gerrit 提供这套极具辨识度的图标集,并友好授权我们在开源项目中使用。

许可证

MIT 许可证。详见 LICENSE 文件。无分层付费限制、无开源内核隐藏功能、无需「联系销售」解锁能力。

专业版 · 高速稳定拉取镜像
50GB 仅 ¥8/年
高速镜像下载在线技术支持专业版保障服务可用付费会员免广告