Coolify — Хостинг с открытым исходным кодом

9 февраля 2026

Введение в Coolify

Coolify — это платформа с открытым исходным кодом для развёртывания приложений, баз данных и сервисов. Это отличная альтернатива платформам, таким как Vercel, Netlify или Heroku, которую можно установить на собственный сервер.

Основные возможности:

Возможность	Описание
🌐 Статические сайты	Развёртывание HTML/CSS/JS сайтов
🐳 Docker-контейнеры	Запуск приложений в контейнерах
🗄️ Базы данных	PostgreSQL, MySQL, MongoDB, Redis и другие
🔄 CI/CD	Автоматическая сборка и деплой
🔒 SSL сертификаты	Автоматическое получение Let's Encrypt
📊 Мониторинг	Отслеживание состояния ресурсов
🖥️ Управление сервером	Панель управления через веб-интерфейс

Преимущества Coolify:

Преимущество	Описание
💰 Бесплатно	Открытый исходный код
🔒 Приватность	Данные хранятся на вашем сервере
⚡ Простота	Удобный веб-интерфейс
🔧 Гибкость	Поддержка множества технологий
🚀 Автоматизация	Деплой из Git-репозитория

Установка Docusaurus в Coolify

Docusaurus отлично работает в Coolify как статический сайт. Coolify автоматически собирает проект и развёртывает его через Nginx или Caddy.

Требования:

Требование	Описание
Git-репозиторий	Проект Docusaurus на GitHub/GitLab
Сервер с Coolify	Установленная платформа Coolify
Открытые порты	80 (HTTP) и 443 (HTTPS)
Домен (опционально)	Для SSL сертификатов

Конфигурация для Docusaurus:

Параметр	Значение
Resource Type	Static Site
Build Pack	Static (авто)
Install Command	`npm install` или `yarn install`
Build Command	`npm run build` или `yarn build`
Publish Directory	`build`

Пошаговая инструкция

Шаг 1: Подготовка проекта

Убедитесь, что ваш проект Docusaurus готов к развёртыванию:

# Проверьте структуру проекта
ls -la
# Должны быть: docusaurus.config.js, package.json, src/, build/

# Проверьте package.json
cat package.json | grep -A 5 '"scripts"'
# Должны быть: "build": "docusaurus build"

Структура проекта Docusaurus:

my-docusaurus-site/
├── docusaurus.config.js    # Конфигурация сайта
├── package.json            # Зависимости и скрипты
├── src/                    # Исходный код
│   ├── pages/              # Страницы
│   └── components/         # Компоненты
├── static/                 # Статические файлы
│   └── img/                # Изображения
├── build/                  # Собранный сайт (автоматически)
└── docs/                   # Документация (если есть)

Шаг 2: Загрузка в Git-репозиторий

# Инициализируйте Git (если не сделано)
git init
git add .
git commit -m "feat: Initial Docusaurus project"

# Создайте репозиторий на GitHub
# Добавьте удалённый репозиторий
git remote add origin https://github.com/ВАШ_НИК/РЕПОЗИТОРИЙ.git

# Отправьте код
git push -u origin main

Шаг 3: Создание ресурса в Coolify

Войдите в панель Coolify
- Перейдите по адресу вашего Coolify сервера
- Введите логин и пароль
Создайте новый ресурс
- Нажмите кнопку "Create New Resource" или "+"
- Выберите тип ресурса: "Static Site"
Настройте репозиторий

Параметр Значение
Repository URL https://github.com/ВАШ_НИК/РЕПОЗИТОРИЙ.git
Branch main или master
Authentication Personal Access Token (при необходимости)

Параметр	Значение
Repository URL	`https://github.com/ВАШ_НИК/РЕПОЗИТОРИЙ.git`
Branch	`main` или `master`
Authentication	Personal Access Token (при необходимости)

Шаг 4: Конфигурация сборки

Настройте параметры сборки:

Resource Type: Static Site
Build Pack: Static (определяется автоматически)

Install Command:
npm install
# или
yarn install

Build Command:
npm run build
# или
yarn build

Publish Directory (папка вывода):
build

Пример конфигурации:

Параметр	Команда/Значение
Install Command	`npm install`
Build Command	`npm run build`
Publish Directory	`build`
Port	3000 (если нужен)

Шаг 5: Деплой

Проверьте все настройки
Нажмите "Save" или "Create"
Coolify начнёт сборку:
- Клонирует репозиторий
- Установит зависимости (npm install)
- Соберёт статические файлы (npm run build)
- Развернёт в папке build
Дождитесь завершения (статус "Running")

Статусы ресурса:

Статус	Описание
🟢 Running	Ресурс работает
🔴 Stopped	Ресурс остановлен
🟡 Deploying	Идёт развёртывание
❌ Failed	Ошибка развёртывания

Настройка домена и SSL

Добавление домена

