Обзор развертывания Element на сервере¶

Предварительные требования¶

Для корректной работы приложения сервер должен соответствовать следующим требованиям:

Операционная система: Ubuntu.
Права доступа: права суперпользователя (root) для установки системных пакетов и управления Docker.
Сетевые параметры: открытые порты 80, 443 (HTTPS), 8448 (Federation) и 8008 (Synapse API).

Для работы сервиса используется динамически формируемый поддомен в зависимости от идентификатора сервера.

Параметр	Значение
Префикс	`element`
Домен	`hostkey.in`
Полный шаблон	`element{Server_ID_from_Invapi}.hostkey.in`

Все основные данные приложения сосредоточены в директории /opt/matrix.

/opt/matrix/files: рабочая директория приложения, включая конфигурацию Synapse (homeserver.yaml) и медиа-файлы.
/opt/matrix/schemas: директория для схем баз данных.
/root/nginx: конфигурационные файлы и compose-файл для прокси-сервера Nginx с поддержкой SSL.
/data/nginx/user_conf.d: пользовательские конфигурации виртуальных хостов Nginx.

Развертывание выполняется в несколько этапов:

Подготовка системы: Установка необходимых системных пакетов (ca-certificates, curl, gnupg, lsb-release).
Установка Docker: Если Docker не установлен, система автоматически добавляет официальный репозиторий Docker и устанавливает пакеты docker-ce, docker-ce-cli, containerd.io, docker-buildx-plugin и docker-compose-plugin.
Настройка окружения: Создание необходимых директорий в /opt/matrix с установкой прав доступа для пользователя Synapse (UID 991).
Развертывание контейнеров:
Генерация конфигурационных файлов (homeserver.yaml, element-config.json).
Запуск стека Docker Compose для основных сервисов приложения.
Настройка прокси и SSL: Развертывание Nginx через Docker для обеспечения работы по протоколу HTTPS с использованием сертификатов Let's Encrypt.

Директория /opt/matrix/files принадлежит пользователю с UID 991.
Конфигурационные файлы в /root/nginx имеют права 0644.
Docker-контейнеры работают в изолированных сетях, за исключением Nginx, который использует режим host для управления портами.

В качестве базы данных используется PostgreSQL 15 (Alpine).

Имя пользователя: synapse
Пароль: synapse
Метод подключения: Контейнеры взаимодействуют через внутреннюю сеть Docker по имени хоста db.
Хранение данных: Данные базы данных сохраняются в именованном томе postgres-data.

Приложение состоит из нескольких контейнеров, управляемых через Docker Compose.

Имя образа	Назначение	Порты	Тома (Volumes)	Политика перезапуска
`postgres:15-alpine`	База данных	-	`postgres-data:/var/lib/postgresql/data`	unless-stopped
`matrixdotorg/synapse:latest`	Matrix Homeserver	`8008:8008`	`./files:/data`	unless-stopped
`vectorim/element-web:latest`	Клиент Element	`127.0.0.1:8080:80`	`./element-config.json:/app/config.json`	unless-stopped

Имя образа	Назначение	Порты	Тома (Volumes)	Политика перезапуска
`jonasal/nginx-certbot:latest`	Nginx + SSL	host mode	`nginx_secrets:/etc/letsencrypt`, `/data/nginx/user_conf.d:/etc/nginx/user_conf.d`, `/usr/share/element-web:/usr/share/element-web:ro`	unless-stopped

Для обновления основного приложения необходимо выполнить следующие действия в директории /opt/matrix:

docker compose pull && docker compose up -d

Это позволит загрузить актуальные версии образов и перезапустить контейнеры.

Конфигурация Matrix: /opt/matrix/files/homeserver.yaml
Конфигурация Element: /opt/matrix/files/element-config.json
Данные базы данных: в Docker volume postgres-data.
Настройки Nginx: /root/nginx/compose.yml и файлы в /data/nginx/user_conf.d/.