# ملفات Cloud والشبكات

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

## رفع الملفات وتنزيلها

يرفع cmux vm push ملفاً أو مجلداً إلى جهاز. يُتحقق من النقل باستخدام SHA-256. افتراضياً يتخطى .git وnode\_modules و.venv و\_\_pycache\_\_ و.DS\_Store. استخدم --no-default-excludes لتضمينها، و--exclude لتخطي مسارات أخرى، و--watch لإعادة رفع التغييرات عند الحفظ.

```
cmux vm push brave-otter ./app ~/app
cmux vm push brave-otter . ~/repo --no-default-excludes
cmux vm push brave-otter . ~/repo --exclude dist --watch
cmux vm pull brave-otter ~/repo/report.html ./report.html
```

يمكن أن يصل الرفع الواحد إلى 256 MB. للمستودعات الكبيرة، استنسخ المستودع داخل الجهاز.

ينزّل cmux vm pull ملفاً من جهاز.

## الملفات السرية

يرفع cmux vm push --secret ملفاً صغيراً، حتى 256 KB، عبر رابط cmux المشفَّر. يُكتب الملف بالوضع 0600 افتراضياً. استخدمه للمفاتيح وبيانات الاعتماد بدلاً من الرفع العادي.

```
cmux vm push --secret brave-otter ~/.npmrc ~/.npmrc
```

## متغيرات البيئة

يخزّن cmux vm env المتغيرات في ~/.config/cmux/env على قرص الجهاز. تحمّلها كل صدفة جديدة. تنتقل القيم عبر الرابط المشفَّر ولا تُعرض. يخفي cmux vm env ls القيم ما لم تضف --show.

```
cmux vm env set brave-otter --from-file .env
op read op://dev/stripe/key | cmux vm env set brave-otter -
cmux vm env ls brave-otter
cmux vm env rm brave-otter STRIPE_KEY
```

قد تبقى وسائط KEY=VALUE في سجل الصدفة المحلية. استخدم --from-file أو الإدخال القياسي للأسرار.

## المنافذ والمتصفح المدمج

شغّل خادم تطوير على جهاز وانقر مع ⌘ على رابط localhost في طرفية Cloud. يفتحه cmux في لوح متصفح على العنوان الخاص للجهاز. تعمل أيضاً الخوادم التي تستمع على localhost فقط. لا تحتاج إلى VPN أو إعادة توجيه المنافذ.

يعرض cmux vm ports المنافذ المفتوحة على جهاز. يعرضها الشريط الجانبي Cloud تحت Ports. يفتح cmux vm open machine:port/number منفذاً منها.

```
cmux vm ports brave-otter
cmux vm open brave-otter:port/3000
```

## سطح المكتب

لكل جهاز سطح مكتب Linux. افتحه من قائمة الجهاز باستخدام Open Desktop، أو شغّل cmux vm desktop. يُفتح في لوح متصفح عبر VNC. تعمل تطبيقات الواجهة الرسومية وChrome وأتمتة المتصفح على هذه الشاشة.

```
cmux vm desktop brave-otter
```

## الشبكة الخاصة

لا تملك أجهزتك منافذ واردة عامة. يمنح cmux كل حساب شبكة خاصة، ويتصل كل جهاز Mac بمفتاح WireGuard خاص به لا يغادر جهاز Mac أبداً. يبدأ الاتصال داخل تطبيق cmux ولا يحتاج إلى موافقة.

يمكن لأجهزتك الوصول إلى بعضها على الشبكة الخاصة نفسها.

تعرض صفحة Cloud Mac access على cmux.com أجهزة Mac التي يمكنها الوصول إلى أجهزتك. أعد تسمية جهاز Mac أو ألغِ وصوله من هناك. يؤدي إلغاء جهاز Mac إلى تسجيل خروجه وإزالة وصوله إلى جميع الأجهزة.

## VPN النظام (اختياري)

يضيف cmux vpn up مساراً على مستوى النظام حتى تتمكن التطبيقات الأخرى على جهاز Mac، مثل متصفح منفصل أو عميل قاعدة بيانات، من الوصول إلى أجهزتك. لا يحتاج cmux نفسه إلى ذلك. في المرة الأولى، وافق على امتداد الشبكة الخاص بـ cmux في System Settings › General › Login Items & Extensions. يوقفه cmux vpn down.

```
cmux vpn up
cmux vpn status
cmux vpn down
```

## الروابط العامة

يمنح cmux cloud domains publish منفذاً على جهاز رابط HTTPS. ينتهي اسم المضيف المولَّد بـ .cmux.sh.

```
cmux cloud domains publish brave-otter 3000
cmux cloud domains publish brave-otter 3000 --access team
cmux cloud domains publish brave-otter 8080 --access public --yes
cmux cloud domains list
cmux cloud domains grant <hostname> teammate@example.com
cmux cloud domains rm <hostname>
```

لكل رابط وضع وصول. الافتراضي هو مالك الجهاز: أنت، أو فريقك عندما يملك فريق الجهاز.

-   personal: أنت وحدك تستطيع فتحه.
-   team: يستطيع فتحه الأعضاء الحاليون في الفريق الذي يملك الجهاز.
-   public: يستطيع أي شخص لديه الرابط فتحه. يطلب منك cmux التأكيد.

بالنسبة لروابط personal وteam، يسجّل الزوار الدخول في صفحة cmux أولاً. لا يرى الجهاز ملفات تعريف الارتباط الخاصة بـ cmux أبداً. يمكنك أيضاً منح عنوان بريد إلكتروني واحد وصولاً إلى رابط واحد باستخدام cmux cloud domains grant.

تعامل مع الرابط العام ككلمة مرور. أي شخص يملكه يستطيع استخدام الخدمة.

## النطاقات المخصصة

يطبع cmux cloud domains verify سجلات DNS التي يجب إضافتها: سجل TXT لإثبات الملكية، وسجلات التوجيه، وتفويض الشهادة. أضفها، ثم شغّل verify مجدداً. بعد التحقق يمكنك النشر على النطاق أو على نطاق فرعي بمستوى واحد تحته.

```
cmux cloud domains verify preview.example.com
cmux cloud domains publish brave-otter 3000 --domain app.preview.example.com
```

Canonical: https://cmux.com/ar/docs/cloud/networking

Documentation index: https://cmux.com/llms.txt
