مرجع 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

يقوم بتنزيل أحدث إصدار لنظام تشغيلك، والتحقق منه مقابل الـ checksums المنشورة، ثم تثبيت الملف التنفيذي.

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

يحدّث الملف التنفيذي المثبَّت ذاتياً من قناة الإصدارات العامة. يتم التحقق من الأرشيف المُنزَّل مقابل ملف الـ checksum المنشور قبل استبدال الملف التنفيذي.

login

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

يسجّل الدخول ويحفظ الرمز في ~/.cdnctl/config.json. افتراضيًا يُفتح متصفّح ويوافق حسابك على هذا الطرفية، فلا تُكتب أي كلمة مرور في سطر الأوامر؛ أضف --password-login لتسجيل الدخول بالبريد وكلمة المرور (وهذا ما يحدث تلقائيًا أيضًا عند غياب الطرفية، مثل CI). يُنفَّذ مرة واحدة لكل جهاز، ويُعاد استخدام الرمز في الأوامر التالية.

configure

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

يضبط نقطة النهاية (endpoint) أو الرمز يدوياً دون تسجيل الدخول. مفيد لبيئات CI أو الأتمتة المعتمدة على الرموز.

accounts list

cdnctl accounts list

يسرد جميع حسابات CDN المتاحة للمستخدم المصادَق عليه (بصيغة JSON كاملة). يُستخدم حقل uuid كقيمة لـ --account في جميع الأوامر الأخرى.

accounts ls

cdnctl accounts ls

نسخة مختصرة وسهلة القراءة من القائمة — سطر واحد لكل حساب يتضمن فقط uuid والنطاق (domain) والنوع. مفيدة لإيجاد الـ 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 في كل مرة. (شغّل cdnctl accounts ls لإيجاد الـ uuid الخاص بك.)

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) إلى 10 ميغابايت.

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 في اتجاه واحد: المصدر والوجهة، وأحدهما فقط بعيد. لا يُنقل إلا ما اختلف — حسب الحجم ووقت التعديل، أو حسب SHA-256 مع -c — وتُحفَظ أوقات التعديل، فلا ينقل التشغيل الثاني شيئاً. يحذف --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>]

ينشئ سجل تطبيق حاوية جديد ومراجعة أولى. لا يقوم بالنشر — شغّل 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>]

يحدّث إعدادات التطبيق. تُغيَّر فقط الرايات (flags) التي تمررها. شغّل 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 لتصفير التطبيق (scale to zero).

container apps show

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

يُعيد تكوين التطبيق الكامل بما في ذلك قائمة المراجعات. استخدم معرّفات UUID للمراجعات من هذا الإخراج مع rollback.

container apps rollback

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

يعيد نشر مراجعة سابقة. استخدم show لسرد معرّفات UUID للمراجعات المتاحة.

container apps operations

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

يسرد جميع عمليات المنصة المسجَّلة للتطبيق، مثل عمليات النشر وإعادة التشغيل وأحداث التحجيم (scale).

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 أو انتهاء المهلة. يخرج بالرمز 0 عند النجاح، و1 عند الفشل أو انتهاء المهلة. عند الفشل، يتضمن إخراج diagnose تلقائياً.

container apps logs

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

يُعيد أحدث أسطر سجل الحاوية (container log).

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

يزيل بيانات اعتماد السجل نهائياً. أي تطبيقات تشير إلى هذا الاعتماد ستفشل في سحب الصور في عملية النشر التالية.

container addons list

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

يسرد جميع الإضافات (add-ons) المرتبطة حالياً بالتطبيق.

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. مرّر --delete-data لتدمير جميع بيانات JetStream نهائياً.

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 إلى الحجم الدائم (persistent volume).

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>

يُعيد إحصائيات استخدام التخزين الحالية للحاوية (bucket).

object-storage buckets delete

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

يحذف الحاوية (bucket) وجميع الكائنات بداخلها نهائياً. هذه العملية لا رجعة فيها.

object-storage access-keys create

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

ينشئ مفتاح وصول متوافقاً مع S3. يُعرض حقل secret_key في الاستجابة مرة واحدة ولا يُعاد أبداً بعد ذلك. انسخه قبل إغلاق الطرفية (terminal).

object-storage access-keys rotate

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

يُولّد سراً جديداً لمفتاح الوصول مع الإبقاء على نفس معرّف المفتاح UUID ونطاق الحاوية. يُعاد secret_key الجديد مرة واحدة ولا يُعاد أبداً مرة أخرى. حدّث أي عملاء (clients) قبل التدوير في بيئة الإنتاج.

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>]

يربط حاوية (bucket) بتطبيق. تُحقن بيانات اعتماد S3 ونقطة النهاية (endpoint) كمتغيرات بيئة في عملية النشر التالية.

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 المؤقت للحساب؛ تذهب الطلبات التالية إلى خادمك الأصلي. يوضح 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.