n8n-nodes-wanguard

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

關於 Wanguard

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

Wanguard 提供全網路範圍的監控，能夠即時檢測和緩解各種網路威脅，包括：

• 分散式阻斷服務攻擊 (DDoS)
• SYN 洪水攻擊
• NTP 放大攻擊
• UDP 或 ICMP 洪水攻擊
• 以及更多其他類型的攻擊

Wanguard 核心組件

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

主要功能

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

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

專案狀態

已完成 ✅

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

進行中 🚧

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

計劃中 📋

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

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

快速開始

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

安裝

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

社群節點安裝（推薦）

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

手動安裝

如果您在本地執行 n8n：

npm install n8n-nodes-wanguard

設定

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

功能特色

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

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

開發

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

先決條件

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

本地開發設定

# 安裝依賴項
npm install

# 以開發模式啟動 n8n（包含熱重載）
npm run dev

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

建置

# 建置專案
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。

疑難排解

我的節點沒有出現在 n8n 中

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

Linting 錯誤

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

TypeScript 錯誤

確保您使用的是 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 獲取進一步協助