Як я Matrix налаштовував

Pavlo Kit

Pavlo Kit

— 1 min read
Як я Matrix налаштовував
Photo by Compare Fibre / Unsplash

Попередні вимоги

  • Сервер з Coolify.
  • Домен на Cloudflare.
  • Wildcard DNS: Запис A з іменем * (зірочка) який вказує на IP сервера, режим "Proxied" (помаранчева хмарка).
  • SSL/TLS: Режим Full (Strict) у налаштуваннях Cloudflare.

Крок 1: Встановлення сервера (Matrix)

  1. У Coolify створіть новий сервіс: Service → Matrix.
  2. Налаштування домену: Вкажіть URL: https://matrix.MYDOMAIN.cc
  3. Змінні оточення (Environment Variables): Змініть/додайте наступні змінні перед першим запуском:
    • SYNAPSE_SERVER_NAME: matrix.MYDOMAIN.cc
    • SYNAPSE_PUBLIC_BASEURL: https://matrix.MYDOMAIN.cc
    • SYNAPSE_ENABLE_REGISTRATION: false (Обов'язково, інакше сервер не запуститься через помилку конфігурації).
    • SYNAPSE_REPORT_STATS: yes
  4. Натисніть Save та Deploy. Очікуйте статус "Healthy".

Крок 2: Налаштування Федерації (Cloudflare Worker)

Це замінює редагування файлів конфігурації. Ми змушуємо Cloudflare відповідати на запити інших серверів замість Synapse.

  1. У Cloudflare перейдіть у Workers & Pages → Create Application → Create Worker.
  2. Назвіть його (напр. matrix-federation) і натисніть Deploy.
  3. Натисніть Edit Code, вставте цей JS-код (замініть домен на свій):
export default { async fetch(request) { const json = { "m.server": "matrix.MYDOMAIN.cc:443" }; return new Response(JSON.stringify(json, null, 2), { headers: { "content-type": "application/json;charset=UTF-8", "access-control-allow-origin": "*", }, }); }, };
  1. Натисніть Deploy (зверху справа).
  2. Поверніться до налаштувань воркера → Settings → Triggers.
  3. Додайте Route:
    • Route: matrix.MYDOMAIN.cc/.well-known/matrix/server
    • Zone: MYDOMAIN.cc

Перевірка: Перейдіть за адресою https://matrix.MYDOMAIN.cc/.well-known/matrix/server — ви маєте побачити JSON.

Крок 3: Створення Адміністратора

Оскільки реєстрація вимкнена, створюємо користувача через консоль.

  1. У Coolify відкрийте сервіс Synapse → вкладка Terminal.
  2. Дотримуйтесь інструкцій:
    • User: admin (або ваш нік)
    • Password: ваш_пароль
    • Make admin: yes

Натисніть Connect і виконайте команду:Bash

register_new_matrix_user -c /data/homeserver.yaml http://localhost:8008

Read more