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。