Как установить Cloudron на VPS с Ubuntu
Пошаговое руководство по установке Cloudron на чистый VPS. Узнайте, как настроить wildcard DNS, запустить скрипт установки и избежать ошибок при выборе версии ОС Ubuntu.
Установка Cloudron на VPS: краткая версия
Для установки Cloudron на VPS требуется чистый сервер с Ubuntu, минимум 2 GB оперативной памяти и домен, для которого вы можете редактировать DNS-записи. Сама установка состоит из трёх команд и одной перезагрузки. Почти все возникающие проблемы связаны либо с этапом подготовки (неподходящий базовый образ, неподдерживаемый тип виртуализации), либо с последующей настройкой (DNS, почта, резервное копирование).
wget https://cloudron.io/cloudron-setup
chmod +x cloudron-setup
sudo ./cloudron-setupCloudron устанавливает, обновляет, выполняет резервное копирование и выпускает TLS (transport layer security) сертификаты для self-hosted приложений. Каждое приложение работает в Docker, перед всеми ними находится nginx, и каждое приложение получает собственный поддомен вашего домена. Именно из-за этой особенности настройка DNS выполняется в первую очередь.
Почему Cloudron требователен к базовой ОС
Установочный скрипт проверяет сервер перед началом установки, и если проверка не пройдена, потребуется новый сервер. Ознакомьтесь с требованиями до выбора образа. Проверки установщика, приведенные в этом разделе, актуальны на 13 октября 2026 года; текущая документация по установке требует чистый сервер Ubuntu 26.04.
- Только Ubuntu и только три версии. Любая другая ОС приводит к завершению работы с
Cloudron requires Ubuntu 22.04, 24.04, 26.04. Ubuntu 20.04 отклоняется, а документация по установке теперь требует чистый сервер Ubuntu 26.04. Debian, Rocky и Alpine не поддерживаются. Для Ubuntu 24.04 требуется Cloudron 8 или новее, скрипт проверяет это автоматически. - Только 64-битные процессоры Intel или AMD:
Error: Cloudron only supports amd64/x86_64. На ARM VPS установка невозможна. - Только полная аппаратная виртуализация. На VPS на базе контейнеров скрипт останавливается с
Error: Cloudron does not support lxc, only runs on bare metal or with full hardware virtualization, так как обнаруживает контейнер с помощьюsystemd-detect-virt --container. KVM подходит, OpenVZ и LXC — нет. - Корневая файловая система должна быть
ext4илиxfs. На любой другой вы получитеError: Cloudron requires '/' to be ext4 or xfs, именно так завершаются образы с btrfs и zfs. - Минимум 941 МБ оперативной памяти, измеряемой через
free -m, и 18 ГБ на/, измеряемой как размер корневой файловой системы. Сообщение об ошибке требует 20 ГБ, но сама проверка проходит при размере корневой файловой системы 19 ГБ. - Полностью чистый сервер. Если
nginx,dockerилиnodeуже установлены, скрипт выдает отказ сError: Some packages like nginx/docker/nodejs are already installed..
Последняя проверка вызывает больше всего споров, поэтому поясним причину. Cloudron устанавливает фиксированные версии Docker, nginx, Node.js и MySQL, самостоятельно записывает конфигурацию nginx для каждого размещаемого приложения и управляет правилами брандмауэра iptables. Docker, установленный вами ранее, будет иметь неверную версию, поэтому скрипт завершает работу без внесения изменений и требует начать с чистой установки Ubuntu. Cloudron берет на себя управление всей машиной, поэтому выделите под него отдельный VPS.
Еще одну проверку легко пропустить. На старых процессорах без поддержки AVX (advanced vector extensions) скрипт выводит CPU has no AVX support. MongoDB will be disabled, после чего любое приложение, требующее MongoDB, становится невозможно установить. Проверьте процессор перед началом работы с помощью grep -m1 -o avx /proc/cpuinfo: на подходящем хосте команда выводит avx, на старом — ничего.
Сколько оперативной памяти требуется для Cloudron?
Проверка установщика от 13 октября 2026 года отказалась запускаться при объеме менее 941 МБ с ошибкой Error: Cloudron requires atleast 1GB physical memory; текущая документация требует 2 ГБ оперативной памяти и 20 ГБ дискового пространства. Оба значения являются минимальным порогом для самой платформы, а не для платформы вместе с вашими приложениями. Cloudron запускает Docker, nginx, собственный сервис box и стек почтовых служб, а также разворачивает общие базы данных по мере установки приложений. Запустите docker ps на чистой установке и подсчитайте их количество.
Лимиты памяти приложений добавляются к этому базовому значению. Каждый пакет приложения поставляется с низким лимитом по умолчанию, который вы можете увеличить с помощью ползунка в представлении ресурсов приложения. Когда приложение превышает свой лимит, оно перезапускается и отправляет вам уведомление OOM (out of memory), поэтому сервер, который постоянно перезапускает одно и то же приложение, обычно сталкивается с проблемой лимитов, а не с ошибкой в коде.
Ниже приведены рекомендации по выбору конфигурации. Это советы для сервера, который вам не придется пересобирать в следующем месяце. Это не результаты замеров производительности.
Данные, на которых построен график
[
{
"label": "2 apps (free tier)",
"vcpu": 2,
"ram_gb": 4,
"disk_gb": 60
},
{
"label": "5 apps",
"vcpu": 4,
"ram_gb": 8,
"disk_gb": 120
},
{
"label": "10 apps",
"vcpu": 6,
"ram_gb": 16,
"disk_gb": 240
}
]Два приложения комфортно работают на 4 ГБ оперативной памяти и 60 ГБ дискового пространства. Около десяти приложений потребуют 16 ГБ и 240 ГБ, так как базовая нагрузка платформы не уменьшается, а каждое приложение добавляет Docker-образ, базу данных и собственные данные. Диск заполняется быстрее, чем ожидают пользователи: образы, данные приложений и локальные резервные копии используют один раздел, пока вы не перенесете бэкапы на другой носитель.
Cloudron предоставляет каждому приложению неограниченный swap, поэтому установленный вами лимит памяти применяется только к оперативной памяти. На образе VPS без файла подкачки команда swapon --show не выводит ничего, и нехватка памяти сразу приводит к перезапускам по OOM, вместо замедления работы приложения. Добавление 2 ГБ swap — это дешевая страховка, хотя она не заменяет реальную память. Разница в цене между тарифными планами VPS невелика по сравнению с часами, которые вы потратите на настройку лимитов, поэтому ознакомьтесь с тем, сколько на самом деле стоит VPS, и выберите тариф на ступень выше.
DNS: wildcard-запись, обеспечивающая работу поддоменов приложений
Cloudron размещает панель управления на my.example.com, а каждое приложение — на собственном поддомене, поэтому настройка DNS является обязательным предварительным условием. Укажите эти записи на публичный IP-адрес сервера до первого открытия панели управления:
my.example.comкак A-запись. Это адрес панели управления.*.example.comкак A-запись. Эта запись обеспечивает работу поддоменов приложений, поэтомуwiki.example.comиgit.example.comбудут разрешаться сразу после установки соответствующих приложений.example.comкак A-запись, только если вы хотите разместить приложение на основном домене.
Wildcard-запись имеет более низкий приоритет, чем явная запись, поэтому существующая www.example.com, указывающая на другой адрес, продолжит работать.
Во время настройки вы выбираете, как Cloudron будет управлять DNS в дальнейшем:
- API-провайдер. Cloudron хранит токен для Cloudflare, DigitalOcean, Route53, Hetzner, Porkbun, Linode, deSEC, Gandi, Namecheap, Hostinger DNS, Scaleway DNS и других (всего 22 интеграции DNS через API, исключая Wildcard, Manual и No-op), а затем самостоятельно записывает каждую запись, включая почтовые.
- Wildcard. Вы добавляете запись
*вручную, и Cloudron не вносит никаких изменений. - Manual. Cloudron показывает вам каждую запись и ожидает, пока вы добавите её перед установкой каждого отдельного приложения.
Wildcard DNS-запись — это не wildcard-сертификат. По умолчанию используется провайдер сертификатов Let's Encrypt Prod - Wildcard, который подтверждает владение доменом через DNS, поэтому он работает только с API-провайдером. В режимах Wildcard или Manual система Let's Encrypt выпускает индивидуальные сертификаты, проверяемые через HTTP, что требует открытого входящего 80-го порта для выпуска и продления. Вы можете отключить интеграцию с Let's Encrypt и загрузить собственный wildcard-сертификат, чтобы 80-й порт не требовался постоянно для проверки сертификатов. Если ваш регистратор или DNS-хостинг есть в списке API, используйте его: настройка почтовых записей и сертификатов перестанет быть вашей задачей.
Выполните проверку перед продолжением. dig +short my.example.com и dig +short anything.example.com должны возвращать IP-адрес вашего сервера. В режиме Wildcard, если wildcard-запрос ничего не возвращает, приложения впоследствии не будут работать, хотя панель управления будет функционировать нормально.
Если домен находится за Cloudflare, установите для записей режим DNS only. Прокси-сервер пересылает только HTTP и HTTPS, поэтому почтовые порты перестанут работать. Для проксируемых веб-приложений в разделе Network в Cloudron можно настроить доверие к опубликованным диапазонам IP-адресов Cloudflare, чтобы восстанавливать IP-адрес посетителя из пересылаемых заголовков.
Запуск скрипта установки
wget https://cloudron.io/cloudron-setup
chmod +x cloudron-setup
sudo ./cloudron-setupЗапускайте его от имени root или через sudo, так как в противном случае первым делом вы увидите сообщение This script should be run as root.. Установка занимает несколько минут и выполняется в фоновом режиме, так как вывод apt и процесс загрузки образов Docker перенаправляются в лог-файл. Отслеживайте процесс из второго SSH-сеанса:
tail -f /var/log/cloudron-setup.logВ версии установщика от 13 октября 2026 года выводится сообщение After reboot, visit one of the following URLs and accept the self-signed certificate to finish setup., за которым следует адрес сервера, после чего система запрашивает The server has to be rebooted to apply all the settings. Reboot now ? [Y/n]. Ответьте утвердительно. Этот же установщик предоставляет флаг --skip-reboot для отложенной перезагрузки.
Первый запуск: домен, DNS-бэкенд и учетная запись администратора
Откройте https://<server-ip> и примите предупреждение браузера. Сертификат является самоподписанным, так как Cloudron еще не знает ваш домен и не может запросить сертификат у центра сертификации. В Chrome нажмите Advanced, затем Proceed to <ip> (unsafe). В Firefox нажмите Advanced, затем Accept the Risk and Continue.
На первом экране потребуется ввести ваш домен. Введите example.com, и панель управления будет доступна по адресу my.example.com. Вы можете использовать поддомен, например cloudron.example.com, тогда панель управления будет находиться по адресу my.cloudron.example.com. Выберите DNS-бэкенд, вставьте API-токен, если он у вас есть, и создайте учетную запись администратора, используя адрес электронной почты, к которому у вас есть доступ: он используется для сброса пароля и получения уведомлений от платформы.
После сохранения настроек Cloudron запросит сертификаты и перенесет панель управления на https://my.example.com. URL-адрес с IP-адресом перестанет работать, поэтому сохраните новый адрес в закладки.
Сертификаты: что обновляется и когда процесс останавливается
Обновление сертификатов происходит автоматически в соответствии с ACME Renewal Information (ARI) — графиком, который публикует центр сертификации. На практике обновление выполняется примерно за месяц до истечения срока действия. При неудачной попытке обновления администратору отправляется уведомление по электронной почте, а при истечении срока действия сертификата система переключается на встроенный самоподписанный сертификат. Именно этот переход и вызывает предупреждение браузера на сайте, который еще вчера работал корректно.
В большинстве случаев проблема вызвана одной из двух причин. Для HTTP-валидации требуется открытый входящий порт 80, поэтому закрытие 80-го порта с аргументом «всё равно всё работает через HTTPS» блокирует обновление для приложений, использующих HTTP-валидацию Let's Encrypt для Wildcard-сертификатов или при ручной настройке DNS. Для DNS-валидации требуется API-токен с правами на запись, поэтому ротация или ограничение прав этого токена приводит к тому, что обновление перестает работать без видимых признаков до момента получения предупреждения по электронной почте.
В представлении Domains есть кнопка Renew All для принудительного запуска попытки обновления, а также провайдер Let's Encrypt Staging для тестирования. Сертификаты Staging намеренно не считаются доверенными в браузерах, в этом и заключается их назначение: тестирование позволяет не расходовать лимиты production-сервера. У среды Staging есть собственные ограничения, включая 200 ошибок авторизации на идентификатор для каждой учетной записи в час.
Стоит ли использовать встроенный почтовый сервер?
Cloudron поставляется с полным набором почтовых инструментов, включая почтовые ящики IMAP, службу отправки, фильтры sieve и подпись DKIM (DomainKeys Identified Mail). Вы можете включить их для каждого домена в разделе Email панели управления. Самая сложная часть — это доставка почты, и трудности здесь не связаны с Cloudron.
- Исходящий порт 25 заблокирован большинством провайдеров VPS для борьбы со спамом. Некоторые провайдеры открывают его после обращения в службу поддержки. Проверьте доступность с сервера с помощью
nc -zv aspmx.l.google.com 25(установитеnetcat-openbsd, если команда отсутствует). Открытый порт выдаст отчетsucceeded, а заблокированный порт будет ожидать ответа до истечения времени ожидания. - PTR-запись (обратный DNS) устанавливается вашим провайдером VPS, а не DNS-хостингом, и она должна совпадать с именем почтового хоста при прямой отправке с сервера. Использование smart host снимает требование к PTR-записи.
- Записи SPF, DKIM и DMARC создаются автоматически при использовании API DNS-бэкенда. При использовании Wildcard или ручного управления DNS их нужно добавлять вручную; отсутствие записи DKIM означает, что каждое подписанное вами сообщение будет невозможно проверить.
Конфигурация, которая подходит большинству пользователей: получение почты через Cloudron и отправка через релей, такой как SendGrid, Postmark, Mailgun или Amazon SES, настроенный в разделе Email. Релей должен разрешать отправку от имени любого адреса вашего домена, иначе уведомления приложений от разных отправителей будут отклоняться. Если почта — основная причина покупки сервера, разверните выделенный почтовый сервер, например Mailcow, на отдельном узле с собственной IP-репутацией.
Если вы вообще не используете почту Cloudron, заблокируйте порты 25, 465, 587, 993 и 4190 в брандмауэре вашего провайдера. Делайте это именно там, а не на сервере, так как Cloudron самостоятельно управляет правилами iptables и ожидает полного контроля над ними. Это отличается от обычного VPS, где вы самостоятельно управляете правилами ufw.
Настройте целевое хранилище для резервных копий заранее
По умолчанию резервные копии сохраняются в локальной файловой системе по пути /var/backups, на том же диске, где находятся остальные данные. Документация прямо предупреждает: «Хранение резервных копий на том же физическом диске, что и сервер платформы, небезопасно». Выход из строя одного диска приведет к потере и приложений, и их копий.
Откройте раздел Backups, затем Backup Sites и укажите другое местоположение в первый же день работы. Обычно для этого используют S3-совместимое объектное хранилище (Backblaze B2, Wasabi, Cloudflare R2, DigitalOcean Spaces или бакет MinIO на другом сервере), также поддерживаются SSHFS, NFS, CIFS и обычные файловые системы.
Три параметра определяют, будет ли резервная копия пригодна для использования:
- Формат.
tgzсоздает один сжатый архив для каждого приложения и при каждом запуске перезаписывает его целиком.rsyncзагружает только измененные файлы, что значительно выгоднее для больших экземпляров Nextcloud, но требует выполнения большего количества запросов к API хранилища. - Шифрование. Опциональное шифрование AES-256, охватывающее как содержимое файлов, так и их имена. Cloudron не хранит копию пароля, поэтому его потеря означает, что расшифровать резервные копии не сможет никто, включая вас. Сохраните пароль в собственном менеджере паролей перед тем, как нажать кнопку сохранения.
- Хранение. Указывается в виде количества, например 7 ежедневных и 4 еженедельных копии. Длительное хранение данных в объектном хранилище оплачивается ежемесячно, поэтому выбирайте значения, за которые вы готовы платить.
После этого протестируйте восстановление. Установите небольшое приложение, восстановите его через панель управления и убедитесь, что оно вернулось в рабочее состояние вместе со всеми данными. Резервная копия, которую никто никогда не восстанавливал, — это лишь предположение о наличии данных.
Ограничения бесплатного тарифа
По состоянию на октябрь 2026 года бесплатный тариф ограничен двумя установленными приложениями. В него включено всё остальное: обновления приложений, резервное копирование для каждого приложения, межсетевой экран, почтовый сервер и единый вход (SSO). Третье приложение — это момент, когда вам потребуется лицензия. Платные тарифы снимают ограничение на количество приложений, а более дорогой тариф добавляет группы пользователей и роли, сервер каталогов и возможность использования нескольких площадок для резервного копирования. Цены меняются, поэтому проверяйте страницу с ценами Cloudron, а не цифры в руководстве.
Лицензия покрывает одну установку Cloudron, поэтому два небольших сервера стоят в два раза дороже, чем один более крупный. Такая модель ценообразования подталкивает большинство пользователей к выбору одного более мощного VPS, что противоречит стандартной рекомендации распределять сервисы по разным машинам. Учитывайте это при выборе размера сервера, так как последующее разделение будет означать двойную оплату.
Что делать при сбоях
Начните со встроенной проверки. Она последовательно анализирует DNS, сертификаты, диск, память и каждый сервис, указывая, какой именно тест завершился неудачей:
sudo cloudron-support --troubleshootПосле этого воспользуйтесь стандартными инструментами systemd (менеджера системы и сервисов). systemctl status box предоставляет отчет о работе самого сервиса Cloudron, journalctl -u box -n 100 выводит его последние логи, а journalctl -u docker отвечает за состояние среды выполнения контейнеров. Все ошибки, возникшие в процессе установки, сохраняются в /var/log/cloudron-setup.log.
Если панель управления не загружается, проблема обычно кроется в DNS или сетевом экране провайдера, а не в самом Cloudron. Запустите dig +short my.example.com со своего ноутбука и убедитесь, что порты 80 и 443 открыты в сетевом экране провайдера, настройки которого независимы от правил самого сервера. В проверке установщика от 13 октября 2026 года повторный запуск отклонялся с ошибкой Error: Cloudron is already installed. To reinstall, start afresh; единственным корректным решением в этом случае является переустановка сервера с нуля.
Когда Cloudron не подходит
Cloudron подходит, если вам нужны готовые приложения, а не управление инфраструктурой. Он плохо сочетается с запуском собственных контейнеров по своему усмотрению, так как система управляет nginx, Docker и межсетевым экраном, перезаписывая любые внесенные вами изменения. Если вы планируете использовать набор файлов compose, Traefik перед вашими стеками Docker Compose обеспечит ту же автоматическую настройку TLS и маршрутизацию по поддоменам без установки дополнительной платформы. Если вы еще не сделали выбор, сравнение Cloudron, CasaOS и Coolify поможет сопоставить их возможности, а обширный список решений для self-hosting станет лучшей отправной точкой, чем руководство по установке.
FAQ
Сколько оперативной памяти требуется Cloudron на VPS?
Проверка установщика от 13 октября 2026 года не позволяла запуск при объеме менее 941 МБ; текущая документация требует 2 ГБ, но это минимальный порог для платформы без установленных приложений. Cloudron запускает Docker, nginx, собственный сервис box и почтовый стек, а также выделяет общие ресурсы баз данных по мере развертывания приложений. Планируйте 4 ГБ для двух приложений и 16 ГБ примерно для десяти, а также добавьте файл подкачки (swap), так как Cloudron предоставляет приложениям неограниченный доступ к swap, и сервер без него будет перезагружать процессы при нехватке памяти.
Можно ли установить Cloudron на Debian или на сервер, где уже работает Docker?
Это невозможно. В проверке установщика от 13 октября 2026 года скрипт останавливался на неподдерживаемых дистрибутивах с Cloudron requires Ubuntu 22.04, 24.04, 26.04 и отказывался работать на серверах, где уже присутствуют nginx, docker или node. Текущая документация по установке требует чистый образ Ubuntu и исключает Debian, Rocky и Alpine. Начинайте с чистого образа Ubuntu на KVM VPS.
Почему поддомены приложений не работают, хотя панель управления доступна?
При использовании Wildcard-бэкенда проверьте наличие wildcard-записи DNS. Установка создает или требует наличия A-записи для my.example.com, поэтому панель управления разрешается, в то время как wiki.example.com возвращает NXDOMAIN, и браузер сообщает, что сайт не найден. Добавьте A-запись для *.example.com, указывающую на IP-адрес сервера, затем подтвердите настройки с помощью dig +short wiki.example.com перед установкой приложения.
Обязательно ли использовать почтовый сервер Cloudron?
Нет. Вы можете отключить входящую почту и отправлять письма через внешний релей, такой как Postmark, Mailgun или Amazon SES. Это более безопасный выбор, если ваш провайдер блокирует исходящий 25 порт или IP-адрес не имеет установленной почтовой репутации. Если вы полностью отказываетесь от использования почты Cloudron, закройте порты 25, 465, 587, 993 и 4190 в фаерволе провайдера, а не на самом сервере.
Что произойдет при достижении лимита в два приложения на бесплатном тарифе?
Для установки третьего приложения потребуется платная подписка. Приложения, которые уже запущены, останутся нетронутыми: они продолжат обновляться, резервироваться и сохранят свои сертификаты. Оформление подписки снимает ограничение без необходимости переустановки чего-либо, поэтому бесплатный тариф — это подходящий способ протестировать платформу на реальном домене.