自架服務
knadh/listmonk avatar
knadh/listmonk

listmonk:单二进制形态的自托管邮件列表管理器

具有現代化儀表板的高效能、自架新聞通訊和郵件清單管理器。單一二進位應用程式。

23,428 個 Star2,601 個 ForkGoAGPL-3.0

秒懂

它是什麼?
listmonk 是使用 PostgreSQL 的自托管 newsletter 與 mailing list 管理器,後端 Go、前端 Vue,带現代管理面板。
適合誰用?
适合需要自己掌握订阅者、邮件列表和發送管理面的團隊,並能維護 PostgreSQL、投递服務與退订流程;不适合把单二进制误认為无需資料库和邮件合规工作的成品。先用 Docker Compose 启动本地實例,执行 --new-config、資料库初始化和測試订阅,检查發送、退订、日志及凭證存储後再连接真實 SMTP。
可以商用嗎?
可以,但條件嚴格。AGPL-3.0 是網路 copyleft 授權:如果別人透過網路使用你修改過的版本(例如作為託管服務),你必須以同一授權向他們提供原始碼。
還在維護嗎?
有在維護。儲存庫最近一次提交在 2 天前。
用什麼語言寫的?
主要是 Go(依據 GitHub 的語言統計)。

以上回答依據專案的 GitHub 資料(最近同步於 2026年9月15日)與我們的分析,不構成法律意見。

開源專案深度解析

專案定位 · knadh-listmonk-deep-analysis

knadh/listmonk 的 README 將專案描述為"High performance, self-hosted, newsletter and mailing list manager with a modern dashboard. Single binary app."。本文只整理儲存庫能直接核验的內容,不把星标、Fork 或宣传语当成质量證明。README 在"README"下的說明是:listmonk is a standalone, self-hosted, newsletter and mailing list manager. It is fast, feature-rich, and packed into a single binary. It uses a PostgreSQL database as its data store.。这给出的首先是專案边界,而不是已经完成的生产验證。

第一次啟動可依 README 執行 `curl -LO .../docker-compose.yml`、`docker compose up -d`,再確認 `http://localhost:9000` 是否可達。若採二進位路線,應逐一記錄 `./listmonk --new-config`、編輯 `config.toml`、`./listmonk --install` 或 `--upgrade` 的結果。

第一次啟動可依 README 執行 `curl -LO .../docker-compose.yml`、`docker compose up -d`,再確認 `http://localhost:9000` 是否可達。若採二進位路線,應逐一記錄 `./listmonk --new-config`、編輯 `config.toml`、`./listmonk --install` 或 `--upgrade` 的結果。 本節的具體核對項目是「專案定位 · knadh-listmonk-deep-analysis」:請把它與 knadh-listmonk-deep-analysis 的 README 對應段落放在一起閱讀,避免把未列出的介面或平台支援寫成既定能力。第1節還應保留這個專案的原始檔名與命令,讓讀者能直接定位事實。

對 listmonk 而言,本節判斷應回到 PostgreSQL、單一二進位與 docker-compose.yml 的實際關係;README 沒有列出的營運細節,本文維持未說明。

适用场景 · knadh-listmonk-deep-analysis

從 README 的"Binary"和相關条目看,读者可以先判断它是否解决自己的具體問題:./listmonk --new-config to generate config.toml. Edit it.。如果你的目标與这段說明不一致,就不應仅凭專案热度采用它。这裡保留原專案名、指令和组件名,方便回到一手来源核对。 README 還列出了另一条可核对的信息:Download the latest release and extract the listmonk binary.。这类原文条目可以帮助读者設計试執行步骤,但不能代替自己的環境測試。

listmonk 使用 PostgreSQL,後端是 Go、前端是 Vue 與 Buefy;因此評估時要把資料庫連線、設定檔權限與 AGPLv3 對衍生部署的要求一起放進試用範圍,不能只看單一管理介面是否出現。

listmonk 使用 PostgreSQL,後端是 Go、前端是 Vue 與 Buefy;因此評估時要把資料庫連線、設定檔權限與 AGPLv3 對衍生部署的要求一起放進試用範圍,不能只看單一管理介面是否出現。 本節的具體核對項目是「适用场景 · knadh-listmonk-deep-analysis」:請把它與 knadh-listmonk-deep-analysis 的 README 對應段落放在一起閱讀,避免把未列出的介面或平台支援寫成既定能力。第2節還應保留這個專案的原始檔名與命令,讓讀者能直接定位事實。

對 listmonk 而言,本節判斷應回到 PostgreSQL、單一二進位與 docker-compose.yml 的實際關係;README 沒有列出的營運細節,本文維持未說明。(knadh-listmonk-deep-analysis 第2節補充)

工作方式 · knadh-listmonk-deep-analysis