Перейдите в настройки ресурса
Найдите секцию "Domains" или "FQDN"
Добавьте ваш домен: example.com или www.example.com
Нажмите "Save"

Настройка DNS:

Тип записи	Значение
A	IP-адрес сервера Coolify
CNAME	ссылка на домен (для поддоменов)

Автоматический SSL

Coolify автоматически настраивает HTTPS:

Добавьте домен в настройках
Добавьте DNS запись, указывающую на сервер
Coolify определит домен
Автоматически получит SSL сертификат от Let's Encrypt
Настроит перенаправление HTTP → HTTPS

Проверка SSL:

# Проверьте сертификат
curl -s -o /dev/null -w "%{http_code}" https://ваш-домен.com/

# Посмотрите детали сертификата
openssl s_client -connect ваш-домен.com:443 -servername ваш-домен.com

Проксирование через Cloudflare

Если используете Cloudflare:

Добавьте домен в Cloudflare
Настройте DNS запись (оранжевый облачок)
В Cloudflare включите:
- SSL/TLS: Full (strict)
- Always Use HTTPS: On
В Coolify добавьте Cloudflare IP в whitelist

Проблемы и решения

Проблема 1: Сборка не запускается

Симптом	Причина	Решение
Статус "Failed"	Неверная команда сборки	Проверьте `npm run build`
Ошибка `npm not found`	Node.js не установлен	Установите Node.js в Coolify
Ошибка прав доступа	Неверный токен	Обновите Personal Access Token

Решение:

Проверьте логи сборки в Coolify

Проверьте package.json:

{
  "scripts": {
    "build": "docusaurus build",
    "start": "docusaurus start"
  }
}

Проблема 2: Сайт не открывается

Симптом	Причина	Решение
404 ошибка	Неверная папка вывода	Установите `build`
403 ошибка	Права доступа	Проверьте chmod
Connection refused	Порт закрыт	Откройте порт в файрволе

Решение:

Проверьте Publish Directory: build
Проверьте содержимое папки:
```
ls -la build/
# Должен быть index.html
```

Проблема 3: Не обновляется контент

Симптом	Причина	Решение
Старая версия	Кэш браузера	Очистите кэш
Не видно изменений	Деплой не запустился	Перезапустите ресурс
Изображения не грузятся	Неправильные пути	Проверьте `/img/...`

Решение:

Нажмите "Redeploy" в Coolify
Очистите кэш браузера (Ctrl+Shift+Del)
Проверьте пути к изображениям

Проблема 4: SSL сертификат не выдаётся

Симптом	Причина	Решение
Ошибка Let's Encrypt	DNS не настроен	Добавьте A запись
Domain not found	Неправильный домен	Проверьте домен
Timeout	Порт закрыт	Откройте 443 порт

Решение:

Проверьте DNS:

dig ваш-домен.com
# Должен вернуть IP сервера

Проверьте порты:
```
nc -zv ваш-домен.com 443
```

Проблема 5: Ошибка Node.js версии

Симптом	Причина	Решение
SyntaxError	Старая версия Node.js	Обновите Node.js
Module not found	Несовместимые версии	Укажите версию в package.json

Решение:

Добавьте в package.json:

{
  "engines": {
    "node": ">=18.0.0"
  }
}

Полезные ссылки

Ресурс	Ссылка
Официальный сайт Coolify	coolify.io
Документация Coolify	docs.coolify.io
GitHub Coolify	github.com/coollabsio/coolify
Docusaurus	docusaurus.io
Let's Encrypt	letsencrypt.org

См. также:

Оглавление​

Введение в Coolify​

Установка Docusaurus в Coolify​

Пошаговая инструкция​

Шаг 1: Подготовка проекта​

Шаг 2: Загрузка в Git-репозиторий​

Шаг 3: Создание ресурса в Coolify​

Шаг 4: Конфигурация сборки​

Шаг 5: Деплой​

Настройка домена и SSL​

Добавление домена​

Автоматический SSL​

Проксирование через Cloudflare​

Проблемы и решения​

Проблема 1: Сборка не запускается​

Проблема 2: Сайт не открывается​

Проблема 3: Не обновляется контент​

Проблема 4: SSL сертификат не выдаётся​

Проблема 5: Ошибка Node.js версии​

Полезные ссылки​

Оглавление

Введение в Coolify

Установка Docusaurus в Coolify

Пошаговая инструкция

Шаг 1: Подготовка проекта

Шаг 2: Загрузка в Git-репозиторий

Шаг 3: Создание ресурса в Coolify

Шаг 4: Конфигурация сборки

Шаг 5: Деплой

Настройка домена и SSL

Добавление домена

Автоматический SSL

Проксирование через Cloudflare

Проблемы и решения

Проблема 1: Сборка не запускается

Проблема 2: Сайт не открывается

Проблема 3: Не обновляется контент

Проблема 4: SSL сертификат не выдаётся

Проблема 5: Ошибка Node.js версии

Полезные ссылки