مرجع cdnctl

install — package managers

# macOS and Linux (Homebrew)
brew install mediatriple/tap/cdnctl

# Debian / Ubuntu (signed APT repository)
curl -fsSL https://cdn.com.tr/downloads/cdn-com-tr.gpg \
  | sudo gpg --dearmor -o /usr/share/keyrings/cdn-com-tr.gpg
echo "deb [signed-by=/usr/share/keyrings/cdn-com-tr.gpg] \
https://cdn.com.tr/downloads/deb stable main" \
  | sudo tee /etc/apt/sources.list.d/cdn-com-tr.list
sudo apt-get update && sudo apt-get install cdnctl

# RHEL / Fedora / Rocky (signed YUM repository)
sudo tee /etc/yum.repos.d/cdn-com-tr.repo >/dev/null <<'EOF'
[cdn-com-tr]
name=cdn.com.tr
baseurl=https://cdn.com.tr/downloads/rpm
enabled=1
gpgcheck=1
repo_gpgcheck=1
gpgkey=https://cdn.com.tr/downloads/cdn-com-tr.gpg
EOF
sudo dnf install cdnctl

# Go toolchain
go install github.com/mediatriple/cdnctl@latest

Installed through a package manager, cdnctl upgrades with that package manager (brew upgrade cdnctl, apt-get install --only-upgrade cdnctl, dnf upgrade cdnctl) and cdnctl update deliberately steps aside, so it never overwrites a file dpkg, rpm or Homebrew owns.

install — script or direct download

curl -fsSL https://cdn.com.tr/downloads/cdnctl/install.sh | sh

# pin a specific version
CDNCTL_VERSION=0.17.2 curl -fsSL https://cdn.com.tr/downloads/cdnctl/install.sh | sh

آخرین نسخهٔ منتشرشده برای پلتفرم شما را دانلود می‌کند، آن را در برابر چک‌سام‌های منتشرشده تأیید می‌کند و باینری را نصب می‌کند.

Archives for linux (amd64/arm64), macOS (amd64/arm64) and Windows (amd64), each with a SHA256 checksums file, are published at /downloads/cdnctl/ and on the GitHub releases page. cdnctl is open source: github.com/mediatriple/cdnctl (MIT).

update

cdnctl update --check
cdnctl update --yes
cdnctl update --version <version> --yes

باینری نصب‌شده را از کانال انتشار عمومی به‌صورت خودکار به‌روزرسانی می‌کند. آرشیو دانلودشده پیش از جایگزینی باینری، در برابر فایل چک‌سام منتشرشده تأیید می‌شود.

login

cdnctl login [--password-login] [--email <email>] [--password <password>] [--endpoint <url>]

وارد می‌شود و توکن را در ~/.cdnctl/config.json ذخیره می‌کند. به‌صورت پیش‌فرض مرورگر باز می‌شود و حساب شما این ترمینال را تأیید می‌کند، بنابراین هیچ گذرواژه‌ای در CLI تایپ نمی‌شود؛ برای ورود با ایمیل و گذرواژه --password-login را اضافه کنید (وقتی ترمینالی وجود ندارد، مثلاً در CI، همین مسیر خودکار انتخاب می‌شود). یک بار برای هر دستگاه انجام می‌شود و توکن در دستورهای بعدی دوباره استفاده می‌شود.

configure

cdnctl configure [--endpoint <url>] [--token <token>]

اندپوینت یا توکن را بدون ورود (login) به‌صورت دستی تنظیم می‌کند. برای محیط‌های CI یا اتوماسیون مبتنی بر توکن مفید است.

accounts list

cdnctl accounts list

همهٔ حساب‌های CDN قابل دسترس برای کاربر احراز هویت‌شده را لیست می‌کند (JSON کامل). فیلد uuid به‌عنوان --account در همهٔ دستورهای دیگر استفاده می‌شود.

accounts ls

cdnctl accounts ls

نسخه‌ای کوتاه و خوانا از این لیست — یک خط برای هر حساب فقط با uuid، دامنه و نوع. برای پیدا کردن uuid و ذخیره کردن آن به‌عنوان پیش‌فرض مفید است.

accounts use / current / clear

cdnctl accounts use <uuid>
cdnctl accounts current
cdnctl accounts clear

