matrix2051

Matrix2051

انضم إلى Matrix من عميل IRC المفضل لديك

Matrix2051 (أو M51 للاختصار) هو خادم IRC مدعوم بالمصفوفة. يمكنك أيضًا رؤيته باعتباره حارس IRC يتصل بـ Matrix Homeservers بدلاً من خوادم IRC. بعبارة أخرى:

         IRC client
  (eg. weechat or hexchat)
             |
             |     IRC protocol
             v
         Matrix2051
             |
             |     Matrix protocol
             v
     Your Homeserver
     (eg. matrix.org)

الأهداف:

1. اجعل من السهل على مستخدمي IRC الانضمام إلى Matrix بسلاسة
2. دعم روبوتات التتابع الحالية ، للسماح بمسحات تتصرف بشكل أفضل على IRC من جسور IRC/Matrix الحالية
3. تنفيذ حافة IRCV3
4. من السهل جدا التثبيت. هذا يعنى:
   1. كجزء كبير من التكوين وقاعدة البيانات (من الناحية المثالية صفر)
   2. مجموعة صغيرة من عمليات الاستغناء.

غير المماثلة:

1. كونك خدمة مستضافة (سوف تتطلب التدابير المضادة للبريد العشوائي ، وهذا كثير من العمل).
2. دعم TLS (انظر النقطة السابقة). فقط تشغيله على مضيف محلي. إذا كنت بحاجة إلى أن تكون بعيدة ، فقم بالوصول إليها عبر VPN أو وكيل عكسي.
3. الاتصال بحسابات متعددة لكل اتصال IRC أو بالبروتوكولات الأخرى (à la bitlbee). هذا يتعارض مع الأهداف 1 و 4.
4. تنفيذ أي ميزات ليس أصلاً من خلال كلا البروتوكولات (أي لا حاجة إلى روبوتات الخدمة التي تتجول فيها مع استخدام PRICMSG)

ميزات رئيسية

• مصادقة التسجيل وكلمة المرور
• الانضمام إلى الغرف
• إرسال واستقبال الرسائل (يدعم التنسيق ، متعددة ، النقاط البارزة ، الرد ، الرد على الرسائل)
• الجزئي IRCV3 دعم Chathistory ؛ يكفي أن تعمل Gamja. فتح قضايا تشاتستوري
• دعم اسم العرض الجزئي

أوجه القصور

• يتم عرض الدردشات المباشرة كقنوات عادية ، بأسماء عشوائية
• لا يشعر "شبكة IRC حقيقية (حتى الآن؟)
• معرفات المستخدم وأسماء الغرف طويلة بشكل غير مريح
• تحميل قائمة Nick من الغرف الضخمة مثل #Matrix: Matrix.org يحمل بعض عملاء IRC
• سيشهد عملاء IRC بدون دعم ألوان Hex بعض القمامة بدلاً من الألوان. (على الرغم من أن النص الملون يبدو غير شائع جدًا على المصفوفة)
• عملاء IRC دون دعم Advanced IRCV3 يغيب عن العديد من الميزات: ردود QUOTE ، رد الفعل ، أسماء العرض.

لقطة شاشة

ملاحظتان على لقطة الشاشة هذه:

• يتم تقديم تعديلات الرسائل مع احتياطي ، حيث لا يتم دعم تحريرات الرسائل من قبل IRC ،
• يتم تقديم الردود على irccloud بأيقونات ملونة ، والنقر فوق هذه الرموز يفتح عمودًا يوضح الخيط بأكمله. قد يقدم العملاء الآخرون الردود بشكل مختلف.

الاستخدام

• تثبيت تبعيات النظام. على سبيل المثال ، على Debian: sudo apt install elixir erlang erlang-dev erlang-inets erlang-xmerl
• تثبيت تبعيات Elixir: mix deps.get
• قم بإجراء اختبارات للتأكد من أن كل شيء يعمل: mix test
• تشغيل: mix run matrix2051.exs
• قم بتوصيل عميل بالمضيف localhost:2051 ، بالتكوين التالي:
  • لا SSL/TLS
  • اسم المستخدم SASL: معرف المصفوفة الكامل ( user:homeserver.example.org )
  • كلمة مرور SASL: كلمة مرور المصفوفة الخاصة بك

انظر أدناه للحصول على تعليمات إضافية للعمل مع عملاء الويب.

انظر INSTALL.md للحصول على دليل أكثر توجهاً نحو الإنتاج.

بنيان

• matrix2051.exs يبدأ M51.Application ، الذي يبدأ M51.Supervisor ، الذي يشرف على:
  • config.ex : وكيل التكوين العالمي
  • irc_server.ex : DynamicSupervisor يتلقى اتصالات من عملاء IRC.

