Для установки на сервер начните с официального ocis_fullпримера Docker Compose от ownCloud для стабильной версии 8.2. Он включает в себя сервис Infinite Scale, обратный прокси-сервер и дополнительные сервисы для совместной работы в офисе; .envперед запуском настройте свои домены, отправитель SMTP и пути к данным в его файле docker compose up -d. Эта настройка предназначена для одного экземпляра и требует наличия общедоступных DNS-серверов и доступных портов для доверенных сертификатов Let's Encrypt. Для внутренней оценки без домена следуйте ограничениям на самоподписанные сертификаты, описанным ниже.
Перед установкой
Данная процедура соответствует руководству ownCloud по настройке Compose для Infinite Scale 8.2 в производственной среде , проверенному 9 октября 2026 года. Руководство ориентировано на Ubuntu LTS 24.04 или 22.04 с уже установленными Docker Engine и Docker Compose. Рекомендуется не менее 4–6 ГБ оперативной памяти. Для служб, включенных по умолчанию, требуется около 2,4 ГБ дискового пространства, не считая пользовательских файлов, журналов, резервных копий и будущего роста.
Выберите этот полный пример, если вы можете управлять DNS, правилами брандмауэра и хостом Linux. Он включает в себя не только основную файловую платформу; для оценки без использования домена ownCloud заявляет, что в настройке используются самоподписанные сертификаты.
- Хост: Ubuntu 24.04 LTS или 22.04 LTS с доступом по SSH и sudo.
- Сеть: домен, необходимые DNS-записи которого разрешаются в WAN-адрес сервера; разрешить входящие TCP-порты 22, 80 и 443 в брандмауэре и любом вышестоящем маршрутизаторе.
- Программное обеспечение: Docker Engine и плагин Compose. В Linux Docker описывает установку через свой репозиторий пакетов; после установки убедитесь, что Compose отвечает сообщением
docker compose version.
- Почта: для начала работы этого примера необходимо указать значение
SMTP_SENDER. Заполните остальные настройки SMTP, если хотите получать уведомления по электронной почте.
1. Установите Docker Compose и подготовьте хост.
Если Docker Engine уже установлен, установите плагин Compose, используя метод, описанный в официальных инструкциях Docker по установке Compose для вашего дистрибутива Linux . Для систем Ubuntu или Debian, где настроен репозиторий Docker, используется следующая команда установки пакета:
sudo apt-get update
sudo apt-get install docker-compose-plugin
docker compose version
Docker рекомендует использовать плагин и командную строку для текущих установок. При необходимости docker composeустановите Docker Engine, следуя официальным инструкциям для Ubuntu .
Перед загрузкой конфигурации укажите публичный IP-адрес хоста для домена или поддоменов, которые вы планируете использовать. Пример ownCloud требует OCIS_DOMAIN; он также может использовать COLLABORA_DOMAINи ONLYOFFICE_DOMAINпри настройке этих офисных служб. DNS-имена должны совпадать со значениями в .env. Убедитесь, что ваш маршрутизатор перенаправляет порты 80 и 443 на этот хост и что локальный брандмауэр разрешает их.
2. Получите официальный пример использования функции Compose.
Используйте ocis_fullкаталог из stable-8.2ветки официальных примеров развертывания ownCloud . Загрузите ZIP-архив на компьютер с браузером, перенесите его на сервер без графического интерфейса с помощью команды scpи распакуйте его в папку, /opt/compose/ocis/ocis_fullкак описано в руководстве ownCloud.
Сохраните текущий файл .envперед извлечением обновленной копии: ownCloud предупреждает, что файл может быть перезаписан. Выполняйте команды Compose из каталога проекта.
3. Настройка доменов, сертификатов, электронной почты и путей передачи данных.
Откройте /opt/compose/ocis/ocis_full/.envв текстовом редакторе. Сохраните имена переменных и синтаксис примера и редактируйте только те значения, которые подходят для вашей установки:
- Установите
OCIS_DOMAINимя хоста, которое будут вводить пользователи. Указывайте имена хостов Collabora или OnlyOffice только в том случае, если эти службы включены в примере.
- Для сервера, доступного из интернета, закомментируйте
INSECUREсоответствующую строку в соответствии с примером. Не оставляйте небезопасную настройку включенной для публичного использования.
- Укажите
TRAEFIK_ACME_MAILадрес электронной почты, который вы контролируете. Для первоначального тестирования сертификата укажите TRAEFIK_ACME_CASERVERтестовый сервер Let's Encrypt. Тестовые сертификаты не являются доверенными для обычного использования; они помогают проверить DNS и доступность перед запросом сертификатов для производственной среды.
- Установите этот параметр
SMTP_SENDER, даже если вы еще не настроили работающий почтовый ретранслятор. В официальном руководстве указано, что развертывание не начнется без него. Добавьте хост SMTP, порт, учетные данные, параметры аутентификации и безопасности, если они доступны; без других параметров почты экземпляр может запуститься, но не сможет отправлять уведомления.
- Проверьте
OCIS_DOCKER_IMAGEтеги изображений в примере. Не переключайтесь между каналами выпуска, следуя инструкциям по установке стабильной версии.
- Для производственного сервера рекомендуется назначать
OCIS_DATA_DIRи OCIS_CONFIG_DIRзапланированным путям к хосту на хранилище с достаточной емкостью и резервным копированием. По умолчанию используются управляемые Docker тома, что удобно, но ownCloud отмечает, что их расположение, снимки, резервное копирование, восстановление, сброс и миграция зависят от хранилища хоста Docker.
Ограничьте доступ к серверу и его конфигурационному файлу. Самоподписанный сертификат подходит только для внутренней оценки, а не для доверенного публичного развертывания.
Перед запуском контейнеров проверьте объединенную конфигурацию в каталоге проекта:
cd /opt/compose/ocis/ocis_full
docker compose config
Перед продолжением исправьте обнаруженные ошибки переменных или YAML-файлов. Эта команда отображает конфигурацию Compose для проверки; она не подтверждает работоспособность DNS, сертификатов, разрешений доступа к хранилищу или SMTP-подключения.
4. Запустите службы и завершите настройку сертификата.
Запустить стек в фоновом режиме:
docker compose up -d
Первый запуск загружает образы и запускает службы, поэтому он может занять больше времени, чем последующие перезапуски. Проверить состояние службы можно с помощью:
docker compose ps -a
Затем проверьте журналы, если служба завершила работу или веб-адрес не загрузился:
docker compose logs --follow
Начните с логов Traefik. Ошибки сертификатов обычно указывают на несоответствие DNS и .envзначений, заблокированные порты 80/443 или недействительный адрес электронной почты ACME. Устраните причину, прежде чем повторять попытку. Не используйте это docker compose down -vкак сброс: это удалит все тома проекта, включая данные.
Если проверка сертификатов на тестовой среде прошла успешно, следуйте процедуре ownCloud для работы с сертификатами: остановите развертывание, удалите только том сертификатов из примера ( ocis_full_certs), очистите настройки центра сертификации на тестовой среде и запустите снова, чтобы запросить доверенные сертификаты для производственной среды. Перед удалением подтвердите точное имя тома с помощью команды docker volume ls. Не удаляйте тома данных или конфигурации.
Проверьте доступ и защитите развертывание.
Откройте URL-адрес, указанный в файле OCIS_DOMAIN. В случае успешного входа в систему браузер переходит на страницу авторизации по протоколу HTTPS без предупреждения о сертификате и docker compose ps -aотображает работающие необходимые службы. Войдите в систему, используя исходные учетные данные, указанные ownCloud ( admin/ admin, если вы не установили другой исходный пароль), затем незамедлительно смените пароль администратора.
Если сайт недоступен, проверьте DNS, переадресацию портов, журналы ACME Traefik, а затем журналы службы Infinite Scale. Если вход в систему работает, но уведомления по электронной почте не приходят, проверьте настройки SMTP.
Перед сохранением важных файлов убедитесь, что резервная копия охватывает как конфигурацию, так и данные. Управляемые Docker тома удобны для оценки; явные пути к хосту проще разместить на отдельном диске и включить в резервные копии хоста. Вы будете готовы, когда HTTPS будет работать, службы останутся запущенными после перезапуска, вход в административную панель будет работать, а резервные копии будут охватывать выбранное хранилище.