Перейти к содержанию

Обзор развертывания 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 для проксирования трафика.

Процесс установки приложения

Развертывание выполняется путем автоматизированной настройки среды и запуска контейнеров:

  1. Установка Docker и docker-compose-plugin.

  2. Создание системного пользователя mastodon и необходимых директорий с соответствующими правами доступа.

  3. Генерация секретных ключей приложения (Secret Key Base, OTP Secret) через запуск временных контейнеров.

  4. Генерация ключей шифрования данных (Encryption Keys) и VAPID-ключей для Web Push уведомлений.

  5. Создание конфигурационных файлов .env на основе сгенерированных секретов.

  6. Запуск сервисов через Docker Compose.

  7. Выполнение миграций базы данных.

  8. Инициализация администратора (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:

  1. Обновить образы контейнеров:

    docker compose pull
    

  2. Перезапустить сервисы для применения изменений:

    docker compose up -d
    

Расположение конфигурационных файлов и данных

  • Конфигурация 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:

  • Запуск всех компонентов:

    docker compose up -d
    

  • Остановка приложения:

    docker compose down
    

  • Перезапуск сервисов:

    docker compose restart
    

Прокси серверы (Nginx, SSL, домены)

Для обеспечения работы по HTTPS используется Nginx с интеграцией Certbot.

  • Конфигурация проксирования настроена для поддержки стандартного HTTP-трафика и WebSocket-соединений (необходимы для стриминга).

  • Сертификаты SSL загружаются из внешнего тома nginx_secrets.

  • Настройка перенаправления с порта 80 на 443 выполняется автоматически.

question_mark
Я могу вам чем-то помочь?
question_mark
ИИ Помощник ×