TenthMatrix WSL Proxy
API গেটওয়ে, CDN ও এন্টারপ্রাইজ WAF — প্রোডাক্ট সংক্ষিপ্ত বিবরণ
TenthMatrix WSL Proxy (WSLProxy) হলো TenthMatrix-এর সম্পূর্ণ API গেটওয়ে ও CDN এজ কন্ট্রোল প্লেন। এটি আপনার অরিজিনের সামনে থাকে এবং প্রতিটি রিকোয়েস্টে কী হবে তা ঠিক করে — রাউট, সুরক্ষা, ক্যাশ ও পর্যবেক্ষণ — লাইভ JSON ও MCP কনফিগ থেকে, প্রতিটি নিয়ম পরিবর্তনে nginx রিলোড ছাড়াই।
TenthMatrix WSL Proxy কী?
WSLProxy হলো OpenResty-ভিত্তিক একটি ডায়নামিক API গেটওয়ে ও রিভার্স প্রক্সি। অপারেটররা ভার্চুয়াল হোস্ট, রাউটিং নিয়ম, WAF নীতি, ক্যাশ, ট্রাফিক স্প্লিট ও এজ POP পরিচালনা করেন Admin UI, REST API, MCP টুল বা wslproxy-cli দিয়ে। দৈনন্দিন নিয়ম হট পাথে কার্যকর হয়; শুধু সার্ভার-স্তরের listen বা SSL ব্লক বদলালে nginx রিলোড হয়।
Watch the overview

