Hypothesis(自托管版)

Hypothesis 是开源的网页批注工具。h 是驱动它的服务器:提供批注网页应用与公开的批注 API。自托管一套之后,你和协作者就能在自己掌控的基础设施上,对任意网页或 PDF 高亮、批注、讨论。

这个模板会一次部署四个服务,组成一键启动的完整堆栈:

• hypothesis — h 服务器(网页应用、API、实时 WebSocket、后台 worker)
• postgresql — 存储账号、群组与批注
• elasticsearch — 提供批注搜索(使用 Hypothesis 内置 ICU 插件的版本)
• rabbitmq — 后台 worker 的消息队列

开始使用

1. 填入你想使用的域名,点击 Deploy。
2. 等四个服务都部署完成。hypothesis 服务首次启动会跑一次性初始化(建立数据库结构、搜索索引与管理员账号),所以第一次启动会花几分钟,这是正常的。
3. 打开你的域名,应该会看到 Hypothesis 首页。

登录

系统会在首次启动时自动创建一个管理员账号:

• 用户名: admin
• 密码: 见 hypothesis 服务上的 ADMIN_PASSWORD 变量(Zeabur 仪表盘的 Variables 标签页)

请到 https://你的域名/login 登录,然后立即从账号设置页更改这组密码。管理工具在 https://你的域名/admin。

使用自定义域名

批注的 authority 与对外 URL 是在部署时根据域名推导出来的。如果你想用自定义域名,请在第一次部署前就先绑定;否则就要做好重新部署的准备:在账号与批注已存在之后才更改域名,会让它们仍绑在旧的 authority 上。

重要事项

• 批注用的 client 是从 https://cdn.hypothes.is 加载的。 这是 Hypothesis 的默认行为,可让 client 保持最新;你的批注「数据」则完全留在你自己的实例上。
• 未配置 email。 账号激活流程会被跳过,密码重置邮件也不会发出,除非你在 hypothesis 服务加上 MAIL_* 环境变量。
• 数据存放在 postgresql 与 elasticsearch 的 volume 里。 hypothesis 服务本身无状态。请勿删除那些 volume。
• PostgreSQL、Elasticsearch、RabbitMQ 三个服务只在项目的私有网络内可达 — 尤其 Elasticsearch 没有任何认证,请勿对外公开。

授权与署名

Hypothesis(h)由 Hypothes.is Project 与贡献者开发,以 BSD-2-Clause 许可证发布。本模板仅将官方 hypothesis/hypothesis Docker image 打包以便在 Zeabur 上部署,与 Hypothes.is Project 无从属或背书关系。

• 源代码:https://github.com/hypothesis/h
• 官方网站:https://web.hypothes.is/

更新日志

• 2026-05-14:首次发布。基于 hypothesis/hypothesis:20260504-g4d0056f。