یک بار یک حساب پیش‌فرض را ذخیره کنید تا مجبور نباشید در هر دستور --account <uuid> را ارسال کنید. پس از accounts use، دستورهای مرتبط با حساب به‌صورت خودکار از حساب ذخیره‌شده استفاده می‌کنند (عبارت (using saved account <uuid>) را چاپ می‌کنند تا بدانید کدام حساب است)؛ در هر زمان می‌توانید با ارسال --account آن را بازنویسی کنید. current آن را نمایش می‌دهد و clear آن را فراموش می‌کند.

Set your account once

cdnctl accounts use <uuid>

به این ترتیب دستورهای فایل در ادامه نیازی به --account در هر بار ندارند. (برای پیدا کردن uuid خود cdnctl accounts ls را اجرا کنید.)

List files — files ls

cdnctl files ls                       # lists wp-content (uploads, plugins, themes, …)
cdnctl files ls --path uploads
cdnctl files ls --path uploads/2026

بدون --path، ریشهٔ wp-content را لیست می‌کند.

Upload files — cp

cdnctl cp ./photo.jpg /uploads/photo.jpg
cdnctl cp ./backup.zip /uploads/backup.zip
cdnctl cp ./my-plugin.php /plugins/my-plugin/my-plugin.php

# upload a whole folder as one archive (structure is preserved):
cdnctl cp -r ./my-folder /uploads/my-folder

برای بارگذاری یک پوشهٔ کامل -r را اضافه کنید. پوشه به‌صورت یک آرشیو واحد منتقل می‌شود، نه فایل‌به‌فایل؛ بنابراین حتی هزاران فایل چند ثانیه طول می‌کشد. ساختار پوشه‌ها، از جمله پوشه‌های خالی، زیر مقصد بازسازی می‌شود و هر فایل پیش از قرار گرفتن در جای خود روی سرور با SHA-256 بررسی می‌شود. فایل‌های موجود بازنویسی نمی‌شوند مگر اینکه --force را اضافه کنید. می‌توانید حساب را به‌جای ذخیرهٔ پیش‌فرض، درون مسیر هم بنویسید: <uuid>:/uploads/photo.jpg.

Download files — cp

cdnctl cp :/uploads/photo.jpg ./                      # into the current folder
cdnctl cp :/plugins/my-plugin/my-plugin.php ./backup.php
cdnctl cp <account_uuid>:/uploads/photo.jpg ./          # a specific account

# download a whole folder recursively (its contents land in ./backup):
cdnctl cp -r :/uploads/2026 ./backup

# the same single-file download as an explicit sub-command:
cdnctl files get --path /uploads/photo.jpg --out ./photo.jpg

اول مسیر راه دور را بنویسید، با دونقطه در ابتدای آن — همان ترتیبی که scp به کار می‌برد. : به‌تنهایی یعنی حساب پیش‌فرض شما؛ برای حسابی دیگر <account_uuid>:مسیر بنویسید. فایل در پوشه‌ای که تعیین می‌کنید (یا با نامی که می‌دهید) ذخیره می‌شود. با -r پوشهٔ راه دور به‌صورت یک آرشیو واحد در پوشهٔ محلی دریافت می‌شود؛ و -r با مسیر خالی (<account_uuid>:) کل فضای ذخیره‌سازی را می‌آورد. هر دریافت پیش از نوشتن هر چیزی با اندازه و SHA-256 بررسی می‌شود؛ فایل محلی موجود فقط با --force جایگزین می‌شود. یک فایل تکی (بدون -r) حداکثر ۱۰ مگابایت است.

Keep a folder in sync — sync

# upload what changed in ./my-theme (rsync-style, one direction):
cdnctl sync ./my-theme :/themes/my-theme

# download what changed on the server:
cdnctl sync :/uploads ./uploads-backup

# mirror, deleting what the source no longer has — look at the plan first:
cdnctl sync --delete --dry-run ./my-theme :/themes/my-theme
cdnctl sync --delete --exclude '*.log' ./my-theme :/themes/my-theme

# compare by SHA-256 instead of size and modification time:
cdnctl sync -c :/uploads ./uploads-backup

مانند rsync و در یک جهت کار می‌کند: مبدأ و مقصد، که دقیقاً یکی از آن‌ها راه دور است. فقط آنچه فرق دارد منتقل می‌شود — بر اساس اندازه و زمان تغییر، یا با -c بر اساس SHA-256 — و زمان‌های تغییر حفظ می‌شوند، پس اجرای دوم چیزی منتقل نمی‌کند. --delete آنچه را که دیگر در مبدأ نیست هم حذف می‌کند (هرگز خود پوشه و نام‌های مستثنا را، و اگر چیزی در اجرا شکست بخورد هیچ چیز را)؛ --dry-run بدون تغییر چیزی، برنامه را نشان می‌دهد (+ جدید، ~ تغییرکرده، - حذف‌شدنی، ! ردشده)؛ --exclude نام‌ها را کنار می‌گذارد (*.log، /cache/). اسلش پایانی اهمیتی ندارد: محتوای مبدأ همیشه به مقصد می‌رود. پیوندهای نمادین گزارش می‌شوند و دست‌نخورده می‌مانند.

