مرجع CLI
ملف تنفيذي واحد، addtothese، هو كل ما تحتاجه: تسجيل الدخول، وفتح الأنفاق، وإعادة توجيه منافذ TCP. يُخزَّن تسجيل دخولك في ~/.addtothese/config.yaml (%USERPROFILE%\.addtothese\config.yaml على Windows).
addtothese login
addtothese login --token att_...
يحفظ رمز API. من دون --token يطلب الرمز من الإدخال القياسي. الأمر addtothese logout يحذفه.
addtothese http
addtothese http <port|host:port|url> [--subdomain name]
ينشر خدمة HTTP محلية. من دون --subdomain تحصل على نقطة نهاية عشوائية. ومعه، يستخدم النفق اسمًا حجزته في لوحة التحكم. تعيد أداة CLI الاتصال تلقائيًا بعد انقطاع الشبكة وتجدّد بيانات اعتمادها قبل انتهاء صلاحيتها.
| الخيار | الافتراضي | المعنى |
|---|---|---|
| --subdomain | عشوائي | الاسم المحجوز المراد استخدامه |
| --timeout | 10s | مهلة إعادة توجيه كل طلب إلى خدمتك |
| --access-log | true | طباعة كل طلب يمرّ عبر الوكيل |
| --log-level | warn | debug أو info أو warn أو error |
احمِ عنوان URL برموز البريد الإلكتروني
addtothese http 4321 --allowed-email ana@gmail.com --allowed-email '*@company.com'
لا يستطيع فتح عنوان URL إلا الأشخاص المدرجون في قائمتك. يُدخل الزائر بريده الإلكتروني؛ فإذا كان في القائمة يتلقى رمزًا مكوّنًا من 6 أرقام صالحًا لمدة 10 دقائق، ويبقى مسجّل الدخول لمدة 24 ساعة. يسمح *@company.com بنطاق كامل. كرّر الخيار لكل عنوان أو نطاق.
تتلقى خدمتك العنوان المُتحقَّق منه في الترويسة X-AddToThese-Email. كل تشغيل يستبدل القائمة، لذا فإن التشغيل بدون --allowed-email يجعل عنوان URL عامًا مجددًا. يمكنك أيضًا تعديل القائمة في صفحة نقطة النهاية في لوحة التحكم.
addtothese tcp
addtothese tcp 5432 --subdomain mydb
ينشر منفذ TCP خامًا مثل Postgres أو SSH أو RDP. يشغّل من يحتاجون إلى الوصول إليه أداة إعادة التوجيه من جهتهم، فتفتح منفذًا محليًا متصلًا بخدمتك:
addtothese forward tcp 5432 mydb --connect.url https://mydb.addtothese.com
بعد ذلك يمكنهم الاتصال بـ localhost:5432 كما لو كانت قاعدة البيانات على أجهزتهم.
متغيرات البيئة
| المتغير | المعنى |
|---|---|
| ADDTOTHESE_TOKEN | رمز API، يتجاوز الرمز المحفوظ |
| ADDTOTHESE_CONFIG | مسار ملف إعداد بديل |