# 快速開始

本頁說明執行 go-web-monitor 所需的環境、安裝方式，以及第一次新增監控網站的流程。

## 前置需求

| 項目 | 需求 |
|------|------|
| Go | 1.21 以上（`go.mod` 宣告 `go 1.21`） |
| 終端機 | 支援 ANSI 色彩，視窗寬度足以容納六欄表格與右側面板 |
| 網路 | 可連線至目標網站；SSL 檢查需對外連線 443 埠 |
| SMTP 帳號 | 選用，僅 Email 告警需要 |

## 安裝

### 直接執行

```bash
git clone https://github.com/pardnchiu/go-web-monitor.git
cd go-web-monitor
go run ./cmd/tui
```

### 建置執行檔

```bash
git clone https://github.com/pardnchiu/go-web-monitor.git
cd go-web-monitor
go build -o go-web-monitor ./cmd/tui
./go-web-monitor
```

`go.mod` 的 module 名稱是 `website-monitor`，與 GitHub 路徑不同，因此 `go install github.com/pardnchiu/go-web-monitor/...` 無法使用，只能從原始碼建置。

## 第一次執行

1. 在想存放資料的目錄下啟動程式。程式會在**當前工作目錄**尋找 `.webMonitor.json`，不存在時自動建立空白設定（`cmd/tui/main.go:12`）。
2. 畫面左側是 Monitor 表格，右側上方是 System 面板，右下角是 Command 輸入框，游標預設停在輸入框。
3. 輸入指令後按 Enter：

```bash
add example.com
add https://api.example.com/health
```

`add` 會立即檢查一次並把結果寫回 `.webMonitor.json`；之後每分鐘自動並行檢查所有網站。

4. 輸入 `quit`（或按 <kbd>Ctrl+C</kbd>）結束程式。

## 下一步

- 告警需要 SMTP，設定方式見 [設定 Email 告警](/zh/smtp-setup)
- 所有指令與快捷鍵見 [命令列參考](/zh/cli-reference)
- 設定檔欄位見 [設定檔](/zh/configuration)