Create a folder — files mkdir

cdnctl files mkdir --path /uploads/2026/07

Delete a file — files rm

cdnctl files rm --path /uploads/photo.jpg --yes

به --yes نیاز دارد. فقط فایل‌ها قابل حذف هستند (دایرکتوری‌ها رد می‌شوند).

container apps list

cdnctl container apps list --account <uuid>

همهٔ اپ‌های کانتینری زیر این حساب را لیست می‌کند.

container apps create

cdnctl container apps create \
  --account <uuid> \
  --name <name> \
  --image <registry/image> \
  [--tag <tag>] \
  [--port <port>] \
  [--healthcheck <path>] \
  [--healthcheck-type http|tcp|none] \
  [--metrics-port <port>] \
  [--metrics-path <path>] \
  [--replicas <n>] \
  [--plan <code>] \
  [--domain <domain>] \
  [--env-json '{"KEY":"value"}'] \
  [--secrets-json '{"SECRET":"value"}'] \
  [--registry-credential <uuid>] \
  [--persistent-mount-path <path>] \
  [--persistent-storage-gb <n>]

یک رکورد اپ کانتینری جدید و اولین نسخه (revision) را ایجاد می‌کند. استقرار (deploy) انجام نمی‌شود — پس از ایجاد، deploy را اجرا کنید.

container apps update

cdnctl container apps update \
  --account <uuid> \
  --app <uuid> \
  [--image <registry/image>] \
  [--tag <tag>] \
  [--port <port>] \
  [--replicas <n>] \
  [--healthcheck <path>] \
  [--healthcheck-type http|tcp|none] \
  [--metrics-port <port>] \
  [--metrics-path <path>] \
  [--domain <domain>] \
  [--env-json '{"KEY":"value"}'] \
  [--secrets-json '{"SECRET":"value"}'] \
  [--registry-credential <uuid>] \
  [--persistent-mount-path <path>]

تنظیمات اپ را به‌روزرسانی می‌کند. فقط فلگ‌هایی که ارسال می‌کنید تغییر می‌کنند. برای انتشار نسخهٔ جدید، پس از به‌روزرسانی deploy را اجرا کنید.

container apps deploy

cdnctl container apps deploy --account <uuid> --app <uuid>

پیکربندی فعلی را به‌عنوان یک نسخهٔ جدید منتشر می‌کند. سپس برای انتظار تا رسیدن استقرار به وضعیت هدف، از wait استفاده کنید.

container apps expose

cdnctl container apps expose --account <uuid> --app <uuid>

یک زیردامنهٔ دائمی و تغییرناپذیر به‌شکل <uid>.cdn.com.tr برای اپ ایجاد می‌کند. این زیردامنه حتی در صورت به‌روزرسانی دامنهٔ اختصاصی هرگز تغییر نمی‌کند.

container apps restart

cdnctl container apps restart --account <uuid> --app <uuid>

بدون ایجاد نسخهٔ جدید، یک ری‌استارت غلتان (rolling restart) برای همهٔ رپلیکاهای در حال اجرا انجام می‌دهد.

container apps scale

cdnctl container apps scale --account <uuid> --app <uuid> --replicas <n>

تعداد رپلیکاها را بلافاصله و بدون ایجاد نسخهٔ جدید تغییر می‌دهد. برای مقیاس‌دهی اپ به صفر، 0 را ارسال کنید.

container apps show

cdnctl container apps show --account <uuid> --app <uuid>

پیکربندی کامل اپ شامل لیست نسخه‌ها (revisions) را برمی‌گرداند. از UUIDهای نسخه در این خروجی همراه با rollback استفاده کنید.

container apps rollback

cdnctl container apps rollback --account <uuid> --app <uuid> --revision <revision_uuid>

یک نسخهٔ قبلی را دوباره مستقر می‌کند. برای لیست UUIDهای نسخهٔ موجود از show استفاده کنید.

container apps operations

cdnctl container apps operations --account <uuid> --app <uuid>

