返回资讯中心
外部精选
软件工程
#开发者实时流

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。

Hacker News 最新elitan2026/11/17 · 今天15 分钟阅读

以下正文由 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 );

  1. 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?)

  1. 页面。文件夹就是 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 同步,内容未经改写;遇到排版缺失或需要图片、视频时请以原文为准。

打开原文
去社区讨论 →