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

9 февраля 2026

Оглавление

1. Введение в Coolify
2. Пошаговая инструкция
3. Настройка домена и SSL
4. Проблемы и решения
5. Полезные ссылки

---

Введение в 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

1. Войдите в панель Coolify

   • Перейдите по адресу вашего Coolify сервера
   • Введите логин и пароль

2. Создайте новый ресурс

   • Нажмите кнопку "Create New Resource" или "+"
   • Выберите тип ресурса: "Static Site"

3. Настройте репозиторий

   Параметр	Значение
   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: Деплой

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

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

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

---

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

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

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

Настройка DNS:

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

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

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

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

Проверка SSL:

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

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

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

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

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

---

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

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

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

Решение:

1. Проверьте логи сборки в Coolify
2. Проверьте package.json:

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

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

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

Решение:

1. Проверьте Publish Directory: build
2. Проверьте содержимое папки:

   ls -la build/
   # Должен быть index.html

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

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

Решение:

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

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

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

Решение:

1. Проверьте DNS:

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

2. Проверьте порты:

   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

---

См. также:

• База знаний компании
• Инструменты создания баз знаний
• Искусственный интеллект в базе знаний