# Як розгорнути сервер Matrix на VPS?

> Встановіть Synapse з пакетів Matrix.org на VPS класу 4 GB, $8.25 на місяць при 12-місячному терміні, з PostgreSQL та зворотним проксі.

- URL: https://gloamport.com/uk/guides/how-to-host-a-matrix-server/
- Останнє оновлення: 2026-11-10
- Видавець: Gloamport (https://gloamport.com)

Matrix — відкритий протокол чату, а Synapse — його еталонний сервер. Цей гайд встановлює Synapse з пакетів Debian проєкту та ставить зворотний проксі перед ним.

**Коротка відповідь — Як розгорнути сервер Matrix на VPS?**

Щоб розгорнути сервер Matrix на VPS, встановіть Synapse з репозиторію apt Matrix.org, дайте йому базу даних PostgreSQL і поставте HTTPS-зворотний проксі на порту 443 перед його портом 8008. Тариф Gloam від Gloamport, 2 vCPU, 4 GB RAM, 80 GB NVMe, 4 TB traffic за $8.25 на місяць при 12-місячному терміні, розрахований саме на це.

## Що включає встановлення Synapse?

| Частина | Параметр | Чому |
| --- | --- | --- |
| Ім'я сервера | Доменне ім'я в ID користувачів, наприклад example.com; пізніше змінити не можна | Федеративна ідентичність |
| Пакет | matrix-synapse-py3 з packages.matrix.org | Власного пакета Debian немає для Debian 13 і старіших |
| Перевизначення конфігурації | /etc/matrix-synapse/conf.d/ | Оновлення пакетів не запитують, чи замінювати вашу конфігурацію |
| Клієнтський і федеративний слухач | HTTP на localhost:8008 за проксі | Проксі завершує HTTPS |
| База даних | PostgreSQL (psycopg2) | Документація називає SQLite прийнятним лише для тестування |
| Порти | 443 для клієнтів; 8448 для федерації, якщо її не делеговано на 443 | Обидва мають бути доступні з інтернету |
| План | Gloam: 2 vCPU, 4 GB RAM, 80 GB NVMe, 4 TB traffic | Список тарифів Gloamport |

*Ціни перевірено 10 листопада 2026 р..*

## Що потрібно перед встановленням сервера Matrix?

Потрібні доменне ім'я, яким ви керуєте, і VPS з публічною IPv4-адресою. Домен важливіший за сервер: документація Synapse каже, що ім'я сервера є доменною частиною кожного ID користувача і його не можна змінити пізніше. Оберіть його до встановлення.

VPS Gloamport має одну IPv4-адресу та IPv6 /64 на кожному тарифі, тож записи DNS можна вказати прямо на нього. Домен тут не продається; купіть його там, де вам зручно, і створіть запис A для імені хоста, яке використаєте. Лише Linux: образи Debian, Ubuntu, AlmaLinux і Rocky Linux. Windows немає. Крім самого встановлення, закладіть близько години на DNS і сертифікат.

## Як встановити Synapse на Debian 13 або Ubuntu 24.04

Команди відповідають офіційній документації Synapse. Виконуйте їх від root або через sudo.

1. **Вкажіть DNS на VPS** — Створіть запис A для matrix.example.com з адресою VPS (і запис AAAA, якщо використовуєте IPv6). Дочекайтеся, поки він резолвиться, перш ніж запитувати сертифікат.
2. **Додайте репозиторій apt Matrix.org** — Завантажте ключ підпису, додайте рядок репозиторію та виконайте apt update, як у першому блоці коду. Документація наводить відбиток ключа AAF9AE843A7584B5A3E4CD2BCF45A512DE2DA058; перевірте його через gpg, перш ніж довіряти ключу.
3. **Встановіть matrix-synapse-py3** — Виконайте apt install matrix-synapse-py3 і задайте ім'я сервера, коли вас попросять. Змінюйте налаштування лише через файли в /etc/matrix-synapse/conf.d/.
4. **Створіть базу даних PostgreSQL** — Встановіть PostgreSQL і бібліотеку libpq5, потім створіть користувача та базу командами з другого блоку коду і вкажіть Synapse на неї блоком бази даних, показаним там.
5. **Поставте зворотний проксі попереду** — Встановіть веб-сервер, отримайте сертифікат для імені хоста і перенаправляйте /_matrix та /_synapse/client на localhost:8008, як у третьому блоці коду. Задайте x_forwarded: true для слухача 8008.
6. **Створіть свого користувача і перевірте** — Задайте registration_shared_secret, перезапустіть Synapse, виконайте register_new_matrix_user, а потім увійдіть з будь-якого клієнта Matrix, вказавши адресу вашого домашнього сервера.

*1. Репозиторій і пакет Matrix.org*

```bash
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-py3
```

*2. PostgreSQL: користувач, база і блок бази даних для Synapse*

```bash
sudo 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
```

*3. Зворотний проксі та слухач (location для nginx з документації Synapse)*

```text
# 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]
```

*4. Перший користувач*

```bash
# 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.yaml
```

> **Перевірте, що репозиторій підтримує вашу версію** Якщо apt update повідомляє, що для packages.matrix.org немає файлу Release для вашого кодового імені, зупиніться і скористайтеся іншими способами встановлення зі сторінки встановлення Synapse. Пакета Debian, який підтримує сам Debian, для Debian 13 немає.

## Скільки потужності потрібно домашньому серверу Matrix?

Приватному домашньому серверу для кількох людей підходить тариф середнього розміру, а навантаження зростає через федерацію з великими публічними кімнатами. Ми не тестували Synapse і не наводимо кількості користувачів. Gloamport пропонує тариф Gloam для Сервер Matrix, Vaultwarden і SearXNG разом: 2 vCPU, 4 GB RAM, 80 GB NVMe, 4 TB traffic, $8.25 на місяць при 12-місячному терміні і $16.50 при оплаті за один місяць.

Для командного чату з багатьма кімнатами Night (4 vCPU, 8 GB RAM, 160 GB NVMe, 8 TB traffic, $13.50 на місяць при 12-місячному терміні) рекомендовано для Завантажений релей, сервер командного чату або кілька сервісів.

## Чи потрібен порт 8448 для федерації?

Ні, федерація може працювати через порт 443, якщо її делегувати. Сторінка зворотного проксі Synapse зазначає, що при делегуванні через відповідь .well-known/matrix/server порт 8448 відкривати не потрібно, і федерація йде через 443. Без делегування стандартний порт федерації — 8448, тож відкрийте його в брандмауері й додайте другий блок сервера, що слухає на ньому.

Клієнти можуть знайти ваш сервер через файл /.well-known/matrix/client на https://ваше-ім'я-сервера/.well-known/matrix/client, який називає домашній сервер у m.homeserver з base_url. Браузерним клієнтам також потрібен заголовок CORS, а public_baseurl у Synapse має мати ту саму URL-адресу. Використовуйте голий домен як ім'я сервера, лише якщо можете віддавати цей файл саме там.

## Як зберегти безпеку власного сервера Matrix?

Робіть резервні копії ключа підпису, бази даних і сховища медіа та регулярно оновлюйте хост. Документація попереджає, що ключі підпису треба зберегти, бо на них покладаються інші сервери. Повідомлення в кімнатах без наскрізного шифрування лежать у базі даних на вашому VPS у читабельному вигляді, тож варто розглянути шифрування диска; [Чи можна зашифрувати диск VPS за допомогою LUKS?](https://gloamport.com/uk/guides/how-to-encrypt-a-vps-disk-with-luks/ "Чи можна зашифрувати диск VPS за допомогою LUKS?") пояснює, що шифрування диска захищає і чого не захищає.

Жоден тариф не містить резервних копій: зберігайте власну копію всього, що не можете втратити. За опитуванням Gloamport серед 10 листопада 2026 р., 28 з 49 провайдерів не вимагають документа, що посвідчує особу, під час реєстрації, тож VPS можна купити без передачі документів, але безпека сервера залишається вашою справою: вхід лише за ключем SSH, як у [Як захистити SSH на новому VPS?](https://gloamport.com/uk/guides/how-to-harden-ssh-on-a-vps/ "Як захистити SSH на новому VPS?").

**Підсумок**

- Synapse встановлюється з packages.matrix.org як matrix-synapse-py3.
- Ім'я сервера постійне; спершу оберіть домен.
- Використовуйте PostgreSQL; документація називає SQLite прийнятним лише для тестування.
- Проксіюйте /_matrix і /_synapse/client на localhost:8008 за HTTPS.
- Делегування дає федерації змогу використовувати порт 443 замість 8448.
- Gloam, $8.25 на місяць при 12-місячному терміні, — відповідний тариф.
- Робіть резервні копії ключів підпису, бази даних і медіа; жоден тариф не включає резервних копій.

## Хостинг сервера Matrix: поширені питання

### Чи потрібне доменне ім'я для Matrix?

Так. Ім'я сервера входить до кожного ID користувача і задається під час встановлення. Його не можна змінити пізніше, тож зареєструйте або оберіть домен перед встановленням.

### Чому не використовувати SQLite?

Документація Synapse каже, що SQLite прийнятний лише для тестування і не має використовуватися у продакшені. Майже всі інсталяції мають використовувати PostgreSQL.

### Де зберігати власні налаштування?

У файлах у /etc/matrix-synapse/conf.d/. Документація рекомендує так, щоб оновлення пакета не питало, чи замінювати файл конфігурації.

### Як створити перший обліковий запис?

Після запуску Synapse виконайте register_new_matrix_user -c на домашньому сервері з конфігурацією. Команда використовує registration_shared_secret: кожен, хто його знає, може створювати облікові записи, зокрема адміністраторів.

### Чи можна запускати Matrix поряд з іншими службами?

Так, на тарифі Gloam або більшому. Vaultwarden і SearXNG займають мало місця поряд з ним; див. гайд про [самостійний хостинг Vaultwarden](https://gloamport.com/uk/guides/how-to-self-host-vaultwarden/ "Як самостійно розмістити Vaultwarden на VPS?").

## Джерела

1. [Документація Synapse: інструкції зі встановлення](https://element-hq.github.io/synapse/latest/setup/installation.html) — Element / Matrix.org Foundation (checked 2026-11-10)
2. [Документація Synapse: використання зворотного проксі з Synapse](https://element-hq.github.io/synapse/latest/reverse_proxy.html) — Element / Matrix.org Foundation (checked 2026-11-10)
3. [Документація Synapse: використання Postgres](https://element-hq.github.io/synapse/latest/postgres.html) — Element / Matrix.org Foundation (checked 2026-11-10)

---

Gloamport: Gloamport — провайдер VPS, що продає Linux-сервери KVM без KYC. Замовлення оформлюється за номером облікового запису з оплатою криптовалютою, насамперед Monero; сервіс керується компанією DomaineGoat LLC, зареєстрованою в Панамі. Для замовлення потрібні тариф, монета і, лише якщо ви цього хочете, адреса email: без імені, поштової адреси, телефону і документа, що посвідчує особу. На терміні 12 місяців кожен тариф коштує щонайменше на 25% менше за названий порівнянний тариф із дослідження 38 VPS-хостів без KYC, що приймають криптовалюту, зчитаного 10 листопада 2026 року.
