
Northstack 发布:Rust、React 与 SQLite 打包为单一二进制,端到端类型安全
来源标题:Show HN: Northstack – Rust, React and SQLite in one binary, typed end to end
开源全栈 Web 框架 Northstack 亮相,把 Rust 后端(axum、sqlx)、Next.js 风格路由的 React 前端和 SQLite 打包成一个二进制,并实现端到端类型贯通。数据库表结构可自动生成 Rust 类型,React 端直接调用已带类型的 API。
以下正文由 AI 翻译自 Hacker News 最新(原文版权归原站所有),可能存在偏差,重要内容请以原文为准。
Rust、React 和 SQLite 打包进一个二进制文件,端到端类型安全。 试一试 · 指南 · 升级 · 贡献 northstack 是一个开源的全栈 Web 框架:Rust 后端(axum、sqlx),带 Next.js 风格文件夹路由的 React 前端,以及 SQLite。
-- server/migrations/20261201_projects.sql CREATE TABLE projects ( id UUID PRIMARY KEY NOT NULL, name TEXT NOT NULL );
- API。就是普通的 Rust 函数。Project 类型由上面的表生成。
// server/src/features/projects/procedures.rs pub async fn list(ctx: Ctx<AppState>, _input: ()) -> RpcResult<Vec<Project>> { Ok(db::list(&ctx.state.db).await?) pub async fn create(ctx: Ctx<AppState>, input: NewProject) -> RpcResult<Project> { northstack::ensure!(!input.name.is_empty(), "name is required"); Ok(db::insert(&ctx.state.db, &input.name).await?)
- 页面。文件夹就是 URL,和 Next.js 一样。API 在 React 里已经有类型了。
// web/app/projects/page.tsx -> /projects import { api } from "northstack"; export default function Projects() { const projects = api.projects.list.useQuery(null); const create = api.projects.create.useMutation(); return ( <>
<h1>Projects</h1> <button onClick={() => create.mutate({ name: "Apollo" })}>Add Apollo</button> <ul> {projects.map((p) => <li key={p.id}>{p.name}</li>)} </ul> </> );就这么简单:没有 REST 路由,没有 fetch 调用,也不用手写 API 类型。create 成功后,列表会自动刷新。
类型从数据库一路流到屏幕,所以一个拼写错误或一个改动的列,几秒钟内就会被 just check 抓住。在示例应用里把某个字段拼错:
$ just check ok migrate 0s ok gen-db 0s ok compile 1s ok gen-ts 0s FAIL typecheck 0s app/page.tsx(95,25): error TS2561: Object literal may only specify known properties, but 'titel' does not exist in type 'CreateNoteInput'. Did you mean to write 'title'?
怎么修:前端已经和 API 对不上了。[...] 更新 React 代码;永远不要编辑生成的文件。
重命名一个列,编译器会列出所有仍在使用旧名字的查询和屏幕。不会有任何东西悄悄漂移。
同一个应用(相同的 API、相同的查询、相同的索引),分别用 northstack 和 Next.js 16 + Postgres 16 构建。每个容器分配 1 个 CPU 和 512 MB 内存,两者都从 1,000 行数据开始。在 50 个并发用户下(3 次运行的中位数):
在 1 个用户时,northstack 在每次读取上都快 1.2–3.7 倍;Next.js 在逐行创建记录时更快(northstack 还会为每一行跑一个后台任务)。测试方法、1、10、50 用户下的每一项测试,以及如何重跑:bench/README.md。2026 年 11 月在笔记本电脑上测得。
页面像 Next.js。一个包含 page.tsx 的文件夹就是一个 URL。[id] 是参数。layout.tsx 包裹它下面的页面。
每侧一种语言。服务器上是 Rust,浏览器里是 React,数据用 SQL。任何 npm 包都能在浏览器里用。
内置后台任务。发送邮件、缩放图片、写日报:任务队列和调度器都在同一个二进制文件里。
小巧、运行成本低。一个二进制文件和一个数据库文件。内存占用只有个位数 MB,吞吐量是同类 Next.js + Postgres 应用的 1.5–12 倍(见上文)。限制一台服务器上能放多少个应用的,很少是内存。
为 agent 而生。一条命令检查所有东西,只打印出错的部分。指南在 CI 中经过测试,所以始终与代码保持一致。
FAQ
northstack 是 Next.js 的替代品吗?对于需要登录的应用(仪表盘、内部工具、SaaS),是的:它有 Next.js 风格的页面(page.tsx、layout.tsx、[id] 文件夹),但后端是 Rust,端到端类型安全,打包在一个只占用几 MB 内存的二进制文件里。
它做服务端渲染(SSR)吗?不做。页面在浏览器里渲染,这让它保持简单:服务器上不运行任何 JavaScript。对于需要 SEO 的公开页面,静态站点或预渲染更合适。
它用哪个数据库?SQLite,WAL 模式:一个文件放在二进制文件旁边,没有数据库服务器。每张表的类型都从数据库生成,每个查询在编译时都会对照它检查。它适合跑在一台机器上的应用(大多数都是);不适合在负载均衡器后面跑多个应用副本。
我能用 npm 包吗?可以,任何能在浏览器里运行的包都行。服务器代码是 Rust,所以服务端的工作使用 Rust crate。
我需要懂 Rust 吗?有帮助,但它的设计目标是让 AI agent 写大部分代码:每个任务一种模式、一份写好的指南,以及能准确说明哪里出错、如何修复的检查。
成本上怎么比?一个应用空闲时约占用 6 MB 内存,且不需要数据库服务器,而同类 Next.js + Postgres 应用约需 134 MB(见对比)。当你在同一台服务器上跑很多小应用时,这很重要。
brew install rustup bun just && rustup default stable cargo install northstack --locked northstack new my-app && cd my-app just dev # open http://localhost:5173
你会看到一个小笔记应用。这是一个把每种模式都展示一遍的示例;你可以用自己的功能替换它(just remove-example 会给你一个空应用)。
然后让你的编码 agent 指向这个应用。它会读 AGENTS.md,后者会把它引导到 docs/northstack.md:针对该应用所用框架确切版本的指南。
一个应用就是你的代码加一个依赖:northstack crate,在 Cargo.toml 里固定到确切版本。这个 crate 包含所有不属于你的东西:服务器库、TypeScript 客户端和路由(由 just check 写入 web/northstack/)、指南,以及 just 背后的命令。在你运行之前什么都不会变:
just upgrade # or: just upgrade 0.2.0
它会移动版本固定、替换 docs/northstack.md、打印它跳过的每个版本的升级说明(来自 changelog,写成 agent 可以遵循的步骤),并运行 just check,所以任何不再能编译的东西都会立刻显现。
这个仓库是框架(crates/northstack)和示例应用(server/、web/),后者也是 northstack new 复制的模板。它本身就是一个可运行的应用,从路径使用框架:
git clone https://github.com/elitan/northstack && cd northstack
(原文较长,此处译出前 6000 字,完整内容请点「打开原文」。)
正文由 探How 从来源站点 RSS 同步,内容未经改写;遇到排版缺失或需要图片、视频时请以原文为准。