همهٔ عملیات ثبت‌شدهٔ پلتفرم برای اپ مانند استقرارها، ری‌استارت‌ها و رویدادهای مقیاس‌دهی را لیست می‌کند.

container apps status

cdnctl container apps status --account <uuid> --app <uuid>

وضعیت اجرای فعلی و نتیجهٔ آخرین عملیات اپ را برمی‌گرداند.

container apps wait

cdnctl container apps wait \
  --account <uuid> \
  --app <uuid> \
  --status <target> \
  [--timeout <seconds>] \
  [--interval <seconds>]

وضعیت اپ را به‌صورت دوره‌ای بررسی می‌کند تا به --status برسد یا زمان مهلت (timeout) به پایان برسد. در صورت موفقیت با کد 0 و در صورت شکست یا اتمام مهلت با کد 1 خارج می‌شود. در صورت شکست، خروجی diagnose به‌طور خودکار افزوده می‌شود.

container apps logs

cdnctl container apps logs --account <uuid> --app <uuid> [--tail <n>]

خطوط اخیر لاگ کانتینر را برمی‌گرداند.

container apps diagnose

cdnctl container apps diagnose --account <uuid> --app <uuid> [--tail <n>]

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

container apps delete

cdnctl container apps delete --account <uuid> --app <uuid> --yes

اپ و همهٔ نسخه‌های آن را به‌طور دائمی حذف می‌کند. این عملیات غیرقابل بازگشت است.

container preflight

cdnctl container preflight --account <uuid>

بررسی می‌کند که آیا حساب برای اجرای بارهای کاری کانتینری آماده است و لیستی از مشکلات یافت‌شده را برمی‌گرداند.

container registry-credentials list

cdnctl container registry-credentials list --account <uuid>

container registry-credentials create

cdnctl container registry-credentials create \
  --account <uuid> \
  --name <name> \
  --password <token> \
  [--registry-url <url>] \
  [--username <user>]

container registry-credentials delete

cdnctl container registry-credentials delete \
  --account <uuid> \
  --credential <credential_uuid> \
  --yes

یک اعتبارنامهٔ رجیستری را به‌طور دائمی حذف می‌کند. هر اپی که به این اعتبارنامه ارجاع دهد، در استقرار بعدی در دریافت (pull) ایمیج با شکست مواجه خواهد شد.

container addons list

cdnctl container addons list --account <uuid> --app <uuid>

همهٔ افزونه‌های (add-on) متصل به اپ در حال حاضر را لیست می‌کند.

container addons enable-database

cdnctl container addons enable-database \
  --account <uuid> \
  --app <uuid> \
  [--plan <code>] \
  [--env-prefix <prefix>] \
  [--storage-mb <n>] \
  [--url-scheme <scheme>]

container addons disable-database

cdnctl container addons disable-database --account <uuid> --app <uuid>

container addons enable-redis

cdnctl container addons enable-redis \
  --account <uuid> \
  --app <uuid> \
  [--plan <code>] \
  [--env-prefix <prefix>]

container addons disable-redis

cdnctl container addons disable-redis --account <uuid> --app <uuid>

container addons enable-postgres

cdnctl container addons enable-postgres \
  --account <uuid> \
  --app <uuid> \
  [--plan <code>] \
  [--env-prefix <prefix>] \
  [--storage-mb <n>]

container addons disable-postgres

cdnctl container addons disable-postgres \
  --account <uuid> \
  --app <uuid> \
  [--delete-data --confirmation <app_name>]

افزونهٔ Postgres را غیرفعال می‌کند. به‌طور پیش‌فرض داده‌ها نگه‌داشته می‌شوند. برای حذف دائمی همهٔ داده‌ها، --delete-data را همراه با --confirmation ارسال کنید.

container addons enable-nats

cdnctl container addons enable-nats \
  --account <uuid> \
  --app <uuid> \
  [--plan <code>] \
  [--env-prefix <prefix>] \
  [--storage-mb <n>]

container addons disable-nats

cdnctl container addons disable-nats \
  --account <uuid> \
  --app <uuid> \
  [--delete-data]

افزونهٔ NATS را غیرفعال می‌کند. برای حذف دائمی همهٔ داده‌های JetStream، --delete-data را ارسال کنید.

container compose preview

cdnctl container compose preview --account <uuid> --file docker-compose.yml

