3 Components Administration fa
vvvomit edited this page 2026-10-30 04:44:29 +03:30
This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

مؤلفه‌ها · خانه · English

مدیریت سرور

پایش سرور، پشتیبان‌گیری در مکانی دیگر و پاک‌سازی. صفحه‌ی Manage خودِ interzone بسیاری از این موارد را بدون نصب چیزی فراهم می‌کند: Dashboard، Backups پایگاه داده، Alerts و Disk space. راهنمای نصب را ببینید.

روش افزودن هر یک: مؤلفه‌ها.

زبانه‌ی Administration

تنظیمات آن‌ها

پرومتئوس و گرافانا (Prometheus + Grafana)

نمودار همه چیز در طول زمان: پردازنده، حافظه، دیسک، شبکه، فعالیت و کندی Synapse، و پستگرس.

رکورد DNS: stats.example.org.

تنظیمات: کاربر مدیر گرافانا (Grafana admin user، یعنی admin) و password آن (به‌طور خودکار ساخته می‌شود؛ ctrl+r آن را نشان می‌دهد). این حساب تنها برای گرافاناست، نه یک حساب ماتریکس.

پس از استقرار: نشانی https://stats.example.org را باز کنید، وارد شوید و Dashboards را باز کنید: داشبوردهای Synapse، Node Exporter (خودِ سرور) و Postgres از پیش آنجا هستند.

نکته: هر کسی که این نمودارها را ببیند، می‌تواند درباره‌ی نحوه‌ی استفاده از سرور شما اطلاعات زیادی به دست آورد. گذرواژه را نزد خود نگه دارید. مستندات پلی‌بوک

گیرنده‌ی Alertmanager (Alertmanager receiver)

هشدارهای یک Alertmanager پرومتئوس را به اتاق‌های ماتریکس می‌فرستد. پلی‌بوک خودِ Alertmanager را نصب نمی‌کند؛ این مؤلفه برای کسانی است که آن را دارند. برای هشدارهای ساده بدون این ابزارها، از Manage › Alerts (A) استفاده کنید.

تنظیمات:

  • توکن ربات (Bot access token): متعلق به حسابی که برای آن ساخته‌اید (دریافت توکن ربات را ببینید).
  • نگاشت اتاق‌ها (Room mapping): یک نام برای هر اتاق: alerts: "!ROOMID:example.org". ربات را به هر اتاق دعوت کنید.

پس از استقرار: وب‌هوک Alertmanager را روی https://matrix.example.org/matrix-alertmanager-receiver-…/alert/alerts تنظیم کنید؛ نشانی کامل و یک نمونه پیکربندی در مستندات پلی‌بوک آمده است. مستندات پلی‌بوک

آمار استفاده (synapse-usage-exporter)

فقط Synapse. آمار استفاده‌ی Synapse (کاربران، اتاق‌ها، پیام‌ها در روز) را برای نمایش در نمودار گرافانا به معیارهای پرومتئوس تبدیل می‌کند. تنها همراه با Prometheus + Grafana سودمند است. مستندات پلی‌بوک

فشرده‌ساز خودکار (synapse-auto-compressor)

فقط Synapse. هر شب در نیمه‌شب، بزرگ‌ترین جدول‌های پایگاه داده‌ی Synapse را فشرده می‌کند تا پایگاه داده کندتر رشد کند. Manage › Compress Synapse's state همین کار را یک بار و به‌صورت دستی انجام می‌دهد. مستندات پلی‌بوک

پاک‌سازی سامانه (System cleanup)

ایمیج‌ها و کانتینرهای داکری را که دیگر هیچ سرویسی از آن‌ها استفاده نمی‌کند، هر روز پاک می‌کند تا به‌روزرسانی‌ها به‌تدریج دیسک را پر نکنند. Manage › Disk space همین کار را یک بار به‌صورت دستی انجام می‌دهد. برای دیدن آنچه پاک خواهد شد، روی سرور فرمان /matrix/system-cleanup/bin/cleanup-docker --dry-run را اجرا کنید. مستندات پلی‌بوک

پشتیبان‌گیری با Borg (BorgBackup)

پشتیبان کامل، رمزنگاری‌شده و بدون تکرار از کل سرور (/matrix و پایگاه داده) روی رایانه‌ای دیگر، هر شب حدود ساعت ۴. هفت نسخه‌ی روزانه، چهار نسخه‌ی هفتگی، دوازده نسخه‌ی ماهانه و دو نسخه‌ی سالانه نگه می‌دارد. Backups خودِ interzone تنها پایگاه داده را پوشش می‌دهد؛ این مؤلفه همه چیز، از جمله فایل‌ها، را پوشش می‌دهد.

پیش از شروع: مکانی برای نگهداری پشتیبان‌ها که با SSH در دسترس باشد: یک سرور دیگر یا یک فضای ذخیره‌سازی (Hetzner Storage Box، BorgBase، rsync.net و…). روی رایانه‌ی خود یک کلید برای آن بسازید و بخش عمومی آن را در آنجا اضافه کنید:

ssh-keygen -t ed25519 -N '' -f borg-key
cat borg-key.pub | ssh USER@HOST 'dd of=.ssh/authorized_keys oflag=append conv=notrunc'

تنظیمات:

  • مخزن‌ها (Repositories): ssh://USER@HOST/./matrix؛ در نخستین پشتیبان‌گیری ساخته می‌شود.
  • عبارت رمز (Encryption passphrase): به‌طور خودکار ساخته می‌شود. آن را در جای دیگری نیز یادداشت کنید: بدون آن، پشتیبان‌ها قابل خواندن نیستند.
  • کلید خصوصی (SSH private key): محتوای borg-key (نه .pub): خط اول تنها یک |، سپس خودِ کلید، با دو فاصله در ابتدای هر خط.

پس از استقرار: برای گرفتن یک پشتیبان در همین لحظه، روی سرور فرمان systemctl start matrix-backup-borg را اجرا کنید. بازگردانی با خودِ borg انجام می‌شود؛ مستندات نقش آن را ببینید. مستندات پلی‌بوک