Ръководство за инсталиране

Образът на Linux сървър

Изградете образа, подгответе сървъра и стартирайте контейнера на вашия домейн.

Изграждане на образа

Образът се изгражда на машината за разработка, с Docker Desktop в режим на Linux контейнери, и стига до сървъра като файл: сървърът не се нуждае нито от регистър, нито от изходния код.

  1. От корена на хранилището изпълнете .\rebuild_container_release.ps1 -NoSeedData: той изгражда образа, проверява, че не съдържа изходен код и че съдържа всяка компилирана част, стартира го за проба и го записва като deploy\docker\merydion-allinone.tar с неговия отпечатък.
  2. Копирайте образа и отпечатъка му на сървъра, например с scp deploy/docker/merydion-allinone.tar* admin@merydion.example.com:/tmp/.
  3. На сървъра проверете отпечатъка и заредете образа: cd /tmp && sha256sum -c merydion-allinone.tar.sha256 && docker load -i merydion-allinone.tar.

Съвет Без -NoSeedData компилацията пакетира и merydion-data.tar.gz с данните от машината за разработка — включително лични данни и частния ключ на услугата за влизане: това не е за нова инсталация.

Подготовка на сървъра

На сървъра запазете структурата на хранилището: compose файлът намира съседите си по относителен път. Файловете по-долу принадлежат на сървъра, никога на образа.

  1. Насочете DNS записа на домейна си към сървъра и отворете портове 80 и 443 към интернет.
  2. В deploy/prod-allinone/Caddyfile напишете истински имейл в глобалния блок: Let's Encrypt пише на него, преди да изтече сертификат.
  3. Създайте deploy/prod-allinone/.env с MERYDION_DOMAIN=merydion.example.com и, за да тръгват имейлите за потвърждение, MERYDION_AUTH_SMTP_PASSWORD=, последвано от паролата на пощенската кутия.
  4. Създайте SERVER_SECRETS.json в корена на хранилището, четим само от вас (chmod 600): там отиват другите тайни на услугите, а ако няма такива, съдържа { "services": {} } — без файла контейнерът не стартира.
  5. Напишете имейла си в ADMINISTRATORS, в корена на хранилището.

Съвет Тайна никога не се поставя в SERVER_CONFIGURATION.json, който е под контрол на версиите и държи тайните полета празни; променливата на поле има предимство пред SERVER_SECRETS.json.

Стартиране на контейнера

Контейнерът съдържа шлюза, услугите, портала и приложенията. Той стартира от заредения образ, без да изгражда нищо на сървъра.

  1. От корена на хранилището: docker compose --env-file deploy/prod-allinone/.env -f deploy/prod-allinone/docker-compose.yml up -d.
  2. Проверете, че работи: docker compose -f deploy/prod-allinone/docker-compose.yml ps трябва да показва running, а не restarting.
  3. При първото посещение Caddy получава сертификата, което отнема до минута: след това curl -sS https://merydion.example.com/health отговаря с ok.
  4. Ако контейнерът непрекъснато се рестартира, една услуга е спряла и е повлякла останалите: прочетете защо с docker compose -f deploy/prod-allinone/docker-compose.yml logs --tail=80.

Съвет Видеоразговорите на този сървър изискват и UDP порта на медийната услуга и TURN реле: ръководството за единичен възел в хранилището описва допълнителните настройки.

Обратно към ръководството

Производителност, made in Italy.

Предоставете целия пакет на екипа си — прост, сигурен и изцяло ваш.