فایل compose را در سمت سرور تجزیه می‌کند و طرح ایمپورت را برمی‌گرداند: اپ‌هایی که باید ایجاد شوند، نگاشت افزونه‌ها، دسته‌بندی کلیدهای متغیر محیطی/محرمانه، هشدارها، سرویس‌های پشتیبانی‌نشده و بررسی مجوز (entitlement). چیزی ایجاد نمی‌شود. مقادیر محرمانه هرگز بازگردانده نمی‌شوند — فقط نام کلیدها.

container compose apply

cdnctl container compose apply --account <uuid> --file docker-compose.yml --yes

ایمپورت را اعمال می‌کند: اپ‌ها را به ترتیب وابستگی ایجاد می‌کند و افزونه‌های نگاشت‌شده را فعال می‌کند. به‌صورت همه‌یا‌هیچ — اگر نام هر اپی با اپ موجود تداخل داشته باشد، یا هر سرویسی پشتیبانی نشود (مثلاً از build: استفاده کند)، چیزی ایجاد نمی‌شود. پس از آن، هر اپ ایجادشده را با container apps deploy مستقر کنید.

container imports list

cdnctl container imports list --account <uuid> --app <uuid>

همهٔ ایمپورت‌ها و وضعیت فعلی آن‌ها را برای اپ لیست می‌کند.

container imports database

cdnctl container imports database \
  --account <uuid> \
  --app <uuid> \
  --file <path/to/dump.sql.gz>

یک دامپ SQL فشرده‌شده با gzip را آپلود و برای ایمپورت به پایگاه‌دادهٔ مدیریت‌شده در صف قرار می‌دهد.

container imports files

cdnctl container imports files \
  --account <uuid> \
  --app <uuid> \
  --file <path/to/archive.tar.gz> \
  [--target-path <path>]

یک آرشیو tar.gz را آپلود و در والیوم پایدار استخراج می‌کند.

container imports cancel

cdnctl container imports cancel \
  --account <uuid> \
  --app <uuid> \
  --import <import_uuid>

یک ایمپورت در صف یا در حال اجرا را لغو می‌کند. اگر ایمپورت قبلاً کامل شده باشد، هیچ تأثیری ندارد.

container jobs list

cdnctl container jobs list --account <uuid> --app <uuid>

container jobs create

cdnctl container jobs create \
  --account <uuid> \
  --app <uuid> \
  --name <name> \
  --schedule "<cron expression>" \
  --path </endpoint/path> \
  [--method <POST|GET>] \
  [--secret-header-name <header>] \
  [--secret-source <ENV_VAR>] \
  [--enabled]

container jobs run

cdnctl container jobs run \
  --account <uuid> \
  --app <uuid> \
  --job <job_uuid> \
  [--wait] \
  [--timeout <seconds>] \
  [--interval <seconds>]

یک اجرای فوری و یک‌باره از جاب را آغاز می‌کند. برای انتظار تا پایان یا شکست اجرا، از --wait استفاده کنید.

container jobs delete

cdnctl container jobs delete \
  --account <uuid> \
  --app <uuid> \
  --job <job_uuid> \
  --yes

جاب زمان‌بندی‌شده را به‌طور دائمی حذف می‌کند.

object-storage buckets list

cdnctl object-storage buckets list --account <uuid>

object-storage buckets create

cdnctl object-storage buckets create \
  --account <uuid> \
  --name <bucket-name> \
  [--visibility private|public]

object-storage buckets usage

cdnctl object-storage buckets usage --account <uuid> --bucket <bucket_uuid>

آمار فعلی مصرف فضای ذخیره‌سازی باکت را برمی‌گرداند.

object-storage buckets delete

cdnctl object-storage buckets delete --account <uuid> --bucket <bucket_uuid> --yes

باکت و همهٔ آبجکت‌های داخل آن را به‌طور دائمی حذف می‌کند. این عملیات غیرقابل بازگشت است.

object-storage access-keys create

cdnctl object-storage access-keys create \
  --account <uuid> \
  [--bucket <uuid>] \
  [--name <name>]

یک کلید دسترسی سازگار با S3 ایجاد می‌کند. فیلد secret_key در پاسخ فقط یک بار نمایش داده می‌شود و دیگر بازگردانده نمی‌شود. پیش از بستن ترمینال آن را کپی کنید.

object-storage access-keys rotate

cdnctl object-storage access-keys rotate --account <uuid> --key <key_uuid>

