Обзор развертывания Mastodon на сервере¶
Предварительные требования¶
Для корректной работы приложения необходимы следующие условия:
-
Операционная система: Ubuntu.
-
Установленный Docker и плагин
docker-compose-plugin. -
Наличие прав доступа для создания пользователя
mastodonс домашним каталогом/opt/mastodon. -
Открытые порты для веб-трафика (80, 443) и внутренних сервисов.
FQDN итоговой панели на домене hostkey.in¶
| Параметр | Значение |
|---|---|
| Префикс | mastodon |
| Домен | hostkey.in |
| Полный шаблон | mastodon{Server_ID_from_Invapi}.hostkey.in |
Структура файлов и каталогов¶
Основные директории приложения:
-
/opt/mastodon— рабочая директория приложения. -
/opt/mastodon/data/postgres— данные базы данных PostgreSQL. -
/opt/mastodon/data/redis— данные Redis. -
/opt/mastodon/public/system— пользовательские медиафайлы и системные данные Mastodon.
Конфигурационные файлы:
-
/opt/mastodon/.env.db— настройки подключения к базе данных. -
/opt/mastodon/.env.production— основные переменные окружения приложения. -
/data/nginx/user_conf.d/— конфигурации Nginx для проксирования трафика.
Процесс установки приложения¶
Развертывание выполняется путем автоматизированной настройки среды и запуска контейнеров:
-
Установка Docker и
docker-compose-plugin. -
Создание системного пользователя
mastodonи необходимых директорий с соответствующими правами доступа. -
Генерация секретных ключей приложения (Secret Key Base, OTP Secret) через запуск временных контейнеров.
-
Генерация ключей шифрования данных (Encryption Keys) и VAPID-ключей для Web Push уведомлений.
-
Создание конфигурационных файлов
.envна основе сгенерированных секретов. -
Запуск сервисов через Docker Compose.
-
Выполнение миграций базы данных.
-
Инициализация администратора (seed data).
Права доступа и безопасность¶
-
Для работы приложения используется выделенный пользователь
mastodon. -
Конфигурационные файлы с секретами (
.env.db,.env.production) имеют права доступа0600и принадлежат пользователюmastodon. -
Директории данных создаются с правами
0755. -
Доступ к базе данных внутри сети Docker ограничен параметрами окружения.
Базы данных¶
Для работы Mastodon используются две системы хранения:
-
PostgreSQL (версия 14-alpine): хранит основные данные приложения. Данные монтируются в локальную директорию
./postgres14. -
Redis (версия 7-alpine): используется для кэширования и управления очередями задач.
Контейнеры Docker и их запуск¶
Приложение разворачивается с использованием следующих контейнеров:
| Имя образа | Назначение | Порты | Тома (volumes) | Политика перезапуска |
|---|---|---|---|---|
jonasal/nginx-certbot:latest | Прокси-сервер и SSL | 80, 443 | nginx_secrets, /data/nginx/user_conf.d | unless-stopped |
postgres:14-alpine | База данных | 5432 (внутр.) | ./postgres14 | always |
redis:7-alpine | Кэш и очереди | 6379 (внутр.) | ./redis | always |
ghcr.io/mastodon/mastodon:v4.3.1 | Основное веб-приложение (web) | 3000 | ./public/system | always |
ghcr.io/mastodon/mastodon-streaming:v4.3.1 | Стриминг данных | 4000 | — | always |
ghcr.io/mastodon/mastodon:v4.3.1 | Обработчик фоновых задач (sidekiq) | — | ./public/system | always |
Инструкция по обновлению приложения¶
Для обновления основного приложения необходимо выполнить следующие действия в директории /opt/mastodon:
-
Обновить образы контейнеров:
-
Перезапустить сервисы для применения изменений:
Расположение конфигурационных файлов и данных¶
-
Конфигурация Docker Compose:
/opt/mastodon/docker-compose.yml -
Файлы переменных окружения:
/opt/mastodon/.env.production,/opt/mastodon/.env.db -
Данные PostgreSQL:
./postgres14(в директории приложения)
Доступные порты для подключения¶
-
3000— Веб-интерфейс Mastodon. -
4000— API стриминга. -
80/443— Стандартные HTTP/HTTPS порты (через Nginx).
Запуск, остановка приложения¶
Управление сервисами осуществляется через Docker Compose:
-
Запуск всех компонентов:
-
Остановка приложения:
-
Перезапуск сервисов:
Прокси серверы (Nginx, SSL, домены)¶
Для обеспечения работы по HTTPS используется Nginx с интеграцией Certbot.
-
Конфигурация проксирования настроена для поддержки стандартного HTTP-трафика и WebSocket-соединений (необходимы для стриминга).
-
Сертификаты SSL загружаются из внешнего тома
nginx_secrets. -
Настройка перенаправления с порта 80 на 443 выполняется автоматически.