---
read_when:
    - پیش از استقرار، باید مسیریابی پروکسیِ مدیریت‌شده توسط اپراتور را اعتبارسنجی کنید
    - برای اشکال‌زدایی باید ترافیک انتقال OpenClaw را به‌صورت محلی ضبط کنید
    - می‌خواهید نشست‌های پروکسی اشکال‌زدایی، داده‌های باینری حجیم یا پیش‌تنظیم‌های داخلی پرس‌وجو را بررسی کنید
summary: مرجع CLI برای `openclaw proxy`، شامل اعتبارسنجی پراکسی مدیریت‌شده توسط اپراتور و بازرس محلی ثبت پراکسی برای اشکال‌زدایی
title: پراکسی
x-i18n:
    generated_at: "2026-07-27T14:59:59Z"
    model: gpt-5.6
    postprocess_version: locale-links-v1
    prompt_version: 32
    provider: openai
    source_hash: 91583f785032bfffe455a1963804108550f6fbb735ac4de1dd91d0ca5ae0df35
    source_path: cli/proxy.md
    workflow: 16
---

# `openclaw proxy`

مسیریابی پراکسی مدیریت‌شده توسط اپراتور را اعتبارسنجی کنید، یا پراکسی اشکال‌زدایی صریح محلی را اجرا و ترافیک ضبط‌شده را بررسی کنید.

```bash
openclaw proxy validate [--json] [--proxy-url <url>] [--proxy-ca-file <path>] [--allowed-url <url>] [--denied-url <url>] [--apns-reachable] [--apns-authority <url>] [--timeout-ms <ms>]
openclaw proxy start [--host <host>] [--port <port>]
openclaw proxy run [--host <host>] [--port <port>] -- <cmd...>
openclaw proxy coverage
openclaw proxy sessions [--limit <count>]
openclaw proxy query --preset <name> [--session <id>]
openclaw proxy blob --id <blobId>
openclaw proxy purge
```

`validate` پیش‌بررسی یک پراکسی هدایت مدیریت‌شده توسط اپراتور را انجام می‌دهد. بقیه ابزارهای اشکال‌زدایی برای بررسی در سطح انتقال هستند: راه‌اندازی یک پراکسی ضبط‌کننده محلی، اجرای یک فرمان فرزند از طریق آن، فهرست‌کردن نشست‌های ضبط، جست‌وجوی الگوهای ترافیک، خواندن بلاب‌های ضبط‌شده و پاک‌سازی داده‌های ضبط محلی.

## اعتبارسنجی

نشانی URL مؤثر پراکسی مدیریت‌شده توسط اپراتور را به‌ترتیب اولویت از `--proxy-url`، پیکربندی (`proxy.proxyUrl`) یا `OPENCLAW_PROXY_URL` بررسی می‌کند. اگر هیچ پراکسی فعال و پیکربندی نشده باشد، یک مشکل پیکربندی گزارش می‌دهد؛ برای پیش‌بررسی یک‌باره بدون تغییر پیکربندی، `--proxy-url` را ارسال کنید.

نشانی‌های URL پراکسی مدیریت‌شده برای یک شنونده پراکسی هدایت ساده از `http://` استفاده می‌کنند، یا هنگامی که OpenClaw باید پیش از ارسال درخواست‌های پراکسی، خودش TLS را به نقطه پایانی پراکسی باز کند، از `https://` استفاده می‌کنند. برای اعتماد به یک CA خصوصی در آن اتصال TLS، از `--proxy-ca-file` استفاده کنید.

به‌طور پیش‌فرض، موارد زیر را اجرا می‌کند:

- یک بررسی **مجاز** در برابر `https://example.com/` (با `--allowed-url` بازنویسی/اضافه کنید؛ قابل‌تکرار)
- یک بررسی **ردشده** در برابر یک قناری موقت loopback (با `--denied-url` بازنویسی کنید؛ قابل‌تکرار)

مقصدهای سفارشی `--denied-url` به‌صورت fail-closed عمل می‌کنند: هم پاسخ‌های HTTP و هم خطاهای مبهم انتقال، شکست محسوب می‌شوند؛ مگر اینکه بتوانید یک سیگنال رد مخصوص استقرار را به‌طور مستقل تأیید کنید. قناری داخلی loopback تنها مقصدی است که در آن خطای انتقال به‌عنوان مدرک مسدودسازی در نظر گرفته می‌شود.

