Jawaban singkat
Bagaimana cara meng-hosting server Matrix di VPS?
Untuk meng-hosting server Matrix di VPS, pasang Synapse dari repositori apt Matrix.org, berikan database PostgreSQL, dan letakkan reverse proxy HTTPS di port 443 di depan port 8008-nya. Paket Gloam dari Gloamport, 2 vCPU, 4 GB RAM, 80 GB NVMe, 4 TB traffic pada $8.25 per bulan untuk masa 12 bulan, berukuran sesuai untuk keperluan itu.
Apa saja yang terlibat dalam instalasi Synapse?
| Bagian | Pengaturan | Alasan |
|---|---|---|
| Nama server | Domain dalam ID pengguna, misalnya example.com; tidak dapat diubah nanti | Identitas federasi |
| Paket | matrix-synapse-py3 dari packages.matrix.org | Paket milik Debian sendiri tidak tersedia untuk Debian 13 dan yang lebih lama |
| Penimpaan konfigurasi | /etc/matrix-synapse/conf.d/ | Pembaruan paket tidak meminta untuk mengganti konfigurasi Anda |
| Listener klien dan federasi | HTTP di localhost:8008 di belakang proxy | Proxy yang mengakhiri HTTPS |
| Database | PostgreSQL (psycopg2) | Dokumentasi menyebut SQLite hanya layak untuk pengujian |
| Port | 443 untuk klien; 8448 untuk federasi kecuali didelegasikan ke 443 | Keduanya harus dapat dijangkau dari internet |
| Paket | Gloam: 2 vCPU, 4 GB RAM, 80 GB NVMe, 4 TB traffic | Daftar paket Gloamport |
Harga diperiksa pada
Apa yang Anda butuhkan sebelum memasang server Matrix?
Anda memerlukan nama domain yang Anda kendalikan dan VPS dengan alamat IPv4 publik. Domain lebih penting daripada servernya: dokumentasi Synapse menyatakan bahwa nama server adalah bagian domain dari setiap ID pengguna, dan tidak dapat diubah nanti. Pilih sebelum Anda memasang.
VPS Gloamport disertai satu IPv4 dan satu IPv6 /64 di setiap paket, sehingga rekaman DNS dapat langsung mengarah ke sana. Domain tidak dijual di sini; belilah di tempat yang Anda pilih dan buat rekaman A untuk nama host yang akan Anda pakai. Hanya Linux: image Debian, Ubuntu, AlmaLinux, dan Rocky Linux. Tidak ada Windows. Sisihkan sekitar satu jam untuk DNS dan sertifikat, di luar instalasi itu sendiri.
Cara memasang Synapse di Debian 13 atau Ubuntu 24.04
Perintahnya mengikuti dokumentasi resmi Synapse. Jalankan sebagai root atau dengan sudo.
Arahkan DNS ke VPS
Buat rekaman A untuk matrix.example.com dengan alamat VPS (dan rekaman AAAA jika Anda memakai IPv6). Tunggu sampai nama itu dapat di-resolve sebelum meminta sertifikat.
Tambahkan repositori apt Matrix.org
Unduh kunci penandatanganan, tambahkan baris repositori, dan jalankan apt update, seperti pada blok kode pertama. Dokumentasi memberikan sidik jari kunci AAF9AE843A7584B5A3E4CD2BCF45A512DE2DA058; bandingkan dengan gpg sebelum Anda mempercayai kunci itu.
Pasang matrix-synapse-py3
Jalankan apt install matrix-synapse-py3 dan atur nama server saat diminta. Ubah pengaturan hanya melalui berkas di /etc/matrix-synapse/conf.d/.
Buat database PostgreSQL
Pasang PostgreSQL dan pustaka libpq5, lalu buat pengguna dan database dengan perintah pada blok kode kedua, dan arahkan Synapse ke sana dengan blok database yang ditampilkan di situ.
Letakkan reverse proxy di depan
Pasang web server, dapatkan sertifikat untuk nama host, dan teruskan /_matrix dan /_synapse/client ke localhost:8008 seperti pada blok kode ketiga. Atur x_forwarded: true pada listener 8008.
Buat pengguna Anda dan uji
Atur registration_shared_secret, mulai ulang Synapse, jalankan register_new_matrix_user, lalu masuk dari klien Matrix dengan alamat homeserver Anda.
sudo apt install -y lsb-release wget apt-transport-https
sudo wget -O /usr/share/keyrings/matrix-org-archive-keyring.gpg https://packages.matrix.org/debian/matrix-org-archive-keyring.gpg
echo "deb [signed-by=/usr/share/keyrings/matrix-org-archive-keyring.gpg] https://packages.matrix.org/debian/ $(lsb_release -cs) main" |
sudo tee /etc/apt/sources.list.d/matrix-org.list
sudo apt update
sudo apt install matrix-synapse-py3sudo apt install postgresql libpq5
sudo -u postgres createuser --pwprompt synapse_user
sudo -u postgres createdb --encoding=UTF8 --locale=C --template=template0 --owner=synapse_user synapse
# /etc/matrix-synapse/conf.d/database.yaml
database:
name: psycopg2
args:
user: synapse_user
password: CHANGE_ME
dbname: synapse
host: localhost
cp_min: 5
cp_max: 10# nginx: inside a server block that listens on 443 ssl for matrix.example.com
location ~ ^(/_matrix|/_synapse/client) {
proxy_pass http://localhost:8008;
proxy_set_header X-Forwarded-For $remote_addr;
proxy_set_header X-Forwarded-Proto $scheme;
client_max_body_size 50M;
}
# Synapse listener on port 8008, in homeserver.yaml or a conf.d file
listeners:
- port: 8008
type: http
x_forwarded: true
bind_addresses: ['127.0.0.1']
resources:
- names: [client, federation]# conf.d/registration.yaml (a random value, kept secret)
registration_shared_secret: "RANDOM_VALUE"
sudo systemctl restart matrix-synapse
register_new_matrix_user -c /etc/matrix-synapse/homeserver.yamlSeberapa besar server yang dibutuhkan homeserver Matrix?
Homeserver privat untuk beberapa orang cocok dengan paket menengah, dan federasi ke ruang publik besar adalah yang membuat beban tumbuh. Kami belum melakukan benchmark Synapse dan tidak memberikan jumlah pengguna. Gloamport mencantumkan Gloam sebagai paket untuk Server Matrix, Vaultwarden, dan SearXNG sekaligus: 2 vCPU, 4 GB RAM, 80 GB NVMe, 4 TB traffic, $8.25 per bulan untuk masa 12 bulan dan $16.50 untuk satu bulan.
Untuk obrolan tim dengan banyak ruangan, Night (4 vCPU, 8 GB RAM, 160 GB NVMe, 8 TB traffic, $13.50 per bulan untuk masa 12 bulan) dicantumkan untuk Relay yang sibuk, server chat tim, atau beberapa layanan.
Apakah federasi memerlukan port 8448?
Tidak, federasi dapat berjalan melalui port 443 jika Anda mendelegasikannya. Halaman reverse proxy Synapse menyatakan bahwa dengan delegasi melalui respons .well-known/matrix/server, port 8448 tidak perlu dibuka dan federasi memakai 443. Tanpa delegasi, port federasi default adalah 8448, jadi bukalah di firewall dan tambahkan blok server kedua yang mendengarkan di sana.
Klien dapat menemukan server Anda melalui berkas /.well-known/matrix/client yang disajikan di https://nama-server-anda/.well-known/matrix/client, yang menyebut homeserver di m.homeserver dengan base_url-nya. Klien browser juga memerlukan header CORS, dan public_baseurl Synapse sebaiknya membawa URL yang sama. Jalankan nama server pada domain polos hanya jika Anda dapat menyajikan berkas itu di sana.
Bagaimana cara menjaga keamanan server Matrix yang di-hosting sendiri?
Cadangkan kunci penandatanganan, database, dan penyimpanan media, serta jaga host tetap ter-patch. Dokumentasi memperingatkan bahwa kunci penandatanganan harus disimpan karena server lain bergantung padanya. Pesan di ruangan tanpa enkripsi ujung-ke-ujung tersimpan dan dapat dibaca di database di VPS Anda, sehingga enkripsi disk layak dipertimbangkan; Bisakah saya mengenkripsi disk VPS dengan LUKS? menjelaskan apa yang dilindungi dan tidak dilindungi oleh enkripsi disk.
Tidak ada paket yang menyertakan cadangan: simpan salinan Anda sendiri atas apa pun yang tidak boleh hilang. Menurut survei Gloamport terhadap 10 November 2026, 28 dari 49 penyedia tidak meminta dokumen identitas saat mendaftar, sehingga VPS dapat dibeli tanpa menyerahkan dokumen, tetapi keamanan server tetap menjadi tanggung jawab Anda: SSH hanya dengan kunci, seperti pada Bagaimana cara mengamankan SSH di VPS baru?.
Ringkasan
- Synapse dipasang dari packages.matrix.org sebagai matrix-synapse-py3.
- Nama server bersifat permanen; pilih domain terlebih dahulu.
- Gunakan PostgreSQL; dokumentasi menyebut SQLite hanya layak untuk pengujian.
- Teruskan /_matrix dan /_synapse/client ke localhost:8008 di belakang HTTPS.
- Delegasi memungkinkan federasi memakai port 443 alih-alih 8448.
- Gloam, $8.25 per bulan untuk masa 12 bulan, adalah paket yang sesuai.
- Cadangkan kunci penandatanganan, database, dan media; tidak ada paket yang menyertakan cadangan.
Meng-hosting server Matrix: pertanyaan umum
Apakah saya memerlukan nama domain untuk Matrix?
Ya. Nama server adalah bagian dari setiap ID pengguna dan diatur saat pemasangan. Ia tidak dapat diubah setelahnya, jadi daftarkan atau pilih domain sebelum Anda memasang.
Mengapa tidak memakai SQLite?
Dokumentasi Synapse menyatakan bahwa SQLite hanya layak untuk pengujian dan tidak boleh dipakai di produksi. Hampir semua instalasi sebaiknya memakai PostgreSQL.
Di mana saya menaruh pengaturan saya sendiri?
Dalam berkas di bawah /etc/matrix-synapse/conf.d/. Dokumentasi menganjurkan ini agar pembaruan paket tidak menanyakan apakah berkas konfigurasi Anda perlu diganti.
Bagaimana cara membuat akun pertama?
Jalankan register_new_matrix_user -c pada konfigurasi homeserver setelah Synapse berjalan. Perintah ini memakai registration_shared_secret, yang dapat digunakan siapa pun yang mengetahuinya untuk membuat akun, termasuk admin.
Bisakah saya menjalankan Matrix bersama layanan lain?
Ya, di paket Gloam atau yang lebih besar. Vaultwarden dan SearXNG berukuran kecil dibandingkan dengannya; lihat panduan self-hosting Vaultwarden.
Sumber (3)
- Dokumentasi Synapse: Petunjuk instalasi — Element / Matrix.org Foundation (checked 2026-11-10)
- Dokumentasi Synapse: Menggunakan reverse proxy dengan Synapse — Element / Matrix.org Foundation (checked 2026-11-10)
- Dokumentasi Synapse: Menggunakan Postgres — Element / Matrix.org Foundation (checked 2026-11-10)