بریج‌ها
بریج، گفتگوهای شما در یک شبکه‌ی دیگر را به اتاق‌های ماتریکس می‌آورد: گفتگوهای تلگرام یا واتس‌اپ خود را از درون Element می‌خوانید و پاسخ می‌دهید و طرف مقابل پیام شما را از حساب خودتان در همان شبکه دریافت می‌کند.
روش افزودن هر یک: مؤلفه‌ها. پیش‌تنظیم Bridge hub در مرحله‌ی Homeserver، تلگرام، واتس‌اپ، سیگنال و دیسکورد را همراه با رمزنگاری و دابل پاپت انتخاب می‌کند.
نحوه‌ی کار همه‌ی بریج‌ها
هیچ‌یک به رکورد DNS نیاز ندارند. پس از استقرار:
۱. در Element با ربات بریج گفتگو را آغاز کنید؛ نشانی هر یک در ادامه آمده
است، برای نمونه @telegrambot:example.org. روی دامنه‌ی اصلی شما، نه matrix..
۲. فرمان login را بفرستید و دستورالعمل ربات را دنبال کنید. ورود در هر شبکه
متفاوت است: یک کد QR برای اسکن با برنامه‌ی تلفن همراه، کدی که با پیامک ارسال
می‌شود، یا کوکی‌هایی که از مرورگر کپی می‌کنید.
۳. گفتگوهای شما به‌صورت اتاق، هر یک با یک دعوت، نمایش داده می‌شوند. گفتگوهای
جدید با رسیدن پیام‌ها اضافه می‌شوند.
برای دیدن فرمان‌های هر ربات، help را برای آن بفرستید. اگر از حساب خارج شدید،
دوباره login را بفرستید.
بریج می‌تواند هر آنچه را منتقل می‌کند بخواند و اطلاعات ورود آن روی سرور شما ذخیره می‌شود. تنها حساب کسانی را بریج کنید که با آن موافق‌اند.
تنظیمات مشترک همه‌ی بریج‌ها
گزینه‌ی Appservice Double Puppet (احراز هویت): آن را همراه با هر بریجی انتخاب کنید. بدون آن، آنچه در برنامه‌ی تلگرام می‌نویسید در ماتریکس به نام شخص دیگری نمایش داده می‌شود.
رمزنگاری بریج (Bridge encryption، همه‌ی بریج‌ها)
به بریج‌های mautrix اجازه می‌دهد به اتاق‌های رمزنگاری‌شده بپیوندند و اتاق‌هایی را که می‌سازند رمزنگاری می‌کند. پیام‌ها پیش از ارسال به شبکه‌ی دیگر، روی سرور شما توسط بریج رمزگشایی می‌شوند (این امر اجتناب‌ناپذیر است)، اما میان برنامه‌های شما و سرور رمزنگاری‌شده باقی می‌مانند. پیشنهاد می‌شود. مستندات
حالت رله (Bridge relay mode، همه‌ی بریج‌ها)
به کسانی که وارد بریج نشده‌اند اجازه می‌دهد در یک گروه بریج‌شده گفتگو کنند: حساب
یکی از اعضای واردشده، پیام‌های آن‌ها را با نامشان در ابتدای پیام ارسال می‌کند.
آن عضو در اتاق !tg set-relay را می‌فرستد (با پیشوند همان بریج: !wa،
!signal، !discord و…)؛ !tg unset-relay آن را متوقف می‌کند.
مستندات
تلگرام (mautrix)
ربات: @telegrambot:example.org
تنظیمات: Telegram API ID و API hash. آن‌ها را یک بار دریافت کنید: در
my.telegram.org با شماره‌ی تلفن خود وارد شوید، API
development tools را باز کنید، یک نام دلخواه برای برنامه وارد کنید و api_id
و api_hash را کپی کنید.
ورود: فرمان login، سپس شماره‌ی تلفن خود با پیش‌شماره‌ی کشور، و سپس کدی را
که تلگرام برایتان می‌فرستد ارسال کنید (و اگر دارید، گذرواژه‌ی تأیید دومرحله‌ای).
گروه‌ها و گفتگوهای شما به اتاق تبدیل می‌شوند.
مستندات ·
راهنمای ورود
واتس‌اپ (mautrix)
ربات: @whatsappbot:example.org · تنظیمات: ندارد.
ورود: فرمان login qr را بفرستید و کد را با واتس‌اپ تلفن خود اسکن کنید:
Settings › Linked devices › Link a device. گفتگوهای اخیر حدود یک دقیقه بعد
نمایش داده می‌شوند.
تلفن شما باید هر از گاهی آنلاین شود: اگر ۱۴ روز خاموش بماند، واتس‌اپ اتصال بریج را قطع می‌کند. ربات پس از ۱۲ روز به شما هشدار می‌دهد. مستندات · راهنمای ورود
سیگنال (mautrix)
ربات: @signalbot:example.org · تنظیمات: ندارد.
ورود: فرمان login را بفرستید و کد QR را با سیگنال تلفن خود اسکن کنید:
Settings › Linked devices › Link new device. گفتگوها با رسیدن پیام‌ها نمایش
داده می‌شوند؛ سیگنال هرگز پیام‌های قدیمی را منتقل نمی‌کند، بنابراین تاریخچه‌ای
وجود ندارد.
مستندات ·
راهنمای ورود
دیسکورد (mautrix)
گزینه‌ی مناسب برای حساب دیسکورد شخصی شما.
ربات: @discordbot:example.org · تنظیمات: ندارد.
ورود: فرمان login qr را بفرستید و کد را با برنامه‌ی دیسکورد تلفن همراه
اسکن کنید (Settings › Scan QR Code). ابتدا پیام‌های خصوصی نمایش داده می‌شوند.
برای سرورها («گیلدها»)، guilds status را بفرستید تا فهرست آن‌ها را ببینید و
برای هر یک که می‌خواهید guilds bridge ID را؛ با افزودن --entire همه‌ی اتاق‌های
آن یک‌جا ساخته می‌شوند.
مستندات ·
راهنمای ورود
توییتر/ایکس (mautrix)
ربات: @twitterbot:example.org · تنظیمات: ندارد.
ورود: فرمان login را بفرستید و کوکی‌های مرورگری را که در آن وارد x.com
شده‌اید، طبق توضیح ربات وارد کنید. پیام‌های مستقیم را بریج می‌کند.
مستندات ·
راهنمای ورود
گوگل مسیجز (mautrix)
پیامک و RCS تلفن شما، از طریق برنامه‌ی Google Messages.
ربات: @gmessagesbot:example.org · تنظیمات: ندارد.
ورود: فرمان login را بفرستید و کد QR را در Google Messages تلفن خود اسکن
کنید: تصویر نمایه › Device pairing › QR code scanner. تلفن باید روشن و
آنلاین بماند؛ پیام‌ها از طریق آن ارسال می‌شوند.
مستندات ·
راهنمای ورود
آی‌آرسی (matrix-appservice-irc)
کل شبکه‌های IRC را بریج می‌کند: هر کانال به اتاقی تبدیل می‌شود که هر کاربر سرور شما می‌تواند به آن بپیوندد.
ربات: @irc_bot:example.org
تنظیمات: سرورهای IRC (IRC servers): برای هر شبکه یک بلوک. مقدار
irc.example.com را به نشانی شبکه و name را به نام آن تغییر دهید؛ باقی نمونه
بدون تغییر کار می‌کند. aliasTemplate باعث می‌شود #irc_linux:example.org اتاق
مربوط به #linux باشد.
استفاده: برای پیوستن به یک کانال، به #irc_CHANNEL:example.org بپیوندید.
برای دیدن فرمان‌ها !help را برای ربات بفرستید، برای نمونه !nick برای انتخاب
نام مستعار.
مستندات
هایزن‌بریج (Heisenbridge، واسط IRC)
آی‌آرسی برای یک نفر (یا چند نفر): هر کاربر با نام مستعار خود به شبکه‌هایی که می‌خواهد متصل می‌شود، مانند یک bouncer.
ربات: @heisenbridge:example.org · تنظیمات: ندارد.
استفاده: نخستین کاربر سرور شما که به ربات پیام دهد، مالک آن می‌شود. فرمان
help را بفرستید؛ با addnetwork، addserver و open متصل می‌شوید. یک
ویدیوی نمایشی اصول کار را نشان
می‌دهد.
مستندات
دیسکورد (matrix-appservice-discord)
رباتی که کانال‌های دیسکورد و اتاق‌های ماتریکس را برای کل یک انجمن به هم متصل می‌کند، نه برای حساب شخصی شما (برای آن، دیسکورد mautrix را انتخاب کنید).
تنظیمات: در Discord Developer Portal یک برنامه بسازید، یک ربات به آن اضافه کنید و Client ID (General Information) و Bot token (Bot › Reset Token) را کپی کنید.
استفاده: به #_discord_GUILDID_CHANNELID:example.org بپیوندید (شناسه‌ها از
دیسکورد با Developer Mode فعال: راست‌کلیک › Copy ID). اتاق‌هایی که به این روش
ساخته می‌شوند عمومی‌اند.
نکته: از Synapse 1.90 به بعد، این بریج تنها زمانی کار می‌کند که روش ورود قدیمی و کم‌امن‌تر سرویس‌های برنامه در Synapse فعال باشد. این خطوط را در Settings زیر Advanced وارد کنید:
matrix_synapse_configuration_extension_yaml: |
use_appservice_legacy_authorization: true
هوک‌شات (matrix-hookshot)
از وب‌هوک‌ها، گیت‌هاب، گیت‌لب، JIRA و خوراک‌های RSS در اتاق‌ها پیام منتشر می‌کند.
ربات: @hookshot:example.org · تنظیمات: ندارد.
استفاده: یک اتاق بسازید، ربات را دعوت کنید، سطح Moderator به آن بدهید و
!hookshot help را بفرستید. برای نمونه !hookshot feed https://…/rss یک خوراک
را دنبال می‌کند و !hookshot webhook name نشانی‌ای در اختیارتان می‌گذارد که
می‌توانید به آن ارسال کنید.
مستندات ·
مستندات Hookshot
ایمیل با Postmoogle
یک اتاق را به صندوق ایمیل تبدیل می‌کند: ایمیلی که به یک نشانی فرستاده شود در اتاق دریافت می‌شود و می‌توانید از ماتریکس پاسخ دهید.
ربات: @postmoogle:example.org
تنظیمات: گذرواژه‌ی ربات (Bot password): به‌طور خودکار ساخته می‌شود.
رکورد DNS: برای دریافت ایمیل، یک رکورد MX برای matrix.example.org که به
matrix.example.org اشاره کند؛ برای ارسال ایمیل بدون افتادن در هرزنامه،
رکوردهای TXT از نوع SPF، DMARC و DKIM که در مستندات فهرست شده‌اند
(رکورد DKIM را ربات با !pm dkim به شما می‌دهد). درگاه‌های 25 و 587 باید باز
باشند.
استفاده: ربات را به یک اتاق دعوت کنید و !pm mailbox NAME را بفرستید: از این
پس ایمیل‌های ارسالی به NAME@matrix.example.org در آنجا دریافت می‌شوند.
!pm help باقی فرمان‌ها را فهرست می‌کند.
مستندات
پیامک (matrix-sms-bridge)
پیامک را از طریق یک تلفن اندرویدی که برنامه‌ی android-sms-gateway-server روی آن اجرا می‌شود ارسال و دریافت می‌کند.
تنظیمات: منطقه‌ی پیش‌فرض (default region، برای نمونه IR) و منطقه‌ی
زمانی (timezone، برای نمونه Asia/Tehran)، و gateway URL، username
و password برنامه‌ی تلفن. تنها اگر گواهی دروازه خودامضا است: مسیر فایل
.p12 truststore آن روی رایانه‌ی شما و گذرواژه‌ی آن.
استفاده: راهنمای کاربر را ببینید. مستندات
رله‌ی مش‌تستیک (Meshtastic relay)
اتاق‌های ماتریکس را به رادیوهای LoRa از نوع Meshtastic متصل می‌کند که بدون اینترنت و شبکه‌ی تلفن همراه، تا چند کیلومتر با یکدیگر ارتباط برقرار می‌کنند. هنگام قطع هر دو، کاربردی است.
تنظیمات:
- گذرواژه‌ی ربات (Bot password): به‌طور خودکار ساخته می‌شود.
- نوع اتصال (Connection type):
tcpبرای رادیویی که در شبکه‌ی شماست (وای‌فای)،serialبرای رادیویی که به سرور متصل است وbleبرای بلوتوث. - نشانی رادیو (Meshtastic node host): برای
tcp. - اتاق‌ها (Rooms): کدام اتاق با کدام کانال رادیو مرتبط است؛ نمونه‌ی آن
#meshtastic:example.orgرا به کانال0متصل می‌کند.
استفاده: اتاق‌ها را بسازید، ربات را به آن‌ها دعوت کنید؛ پیام‌ها در هر دو جهت منتقل می‌شوند. اطلاعات بیشتر در ویکی پروژه. مستندات