في كل مرة يتلقى فيها irc_server.ex اتصالًا ، فإنه يولد irc_conn/supervisor.ex ، والذي يشرف على:

• irc_conn/state.ex : يخزن حالة الاتصال
• irc_conn/writer.ex : Genserver يمسك المقبس والسماح لكتابة خطوط لها (ودفعات من الخطوط في المستقبل)
• irc_conn/handler.ex : المهمة المشغولة على الأوامر الواردة من القارئ ، والإجابات على الأوامر البسيطة ، وترسل أوامر أكثر تعقيدًا
• matrix_client/state.ex : يحافظ على حالة الاتصال بمصفوفة homeServer
• matrix_client/client.ex : معالجة اتصال واحد بمصفوفة homeServer ، كمستخدم واحد
• matrix_client/sender.ex : يرسل الأحداث إلى matrix homeServer ومع إعادة المحاكمة على الفشل
• matrix_client/poller.ex : يسأل مرارًا وتكرارًا من Matrix HomeServer للأحداث الجديدة (بما في ذلك المزامنة الأولية)
• irc_conn/reader.ex : المهمة المشغولة على الخطوط الواردة ، وترسلها إلى المعالج

المرافق:

• matrix/raw_client.ex : عميل مصفوفة منخفضة المستوى / غلاف رفيع حول طلبات HTTP
• irc/command.ex : معالجة خط IRC ، بما في ذلك "خفض" للعملاء الذين لا يدعمون بعض القدرات.
• irc/word_wrap.ex : ملف خط عام
• format/ : تحويل بين تنسيق IRC و org.matrix.custom.html
• matrix_client/chat_history.ex : يجلب سجل الرسائل من Matrix ، عند طلبه من قبل عميل IRC

أسئلة

لماذا؟

هناك العديد من عملاء IRC الرائعين ، لكن لا يمكنني العثور على عميل Matrix الذي يعجبني. ومع ذلك ، تنتقل بعض المجتمعات من IRC إلى Matrix ، لذلك كتبت هذا حتى أتمكن من الانضمام إليهم مع عميل مريح.

هذه أيضًا طريقة لتنسيق أحدث ميزات IRCV3 بسهولة ، ولكي أتعلم بروتوكول المصفوفة.

ما الذي يتم دعم عملاء IRC؟

من الناحية النظرية ، يجب على أي عميل IRC العمل. على وجه الخصوص ، أختبره مع Gamja و IrcCloud و The Lounge و Weechat.

يرجى فتح مشكلة إذا كان لدى عميلك أي مشكلة.

ما هي المصفوفة المنزلية المدعومة؟

من الناحية النظرية ، أي ، كما كتبت هذا من خلال قراءة مواصفات المصفوفة. في الممارسة العملية ، يتم اختبار هذا فقط مع المشبك.

الاستثناء الملحوظ هو التسجيل ، والذي يستخدم واجهة برمجة تطبيقات خاصة بالمشبك لأن المصفوفة نفسها لا تحدد التسجيل.

يرجى فتح مشكلة إذا كان لديك أي مشكلة مع HomeServer الخاص بك (تسجيل الدخول/كلمة المرور الوهمية التي يمكنني استخدامها للاتصال بها سيكون موضع تقدير).

هل تخطط لدعم الميزات x ، y ، ...؟

في وقت كتابة هذا التقرير ، إذا كان كل من المصفوفة و IRC/IRCV3 يدعمانهم ، فمن المحتمل أن يكون Matrix2051. ألقِ نظرة على قائمة قضايا "التحسين" المفتوحة.

الاستثناء الملحوظ هو الرسائل المباشرة ، لأن نموذج Matrix يختلف اختلافًا كبيرًا عن IRC.

هل يمكنني التواصل مع عميل ويب؟

لتوصيل عملاء الويب ، تحتاج إلى بوابة WebSocket. تم اختبار Matrix2051 باستخدام Webircgateway من Kiwiirc (جرب هذا التصحيح إذا كنت بحاجة إلى تشغيله على إصدارات GO القديمة).

فيما يلي كيف يمكنك تكوينه للاتصال بـ Matrix2051 مع Gamja:

[ fileserving ]
enabled = true
webroot = " /path/to/gamja "


[ upstream . 1 ]
hostname = " localhost "
port = 2051
tls = false
# Connection timeout in seconds
timeout = 20
# Throttle the lines being written by X per second
throttle = 100
webirc = " "
serverpassword = " "

ما هو الاسم؟

هذه إشارة إلى XKCD 1782:

لا يزال لدي سؤال ، كيف يمكنني الاتصال بك؟

انضم إلى #Matrix2051 في irc.interlinked.me. (لا ، أنا لا آكل لعبة الكلب الخاصة بي ، ما زلت أفضل IRC "الأصلي".)