n8n-nodes-wanguard

這是一個為 n8n 工作流程自動化平台設計的 Wanguard 整合節點。

關於 Wanguard

Andrisoft Wanguard 是一款獲獎的企業級 DDoS 檢測與緩解軟體解決方案，專為監控和保護大型 WAN 網路免受大規模 DDoS 攻擊而設計。

Wanguard 提供全網路範圍的監控，能夠即時檢測和緩解各種網路威脅，包括：
- 分散式阻斷服務攻擊 (DDoS)
- SYN 洪水攻擊
- NTP 放大攻擊
- UDP 或 ICMP 洪水攻擊
- 以及更多其他類型的攻擊

$3

- Flow Sensor 和 Packet Sensor：提供深入的流量分析、流量計費、頻寬監控、流量異常和 DDoS 攻擊檢測
- Filter：在 DoS、DDoS 或 DrDOS 攻擊期間啟動，以精細的方式清洗異常流量
- Console：多租戶網頁應用程式，作為軟體的管理核心，整合來自網路中部署的 Sensors 和 Filters 的數據

$3

- ✅ DDoS 檢測與緩解
- ✅ 強大的反應工具（BGP 路由更新、Flowspec、自動化腳本執行）
- ✅ 詳細的攻擊取證分析
- ✅ 完整的網路可視性（支援 NetFlow、sFlow、IPFIX 等）
- ✅ 進階網頁控制台
- ✅ 複雜的分析報告
- ✅ 即時和歷史報告
- ✅ 完全可擴展的架構

詳細資訊請參閱 Wanguard 官方網站

專案狀態

$3

- ✅ 基礎設施（認證、傳輸層、工具函數）
- ✅ 37 個資源的基礎架構
- ✅ 2 個完整實作的資源（Anomaly、BGP Announcement）
- ✅ 支援 180+ API 操作的框架
- ✅ TypeScript 完全型別支援

$3

- 🚧 完善剩餘 35 個資源的 API 實作
- 🚧 API 端點和參數映射
- 🚧 錯誤處理和驗證

$3

- 📋 單元測試
- 📋 整合測試
- 📋 完整文檔和範例
- 📋 發布到 npm

詳細開發狀態和貢獻指南請參閱 DEVELOPMENT.md。

快速開始

> ⚠️ 開發中: 此專案目前處於活躍開發階段。基礎架構已完成，可以正常編譯和使用，但許多 API 操作仍需要完善實作。詳情請參閱 DEVELOPMENT.md。

$3

在您的 n8n 實例中安裝此社群節點：

#### 社群節點安裝（推薦）

1. 前往 Settings > Community Nodes
2. 選擇 Install
3. 輸入 n8n-nodes-wanguard
4. 點擊 Install

#### 手動安裝

如果您在本地執行 n8n：

``bash
npm install n8n-nodes-wanguard
`

$3

1. 在 n8n 中新增 Wanguard 憑證
2. 輸入您的 Wanguard API URL 和憑證
3. 開始在工作流程中使用 Wanguard 節點

功能特色

此 n8n 整合節點提供以下功能：

- 🔍 查詢 DDoS 攻擊資訊
- 📊 獲取流量統計數據
- ⚙️ 管理緩解規則
- 📧 設定告警通知
- 🌐 監控網路狀態

開發

如果您想要為此專案做出貢獻或進行本地開發：

$3

- Node.js (v22 或更高版本) 和 npm
- git

$3

`bash


安裝依賴項

npm install

以開發模式啟動 n8n（包含熱重載）

npm run dev
`

這會啟動 n8n，您可以在 http://localhost:5678 測試您的節點。

$3

`bash


建置專案

npm run build

檢查程式碼品質

npm run lint

自動修復 lint 問題

npm run lint:fix
`

可用的腳本指令

此專案包含多個 npm 指令來簡化開發流程：

| 指令 | 說明 |
| --------------------- | ---------------------------------------------------------------- |
| npm run dev | 啟動 n8n 並載入您的節點，監控檔案變更（執行 n8n-node dev） |
| npm run build | 將 TypeScript 編譯為 JavaScript 以用於生產環境（執行 n8n-node build） |
| npm run build:watch | 以監控模式建置（檔案變更時自動重新建置） |
| npm run lint | 檢查程式碼錯誤和樣式問題（執行 n8n-node lint） |
| npm run lint:fix | 自動修復 linting 問題（執行 n8n-node lint --fix） |
| npm run release | 建立新的發佈版本（執行 n8n-node release） |

> [!TIP]
> 這些指令在背後使用 @n8n/node-cli。您也可以直接執行 CLI 指令，例如：npx n8n-node dev。

疑難排解

$3

1. 確認您已執行 npm install 安裝依賴項
2. 檢查您的節點是否已在 package.json 的 n8n.nodes 中列出
3. 使用 npm run dev 重新啟動開發伺服器
4. 檢查控制台是否有任何錯誤訊息

$3

執行 npm run lint:fix 自動修復大多數常見問題。對於剩餘的錯誤，請查看 n8n 節點開發指南。

$3

確保您使用的是 Node.js v22 或更高版本，並已執行 npm install` 來取得所有型別定義。

相關資源

- n8n 節點開發文檔 - 完整的節點建置指南
- n8n 社群論壇 - 獲取協助並分享您的節點
- @n8n/node-cli 文檔 - CLI 工具參考
- Wanguard 官方網站 - Wanguard 產品資訊
- Wanguard 使用者指南 - Wanguard 使用手冊

貢獻

歡迎提出改進建議！請透過 Issue 或 Pull Request 來貢獻您的想法。

授權條款

MIT

關於 Andrisoft Wanguard

Wanguard 是 Andrisoft 公司開發的專業 DDoS 防護解決方案。您可以：
- 申請 30 天免費評估授權
- 從線上商店購買授權
- 查看知識庫獲取更多資訊
- 聯絡 Andrisoft 獲取進一步協助