tailsgora Control Center

شبكة الأقران (Mesh Network)

0

إجمالي الأقران

0

متصل الآن

0

VPN نشط

دليل الأسماء الرمزية

جاري التحميل...

قائمة الأقران

المستخدم	الاسم الرمزي	UID	Virtual IP	الحالة	آخر ظهور	إجراءات
جاري التحميل...

مركز المكالمات (WebRTC · tailsgora)

0

نشطة

0

إجمالي

0s

متوسط المدة

HD

جودة الصوت

اتصال باسم رمزي

مكالمة جماعية (رنين للكل)

المتصلون فقط

يرن كل الأعضاء كاتصال وارد من tailsgora

ضوابط الأدمن

إلغاء إرسال الرسائل من الجميع إلغاء المكالمات من الجميع —

المكالمات النشطة

لا توجد مكالمات نشطة

سجل المكالمات

لا يوجد سجل

WebRTC Signaling

Waiting for signaling data...

مراقبة الدردشة

الرسائل المباشرة

Firebase /chats/*/messages

لا توجد رسائل

إحصائيات

إجمالي الرسائل0

رسائل/دقيقة0

مستخدمون نشطون0

إرسال رسالة

تظهر في الدردشة الخاصة باسم tailsgora عبر Firebase + FCM

WireGuard VPN Monitor

34.165.237.115

Server IP

51820

Port (UDP)

0

Active Tunnels

AES-256

Encryption

Server Configuration

[Interface]
Address = 100.64.0.1/10
ListenPort = 51820
PrivateKey = (hidden)

[Peer]
# Server public key
PublicKey = VJiYOv8sd2w82txb5Au7kCzZJvZELrO1RPCTBygyOCk=
Endpoint = 34.165.237.115:51820
AllowedIPs = 100.64.0.0/10

أنفاق VPN النشطة

Waiting for data...

Firebase /mesh

أجهزة Android

0

إجمالي

0

متصل

0

غير متصل

الأجهزة المسجلة

الجهاز	UID	Virtual IP	VPN	آخر نشاط
جاري التحميل...

أدمن tailsgora

رسائل خاصة + أوامر التيرمنال العميق للأعضاء

رسالة خاصة من tailsgora

أوامر التيرمنال العميق

انتظار ردود /admin/replies...

أجهزة أونلاين (AdminBridge)

—

بلاغات التطبيق

0

/reports

0

/support/reports

0

الإجمالي

بلاغات الأعضاء

تقارير المشاكل (تيرمنال)

التخزين · tailsgora.duckdns.org/storage · القرص

https://tailsgora.duckdns.org/storage

permanent storage base

—

G: متبقي (GB)

—

G: مستخدم (GB)

—

G: الإجمالي (GB)

مساحة القرص G:—

ops-agent ينشر /server/disk كل 20 ثانية

محتويات LocalNetStorage

—

مجلد	ملف	حجم	تاريخ	إجراء
اضغط تحديث أو انتظر التحميل…

حصة كل عضو (100MB / 24h)

العضو	UID	مستخدم	متبقي	النسبة
لا بيانات /storage/quota بعد

التحكم بالحسابات

حظر إيميل / يوزرنيم / الاثنين · فك الحظر · حذف اليوزرنيم · حذف الحساب (Auth + RTDB عبر ops-agent)

إيميل

يوزرنيم

نمط

UID	يوزر	إيميل	ربط	حظر	إجراءات

دليل الأسماء الرمزية

كل الأسماء من /usernames + /mesh · تعديل / حذف اليوزر · حذف الحساب بالكامل (Firebase + Auth)

الاسم الرمزي	الإيميل	الاسم	UID	Android ID	حالة	إجراءات

مولّد SDK · Projects

مثل Agora Console: أنشئ App ID + Certificate + Temporary Token لدمج محادثات نصية/صوتية في الألعاب والتطبيقات الأخرى

Projects 0 sdk/tailsgora-client.js

Create New Project

اسم المشروع Use case Authentication

Text Chat Voice Video

يُحفظ في Firebase /sdkApps — App ID بطول 32 حرف مثل Agora، مع شهادة لتوليد التوكن.

Projects

الاسم	App ID	Use case	Features	Status	إجراءات

اختر مشروعاً من القائمة أو أنشئ مشروعاً جديداً لعرض App ID / Certificate / Token Generator

—

Use case · —

Security · —

App ID

—

Primary Certificate

••••

لا تضع الـ Certificate داخل لعبة أو APK — فقط على السيرفر.

Generate Temporary Token

Channel

UID

TTL (seconds)

—

Integration snippet · app.js

جاهز للصق في ألعابك مثل تكامل Agora + Firebase — يستبدل AGORA_APP_ID بـ TAILSGORA_APP_ID.

سجل البناء · tailsgora Playbook

كيف نشرنا الروابط · استخدمنا SDK · وصلنا لمكالمة ودردشة حقيقية · بنينا CodePenio · وجعلنا الروابط عالمية — مع المشاكل التي واجهتنا

netforge-tailsgora 34.165.237.115 WebRTC + RTDB

انتقال سريع

البنية استخدام SDK مكالمة حقيقية دردشة نصية نشر الروابط CodePenio روابط عالمية المشاكل Checklist

1) البنية التي اعتمدناها

Firebase · netforge-tailsgora

RTDB (Asia): إشارات المكالمات، الأعضاء، الرسائل، sdkApps / sdkRooms

Auth: Anonymous مطلوب لقواعد /sdkRooms

Storage (اختياري): رفع HTML لـ CodePenio

Google Cloud Hub · 34.165.237.115

WireGuard :51820 · WS relay :8080

Storage عبر Nginx: https://tailsgora.duckdns.org/storage → :3000

STUN :3478 (قد يكون مغلقاً من بعض الشبكات)

عميل الويب التجريبي: Desktop/index.html + app.js · لوحة الإدارة: هذا الملف · CodePenio: مجلد مستقل على سطح المكتب.

2) كيف نستخدم الـ SDK (مثل Agora)

من الشريط: → Create New Project (اسم + use case + Text/Voice).
يُنشأ App ID (32 hex) + Certificate ويُحفظ في /sdkApps/{appId}.
Generate Temporary Token للقناة (مثل lobby) والـ UID — الصيغة: TG1.appId.channel.uid.expire.sig.
انسخ snippet أو حمّل الملف، وفي العميل ضع TAILSGORA_APP_ID + التوكن + إعدادات Firebase tailsgora.
الملف المرجعي: sdk/tailsgora-client.js — دردشة عبر RTDB؛ الصوت الحقيقي يحتاج WebRTC فوق الإشارة.

const TAILSGORA_APP_ID = "<appId>";
// Firebase: netforge-tailsgora + Asia RTDB
await joinChat({ channel: "lobby", token: "TG1...." });
await joinVoice({ channel: "lobby", token: "TG1...." }); // + WebRTC mesh في عميل الويب

3) كيف وصلنا لمكالمة حقيقية

في البداية كان «الانضمام للصوت» يكتب فقط عضواً وجلسة في Firebase — بدون مسار ميديا. لذلك لا يُسمع الطرف الآخر.

الحل: WebRTC mesh بين المتصفحات مع إشارة على:

/sdkRooms/{appId}/{channel}/voice/webrtc/{uid}/offers|answers|candidates

المايك عبر getUserMedia → addTrack → Offer/Answer حسب ترتيب الـ uid → تشغيل <audio autoplay> للأقران.

ICE: Google STUN أولاً، ثم محاولة STUN الـ hub. زر إنهاء المكالمة يوقف المسارات محلياً فوراً ثم ينظّف RTDB.

اختبار: افتح http://127.0.0.1:5501/index.html من جهازين/متصفحين بنفس القناة بعد إذن المايك.

4) دردشة نصية حقيقية

المسار: /sdkRooms/{appId}/{channel}/messages
تظهر في تبويب «الدردشة النصية» + صندوق مصغّر داخل صفحة المكالمة.
تنضم تلقائياً عند انضمام الصوت؛ أو يدوياً بزر «انضمام للدردشة».
يتطلب Auth (Anonymous) لأن قواعد sdkRooms = auth != null.

5) كيف تنشر الروابط (من الإدارة والمنتجات)

أ) رابط دعوة / تطبيق

من إعدادات APP_LINK: inviteBaseUrl على Firebase Hosting. حدّث الحقول من لوحة التخزين/البنية ثم انشرها للعملاء.

ب) رابط Storage عام

شغّل storage-server.js على الـ hub، ثم ضع النفق في RTDB:

https://tailsgora.duckdns.org/storage
(Nginx → 127.0.0.1:3000 — no Cloudflare)

ج) رابط قلم CodePenio

من المحرر: «إنشاء رابط عالمي» → حفظ في RTDB /codepenio/pens + رفع HTML عبر نفق الرفع /upload → رابط /download/files/….html.

6) كيف صنعنا CodePenio

مشروع مستقل: Desktop/codepenio/ (لا يلمس كود Android مباشرة).
محرر HTML/CSS/JS + معاينة iframe srcdoc كل 500ms + حفظ مسودة محلية.
ربط بنفس Firebase tailsgora في config.js.
عند النشر: كتابة القلم في RTDB + رفع صفحة HTML كاملة عبر /storage/upload (نفس نطاق tailsgora.duckdns.org).
صفحة view.html?id= تعرض القلم من RTDB إن كان غير منتهٍ (24 ساعة).

محلي: python -m http.server 5502 داخل مجلد codepenio → http://127.0.0.1:5502/index.html

7) كيف خلّينا الروابط تشتغل عالمياً

المشكلة: IP الـ hub :3000 غالباً غيرreachable من الإنترنت / المتصفح (timeout).
الحل: نطاق دائم https://tailsgora.duckdns.org مع Nginx reverse proxy — لا Cloudflare Tunnel عشوائي.
الرابط النهائي ثابت مثل: https://tailsgora.duckdns.org/storage/download/files/uuid.html
بديل/مكمل: Firebase Storage تحت codepenio/pens/ إن فُتحت قواعد الكتابة لـ text/html.
عرض تفاعلي عبر Hosting لاحقاً: …/codepenio/view.html?id= بعد نشر المجلد.

8) المشاكل التي واجهتنا وكيف عالجناها

المشكلة	السبب	العلاج
لا أسمع الطرف الآخر	إشارة RTDB فقط بلا WebRTC	mesh WebRTC + audio elements
زر الخروج لا ينهي المكالمة	await Firebase يعلّق قبل تحديث الواجهة	إيقاف محلي فوري ثم تنظيف بمهلة
الدردشة «غير موجودة»	مخفية في درج ضيق / بدون انضمام	شريط علوي + دردشة مصغّرة في المكالمة
Permission denied على sdkRooms	rules تتطلب auth	signInAnonymously قبل join
المايك مرفوض	فتح file:// بدل http	خدمة محلية 127.0.0.1:5501
توكن منتهٍ فجأة	TTL قصير للتجربة	إعادة التوليد من مولّد SDK / TTL أطول
روابط Storage لا تفتح عالمياً	:3000 على IP عام مغلق/محجوب	Duck DNS + Nginx HTTPS
Hub WS :8080 / STUN :3478 timeout	جدار ناري أو الخدمة متوقفة	Google STUN للمكالمات؛ شخّص من صفحة العميل
حلقة «تحميل رسائل أقدم» في التطبيق	مراقب حي يعيد hasMore	فصل تحديثات live عن صفحات الأقدم
Crash CallForegroundService	startForeground / صلاحيات	fallback specialUse + ترقية مبكرة

9) Checklist تشغيل سريع

Firebase مشروع netforge-tailsgora + Anonymous مفعّل قواعد sdkRooms / codepenio منشورة مولّد SDK: مشروع + توكن قناة صالح عميل الويب على http://127.0.0.1 وليس file:// Storage يعمل على https://tailsgora.duckdns.org/storage اختبار مكالمة من متصفحين + مشخص Terminal في العميل

عميل الويب MDV CodePenio

NetForge Overview tailsgora · بيانات حية

WebSocket

—

relay

Mesh peers

0

/mesh

Active calls

0

WebRTC

Disk used

—

G:

Online

0

peers

All calls

0

/calls

Bans

0

admin

Reports

0

/reports

Hub · Firebase · Storage linked via APP_LINK

البنية التحتية · حية

Google Cloud Hub

IP—

WG—

WS—

VIP—

Mesh—

PubKey —

التخزين المحلي

DriveG:

Used %—

publicUrl —

Mesh

Peers—

Packagecom.netforge.tailsgora

Projectnetforge-tailsgora

API Gateway Console · حي

—

المسارات الحقيقية

الخدمة	الهدف	Methods	Latency	Status

WebRTC Analytics · من /calls

0

Active

0

Voice (all)

0

Video (all)

0

Ended

آخر المكالمات

ID	نوع	حالة	من → إلى

Security Center · حي

0

حظر نشط

0

بلاغات

0

انهيارات (/crashes)

قائمة المحظورين

AI Log Analyzer

Live Log Stream

All INFO WARN ERROR

[2024-07-24 19:58:12] INFO api-gateway Request processed: GET /api/v3/users in 12ms

تيرمنال التطبيق العميق

mirror من Settings Terminal + /terminalLive + /admin/diag

الشبكة

—

WireGuard

—

Force VPN

—

VIP / Address

—

Ping / ICMP

—

UDP / NAT

—

Headscale / WG URL

—

Public key / config (من الجهاز)

—

—

أوامر الجهاز

الهدف = الجهاز المختار أعلاه (أو * من أدمن)

tailsgora@deep-terminal