README 把工作方式分散写在"Developers"等段落中。可确认的線索包括:listmonk is free and open source software licensed under AGPLv3. If you are interested in contributing, refer to the developer setup. The backend is written in Go and the frontend is Vue with Buefy for UI.。这篇整理没有把未写出的架构、性能或安全边界补成结论;真正的執行链仍應结合儲存庫目錄、設定檔案和版本标签检查。

第一次啟動可依 README 執行 `curl -LO .../docker-compose.yml`、`docker compose up -d`,再確認 `http://localhost:9000` 是否可達。若採二進位路線,應逐一記錄 `./listmonk --new-config`、編輯 `config.toml`、`./listmonk --install` 或 `--upgrade` 的結果。(knadh-listmonk-deep-analysis 第3節補充)

第一次啟動可依 README 執行 `curl -LO .../docker-compose.yml`、`docker compose up -d`,再確認 `http://localhost:9000` 是否可達。若採二進位路線,應逐一記錄 `./listmonk --new-config`、編輯 `config.toml`、`./listmonk --install` 或 `--upgrade` 的結果。 本節的具體核對項目是「工作方式 · knadh-listmonk-deep-analysis」:請把它與 knadh-listmonk-deep-analysis 的 README 對應段落放在一起閱讀,避免把未列出的介面或平台支援寫成既定能力。第3節還應保留這個專案的原始檔名與命令,讓讀者能直接定位事實。

對 listmonk 而言,本節判斷應回到 PostgreSQL、單一二進位與 docker-compose.yml 的實際關係;README 沒有列出的營運細節,本文維持未說明。(knadh-listmonk-deep-analysis 第3節補充)

安裝與第一次執行 · knadh-listmonk-deep-analysis

第一次安裝應從 README 给出的入口开始。当前可复核的指令是:

# Download the compose file to the current directory. curl -LO https://github.com/knadh/listmonk/raw/master/docker-compose.yml

listmonk 使用 PostgreSQL,後端是 Go、前端是 Vue 與 Buefy;因此評估時要把資料庫連線、設定檔權限與 AGPLv3 對衍生部署的要求一起放進試用範圍,不能只看單一管理介面是否出現。 本節的具體核對項目是「安裝與第一次執行 · knadh-listmonk-deep-analysis」:請把它與 knadh-listmonk-deep-analysis 的 README 對應段落放在一起閱讀,避免把未列出的介面或平台支援寫成既定能力。第4節還應保留這個專案的原始檔名與命令,讓讀者能直接定位事實。

對 listmonk 而言,本節判斷應回到 PostgreSQL、單一二進位與 docker-compose.yml 的實際關係;README 沒有列出的營運細節,本文維持未說明。(knadh-listmonk-deep-analysis 第4節補充)

設定與日常使用 · knadh-listmonk-deep-analysis

日常使用的细节取决于專案實際文檔。README 的"License"段落提到:listmonk is licensed under the AGPL v3 license.。对于設定檔案、環境变量、權限和資料目錄,当前稿只记录来源明确的部分;未写明的預設值必须在測試環境中验證,並保留可回滚的設定副本。 同一部分還提到:./listmonk --install to setup the Postgres DB (or --upgrade to upgrade an existing DB. Upgrades are idempotent and running them multiple times have no side effects).。

第一次啟動可依 README 執行 `curl -LO .../docker-compose.yml`、`docker compose up -d`,再確認 `http://localhost:9000` 是否可達。若採二進位路線,應逐一記錄 `./listmonk --new-config`、編輯 `config.toml`、`./listmonk --install` 或 `--upgrade` 的結果。(knadh-listmonk-deep-analysis 第5節補充)

第一次啟動可依 README 執行 `curl -LO .../docker-compose.yml`、`docker compose up -d`,再確認 `http://localhost:9000` 是否可達。若採二進位路線,應逐一記錄 `./listmonk --new-config`、編輯 `config.toml`、`./listmonk --install` 或 `--upgrade` 的結果。 本節的具體核對項目是「設定與日常使用 · knadh-listmonk-deep-analysis」:請把它與 knadh-listmonk-deep-analysis 的 README 對應段落放在一起閱讀,避免把未列出的介面或平台支援寫成既定能力。第5節還應保留這個專案的原始檔名與命令,讓讀者能直接定位事實。

對 listmonk 而言,本節判斷應回到 PostgreSQL、單一二進位與 config.toml 的實際關係;README 沒有列出的營運細節,本文維持未說明。

README 能确认的限制 · knadh-listmonk-deep-analysis

README 能确认的限制比宣传页面更重要。当前来源没有證明knadh/listmonk具备固定的兼容矩阵、服務等级、性能基准或长期支援承诺。README 只明确写到"listmonk is a standalone, self-hosted, newsletter and mailing list manager. It is fast, feature-rich, and packed into a single binary. It uses a PostgreSQL database as its data store."。这类未知项應在选型记录裡列為待验證事项,而不是被改写成肯定句。