یک مقدار محرمانهٔ جدید برای کلید دسترسی تولید می‌کند در حالی که همان UUID کلید و محدودهٔ باکت حفظ می‌شود. secret_key جدید فقط یک بار بازگردانده می‌شود و دیگر تکرار نمی‌شود. پیش از چرخش (rotate) در محیط پروداکشن، همهٔ کلاینت‌ها را به‌روزرسانی کنید.

object-storage access-keys revoke

cdnctl object-storage access-keys revoke --account <uuid> --key <key_uuid> --yes

کلید دسترسی را به‌طور دائمی لغو و حذف می‌کند. هر کلاینتی که هنوز از این کلید استفاده می‌کند، بلافاصله با خطاهای احراز هویت مواجه خواهد شد.

object-storage bindings create

cdnctl object-storage bindings create \
  --account <uuid> \
  --app <uuid> \
  --bucket <uuid> \
  [--access-key <uuid>] \
  [--env-prefix <prefix>]

یک باکت را به یک اپ متصل می‌کند. در استقرار بعدی، اعتبارنامه‌های S3 و اندپوینت به‌عنوان متغیرهای محیطی تزریق می‌شوند.

object-storage bindings delete

cdnctl object-storage bindings delete \
  --account <uuid> \
  --app <uuid> \
  --binding <binding_uuid> \
  --yes

اتصال باکت را از اپ حذف می‌کند. باکت و کلید دسترسی تحت تأثیر قرار نمی‌گیرند؛ فقط تزریق متغیر محیطی در استقرار بعدی حذف می‌شود.

purge

cdnctl purge --account <uuid> --path /sitemap.xml [--path /other] [--type exact|prefix|variants] [--save]
cdnctl purge --account <uuid> --paths "/a,/b,/c" [--type prefix]

purge all

cdnctl purge all --account <uuid> --yes
cdnctl purge all status --account <uuid>

کل کش edge حساب را خالی می‌کند؛ درخواست‌های بعدی به origin شما می‌روند. purge all status نشان می‌دهد آخرین پاک‌سازی کامل روی همه edgeها تمام شده است یا نه.

waf logs

cdnctl waf logs [--account <uuid>] [--range 1h|1d|7d|30d] [--format table|json]

آنچه WAF در بازه گرفته: قوانین، کشورها، IP کلاینت‌ها و کدهای پاسخ — همان اعداد صفحه WAF در پنل.

waf show

cdnctl waf show <ref> [--account <uuid>] [--format table|json]

جزئیات یک درخواست مسدودشده. <ref> همان Reference ID صفحه مسدودسازی است که بازدیدکننده دیده (32 نویسه)، یا دست‌کم 12 نویسه اول آن، همان‌طور که جدول پنل نشان می‌دهد. 30 روز گذشته سایت‌های این حساب را جست‌وجو می‌کند و درخواست، هر قانون منطبق همراه با داده منطبق، و یک تشخیص را چاپ می‌کند — مثلاً اینکه آیا فایل بارگذاری‌شده فقط به این دلیل مسدود شد که از بخشی از بدنه که WAF بررسی می‌کند بزرگ‌تر بود. اگر چیزی پیدا نشود با کد 1 خارج می‌شود.

logs status / logs list

cdnctl logs status [--account <uuid>]
cdnctl logs list [--account <uuid>] [--day YYYY-MM-DD] [--format table|json]

logs status نشان می‌دهد تحویل روشن است یا نه، IPها پوشانده می‌شوند یا نه و فایل‌ها چند روز نگه داشته می‌شوند. logs list فایل‌های یک روز UTC را فهرست می‌کند — برای هر edge هر پنج دقیقه یک فایل.

logs pull

cdnctl logs pull [--account <uuid>] [--day YYYY-MM-DD] [--out <dir>]

همه فایل‌های یک روز UTC را در یک پوشه دانلود می‌کند. اجرای دوباره فقط فایل‌های جدید را می‌آورد؛ همین پوشه کش logs grep است.

logs grep

cdnctl logs grep --from "2026-09-25 14:00" --to "2026-09-25 15:00" \
  --status 5xx --path /api/ --format table
cdnctl logs grep --from 14:00 --ip 203.0.113.0/24 --count

یک بازه زمانی را روی رایانه خودتان جستجو می‌کند: فقط فایل‌های پنج‌دقیقه‌ای هم‌پوشان با بازه را دانلود می‌کند (آنچه در کش هست را رد می‌کند) و سپس هر خط را فیلتر می‌کند. فیلترها با هم ترکیب می‌شوند؛ بدون فیلتر هر خط بازه چاپ می‌شود. خروجی خطوط خام JSON است، آماده برای jq.