在當今API驅動的開發(fā)環(huán)境中，開發(fā)者們經(jīng)常需要高效的工具來測試和調(diào)試各種HTTP接口。WebCurl作為一個極致輕量、跨平臺、無依賴的HTTP請求轉發(fā)與調(diào)試工具，為開發(fā)者提供了網(wǎng)頁版的API測試解決方案。

簡介

WebCurl是GitHub上一個名為"極簡網(wǎng)頁版API調(diào)試神器"的開源項目。

與Postman、Insomnia等傳統(tǒng)API測試工具不同，WebCurl采用了完全不同的設計哲學——極簡主義與無依賴架構，打造了一個無需安裝、開箱即用的網(wǎng)頁版解決方案 。

這個項目的核心目標是解決傳統(tǒng)API調(diào)試工具的幾大痛點：

• ? 復雜臃腫： 許多API工具功能過于繁雜，啟動緩慢
• ? 平臺限制： 需要下載安裝特定平臺的客戶端
• ? 隱私擔憂： 部分商業(yè)化工具需要注冊賬戶并上傳API數(shù)據(jù)
• ? 內(nèi)網(wǎng)限制： 企業(yè)內(nèi)網(wǎng)環(huán)境難以使用云端服務

WebCurl通過其獨特的設計，完美應對了這些挑戰(zhàn)，成為接口開發(fā)、調(diào)試和測試的理想選擇。

技術架構

WebCurl的技術架構體現(xiàn)了"少即是多"的設計理念：

• ? 前端： 純原生HTML+JS+CSS實現(xiàn)，不依賴任何第三方庫或框架，保證了極致的加載速度和運行效率 。
• ? 后端： 僅使用Golang標準庫，沒有任何外部依賴，確保了安全性和可靠性 。
• ? 代碼精簡： 整個項目僅包含2個文件——index.html和main.go，代碼結構清晰，易于理解和維護 。

這種架構使得WebCurl的編譯產(chǎn)物僅為一個約14MB的單一二進制文件（包含前端頁面），真正實現(xiàn)了"一次編譯，到處運行"的跨平臺體驗 。

功能特點

核心功能

• ? 網(wǎng)頁版Postman體驗：無需安裝客戶端，瀏覽器即用，界面美觀，功能豐富。
• ? HTTP 請求轉發(fā)：接口通過/api/forward接口將請求參數(shù)提交給前端，立即代為轉發(fā)并返回結果，突破瀏覽器跨域限制。
• ? 支持HTTP CONNECT代理隧道：支持HTTP CONNECT方式，可作為HTTPS/SSH等協(xié)議的代理隧道，適用于curl、ssh、ncat等工具的代理轉發(fā)。
• ? 多種請求體支持：支持form-data（含多文件上傳）、x-www-form-urlencoded、json、text、xml、binary。
• ? 請求頭自定義：支持任意請求頭。
• ? 文件上傳/下載：支持多文件上傳，響應內(nèi)容可直接下載。
• ? 請求重試與超時：可配置重試次數(shù)、重試間隔、超時時間。
• ? SSL 驗證與重定向：選擇是否驗證 SSL 證書、是否自動跟蹤重定向。
• ? 接口功能豐富：接口歷史、接口集合、變量替換、全局請求頭、導入導出等。
• ? 命令行靈活配置：支持自定義監(jiān)聽地址、端口、靜態(tài)目錄、日志、SSL證書等。
• ? 最大輕量：單個二進制文件，體積僅約10M，部署、遷移、搬運方便。
• ? 無依賴、易運維：不需要數(shù)據(jù)庫、不需要外部依賴，直接運行。
• ? 跨平臺/信創(chuàng)兼容：支持主流網(wǎng)絡及國產(chǎn)軟硬件平臺，適合信創(chuàng)環(huán)境、內(nèi)網(wǎng)、離線等特殊場景。
• ? 網(wǎng)絡協(xié)議支持：完美支持 IPv4 和 IPv6 網(wǎng)絡協(xié)議，適應各種網(wǎng)絡環(huán)境。
• ? 實時通信支持：初步支持WebSocket和SSE（Server-Sent Events），滿足實時數(shù)據(jù)需求。

EchoServer 調(diào)試服務

• ? 智能請求回顯：自動解析并回顯請求的URL、方法、請求頭、請求體（文本、表單、文件、二進制等）。
• ? 靈活的響應控制：支持通過自定義請求頭或URL參數(shù)靈活控制響應內(nèi)容和行為。
• ? 多種響應格式：支持JSON、XML、Text等多種響應格式。
• ? 響應延遲控制：可自定義響應延遲時間，模擬網(wǎng)絡延遲場景。
• ? 下載響應控制：支持將響應內(nèi)容作為文件下載。
• ? 流式通信支持：SSE和WebSocket接口支持流式數(shù)據(jù)本體。
• ? 自定義數(shù)據(jù)隊列：支持默認響應數(shù)據(jù)，實現(xiàn)自定義流式自適應。
• ? 健壯性保障：內(nèi)置恐慌恢復機制，防止服務崩潰。

靜態(tài)文件服務器

• ? 完整文件服務：類似Nginx的靜態(tài)文件服務器功能，支持所有常見文件類型。
• ? 豐富的MIME支持：自動識別HTML、CSS、JS、圖片、音頻、視頻、字體等文件類型。
• ? 安全防護：防止路徑攻擊，確保文件訪問安全。
• ? 高性能：支持大文件傳輸，內(nèi)置存儲控制。
• ? CORS支持：內(nèi)置跨域資源共享支持，適合前端開發(fā)。
• ? 移動接口：支持移動設備訪問，響應式設計。

常用工具

• ? JWT解析：支持一鍵JWT Token，快速查看Payload信息，即可調(diào)試鑒權接口。
• ? UUID生成：支持生成標準UUID，方便接口測試與數(shù)據(jù)填充。
• ? 時間轉換：支持毫秒/秒時鐘與日期時間的相互轉換，適配多個場景。
• ? Base64編碼解碼：支持Base64字符串的編碼與解碼，其次處理二進制與文本數(shù)據(jù)。
• ? Token生成器：支持自定義規(guī)則生成隨機Token，適合接口測試、模擬登錄等場景。

快速開始

安裝與運行

從GitHub倉庫下載預編譯的二進制文件

# 編譯
go build -o WebCurl main.go
# 也可以使用 sh build.sh 命令

# 運行（默認 0.0.0.0:4444，內(nèi)嵌前端頁面）
./WebCurl

# 瀏覽器訪問
http://localhost:4444

命令行選項

WebCurl支持多種啟動參數(shù)以滿足不同需求：

• ? -p：指定監(jiān)聽端口
• ? -d：設置靜態(tài)文件目錄
• ? -s：啟用HTTPS模式
• ? -c：指定SSL證書路徑

例如，要在9000端口運行并啟用HTTPS：

./webcurl -p 9000 -s -c /path/to/cert

界面預覽

開源地址

https://github.com/o8oo8o/WebCurl