jensoft/mainsail repository overview

⁠Mainsail - Веб-интерфейс для Klipper 3D принтера

Mainsail — это современный, минималистичный и функциональный веб-интерфейс для управления 3D принтерами на базе Klipper через Moonraker API.

⁠О проекте

Оригинальный репозиторий: https://github.com/mainsail-crew/mainsail⁠

Это зеркало/перезалив официального образа с GitHub Container Registry на Docker Hub для удобства использования без аутентификации.

⁠Описание

Mainsail предоставляет:

• 🖥️ Чистый, современный и минималистичный интерфейс
• 📊 Мониторинг принтера в реальном времени
• 🌡️ Управление температурой и нагревом
• 🎮 Интерактивное управление движением
• 📁 Работа с файлами G-code
• 🎥 Интеграция с веб-камерой
• 📈 Графики и статистика
• 🔧 Вкладка макросов и управления
• ⚙️ Полная настройка через UI
• 📱 Адаптивный дизайн для мобильных
• 🌍 Многоязычная поддержка

⁠Быстрый старт

⁠Установка образа

docker pull jensoft/mainsail:latest

⁠Запуск контейнера

docker run -d -p 8083:80 --add-host=host.docker.internal:host-gateway --name mainsail jensoft/mainsail:latest

⁠Доступ к интерфейсу

Откройте в браузере:

http://localhost:8083

⁠Подключение к принтеру

1. Откройте Mainsail в браузере
2. Нажмите на логотип Mainsail в левом верхнем углу
3. Выберите "Add Printer"
4. Введите адрес вашего Moonraker:
   • Host: 192.168.0.30 (IP адрес принтера)
   • Port: 7125 (порт Moonraker)
5. Нажмите "Save"

⁠Параметры запуска

⁠Примеры использования

Базовый запуск:

docker run -d -p 8083:80 --name mainsail jensoft/mainsail:latest

С пользовательским портом:

docker run -d -p 9001:80 --name mainsail jensoft/mainsail:latest

Затем откройте: http://localhost:9001

С Docker Compose:

version: '3.8'
services:
  mainsail:
    image: jensoft/mainsail:latest
    container_name: mainsail
    ports:
      - "8083:80"
    restart: unless-stopped

Запуск:

docker-compose up -d

⁠Требования

• Docker (установлен и запущен)
• Klipper с Moonraker на локальной сети
• Современный браузер (Chrome, Firefox, Safari, Edge)

⁠Поддерживаемые платформы

• ✅ Windows 10/11 с Docker Desktop
• ✅ Linux с Docker
• ✅ macOS с Docker Desktop
• ✅ Raspberry Pi

⁠Размер образа

~40-50 MB (легкий и быстро загружается)

⁠Управление контейнером

Остановить контейнер:

docker stop mainsail

Запустить остановленный контейнер:

docker start mainsail

Удалить контейнер:

docker rm mainsail

Просмотреть логи:

docker logs mainsail

Просмотреть статус:

docker ps | grep mainsail

⁠Особенности Mainsail

• Консоль Moonraker — отправка команд напрямую
• Управление экструдером — контроль температуры и скорости
• Калибровка — инструменты для Z-offset, bed leveling
• Рабочий стол — кастомизируемая главная страница
• История печати — отслеживание заданий и статистика
• Системная информация — данные о системе, обновления

⁠Версионирование

• latest — последняя стабильная версия из основной ветки

⁠Что такое Klipper и Moonraker?

• Klipper — это программное обеспечение для управления 3D принтерами
• Moonraker — это API сервер для Klipper с поддержкой WebSocket и HTTP

⁠Сравнение Mainsail и Fluidd

Выбор между ними зависит от предпочтений в интерфейсе — оба отличные решения!

⁠Поддержка и вопросы

Для вопросов и проблем:

• Официальный проект Mainsail: https://github.com/mainsail-crew/mainsail⁠
• Документация: https://docs.mainsail.xyz⁠
• Klipper документация: https://www.klipper3d.org/⁠
• Moonraker документация: https://moonraker.readthedocs.io/⁠

⁠Информация о перезаливе

Оригинальный образ: ghcr.io/mainsail-crew/mainsail:latest
Зеркало на Docker Hub: jensoft/mainsail:latest

Этот образ является прямым перезаливом официального образа из GitHub Container Registry для удобства использования без необходимости аутентификации.

⁠Лицензия

Mainsail распространяется под лицензией GPL-3.0. Подробнее: https://github.com/mainsail-crew/mainsail/blob/master/LICENSE⁠

Последнее обновление: 2026-02-13
Версия образа: latest
Статус: Активно поддерживается