v0.1.0

架構

最後更新


本頁以一張圖呈現 go-web-monitor 各套件的層級關係,並列出每層的職責、跨層共用的設計原則與部署型態。

系統概覽


graph TB
    Main[cmd/tui main] -->|util.Read / util.Save| Store[(.webMonitor.json)]
    Main -->|service.New| Monitor[service.Monitor]
    Main -->|service.NewUI| UI[service.UI]
    UI -->|Ticker 每分鐘 / refresh| Monitor
    UI -->|指令方法| Monitor
    Monitor -->|Check: HEAD → GET| Site[目標網站]
    Monitor -->|util.CheckExpire| TLS[目標網站 :443]
    Monitor -->|sendEmail / TestEmail| SMTP[service.SMTP]
    SMTP --> Mail[郵件伺服器]
    Monitor -->|Save| Store
  1. graph TB
  2. Main[cmd/tui main] -->|util.Read / util.Save| Store[(.webMonitor.json)]
  3. Main -->|service.New| Monitor[service.Monitor]
  4. Main -->|service.NewUI| UI[service.UI]
  5. UI -->|Ticker 每分鐘 / refresh| Monitor
  6. UI -->|指令方法| Monitor
  7. Monitor -->|Check: HEAD → GET| Site[目標網站]
  8. Monitor -->|util.CheckExpire| TLS[目標網站 :443]
  9. Monitor -->|sendEmail / TestEmail| SMTP[service.SMTP]
  10. SMTP --> Mail[郵件伺服器]
  11. Monitor -->|Save| Store

分層


層套件/檔案職責
入口cmd/tui/main.go建立或讀取 .webMonitor.json,組裝 Monitor 與 UI 後執行
介面internal/service/ui.gotview 介面、每分鐘排程、指令解析、表格與面板渲染
監控核心internal/service/monitor.go監控清單與狀態表、HTTP 探測、失敗計數、告警觸發、SMTP 設定管理
寄信internal/service/smtp.go依 port 選擇明文/隱式 TLS/STARTTLS,寄出 HTML 信件
工具internal/util/JSON 設定檔讀寫、SSL 憑證剩餘天數
資料模型internal/model/model.goWebsite、Config、MonitorData

跨層原則


原則實作
單一持久化檔案所有狀態與設定都寫在當前目錄的 .webMonitor.json,沒有資料庫或外部服務
狀態集中於 MonitorUI 不持有資料,只透過 Monitor 的 getter 與指令方法讀寫
共享狀態以 sync.RWMutex 保護list、status、config、isShow 由同一把鎖保護
無外部相依的網路層HTTP、TLS、SMTP 全用標準庫;第三方套件只有 tview 與 tcell

部署型態


Uptime Kuma 與 Gatus 是自架服務,提供網頁儀表板或狀態頁(status page),兩者都提供 Docker 映像檔。updo 與 statusok 則和本專案一樣是從終端機啟動的 Go 程式:updo 有互動式 TUI,透過桌面通知或 webhook 告警;statusok 讀取 config.json,透過 Slack 或 SMTP Email 通知。go-web-monitor 是單一 TUI 行程、不架網頁伺服器:監控清單與 SMTP 設定都存在同一個 .webMonitor.json,在介面內以指令修改;每分鐘以 HEAD 優先、GET 回退檢查每個網站,每列顯示 SSL 憑證剩餘天數,連續 5 次離線才寄出 Email。

延伸閱讀


EN