自己架共筆的人，怕的往往不是功能少了什麼，而是某天發現一條筆記連結竟然能用別人的身分打開。HedgeDoc 1.12.2 處理的就是這一類事。

想要一套能自己架的即時共筆工具，HedgeDoc 是常見的答案：它在瀏覽器裡運作，以 Markdown 為本，授權為 AGPL-3.0。專案原本叫 CodiMD，2020 年碰上同名問題，才改成今天的名字。它想解決的事情很單純——同事收到一條連結、點開就能一起寫，不必先裝任何東西，資料也始終待在自己的伺服器上。11 月 4 日這天，專案接連推出 1.12.1 與 1.12.2。

同一天兩版，先出來的那個已經被收回

兩個版本都在 11 月 4 日報到，不過 1.12.1 的頁面上留著一行提示：在 PostgreSQL 環境下跑出了狀況，版本已撤回，請改用 1.12.2。至於 1.12.2 自己，真正動到的只有一處——profile provider 的遷移在 PostgreSQL 上會失敗。所以，如果你的站已經跑到 1.12.1、資料庫又是 PostgreSQL，換到 1.12.2 沒有討論空間。

真正該花時間讀的，是 1.12.1 帶進來的那批安全修補。它們對應七份已經公開的公告，位置落在權限、認證、內容渲染這三條出錯代價最高的路徑上。

七份公告分別補哪裡

第一份講冒充登入：兩個認證來源若回報同一個 profile id，就有機會被當成同一個人。這種事在同時接了好幾家登入的自架站上最要命——管理者通常一邊接公司帳號體系，一邊接外部登入。

第二份是即時共筆的程式會掛：一個不合法的選取動作，就能把共筆通道打斷。第三份是簡報檢視會嵌進未轉義的 iframe，等於替 HTML 注入開了一道門。第四份跟信箱有關，攻擊者靠回應時間的長短，就能判斷某個信箱在這台站上註冊過沒有，是很典型的時序側通道。第五份是權限無效時沒有落實強制檢查，第六份是拿特製的顯示名稱塞進 HTML 注入。第七份最直接：任何已登入的人挑一個特定別名開筆記，整個站就垮了。

公告文字裡還補了一句，另外幾處 HTML 注入的可能也一併關掉了。對自架站而言，這串加起來不輕——它們大多不必動用管理者權限，有一個帳號就夠，有些甚至只要能打開分享連結。

順帶加進來的兩件小事

功能面這次沒什麼大動作，但有兩處值得一提。一是多了設定項，讓 OAuth2 或 OIDC 來源可以直接給出頭像網址，不必一律退回系統產生的預設頭像，用單一登入的團隊看了會舒服些。二是 mermaid 升到 11.17，能畫的圖表種類跟著變寬。執行環境方面，1.12.0 起最低要 Node 20.17，1.12.1 起官方連 Node 26 都測過並正式支援，還留在舊環境的部署該把升級排進時程了。

它究竟是個什麼樣的工具

功能上它只專注一件事，就是 Markdown。幾個人同時編輯同一則筆記，改動立刻同步；切到簡報模式，一則筆記可以直接當投影片講；流程圖和各類圖表能嵌在筆記裡；權限用一個下拉選單就能調成公開、僅登入可見或指定人可見；修訂歷史把每次改動都記下來，還能回到任何一個舊版本。資源吃得不多，官方說在樹莓派上也跑得動，部署包與容器映像都有現成的。

帳號可以接 OAuth2、LDAP、SAML 這些常見方案，檔案除了放本機，也支援物件儲存。這套組合的價值在於：團隊不必為了一款共筆工具，另外再養一套帳號和一座資料孤島。

動手升級前的兩件事

先把資料庫備份起來。這次的狀況正好出在 PostgreSQL 上的遷移環節，1.12.1 已經示範了升級路徑本身也會埋坑，一份能回溯的備份，比任何操作指南都實用。接著確認執行環境版本，Node 20.17 是底線，比它更低的環境升完之後根本起不來。

至於該不該現在升，判斷很簡單：只要你的站對外開放、接受註冊，或者允許用連結分享筆記，七份公告裡至少有三、四份直接命中你，那就別拖。反過來說，只在內網、只對固定幾個人開放，風險窗口小一點，但也沒小到可以不管。

這兩個版本沒有帶來任何讓人眼睛一亮的新功能，它們做的是把一扇扇沒關緊的窗，逐一關好。自己架的好處是資料在自己手上，代價也在這裡——修補程式得自己動手打。