দেখুন: TenthMatrix WSL Proxy পরিচিতি
দেখুন
YouTube-এ দেখুন: দেখুন: TenthMatrix WSL Proxy পরিচিতিwslproxy.org
দেখুন: WSL Proxy WAF ট্যুর
দেখুন
YouTube-এ দেখুন: দেখুন: WSL Proxy WAF ট্যুরwslproxy.org/waf
প্রক্সি কীভাবে কাজ করে
একটি সলিউশন প্লেবুকের মতো: একবার মেলান, প্রতিটি রিকোয়েস্টে সিদ্ধান্ত নিন, তারপর প্রক্সি বা সুরক্ষা দিন। সাধারণ নিয়ম পরিবর্তনে কন্ট্রোল প্লেনকে কখনো এজ রিস্টার্ট করতে হয় না।
১. রিকোয়েস্ট POP-এ পৌঁছায়
ব্রাউজার, API ও এজেন্ট TenthMatrix WSL Proxy এজে (Docker, বেয়ার-মেটাল Ansible POP, বা k3s Helm ingress) পৌঁছায়। OpenResty TLS গ্রহণ করে এবং Lua হট পাথে প্রবেশ করে।
২. রাউটিং নিয়ম মেলান
gateway_ack.lua ভার্চুয়াল হোস্ট লোড করে এবং ডিস্ক বা Redis থেকে লাইভ নিয়ম মূল্যায়ন করে: path, IP, দেশ, JWT, S3, cookie এবং আরও। অগ্রাধিকার ও নির্দিষ্টতা বিজয়ী নির্বাচন করে — কোনো nginx রিলোড নয়।
৩. পাইপলাইন: রেট লিমিট → WAF → রেসপন্ড
গেটওয়ে পাইপলাইন প্রথমে রেট লিমিট চালায়, তারপর WAF ইঞ্জিন (ধাপ + সিগনেচার), তারপর gateway_resp.lua রেসপন্স অ্যাকশন ও ব্যালান্সার টাইমআউট প্রয়োগ করে।
৪. ফলাফল নির্ধারণ করুন
সাধারণ ফলাফল: upstream-এ 305 রিভার্স-প্রক্সি, 301/302 রিডাইরেক্ট, স্ট্যাটিক HTML ব্লক, CAPTCHA চ্যালেঞ্জ, বা সাপোর্ট ID হেডারসহ 403 WAF ব্লক।
৫. ব্যালান্স ও পর্যবেক্ষণ
প্রক্সি রেসপন্সের জন্য balancer_by_lua weighted, RR, canary, sticky বা least-conn প্রয়োগ করে। হেলথ, মেট্রিক্স ও ট্রাফিক পরিসংখ্যান অপস ও AI লগ হুকে যায়।
৬. অপারেটর ও এজেন্ট কনফিগ চালায়
মানুষ Admin UI / CLI ব্যবহার করে; এজেন্ট সার্ভার, নিয়ম ও WAF বাইন্ড CRUD করতে REST বা MCP টুল ব্যবহার করে — একই সারফেস, GitOps-বান্ধব pull/push।
| Code | অর্থ |
|---|---|
| 305 | upstream-এ রিভার্স প্রক্সি (প্রাথমিক গেটওয়ে পাথ) |
| 301 / 302 | রিডাইরেক্ট |
| 200 HTML | স্ট্যাটিক / ব্র্যান্ডেড ব্লক বা ইন্টারস্টিশিয়াল |
| CAPTCHA | চালিয়ে যাওয়ার আগে চ্যালেঞ্জ |
| 403 WAF | X-WAF-* ও X-Support-ID হেডারসহ WAF দ্বারা ব্লক |
প্রধান প্রোডাক্ট বৈশিষ্ট্য বিস্তারিত
নিয়ন্ত্রিত এজের জন্য যা দরকার সবকিছু: রাউটিং, নিরাপত্তা, CDN ক্যাশ, মাল্টি-POP ডেলিভারি, এবং এমন কন্ট্রোল প্লেন যা মানুষ ও এজেন্ট উভয়েই চালাতে পারে।
ডায়নামিক রাউটিং নিয়ম
path, IP, দেশ, JWT claims, S3-ধাঁচের keys ও cookies-এ মেলান। অ্যাকশনের মধ্যে রিভার্স প্রক্সি, রিডাইরেক্ট, HTML রেসপন্স ও CAPTCHA আছে। নিয়মগুলো অগ্রাধিকার অনুযায়ী সাজানো এবং সমতায় নির্দিষ্টতা সিদ্ধান্ত নেয়, যাতে nginx রিস্টার্ট ছাড়াই সবচেয়ে নির্ভুল রাউট জেতে।
ট্রাফিক ইঞ্জিনিয়ারিং
Weighted, round-robin, হেডার-ভিত্তিক canary, cookie sticky সেশন ও least-conn ব্যালান্সিং। canary সুস্থ দেখালে কন্ট্রোল প্লেন থেকে ব্যাকএন্ড প্রমোট বা রোলব্যাক করুন — অথবা এক অ্যাকশনেই ফিরিয়ে আনুন।
এন্টারপ্রাইজ WAF engine v2
পলিসি প্যাক প্রতিটি ডোমেইন, সেবা ও রাউটে বাইন্ড হয়। ধাপগুলোর মধ্যে মেথড allow-list, filetype deny, IP/geo তালিকা, JWT অ্যালগরিদম নীতি, JSON body প্রোফাইল, ব্রুট-ফোর্স ভেলোসিটি ও OpenAPI পজিটিভ সিকিউরিটি — সাথে নিয়ন্ত্রিত অ্যাটাক সিগনেচার ও অ্যানোমালি স্কোরিং। ব্লকিং বা ট্রান্সপারেন্ট (মনিটর) মোড।
CDN ও এজ ক্যাশ
এজ স্ট্যাটিক ক্যাশ, ঐচ্ছিক Docker blob ক্যাশ ও Varnish হুক আপনাকে অরিজিনের সামনে CDN-ধাঁচের স্তর দেয় — API গেটওয়ে ট্রাফিকের পাশাপাশি মার্কেটিং সাইট, API ডকুমেন্টেশন ও আর্টিফ্যাক্ট ডেলিভারির জন্য আদর্শ।
SSL ও HTTPS
auto-ssl / Let’s Encrypt, প্রতি-ডোমেইন SSL JSON ও force-HTTPS নীতি, যাতে প্রতিটি ভার্চুয়াল হোস্ট POP-এ সঠিকভাবে TLS টার্মিনেট করতে পারে।
মাল্টি-POP + DNS
এজ লোকেশন ঘোষণা করুন এবং নিরাপত্তা গার্ডরেলসহ Cloudflare A-records প্রভিশন করুন। একটি সাধারণ প্রোডাকশন প্যাটার্ন হলো public POP → k3s NodePort → wslproxy-ingress Helm → app pods।
কন্ট্রোল প্লেন
React Admin ও Next.js ড্যাশবোর্ড, Swagger REST, Claude/Cursor-এর জন্য MCP টুল, এবং pull/push/diff/verify ওয়ার্কফ্লোর জন্য wslproxy-cli ইমেজ (ghcr.io/bwalia/wslproxy-cli)।
যেকোনো জায়গায় ডিপ্লয় করুন
ল্যাবের জন্য Docker Compose, বেয়ার-মেটাল বা VM POP-এর জন্য Ansible, এবং k3s / Kubernetes-এর জন্য Helm ingress-controller চার্ট — সব এনভায়রনমেন্টে একটি প্রোডাক্ট সারফেস।
অবজার্ভেবিলিটি
/health, /healthz, /ready, Prometheus /metrics, traffic stats, structured WAF security logs, and AI log analysis hooks for SRE teams.
WAF নিয়ম ও প্রয়োগ
WAF চলে OpenResty রিকোয়েস্ট পাথে (এন্টারপ্রাইজ NGINX WAF প্যাটার্ন দ্বারা অনুপ্রাণিত)। এটি ডিফল্টভাবে fail-open যাতে WAF বাগ সাইট ডাউন করতে না পারে, প্রতিটি ব্লকে ব্যাখ্যাযোগ্য, এবং সাধারণ v1 নিয়ম তালিকার সাথে ব্যাকওয়ার্ড কম্প্যাটিবল। গাইডেড ট্যুর ও বিস্তারিত জানতে নিচের সম্পর্কিত লেখা দেখুন — অথবা এই পৃষ্ঠার WAF ভিডিও দেখুন।
রিকোয়েস্ট-পাথ পাইপলাইন
- rewrite_by_lua: gateway_ack.lua রাউটিং নিয়ম নির্বাচন করে
- gateway_pipeline.execute(): rate-limit → WAF → continue
- waf_engine.inspect(): পলিসি লোড, বাইন্ডিং নির্ধারণ, ধাপ চালানো, তারপর সিগনেচার
- ব্লক হলে: 403 + X-WAF-Block, X-WAF-Rule, X-WAF-Violation, X-Support-ID
ধাপ পাইপলাইন (সিগনেচারের আগে)
| Code | ধাপ | বিবরণ |
|---|---|---|
| VIOL_METHOD | মেথড allow-list | শুধু অনুমোদিত HTTP মেথড (যেমন GET, POST, HEAD, OPTIONS)। |
| VIOL_FILETYPE | Filetype deny | .env, .sql, .bak, .git, .pem-এর মতো সংবেদনশীল এক্সটেনশন ব্লক করুন। |
| VIOL_IP_DENY / VIOL_GEO | IP তালিকা ও geo | CIDR allow/deny করুন এবং IP2Location-ধাঁচের DB দিয়ে দেশ deny করুন। |
| VIOL_JWT_ALG | JWT অ্যালগরিদম নীতি | দুর্বল algs (none, HS256) deny করুন; প্রয়োজনে RS256/ES256 বাধ্যতামূলক করুন। |
| VIOL_JSON_SIZE / DEPTH | JSON body প্রোফাইল | পার্সার অপব্যবহার রোধে JSON গভীরতা ও body আকার সীমিত করুন। |
| VIOL_BRUTE_FORCE | ব্রুট-ফোর্স ভেলোসিটি | IP-ভিত্তিক প্রতি-পাথ স্লাইডিং উইন্ডো (যেমন /api/login)। |
| VIOL_OPENAPI_* | OpenAPI পজিটিভ সিকিউরিটি | শুধু ঘোষিত path+method সারফেস (টেমপ্লেটেড পাথ) অনুমোদন করুন। |
সিগনেচার নিয়ম ও গভর্নেন্স
প্রতিটি সিগনেচারের একটি স্থির ID (অ্যাড্রেসযোগ্য একক), বিভাগ/সেট, তীব্রতা, ম্যাচ লক্ষ্য (url, args, body, headers, cookies, UA, বা all), regex বা string প্যাটার্ন, অ্যাকশন (block বা monitor) এবং অ্যানোমালি স্কোর থাকে।
disable
signatures.disable একটি নিয়ম সম্পূর্ণ এড়িয়ে যায়।
stage
signatures.stage একটি টাইমস্ট্যাম্প পর্যন্ত শুধু অ্যালার্ম দেয় — নিরাপদ রোলআউট যা staged থাকাকালীন কখনো অ্যানোমালি স্কোরে যোগ হয় না।
সিগনেচার সেট
প্রতিটি নিয়ম পুনরায় না লিখেই পুরো সেট (যেমন SET_SQLI) block ও alarm-এর মধ্যে টগল করুন।
অ্যানোমালি থ্রেশহোল্ড
সঞ্চিত স্কোর ≥ থ্রেশহোল্ড হলে VIOL_ANOMALY_SCORE ওঠে, এমনকি কোনো একক সিগনেচার একা ব্লক না করলেও।
বাইন্ডিং অগ্রাধিকার
সবচেয়ে নির্দিষ্টটি জেতে: route override → প্রতি-সার্ভার waf_mode_override → পলিসি ডিফল্ট enforcementMode (blocking বা transparent/monitor)। প্রতিটি ফাইন্ডিং রেকর্ড করে কোন বাইন্ডিং জিতেছে, যাতে লগ উত্তর দিতে পারে “এটি কেন ব্লক হলো?”
ব্লকিং
লঙ্ঘন সাপোর্ট ID ও ঐচ্ছিক ব্র্যান্ডেড ব্লক পেজসহ 403 ফেরত দেয়।
ট্রান্সপারেন্ট / মনিটর
লঙ্ঘন শুধু অ্যালার্ম ও লগ করে — ড্রাই-রান ও স্টেজিংয়ের জন্য আদর্শ।
Agents Gateway ও MCP Gateway
TenthMatrix, WSL Proxy-কে এজেন্ট যুগে প্রসারিত করছে। HTTP API-এর সামনে থাকা একই এজ নিয়ন্ত্রণ করবে এজেন্ট ও Model Context Protocol (MCP) ক্লায়েন্ট কীভাবে টুল ও ব্যাকএন্ডে পৌঁছায়।
In progress
MCP Gateway (চলমান)
বাহ্যিক MCP সার্ভারের সামনে একটি নিয়ন্ত্রিত প্রবেশদ্বার — auth ব্রিজিং, tool/method allow-deny তালিকা, tools/call-এর অডিট, এবং প্রতি-টুল রেট লিমিট। ক্লায়েন্ট কখনো upstream টোকেন রাখে না।
In progress
Agents Gateway (চলমান)
মাল্টি-এজেন্ট ট্রাফিকের জন্য নীতি, রাউটিং ও অবজার্ভেবিলিটি — যাতে এজেন্ট ফ্লিট আপনার API ও CDN ওয়ার্কলোডের মতো একই TenthMatrix WSL Proxy এজ দিয়ে অরিজিনে পৌঁছায়।
Available
MCP ব্যবস্থাপনা সারফেস (উপলব্ধ)
WSLProxy ইতিমধ্যে তার Admin সারফেস Claude, Cursor ও অন্যান্য এজেন্টের জন্য MCP টুল হিসেবে উন্মুক্ত করে — IDE না ছেড়েই নিয়ম কনফিগার করুন ও এজ পরীক্ষা করুন।
সলিউশন আর্কিটেকচার
ক্লায়েন্ট ও এজেন্ট TenthMatrix WSL Proxy POP-এ পৌঁছায়। এজ লাইভ নিয়ম মেলায়, WAF ও ক্যাশ প্রয়োগ করে, তারপর অরিজিনে ব্যালান্স করে। অপারেটররা সবকিছু Admin UI, REST, MCP বা CLI দিয়ে চালান।
এজ POP
OpenResty + Lua হট পাথ: নিয়ম মেলান, রেসপন্ড করুন, ব্যাকএন্ড ব্যালান্স করুন।
লাইভ কনফিগ
ডিস্ক বা Redis থেকে নিয়ম, WAF ও ট্রাফিক স্প্লিট — দৈনন্দিন পরিবর্তনে কোনো nginx রিলোড নয়।
কন্ট্রোল প্লেন
মানুষ ও এজেন্টের জন্য Admin UI, REST, MCP ও wslproxy-cli।
অরিজিন
API, k3s সেবা, স্ট্যাটিক সাইট, এবং ভবিষ্যতের MCP / এজেন্ট upstream।
প্রোডাক্ট সাইটে চালিয়ে যান
ডেমো, ডকুমেন্টেশন ও সর্বশেষ TenthMatrix WSL Proxy রিলিজের জন্য wslproxy.org দেখুন।
TenthMatrix WSL Proxy নিন
wslproxy.org-এ প্রোডাক্টটি দেখুন, TenthMatrix-এ WAF-এর বিস্তারিত বিশ্লেষণ পড়ুন, অথবা এজ, CDN, WAF ও এজেন্ট গেটওয়ে ডিপ্লয়মেন্ট নিয়ে আমাদের সাথে কথা বলুন।