> ## Documentation Index
> Fetch the complete documentation index at: https://docs.panguard.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 第一次掃描

> 手把手帶你跑第一次 Panguard 安全掃描，看懂結果，知道該修什麼。

# 第一次掃描

Panguard 掃描大約 60 秒就能分析完你的系統、找出安全弱點，並給出具體的修復建議。所有掃描功能免費開源。

***

## 前置需求

開始掃描前，先確認 Panguard 已裝好：

```bash theme={null}
# 透過 npm 安裝
npm install -g panguard

# 或用一行安裝腳本
curl -fsSL https://get.panguard.ai | bash

# 確認安裝成功
panguard --version
```

***

## 跑你的第一次掃描

<Steps>
  <Step title="跑快速掃描">
    先用快速掃描看個大概：

    ```bash theme={null}
    panguard scan --quick
    ```

    大約 30 秒完成，涵蓋 OS 偵測、網路介面、開放 port、執行中服務、密碼政策、防火牆狀態、安全工具偵測。
  </Step>

  <Step title="看掃描結果">
    結果會依嚴重程度分組顯示：

    ```
      -- Network Interfaces -------------------

      en0    192.168.1.100  (Wi-Fi)
      lo0    127.0.0.1      (Loopback)

      -- Open Ports ----------------------------

      Port   Proto  Service     PID    Risk
      22     tcp    sshd        1234   HIGH
      80     tcp    nginx       5678   LOW
      443    tcp    nginx       5678   LOW
      3306   tcp    mysqld      9012   MEDIUM
    ```
  </Step>

  <Step title="看安全分數">
    每次掃描都會算出 0-100 的安全分數和等級：

    ```
      -- Risk Score ----------------------------

      Score: 72/100 [------------------] Grade: C
      Trend: improving (+5 since last scan)

      Breakdown:
        Firewall:    80/100
        Open Ports:  60/100
        Passwords:   50/100
        Updates:     90/100
        Tools:       70/100
        Threats:     85/100
        Compliance:  65/100
        Response:    70/100
    ```
  </Step>

  <Step title="先修最嚴重的">
    先處理 CRITICAL 和 HIGH 的發現。每個發現都附帶說明和修復步驟。
  </Step>
</Steps>

***

## 快速掃描 vs. 完整掃描

| 功能           | 快速模式 (`--quick`) | 完整模式（預設） |
| ------------ | ---------------- | -------- |
| **耗時**       | \~30 秒           | \~60 秒   |
| **OS 偵測**    | 有                | 有        |
| **網路介面**     | 有                | 有        |
| **開放 port**  | 有                | 有        |
| **執行中服務**    | 有                | 有        |
| **密碼政策**     | 有                | 有        |
| **防火牆狀態**    | 有                | 有        |
| **安全工具**     | 有                | 有        |
| **SSL 憑證驗證** | 無                | 有        |
| **排程任務稽核**   | 無                | 有        |
| **共享資料夾安全**  | 無                | 有        |
| **風險分數**     | 有                | 有        |

跑完整掃描：

```bash theme={null}
panguard scan
```

***

## 嚴重程度等級

| 嚴重程度         | 意思         | 建議處理    |
| ------------ | ---------- | ------- |
| **CRITICAL** | 隨時可能被打穿    | 立刻修     |
| **HIGH**     | 重大安全風險     | 24 小時內修 |
| **MEDIUM**   | 中等風險，建議改善  | 一週內修    |
| **LOW**      | 低風險，屬於最佳實務 | 有空再修    |
| **INFO**     | 純資訊        | 不需處理    |

***

## 產生 PDF 報告

把掃描結果匯出成 PDF：

```bash theme={null}
# 英文報告
panguard scan --output my-report.pdf

# 繁體中文報告
panguard scan --output my-report.pdf --lang zh-TW
```

PDF 內容包含：

1. **封面** -- 組織名稱、掃描日期、品牌
2. **摘要** -- 風險分數、等級、發現統計
3. **發現明細** -- 每項發現的嚴重程度、說明、位置
4. **修復指引** -- 每項發現的具體修復步驟
5. **合規對應** -- 對應 ISO 27001 / SOC 2 / 台灣資通安全管理法

***

## 掃完之後下一步

<CardGroup cols={2}>
  <Card title="開啟即時防護" icon="shield" href="/guides/real-time-protection">
    啟動 Guard 持續監控並保護你的系統。
  </Card>

  <Card title="設定通知" icon="bell" href="/guides/notifications-setup">
    設定 Telegram、Slack 或 Email 警報，即時收到安全事件通知。
  </Card>

  <Card title="產生合規報告" icon="file-check" href="/guides/compliance-reports">
    用掃描結果產出 ISO 27001、SOC 2 或資通安全管理法報告。
  </Card>

  <Card title="部署蜜罐" icon="flask" href="/guides/honeypots">
    設置誘餌服務來偵測和分析攻擊者。
  </Card>
</CardGroup>

***

## CLI 參考

```
panguard scan [options]

Options:
  --quick              快速模式（~30 秒）
  --output <path>      PDF 報告輸出路徑
  --lang <en|zh-TW>    語言（預設：en）
  --verbose            詳細輸出
```