برای بازکردن یک تونل APNs HTTP/2 CONNECT از طریق پراکسی و تأیید پاسخ‌گویی APNs سندباکس، `--apns-reachable` را نیز اضافه کنید. این کاوش یک توکن ارائه‌دهنده عمداً نامعتبر ارسال می‌کند؛ بنابراین پاسخ `403 InvalidProviderToken` از APNs یک سیگنال موفق دسترسی‌پذیری محسوب می‌شود (نه شکست).

### گزینه‌ها

| پرچم                     | اثر                                                                                                             |
| ------------------------ | ------------------------------------------------------------------------------------------------------------------ |
| `--json`                 | چاپ JSON قابل‌خواندن توسط ماشین                                                                                        |
| `--proxy-url <url>`      | اعتبارسنجی این نشانی URL پراکسی `http://`/`https://` به‌جای پیکربندی یا محیط                                              |
| `--proxy-ca-file <path>` | اعتماد به این فایل CA با قالب PEM برای تأیید TLS یک نقطه پایانی پراکسی HTTPS                                             |
| `--allowed-url <url>`    | مقصدی که انتظار می‌رود از طریق پراکسی موفق شود (قابل‌تکرار)                                                     |
| `--denied-url <url>`     | مقصدی که انتظار می‌رود توسط پراکسی مسدود شود (قابل‌تکرار)                                                       |
| `--apns-reachable`       | همچنین تأیید دسترسی‌پذیری APNs HTTP/2 سندباکس از طریق پراکسی                                                     |
| `--apns-authority <url>` | مرجع APNs برای کاوش (پیش‌فرض `https://api.sandbox.push.apple.com`؛ محیط عملیاتی `https://api.push.apple.com` است) |
| `--timeout-ms <ms>`      | مهلت زمانی هر درخواست                                                                                                |

هنگامی که پیکربندی پراکسی یا بررسی مقصدها شکست بخورد، با کد 1 خارج می‌شود.

برای راهنمای استقرار و معنای رد، به [پراکسی شبکه](/fa/security/network-proxy) مراجعه کنید.

## پراکسی اشکال‌زدایی

`start` یک پراکسی ضبط‌کننده محلی راه‌اندازی می‌کند و نشانی URL، مسیر گواهی CA و مسیر پایگاه داده ضبط آن را چاپ می‌کند؛ با Ctrl+C متوقف کنید. مگر اینکه `--host` تنظیم شده باشد، به‌طور پیش‌فرض به `127.0.0.1` متصل می‌شود.

`run` یک پراکسی اشکال‌زدایی محلی را راه‌اندازی می‌کند، سپس `<cmd...>` را (پس از `--`) با اعمال محیط پراکسی و در نشست ضبط اختصاصی آن اجرا می‌کند.

هدایت مستقیم بالادستی پراکسی اشکال‌زدایی، سوکت‌های بالادستی را برای عیب‌یابی باز می‌کند. هنگامی که حالت پراکسی مدیریت‌شده OpenClaw فعال است، هدایت مستقیم درخواست‌های پراکسی و تونل‌های CONNECT به‌طور پیش‌فرض غیرفعال است؛ `OPENCLAW_DEBUG_PROXY_ALLOW_DIRECT_CONNECT_WITH_MANAGED_PROXY=1` را فقط برای عیب‌یابی محلی تأییدشده تنظیم کنید.

`coverage` یک گزارش JSON (`summary` + `entries` برای هر انتقال) چاپ می‌کند که نشان می‌دهد کدام انتقال‌ها ضبط‌شده، فقط‌پراکسی یا فاقد پوشش هستند.

`sessions` نشست‌های ضبط اخیر را فهرست می‌کند (`--limit`، پیش‌فرض 20).

`query --preset <name>` یک جست‌وجوی داخلی را روی ترافیک ضبط‌شده اجرا می‌کند که در صورت تمایل می‌تواند به `--session <id>` محدود شود. پیش‌تنظیم‌ها:

- `double-sends`
- `retry-storms`
- `cache-busting`
- `ws-duplicate-frames`
- `missing-ack`
- `error-bursts`

`blob --id <blobId>` محتوای خام بلابِ بار مفید ضبط‌شده را چاپ می‌کند.

`purge` همه فراداده‌ها و بلاب‌های ترافیک ضبط‌شده را حذف می‌کند. موارد ضبط‌شده داده‌های اشکال‌زدایی محلی هستند؛ پس از پایان کار آن‌ها را پاک‌سازی کنید.

## مرتبط

- [مرجع CLI](/fa/cli)
- [پراکسی شبکه](/fa/security/network-proxy)
- [احراز هویت پراکسی مورد اعتماد](/fa/gateway/trusted-proxy-auth)
