Pilih nama server
Nama server yang terlihat oleh pengguna bisa sulit diubah nanti. Pahami delegasi dan record well-known yang digunakan oleh deployment Anda. Uji penemuan klien dan federasi, jangan menganggap login web yang berhasil membuktikan keduanya.
Gunakan stack yang didukung
Synapse umumnya menggunakan PostgreSQL untuk data produksi, dengan layanan pendukung bergantung pada skala dan konfigurasi. Ikuti rekomendasi upstream terkini. Jaga agar batas waktu worker, basis data, dan reverse proxy tetap kompatibel dengan beban.
Jaga klaim enkripsi tetap akurat
Enkripsi ujung ke ujung melindungi konten di ruang terenkripsi yang didukung antara klien yang berpartisipasi. Homeserver tetap dapat memproses metadata dan konten yang tidak terenkripsi. Cadangan kunci klien, verifikasi, dan pemulihan akun memerlukan penjelasan tersendiri.
Kelola instans
Batasi pendaftaran bila perlu, lindungi antarmuka administratif dan rahasia bersama, serta tetapkan retensi media dan peristiwa secara sengaja. Cadangkan basis data, konfigurasi, dan kunci penandatanganan secara konsisten, lalu uji pemulihan.
Uji klien dan jalur federasi secara terpisah
Klien seperti Element menjangkau API klien homeserver, sementara homeserver lain menggunakan penemuan dan endpoint federasi. Perubahan reverse-proxy dapat merusak satu sementara yang lain tetap berfungsi. Uji akun baru, ruang lokal, dan ruang terfederasi yang diotorisasi, lalu verifikasi perilaku enkripsi dan pemulihan dari klien.
Dokumentasi resmi: Panduan instalasi Synapse terkini
Simpan materi identitas yang tahan lama
Basis data bukanlah keseluruhan identitas homeserver. Pertahankan kunci penandatanganan serta konfigurasi dan rahasia yang relevan dengan cadangan yang konsisten. Periksa media eksternal dan riwayat mana yang disimpan dan tetapkan kebijakan yang sesuai untuk komunitas Anda. Pantau penyimpanan dan antrean pekerja sebelum pertumbuhan menjadi gangguan layanan.
Pisahkan nama akun dari endpoint hosting
Tentukan server_name Matrix sebelum pembuatan akun: itu menjadi bagian dari pengenal pengguna dan ruangan. Nama host web yang melayani Synapse dapat berbeda bila penemuan/delegasi dikonfigurasi dengan benar. Rencanakan penemuan klien dan penemuan server-ke-server, sertifikat yang valid, dan keluarga alamat yang benar-benar dapat dijangkau. Element adalah klien, bukan pengganti homeserver. Pertahankan rute administrator independen dan kontak pemulihan di luar homeserver.
- Pilih rilis Synapse yang didukung dan deployment PostgreSQL yang sesuai untuk produksi.
- Jaga database dan listener administratif tetap privat.
- Tentukan kebijakan pendaftaran dan federasi secara eksplisit.
Dokumentasi resmi: Instalasi Synapse · Delegasi Matrix
Bangun penemuan dan proxy sebagai bagian dari layanan
Buat konfigurasi untuk rilis yang dipilih, pertahankan kunci penandatanganan dan basis data, serta konfigurasikan proxy sesuai panduan resmi Synapse. Origin yang terlihat secara eksternal, header yang diteruskan, dan jalur permintaan harus sesuai. Jika delegasi digunakan, sajikan dokumen well-known yang diperlukan dari domain identitas. Jangan mengekspos port API internal mentah untuk mengatasi kesalahan proxy. Jauhkan rahasia pendaftaran dari konfigurasi klien browser.
Dokumentasi resmi: Proksi terbalik Synapse
Uji sesi klien dan sesi federasi
Buat akun uji, hubungkan klien yang didukung, kirim pesan lokal, dan unggah file kecil. Verifikasi penemuan klien secara independen dari penemuan federasi, lalu uji ruang dengan server lain yang diizinkan jika federasi dimaksudkan. Di ruang terenkripsi, lakukan verifikasi dan alur pemulihan kunci klien. Cadangan homeserver tidak otomatis memulihkan setiap kunci dekripsi yang dipegang klien. Jelaskan metadata mana yang disimpan server dan ruang mana yang terenkripsi.
# Discovery checks use your identity domain and HTTPS:
curl --fail https://example.com/.well-known/matrix/client
curl --fail https://example.com/.well-known/matrix/serverGunakan lokasi kesalahan untuk mempersempit perbaikan
Jika Element tidak dapat menemukan server, periksa respons well-known klien dan origin TLS. Jika perpesanan lokal berfungsi tetapi federasi gagal, periksa delegasi federasi, alamat yang dapat dijangkau, sertifikat, dan kebijakan. Kegagalan media berulang dapat melibatkan batas unggahan atau penyimpanan. Pertahankan basis data, media, konfigurasi, dan kunci penandatanganan secara konsisten; uji pemulihan tanpa federasi diaktifkan terlebih dahulu, agar latihan tidak membuat salinan identitas produksi yang bersaing.