Workstation WSL 代理 （也稱為 WSL代理）是Workstation的完整版本 API閘道器和CDN 邊緣控制平面：用於運營商和 AI 代理的實時路由、WAF、快取、多 POP DNS 和 MCP。本技術簡介擴充套件了開放產品 wslproxy.org 和來源 github.com/bwalia/wslproxy。伴侶： 部落格 · 產品： /wsl-代理.
Watch: Workstation WSL Proxy intro
Watch: youtu.be/7NJulclG5sQ · Product: wslproxy.org
- 什麼： OpenResty API 閘道器 + 帶熱路徑規則的 CDN 邊緣（日常路由/WAF/快取無需重新載入 nginx）。
- WHO： 平臺、SRE、DevOps 和 AI/平臺團隊負責 API、站點和代理流量。
- 控制： 管理 UI、Swagger REST、MCP 工具、
wslproxy-cli(ghcr.io/bwalia/wslproxy-cli). - 路線圖： 代理閘道器和 MCP 閘道器整合 — 代理和 MCP 上游的治理。
1、定位
成熟的組織已經執行反向代理。他們缺少的是一種優勢 像產品一樣可操作：JSON/MCP驅動的規則、多POP感知、CDN式快取、具有事件的WAF以及可以呼叫的控制平面代理。 Workstation WSL Proxy 就是這樣的產品 — 開源，可部署在 Docker、Ansible 或 Kubernetes/k3s Helm 上，並針對 Workstation 客戶對話進行品牌化 Workstation WSL 代理.
2. 能力（今天）
| 區域 | 你得到什麼 |
|---|---|
| 路由 | 路徑/IP/國家/JWT/S3/cookie匹配→代理（305）、重定向、HTML、CAPTCHA；優先順序+特殊性 |
| 交通 | 加權/RR/標頭金絲雀/cookie粘性/最少連線；提升和回滾 |
| WAF | 策略包、異常評分、監控/阻止、事件 API |
| SSL協議 | auto-ssl / Let’s Encrypt、每個域 SSL JSON、強制 HTTPS |
| CDN/快取 | 邊緣靜態快取、可選的 Docker blob 快取、Varnish 掛鉤 |
| POP + DNS | 邊緣位置；帶有護欄的 Cloudflare A 記錄配置 |
| 控制平面 | React Admin、Next.js 儀表板、Swagger、MCP、CLI |
| 部署 | Docker Compose、Ansible、Helm 入口控制器 (k3s) |
| 可觀察性 | /health /healthz /ready /metrics、流量統計、AI日誌掛鉤 |
3.架構（熱路徑）
客戶端和代理訪問 WSLProxy POP。 OpenResty 在請求路徑上執行 Lua (gateway_ack → gateway_resp → 平衡器）。規則、WAF 策略和流量會從磁碟或 Redis 中拆分負載，並且無需重新載入 nginx 即可應用。僅當伺服器級偵聽/SSL 塊發生更改時才重新載入。
Clients / Agents
→ Workstation WSL Proxy POP (OpenResty + Lua)
→ match rules (JSON / Redis)
→ WAF · cache · traffic split
→ Origins / k3s / APIs / (future MCP upstreams)
Operators: Admin UI · REST · MCP · wslproxy-cli
4. MCP 現狀與 MCP 閘道器路線圖
兩個相關的表面——不要混淆它們：
- MCP 管理伺服器（可用）： 將 WSLProxy 自己的管理功能公開為 MCP 工具，以便 Claude/Cursor 可以配置和檢查邊緣。
- MCP 閘道器（正在進行中）： WSLProxy 作為 受管制的前門位於其他門前 MCP 伺服器 — 身份驗證橋接（客戶端從不持有上游令牌）、工具/方法允許-拒絕、審計
tools/call和每個工具的速率限制。記錄在上游docs/mcp-gateway.md.
5. 代理閘道器（進行中）
當組織執行多代理佇列時，他們需要與 API 相同的邊緣策略：身份橋接、速率限制、審計、金絲雀和 POP 關聯。 代理閘道器 是 Workstation 的程式，用於透過 Workstation WSL 代理（以及 MCP 閘道器）路由和管理代理流量，因此代理解決方案和 API/CDN 工作負載共享一個控制平面。
6. 部署選項
- Docker 組合 — 本地和實驗室堆疊（
docker-compose-*.yml在回購協議中）。 - 安西布林 — 裸機/VM POP 構建。
- 舵 — k3s / Kubernetes 的入口控制器樣式圖表。
- 命令列介面：
ghcr.io/bwalia/wslproxy-cli:latest對於運營商和代理商。
7. 為什麼Workstation發貨
Workstation構建AI工作站、私有AI和代理平臺。這些產品需要一個重要的優勢：不是一次性的 nginx 片段，而是操作員和代理都可以驅動的閘道器/CDN。 WSLProxy 是共享邊緣 — 開放於 wslproxy.org，整合到 Workstation 解決方案中 Workstation WSL 代理.
8. 後續步驟
釋出者： Workstation。上游文件：自述檔案， docs/mcp-gateway.md、WAF 和 POP 指南位於 GitHub 儲存庫中。
Continue on the product site: https://wslproxy.org
