在浏览器里跑一个真后端:Datasette Lite 怎么用
以前要把一个 SQLite 数据库变成能点的网页,得搭服务器。现在一条 URL 就够:浏览器下载 Python 解释器、装上 Datasette,把整个服务端应用跑在本地。本文讲清新旧两版差在哪、URL 里能塞什么参数,以及为什么这套办法不限于 Datasette。

在浏览器里跑一个真后端:Datasette Lite 怎么用
先说结论:一条 URL 顶一台服务器
有件事以前要搭服务器:把一个 SQLite 数据库变成能点的网页。
现在一条 URL 就能做到。打开 lite.datasette.io,填进数据库文件的地址,浏览器会下载一个完整的 Python 解释器,装上 Datasette,把整个服务端应用跑在本地。
作者 Simon Willison 把它叫 Datasette Lite。2026 年 11 月 17 日他重写了这一版 —— 新旧两版的区别在于能不能交互,下面说清差在哪。
老版本卡在哪里
2022 年 5 月 Willison 第一次做这个项目时,用的是 Web Worker 加 innerHTML。
做法是:在 Web Worker 里跑 Datasette,模拟请求走一遍,然后把生成的 HTML 用 innerHTML 塞回顶层页面。
这条路有个硬伤:innerHTML 塞进去的 <script> 标签不会执行。
结果是所有依赖 JavaScript 的功能都失效 —— 插件带不进来,插件自己的 CSS 和 JS 也加载不了。基础查询能用,一交互就露馅。
新架构怎么绕过去的
Service Worker 提供了另一条路:让 JavaScript 拦截针对新页面和资源的 HTTP 请求,改由客户端代码自己应答。
具体到 Datasette Lite,一次请求要转三道手:
| 环节 | 发生什么 |
|---|---|
| Service Worker 注册 | 覆盖整个 lite.datasette.io 域名 |
| 顶层页面 | 开一个 iframe 显示 Datasette,iframe 请求 /app/aa94e6851595/、/app/aa94e6851595/data/places 这类地址 |
| Service Worker 拦截 | 这些地址在服务器上根本存在不了,被拦下来转交顶层页面 |
| Web Worker | 顶层页面再转给跑着 Pyodide 的 Web Worker,里面的 Datasette 真正处理请求 |
一层层中转之后,Datasette 自己的 JavaScript 正常执行,插件的 JavaScript 和 CSS 也正常加载。POST 表单、CSRF 防护、登录 cookie、文件上传与下载,都跟着能用 —— 这就是新旧两版最核心的差别。
为什么前面要加 /app/<session>/ 这一段:多个标签页会共用同一个 Service Worker。如果所有标签页都路由到同一个 Datasette 实例,那不管每个 URL 想配什么插件和设置,最后全都共用一份。所以顶层页面给每个标签页生成一个随机 session ID 作为前缀,Service Worker 靠这个 ID 把请求送回正确的那个实例。
为什么还需要 Web Worker:Pyodide 跑在 Service Worker 里没法维持超过大约 30 秒的状态,取决于浏览器。所以真正的 Python 运行环境放在 Web Worker 里。
URL 里能塞什么
这是 Datasette Lite 最实用的部分 —— 整个应用装在 URL 参数里。
| 参数 | 作用 | 例子 |
|---|---|---|
?url= | 要打开的 SQLite 数据库地址 | ?url=https://example.com/data.db |
?csv= | 要打开的 CSV 文件地址,可重复多次 | ?csv=https://.../a.csv&csv=https://.../b.csv |
?json= | JSON 文件地址 | ?json=https://.../data.json |
?sql= | 一段 SQL 脚本,加载后先执行 | ?sql=https://.../demo.sql |
?metadata= | metadata.yml 文件地址,给表加说明 | ?metadata=https://.../metadata.yml |
?ref= | 用哪个版本的 Datasette | ?ref=stable、?ref=main、?ref=0.64.2 |
?sqlite= | 用哪个版本的 SQLite | ?sqlite=3.54.1 |
?install= | 装哪个插件,可重复多次 | ?install=datasette-maplibre |
?ref= 有个容易踩的坑。看起来像版本号的(比如 1.0a11)永远从 PyPI 装;其他的一律当成 GitHub 仓库里的分支、标签或提交号,从源码跑。所以 ?ref=main 拿的是开发代码,不是稳定版。
?csv= 后面可以接多次 —— 多个 CSV 会按列名自动 join。README 里那个例子把纽约时报的新冠 county 数据和美国人口普查的 county 人口数据接在一起,算出每十万人感染数。
?csv=https://.../us-counties-recent.csv
&csv=https://.../us_census_county_populations_2019.csv
#/data?sql=select ... from [us-counties-recent] join [us_census_county_populations_2019] ...
不用上传数据库,不用装 Python,打开链接就能查。
三个 SQLite 版本
默认用的 SQLite 是 3.39.0,也就是 Pyodide 自带的那版。
想换版本就加 ?sqlite=3.54.1。
这个参数背后的实现是一套自己编译的 WebAssembly 轮子。
Willison 新建了 datasette/pysqlite3-wasm-wheels 仓库,为 163 个不同的 SQLite 版本编译了 pysqlite3 的 WebAssembly Python wheel。文件名长这样:
pysqlite3-0.6.2-3.54.1-cp314-cp314-pyemscripten_2026_0_wasm32.whl
中间那段 3.54.1 就是 SQLite 版本号,末尾是当前最新的那版。
换版本是有实际意义的:Datasette 本就该能在 3.25(2018 年 9 月发布)之后的任何 SQLite 版本上跑,那之后又出了 87 个版本。有些新特性只在特定版本里可用,遇到怪问题也需在特定版本上复现。
选定的版本会用在所有地方 —— Datasette 自己、import sqlite3 的插件、加载 ?csv=、?json=、?parquet=、?sql= 文件。
/-/versions 页面和 select sqlite_version() 都会报出当前用的哪个。还能和别的参数组合:?ref=stable&sqlite=3.54.1 就是稳定版 Datasette 配指定版本的 SQLite。
Willison 还用 Claude Fable 5.2 做了个配套小工具,可以拿同一段 SQL 在选定的多个 SQLite 版本之间跑,横向对比结果差异。
它真正好用的场景
最大的价值不是「看数据库」,是「一条链接就能演示」。
Willison 自己就是这么用的 —— 他在 Datasette 的一个 issue 里贴了一条分页有 bug 的复现链接,点下一页,第二页是空的;然后贴了修复版本的链接,同样的操作就正常了。两条 URL 直接把 bug 讲清楚,不用搭服务、不用截图、不用录屏。
这个模式不限于 Datasette。Willison 明说:几乎没有哪个 Python 应用是特殊的,几乎任何 Python 应用都能用 WebAssembly 加 Pyodide 这一套,在浏览器里跑起来当预览环境、演示、复现 bug。
以前挡路的是 C 和 Rust 扩展 —— 它们编译不到浏览器里。现在任何称职的编码 Agent 都能把它们编译成 Pyodide 兼容的 WebAssembly,2026 年 4 月 PEP 783 之后甚至可以直接发布到 PyPI。
唯一的硬限制是数据库。SQLite 完全没问题,但在 WebAssembly 里跑 PostgreSQL 或 MySQL 虽然做得到,路子还很冷门。
还有个细节值得记:这项目最早是 2026 年 5 月用 Claude Opus 4.8 生成的 AI 研究性尝试,作者到 11 月才敢上线。
三条要注意的限制
第一,.db 文件所在服务器必须允许跨域。 用 ?url= 加载别人的数据库时,那个地址要带 CORS 响应头,否则浏览器不让读。Willison 把文件放在 Gist 上,就是因为 Gist 自带开放跨域。
第二,WebAssembly 版本比原生慢。 这套东西跑在浏览器里,不是在你机器上原生跑,跑大数据量的分析要留出时间余量。
第三,这是作者项目的实验性用法。 原文的定位是「提供预览环境、演示功能、复现 bug 的廉价办法」,并希望这种 WebAssembly 预览环境成为 Python 生态里的常见模式 —— 这是个愿望,不是现状承诺。
资料来源与未核实项
核对了什么。 2026-11-19 逐条核对了 Simon Willison 2026-11-17 的原文,以及 simonw/datasette-lite 仓库 README 全文。两处一致:老版用 Web Worker 加 innerHTML、新版改用 Service Worker、/app/<session>/ 前缀用于多标签页隔离、Pyodide 在 Service Worker 里维持不住约 30 秒的状态、默认 SQLite 是 3.39.0、?ref= 像版本号的走 PyPI 而其余当分支或提交处理、?csv= 可重复多次并按列名 join、wasm-wheels 仓库覆盖 163 个 SQLite 版本、Datasette 该在 3.25 之后的版本上跑且之后又出了 87 个版本。
没做什么。 没有在浏览器里实际打开 lite.datasette.io 跑一遍 —— 抓取时该地址返回的是页面骨架,Pyodide 的下载安装没法用纯文本抓取验证,README 里的参数是照文档记的,不是实测出来的。
没有测过性能差异:原生 SQLite 与这套 WebAssembly 版在同一份数据上的速度差,两处来源都没给数字,本文不给具体倍数。
没有核对仓库的 star 数与提交历史(只取了最近推送时间 2026-11-18T13:58:35Z,star 数会变,不引用),也没有核对 datasette-maplibre 在 PyPI 上的现状,没跑过官方那个 maplibre 演示链接。
一个只有单一来源的地方:pysqlite3-wasm-wheels 只有作者本人这一个来源,163 个版本这个数字目前属于「作者自述,未独立核实」。原文与 README 之间本文没遇到需要并列的口径差异。
自己去试
- Datasette Lite 项目仓库与 README:https://github.com/simonw/datasette-lite ↗
- 在线试用:https://lite.datasette.io/ ↗
- Willison 的项目系列文章:https://simonwillison.net/2026/Nov/17/datasette-lite/ ↗
知道 SQLite 或 CSV 文件是什么;见过 URL 里的查询参数,但没自己拼过
适用范围:基于 2026 年 11 月 17 日采集素材整理,核对至 2026-11-19
以下来源方便你逐项对照;引用文档不代表已经完成实际操作测试。 本文标注为 AI 辅助起草。
- 核对了什么:simonw/datasette-lite 仓库 README 全文。URL 参数:?url= 打开 SQLite 数据库、?csv= 打开 CSV(可重复多次并按列名 join)、?json=、?sql=、?metadata=、?ref= 指定 Datasette 版本、?sqlite= 指定 SQLite 版本、?install= 装插件。?ref= 看起来像版本号的(如 1.0a11)从 PyPI 装,其余当作分支、标签或提交号从源码跑。默认 SQLite 是 Pyodide 自带的 3.39.0;/-/versions 与 select sqlite_version() 报出当前版本。核对日期 2026-11-19。
- 核对了什么:README 里关于 SQLite 版本的说明。Datasette 本就该在 3.25(2018 年 9 月发布)之后的任何 SQLite 版本上跑,之后又出了 87 个版本;datasette/pysqlite3-wasm-wheels 仓库为 163 个 SQLite 版本编译了 pysqlite3 的 WebAssembly wheel,文件名形如 pysqlite3-0.6.2-3.54.1-cp314-cp314-pyemscripten_2026_0_wasm32.whl。README 里那个多 CSV join 的例子用的是纽约时报新冠 county 数据与美国人口普查 county 人口数据。核对日期 2026-11-19。没做什么:该仓库只有作者本人一个来源,163 这个数字属作者自述,未独立核实。
- 核对了什么:Simon Willison 2026-11-17《Running the full server-side Datasette Python app in the browser with service workers and Pyodide》原文。第一版 2022 年 5 月上线,原作者说是「a bit of a joke」;老版做法是在 Pyodide Web Worker 里跑 Datasette、模拟请求、再用 innerHTML 塞回顶层页面,脚本标签在 innerHTML 里不执行,所以依赖 JavaScript 的功能全部失效,插件的 JS/CSS 也加载不了。新版改用 Service Worker 拦截请求,注册覆盖整个 lite.datasette.io 域名。核对日期 2026-11-19。
- 核对了什么:同一篇原文里的请求链路细节。iframe 请求的地址形如 /app/aa94e6851595/ 与 /app/aa94e6851595/data/places,这些地址在服务器上不存在,由 Service Worker 拦截后转交顶层页面,再转给 Web Worker。多标签页靠顶层页面生成的随机 session ID 前缀隔离。另需 Web Worker 的原因是 Pyodide 在 Service Worker 里维持不住约 30 秒的状态,取决于浏览器。核对日期 2026-11-19。
来源发布时间:2026/11/18。来源采集记录随文章版本保留。
发现内容与当前界面不一致?
提交内容纠错金额随意,多少都帮得上忙。AITime 的资料整理、事实核对和每日更新由个人完成, 没有付费墙,所有内容都可以免费读。
扫码使用微信支付,备注可以留空。
哪个工具卡在哪一步、想给文章补一个真实案例、都可以加我。 留言时写清来源和具体问题,我看到会回。
扫一扫添加好友,备注写「AITime」我更容易认出来。
讨论与使用经验
正在加载讨论…