`serve` يطبع عنوان URL. افتحه في أي متصفح وستحصل على طرفية، ومتصفح ملفات، ووكيلًا لشبكة ذلك الجهاز — أو يمكنك الوصول إلى نفس الجهاز من طرفية أخرى باستخدام `bitbang connect <url>`، الذي يضيف إعادة توجيه المنافذ (`-L`) ونسخ الملفات (`bitbang cp`). الاتصال مشفّر من طرف إلى طرف ومن نظير إلى نظير؛ خادم `bitba.ng` يقدّم الطرفين لبعضهما، ثم يتنحى جانبًا.

`bitbang` هو ملف ثنائي واحد ثابت بلغة Go. إنه جزء من [مشروع BitBang](https://github.com/richlegrand/bitbang)؛ وتغطي هذه [الورقة التقنية](https://github.com/richlegrand/bitbang/blob/main/whitepaper.md) التصميم بعمق.

## كيف يقارن

|                                | ngrok                  | Tailscale                      | `bitbang`           |
| ------------------------------ | ---------------------- | ------------------------------ | ------------------- |
| الإعداد قبل أول استخدام        | حساب + رمز مصادقة      | حساب + تسجيل دخول على كل جهاز  | **تشغيل أمر واحد**  |
| لمشاركة شيء ما، تشغّل          | خادم ويب، بالإضافة إلى ngrok | عميلهم على كلا الجهازين        | **`bitbang serve`** |
| ما يحصل عليه المتصفح في الطرف البعيد | خادم الويب الذي كنت تشغّله بالفعل | لا شيء — يحتاج إلى عميلهم      | **طرفية، ومتصفح ملفات، وتطبيقات ويب على الشبكة البعيدة** |
| مسار البيانات                  | خوادمهم                 | P2P (تراجع عبر الترحيل)        | **P2P (تراجع عبر الترحيل)** |
| مشفّر من طرف إلى طرف           | ليس افتراضيًا           | نعم                            | **نعم**             |

## وصفات سريعة

**الوصول إلى خدمة في المنزل**

- [تحميل NAS المنزلي من أي مكان (SMB)](https://github.com/richlegrand/bitbang/blob/main/cookbook.md#mount-your-home-nas-from-anywhere-smb)
- [مشاهدة مكتبة الوسائط من أي مكان (Jellyfin)](https://github.com/richlegrand/bitbang/blob/main/cookbook.md#watch-your-media-library-from-anywhere-jellyfin)
- [استخدام LLM الخاص بك من أي مكان (Ollama, Open WebUI)](https://github.com/richlegrand/bitbang/blob/main/cookbook.md#use-your-own-llm-from-anywhere-ollama-open-webui)
- [فحص كاميرات الأمان (Frigate)](https://github.com/richlegrand/bitbang/blob/main/cookbook.md#check-your-security-cameras-frigate)
- [الوصول إلى أتمتة المنزل دون كشفها (Home Assistant)](https://github.com/richlegrand/bitbang/blob/main/cookbook.md#reach-your-home-automation-without-exposing-it-home-assistant)
- [الطباعة على طابعة المنزل (IPP, CUPS)](https://github.com/richlegrand/bitbang/blob/main/cookbook.md#print-to-your-home-printer-ipp-cups)

**الوصول إلى جهاز**

- [الحصول على قشرة على جهاز خلف NAT](https://github.com/richlegrand/bitbang/blob/main/cookbook.md#get-a-shell-on-a-machine-behind-nat)
- [الحصول على قشرة من هاتفك](https://github.com/richlegrand/bitbang/blob/main/cookbook.md#get-a-shell-from-your-phone)
- [سطح مكتب بعيد إلى جهاز Windows (RDP)](https://github.com/richlegrand/bitbang/blob/main/cookbook.md#remote-desktop-into-a-windows-machine-rdp)
- [الوصول إلى سطح مكتب Linux أو Mac (VNC)](https://github.com/richlegrand/bitbang/blob/main/cookbook.md#reach-a-linux-or-mac-desktop-vnc)
- [SSH إلى جهاز بدون منفذ مفتوح (OpenSSH)](https://github.com/richlegrand/bitbang/blob/main/cookbook.md#ssh-to-a-machine-with-no-open-port-openssh)
- [إعداد Raspberry Pi بدون شاشة](https://github.com/richlegrand/bitbang/blob/main/cookbook.md#set-up-a-headless-raspberry-pi)

**المشاركة مع شخص آخر**

المشاركة تعني ببساطة إعطاء شخص ما عنوان URL فريدًا أو رمز QR يمنحه الوصول. يمكن تخصيص الأذونات وضبطها لتنتهي خلال دقائق أو ساعات، إلخ.

- [مشاركة الملفات دون رفعها إلى أي مكان](https://github.com/richlegrand/bitbang/blob/main/cookbook.md#share-files-without-uploading-them-anywhere)
- [إظهار مشروعك لشخص ما](https://github.com/richlegrand/bitbang/blob/main/cookbook.md#show-someone-your-project)
- [منح شخص ما وصولًا ينتهي](https://github.com/richlegrand/bitbang/blob/main/cookbook.md#give-someone-access-that-expires)
- [التحقق من جلسة الوكيل من هاتفك (Claude Code, tmux)](https://github.com/richlegrand/bitbang/blob/main/cookbook.md#check-your-agent-session-from-your-phone-claude-code-tmux)
- [إصلاح جهاز توجيه شخص آخر](https://github.com/richlegrand/bitbang/blob/main/cookbook.md#fix-someone-elses-router)

**التطوير والأجهزة**

- [الوصول إلى قاعدة بيانات من جهاز التطوير (Postgres, MySQL)](https://github.com/richlegrand/bitbang/blob/main/cookbook.md#reach-a-database-from-your-dev-machine-postgres-mysql)
- [مزامنة الأجهزة التي لا يمكنها العثور على بعضها (Syncthing)](https://github.com/richlegrand/bitbang/blob/main/cookbook.md#sync-devices-that-cannot-find-each-other-syncthing)
- [مشاهدة روبوت من متصفح (ROS, Foxglove)](https://github.com/richlegrand/bitbang/blob/main/cookbook.md#watch-a-robot-from-a-browser-ros-foxglove)

**تقنيات**

- [ما يكشفه مستمع إعادة التوجيه](https://github.com/richlegrand/bitbang/blob/main/cookbook.md#what-a-forwarding-listener-exposes)
- [السماح لأجهزة أخرى على شبكتك المحلية باستخدام إعادة توجيه](https://github.com/richlegrand/bitbang/blob/main/cookbook.md#let-other-machines-on-your-lan-use-a-forward)
- [معروف أنه لا يعمل](https://github.com/richlegrand/bitbang/blob/main/cookbook.md#known-not-to-work)

## استخدام `bitbang`

كل اتصال له طرفان: **مستمع** (`bitbang serve`، يعمل على الجهاز الذي يتم الوصول إليه) و**موصل** (متصفح، أو واجهة سطر الأوامر `bitbang`، على الجهاز الذي يقوم بالوصول). عنوان URL واحد للمستمع يخدم كلا النوعين من الموصلات.

### المستمع: `bitbang serve````
bitbang serve                    # everything: shell + proxy + files + forward
bitbang serve shell              # just a terminal
bitbang serve files ~/share      # just a directory (-files-upload to allow uploads)
bitbang serve proxy localhost:8080       # just one web app, straight at the URL
bitbang serve proxy a.lan:80,b.lan:80    # ...or several, chosen in the browser
bitbang serve forward 127.0.0.1:22       # just TCP, for `connect -L`

bitbang serve shell files ~/share proxy nas.lan:8096   # any combination

يعود الأمر بعد النشر، لذا فإن `Ctrl-Z`، `bitbang share`، `fg`
يعمل لمهمة قيد التنفيذ بالفعل. يتطلب الاستضافة tmux 3.2+ على Unix أو
WSL. يمكن لعملاء Windows الأصليين فتح عناوين URL لكن لا يمكنهم استضافة مشاركة.

بشكل افتراضي، يطبع الأمر عنواني URL للحامل:

- يمكن لـ **عنوان التحكم** الكتابة بنفس صلاحية لوحة المفاتيح المحلية.
  يمكن لجهاز تحكم واحد الاتصال في كل مرة.
- **عنوان العرض** للعرض فقط. يتم إسقاط الإدخال قبل وصوله إلى tmux، و
  يمكن لما يصل إلى `--max-viewers` من المشاهدين الاتصال في وقت واحد (الافتراضي 16).

يحذف `--read-only` بيانات اعتماد التحكم بالكامل. يتم الاحتفاظ بحدود المشاهدين
والمتحكمين طوال مدة كل اتصال، حتى قبل فتح قشرة.

تعمل المشاركات حتى يتم إيقافها افتراضيًا؛ يحدد `--ttl` عمرًا (مثل `--ttl 1h`).
عناوين URL للمشاركة مؤقتة ولا تُحفظ أبدًا في `devices.json`. يؤدي `share stop`،
أو انتهاء صلاحية TTL، أو إزالة الجلسة المصدر إلى فصل الأقران البعيدين دون
إيقاف الجلسة المصدر.

إعادة تشغيل `bitbang share` تعيد طباعة عناوين URL للمشاركة الجارية. إذا
مررت علامة تتعارض مع ما هو قيد التشغيل (مثل `--read-only`
ضد مشاركة تحتوي على عنوان تحكم)، فإنه يوضح ذلك بدلاً من
إعادة عناوين URL القديمة؛ يستبدل `bitbang share rotate` المشاركة
بأخرى تستخدم العلامات الجديدة.

يعمل عامل خلفي في جلسة إدارة tmux منفصلة `_bbshare_*`،
لذلك لا يوجد برنامج خفي أو ملف PID لإدارته.

لا تغير المشاركة أي خيارات tmux. مع إعداد tmux الافتراضي `window-size latest`،
تتبع النافذة عميل القراءة-الكتابة النشط؛ لا يزال المشاهد المنفرد يوفر
الحجم الوحيد المتاح. إذا تم تجاوز `window-size`، يبلغ `share` بذلك
لكنه لا يغير تكوين المستخدم.

### منح وصول محدود: `bitbang link`

مستمع واحد، وعنوان URL واحد، وعدد من **روابط الوصول** بقدر ما تحتاج. كل رابط هو
رمز منفصل على نفس عنوان URL، يمنح مجموعة فرعية مما يقدمه المستمع
وينتهي اختياريًا في وقت محدد:```
bitbang link edit                # add entries in $EDITOR
bitbang link ls                  # what you have handed out
bitbang link rm <label>          # revoke one
bitbang link qr <label>          # its URL and QR code

بما أنك لم تقدم النص الفعلي للترجمة (المحتوى المطلوب ترجمته)، لا يمكنني تنفيذ الترجمة. يرجى تزويدي بالنص الكامل للجزء 11 من 35 باللغة الإنجليزية، وسأقوم بترجمته إلى العربية مع الالتزام بجميع القواعد المحددة.```
  0) owner  files forward proxy shell
     https://bitba.ng/8ach_I7oQk2vBb9xYzT0Lw#_vtQ0JCPe7s
  1) ana    files  expires in 6d
     https://bitba.ng/8ach_I7oQk2vBb9xYzT0Lw#T-Ty_HhvLfY
  2) ben    files /srv/photos
     https://bitba.ng/8ach_I7oQk2vBb9xYzT0Lw#L6La8OzBO74
  3) dev    forward 127.0.0.1:5432 shell
     https://bitba.ng/8ach_I7oQk2vBb9xYzT0Lw#8kmI3LYzB7E

يستلم المستمع الإعدادات ويسلّمها إلى خادم الإشارات عند التسجيل، ويقوم الخادم
بتمريرها إلى أي شخص يتصل — لذا يستخدم الطرفان مرحّلك الخاص ولا يتم إشراك مرحّلنا أبدًا.
أي خادم coturn، أو مزوّد مستضاف مثل Cloudflare أو Twilio، يعمل بشكل جيد.

الملف بصيغة JSON، بأيٍّ من هذه الأشكال الثلاثة التي سلّمها لك مزوّدك:```json
[{"urls": ["turn:turn.example.net:3478"], "username": "user", "credential": "pass"}]

toolname --version

toolname scan --target example.com

toolname --help

# فحص منفذ سريع
toolname scan --target example.com --ports 80,443

# فحص شامل مع تصدير النتائج
toolname scan --target example.com --all --output report.json

# وضع التحديد الصامت
toolname scan --target example.com --silent

# مثال على ملف التكوين
threads: 10
timeout: 30
user_agent: "ToolName/1.0"
proxy: ""

Since the input chunk is empty, there is no content to translate. Please provide the actual Markdown content for chunk 19 of 35, and I will translate it into Arabic following all specified rules.```json
{"iceServers": [{"urls": ["turn:turn.example.net:3478"], "username": "u", "credential": "p"}]}

`-L` يمرر **TCP فقط**، مثل `ssh -L`. يرتبط `-L` بـ `127.0.0.1` ما لم تمرر
`-g`، مما يجعل المنفذ المُمرَّر قابلاً للوصول من شبكتك المحلية — وأي شخص
يصل إليه يحصل على ما يصل إليه النفق، دون أي بيانات اعتماد BitBang
أمامه.

يحتاج المستمع إلى `bitbang serve forward` أو `bitbang serve`. افتراضيًا، يصل
رابط `forward` إلى **أي host:port يمكن للمستمع الوصول إليه**، وليس فقط
الذي كنت تقصده، لذا فإن الرابط المُسلَّم لقاعدة بيانات يصل أيضًا إلى بقية
تلك الشبكة. ضيّقه بتحديد ما يمكنه الوصول إليه:```
bitbang serve forward db.internal:5432        # this link reaches one service

لينكس وmacOS. يكتشف نظام التشغيل والمعمارية لديك (`amd64`، `arm64`، و`armv7` على لينكس)، ويقوم بتنزيل الملف الثنائي من أحدث [إصدار على GitHub](https://github.com/richlegrand/bitbang-cli/releases)، ويتحقق من SHA-256 الخاص به مقابل ملف `checksums.txt` الخاص بالإصدار، ثم يثبّته في `~/.local/bin/bitbang`.

تُنشر إصدارات Windows كملفات `bitbang-windows-amd64.exe` و
`bitbang-windows-arm64.exe`. قم بتنزيل الملف الثنائي المناسب من صفحة Releases،
وأعد تسميته إلى `bitbang.exe`، ثم ضعه في مسار `PATH` لديك.
**البناء من المصدر:** انظر [أدناه](#building-from-source).

**macOS وGatekeeper.** سطر التثبيت أعلاه غير متأثر: `curl` لا
يضبط سمة `com.apple.quarantine`، لذا فإن الملف الثنائي الذي يجلبه يعمل
بشكل طبيعي. إذا قمت بدلاً من ذلك بتنزيل `bitbang-darwin-arm64` من صفحة Releases
عبر متصفح، فإن macOS يضعه في الحجر الصحي ويرفض فتحه، لأن
الملفات الثنائية للإصدارات غير موقّعة رقمياً. قم بإزالة ذلك باستخدام أيٍّ من الأمرين التاليين:```
xattr -d com.apple.quarantine ./bitbang-darwin-arm64

وسوم الإصدار لا تحتوي على بادئة `v` (`0.5.0`، وليس `v0.5.0`).

### كيف يعمل رابط التثبيت

`bitba.ng/install` هو إعادة توجيه، وليس نصًا برمجيًا مستضافًا. السلسلة:

1. يصل `curl` إلى `https://bitba.ng/install`، والذي يعيد توجيه 302 إلى [`install.sh`](https://github.com/richlegrand/bitbang-cli/blob/HEAD/install.sh) في هذا المستودع (على فرع `main`).
2. يعمل النص البرمجي في الصدفة الخاصة بك، ويكتشف نظام التشغيل والبنية، ثم ينزّل ملف الثنائي من `https://github.com/richlegrand/bitbang-cli/releases/latest/download/bitbang-linux-<arch>`.
3. يجلب `checksums.txt` من نفس الإصدار ويتحقق من SHA-256 للثنائي.
4. يثبّت في `~/.local/bin` (قابل للتجاوز).

يعيش نص التثبيت في هذا المستودع، بجوار الكود الذي يثبّته — لذا يمكنك مراجعته جنبًا إلى جنب مع الثنائي، ومضيف bitba.ng الرسمي يملك فقط الرابط المختصر. يمكن للمستضيفين الذاتيين توجيه `/install` الخاص بمضيفهم إلى أي نص يوزّعونه: متغير البيئة `INSTALL_URL` في خادم الإشارات يتحكم في هدف إعادة التوجيه (فارغ ← 404).

## مرجع الأوامر

كل أمر فرعي وعلامة موجود في **[CLI.md](https://github.com/richlegrand/bitbang-cli/blob/HEAD/CLI.md)**، و`bitbang <command> --help` يطبع نفس المحتوى في الطرفية.

## البناء من المصدر

يتطلب Go 1.25+. Go نقي، مرتبط بشكل ثابت (`CGO_ENABLED=0`) — ترجمة متقاطعة بسيطة، بدون تبعيات وقت التشغيل.```
go build ./cmd/bitbang/

# cross-compile:
GOOS=linux   GOARCH=arm64        go build -o bitbang-arm64 ./cmd/bitbang/
GOOS=linux   GOARCH=arm GOARM=7  go build -o bitbang-armv7 ./cmd/bitbang/
GOOS=windows GOARCH=amd64        go build -o bitbang.exe   ./cmd/bitbang/
GOOS=darwin  GOARCH=arm64        go build -o bitbang-macos ./cmd/bitbang/

أوامر الصدفة، ومشاركة الملفات، والوكيل، وعميل CLI مدعومة على
نظام Windows. تستخدم أوامر الصدفة التفاعلية في المتصفح وCLI تقنية Windows ConPTY، بما في ذلك
صدى إدخال الطرفية، وتحرير الأسطر، وإخراج VT، وأحداث تغيير الحجم. يتطلب ConPTY
نظام Windows 10 الإصدار 1809 أو Windows Server 2019 أو أحدث.

## الرسوم البيانية

<p align="center">
  <img src="https://assets.kitploit.com/production/public/readmes/47068/d68fcddad62ab84f11a549906a2b5abf2330fb25f39b3c1a1266eac7257a080d.png" alt="صدفة CLI في bitbang ومشاركة الملفات" width="760">
  <img src="https://assets.kitploit.com/production/public/readmes/47068/55bb6866c22504a6434e3dee8cb998e747cd73cb9d0bfa5e0bc0ede7b90ce262.png" alt="عملية الوكيل في CLI bitbang" width="720">  
</p>

## خارطة الطريق

متاح اليوم: **الصدفة، والملفات، والوكيل**، يمكن الوصول إليها من المتصفح أو CLI، بالإضافة إلى **إعادة توجيه منفذ TCP**، ونسخ الملفات بنمط scp، و**الاقتران المخصص** مع جدول أجهزة محفوظ، و**مشاركة الطرفية** (`bitbang share`)، و**روابط الوصول** (`bitbang link`) التي تضيّق نطاق ما يمنحه الرابط وتحدد مدة صلاحيته. مصمم وقيد التنفيذ:

- **جسر تسلسلي** -- تشغيل `/dev/ttyUSB0` عن بُعد من منفذ افتراضي محلي (مثل تشغيل Arduino IDE عبر الإنترنت). تم فتح قضية [هنا](https://github.com/richlegrand/bitbang-cli/issues/3).
- **سطح مكتب عن بُعد** -- الشاشة عبر مسار فيديو WebRTC، ولوحة المفاتيح/الماوس عبر قناة البيانات.

## الترخيص

MIT -- انظر [LICENSE](https://github.com/richlegrand/bitbang-cli/blob/HEAD/LICENSE).

## المساهمة

نرحب بالقضايا وطلبات السحب.

الوصفات مختلفة: فهي موجودة في [كتاب الطبخ](https://github.com/richlegrand/bitbang/blob/main/cookbook.md)،
في مستودع [bitbang](https://github.com/richlegrand/bitbang)، لأنها تمتد عبر
كل مشروع بدلاً من هذا المشروع فقط. إضافة وصفة هي طلب سحب هناك.

إدراجها *في القائمة* هو طلب سحب صغير ثانٍ لكل مشروع يجب أن يظهر README الخاص به
الوصفة -- قائمة [الوصفات](#recipes) أعلاه تُصان هنا يدويًا. هذا
مقصود: كل مشروع يقرر أي الوصفات تستحق أن تُعرض أمام
قرائه، بدلاً من أن ينمو كل README بكل وصفة.