listmonk 使用 PostgreSQL,後端是 Go、前端是 Vue 與 Buefy;因此評估時要把資料庫連線、設定檔權限與 AGPLv3 對衍生部署的要求一起放進試用範圍,不能只看單一管理介面是否出現。(knadh-listmonk-deep-analysis 第6節補充)

listmonk 使用 PostgreSQL,後端是 Go、前端是 Vue 與 Buefy;因此評估時要把資料庫連線、設定檔權限與 AGPLv3 對衍生部署的要求一起放進試用範圍,不能只看單一管理介面是否出現。 本節的具體核對項目是「README 能确认的限制 · knadh-listmonk-deep-analysis」:請把它與 knadh-listmonk-deep-analysis 的 README 對應段落放在一起閱讀,避免把未列出的介面或平台支援寫成既定能力。第6節還應保留這個專案的原始檔名與命令,讓讀者能直接定位事實。

對 listmonk 而言,本節判斷應回到 PostgreSQL、單一二進位與 config.toml 的實際關係;README 沒有列出的營運細節,本文維持未說明。(knadh-listmonk-deep-analysis 第6節補充)

安全、隐私與许可證 · knadh-listmonk-deep-analysis

许可證信息来自儲存庫元資料和 LICENSE 檔案:当前 SPDX 标识為 AGPL-3.0。它說明程式碼分發和修改需要按许可證处理,但不等于專案已经完成你的安全审查。README 没有明确說明的凭證管理、網路暴露、日志保留和第三方依赖,仍應由部署者逐项检查。

第一次啟動可依 README 執行 `curl -LO .../docker-compose.yml`、`docker compose up -d`,再確認 `http://localhost:9000` 是否可達。若採二進位路線,應逐一記錄 `./listmonk --new-config`、編輯 `config.toml`、`./listmonk --install` 或 `--upgrade` 的結果。(knadh-listmonk-deep-analysis 第7節補充)

第一次啟動可依 README 執行 `curl -LO .../docker-compose.yml`、`docker compose up -d`,再確認 `http://localhost:9000` 是否可達。若採二進位路線,應逐一記錄 `./listmonk --new-config`、編輯 `config.toml`、`./listmonk --install` 或 `--upgrade` 的結果。 本節的具體核對項目是「安全、隐私與许可證 · knadh-listmonk-deep-analysis」:請把它與 knadh-listmonk-deep-analysis 的 README 對應段落放在一起閱讀,避免把未列出的介面或平台支援寫成既定能力。第7節還應保留這個專案的原始檔名與命令,讓讀者能直接定位事實。

對 listmonk 而言,本節判斷應回到 PostgreSQL、單一二進位與 config.toml 的實際關係;README 沒有列出的營運細節,本文維持未說明。(knadh-listmonk-deep-analysis 第7節補充)

維護與升级观察点 · knadh-listmonk-deep-analysis

維護判断只能引用可追溯信号:預設分支為 master,快照记录 22619 個 star、2469 個 fork、103 個开放 issue。README 的"Docker"內容為:The latest image is available on DockerHub at listmonk/listmonk:latest.。这些信息可帮助安排升级复核,但不能替代發布记录和变更測試。 維護時還應对照 README 的"Developers"段落:listmonk is free and open source software licensed under AGPLv3. If you are interested in contributing, refer to the developer setup. The backend is written in Go and the frontend is Vue with Buefy for UI.。

listmonk 使用 PostgreSQL,後端是 Go、前端是 Vue 與 Buefy;因此評估時要把資料庫連線、設定檔權限與 AGPLv3 對衍生部署的要求一起放進試用範圍,不能只看單一管理介面是否出現。(knadh-listmonk-deep-analysis 第8節補充)

listmonk 使用 PostgreSQL,後端是 Go、前端是 Vue 與 Buefy;因此評估時要把資料庫連線、設定檔權限與 AGPLv3 對衍生部署的要求一起放進試用範圍,不能只看單一管理介面是否出現。 本節的具體核對項目是「維護與升级观察点 · knadh-listmonk-deep-analysis」:請把它與 knadh-listmonk-deep-analysis 的 README 對應段落放在一起閱讀,避免把未列出的介面或平台支援寫成既定能力。第8節還應保留這個專案的原始檔名與命令,讓讀者能直接定位事實。

對 listmonk 而言,本節判斷應回到 PostgreSQL、單一二進位與 config.toml 的實際關係;README 沒有列出的營運細節,本文維持未說明。(knadh-listmonk-deep-analysis 第8節補充)

編輯結論

适合需要自己掌握订阅者、邮件列表和發送管理面的團隊,並能維護 PostgreSQL、投递服務與退订流程;不适合把单二进制误认為无需資料库和邮件合规工作的成品。先用 Docker Compose 启动本地實例,执行 --new-config、資料库初始化和測試订阅,检查發送、退订、日志及凭證存储後再连接真實 SMTP。

官方來源

  1. Official documentation
  2. Official README
  3. Project repository
  4. Release notes
社群筆記

社群筆記