Статья 90 из 141
Гайды
Nextcloud на VPS: своё облачное хранилище через Nextcloud All-in-One (Docker)
Nextcloud — своё облако для файлов, календарей, контактов и заметок. Вы ставите его на VPS и синхронизируете файлы с компьютером и телефоном через официальные клиенты, как с Яндекс Диском или Google Drive, только данные лежат на вашем сервере.
Официально рекомендуемый способ установки — Nextcloud All-in-One (AIO). Это один «мастер-контейнер» в Docker, который сам скачивает и настраивает остальное: Nextcloud, PostgreSQL, Redis, веб-сервер с HTTPS, бэкапы на BorgBackup. По желанию добавляются Nextcloud Office, Talk, антивирус и полнотекстовый поиск. Бесплатно поддерживается до 100 пользователей.
Требования
Заголовок раздела «Требования»| Ресурс | Рекомендуем | Комментарий |
|---|---|---|
| CPU | 2 vCPU | архитектура x86_64 или arm64 |
| RAM | 4 ГБ | AIO по умолчанию даёт каждому процессу PHP до 512 МБ. Office и Talk добавляют нагрузку |
| Диск | сколько файлов планируете хранить, плюс запас | SSD или NVMe |
| ОС | Ubuntu 22.04 или 24.04 | KVM-виртуализация |
| Домен | обязателен | Nextcloud AIO не работает по IP и с самоподписанным сертификатом |
Официального минимума по RAM у AIO нет, цифры выше наш ориентир для одного-нескольких пользователей.
Главное здесь диск. Nextcloud хранит файлы, поэтому объём диска определяет, сколько данных влезет. Локальные бэкапы BorgBackup на том же диске займут ещё место. На NVMe-тарифах диск быстрый, но ограничен по объёму: прикиньте объём заранее (выбор тарифа), а при нехватке места смените тариф.
Порты, которые должны быть открыты:
| Порт | Назначение |
|---|---|
| 443/tcp | сам Nextcloud (443/udp для HTTP/3) |
| 80/tcp | выпуск сертификата и редирект на HTTPS |
| 8080/tcp | интерфейс AIO с самоподписанным сертификатом |
| 8443/tcp | интерфейс AIO с валидным сертификатом |
| 3478/tcp и 3478/udp | TURN-сервер Talk, только если включаете Talk |
Подготовка
Заголовок раздела «Подготовка»- Создайте A-запись, например
cloud.example.com, на IP сервера (DNS). Nextcloud нельзя поставить в подкаталог видаexample.com/cloud, нужен отдельный домен или поддомен. - Установите Docker из официального репозитория: Docker. Docker из snap AIO не поддерживает. Проверьте:
sudo docker info | grep "Docker Root Dir" | grep "/var/snap/docker/"Если команда вывела /var/snap/docker/, у вас snap-версия. Перенесите контейнеры, удалите её (sudo snap remove docker) и поставьте Docker по официальной инструкции.
Дальше выберите один из двух вариантов.
Вариант 1: без другого веб-сервера
Заголовок раздела «Вариант 1: без другого веб-сервера»Подходит, если на сервере нет Nginx или другого прокси. AIO сам займёт порты 80 и 443 и сам получит сертификат. Команда из официального README:
sudo docker run \ --init \ --sig-proxy=false \ --name nextcloud-aio-mastercontainer \ --restart always \ --publish 80:80 \ --publish 8080:8080 \ --publish 8443:8443 \ --volume nextcloud_aio_mastercontainer:/mnt/docker-aio-config \ --volume /var/run/docker.sock:/var/run/docker.sock:ro \ ghcr.io/nextcloud-releases/all-in-one:latestНе меняйте имя контейнера nextcloud-aio-mastercontainer и имя тома nextcloud_aio_mastercontainer: на них завязаны обновления и бэкапы. Окно с логами можно закрыть через Ctrl+C, контейнер продолжит работать.
Вариант 2: за существующим Nginx
Заголовок раздела «Вариант 2: за существующим Nginx»Если на сервере уже есть Nginx с другими сайтами, AIO встаёт за него. Порты 80 и 443 остаются у Nginx, а веб-сервер Nextcloud слушает 127.0.0.1:11000.
Сначала настройте Nginx. Файл /etc/nginx/sites-available/nextcloud (основан на примере из официальной документации AIO):
map $http_upgrade $connection_upgrade { default upgrade; "" "";}
server { listen 80; server_name cloud.example.com;
client_max_body_size 0; proxy_buffering off; proxy_request_buffering off; proxy_read_timeout 3610s;
location / { proxy_pass http://127.0.0.1:11000; proxy_set_header Host $host; proxy_set_header X-Forwarded-Host $host; proxy_set_header X-Forwarded-Proto $scheme; proxy_set_header X-Forwarded-For $remote_addr; proxy_http_version 1.1; proxy_set_header Upgrade $http_upgrade; proxy_set_header Connection $connection_upgrade; }}ln -s /etc/nginx/sites-available/nextcloud /etc/nginx/sites-enabled/nginx -t && systemctl reload nginxcertbot --nginx -d cloud.example.comclient_max_body_size 0 снимает лимит на размер загрузки, а таймаут 3610 секунд чуть больше таймаута самого Nextcloud. Подробнее о сертификатах: Let’s Encrypt.
Затем запустите AIO командой из документации по reverse proxy. APACHE_IP_BINDING=127.0.0.1 закрывает порт 11000 от внешнего мира, это подходит, когда Nginx стоит на том же сервере и ходит на 127.0.0.1:
sudo docker run \--init \--sig-proxy=false \--name nextcloud-aio-mastercontainer \--restart always \--publish 8080:8080 \--env APACHE_PORT=11000 \--env APACHE_IP_BINDING=127.0.0.1 \--env APACHE_ADDITIONAL_NETWORK="" \--env SKIP_DOMAIN_VALIDATION=false \--volume nextcloud_aio_mastercontainer:/mnt/docker-aio-config \--volume /var/run/docker.sock:/var/run/docker.sock:ro \ghcr.io/nextcloud-releases/all-in-one:latestЕсли порт 8080 уже занят, замените --publish 8080:8080 на --publish 8081:8080.
Первая настройка
Заголовок раздела «Первая настройка»- Откройте
https://IP_СЕРВЕРА:8080. Используйте именно IP, а не домен: из-за HSTS доступ по домену на этот порт позже может сломаться. Сертификат самоподписанный, примите предупреждение браузера. - AIO покажет пароль-фразу (passphrase). Сохраните её в менеджер паролей и войдите с ней.
- Введите домен
cloud.example.comи нажмите Submit domain. AIO проверит, что домен указывает на сервер и доходит до Nextcloud. - Выберите дополнительные компоненты (Office, Talk и другие). На небольшом VPS включайте только нужное.
- Нажмите Download and start containers и дождитесь запуска всех контейнеров.
- AIO покажет Initial Nextcloud username и Initial Nextcloud password. Войдите в Nextcloud по
https://cloud.example.comи смените пароль.
Пока Nextcloud работает, прямой вход в интерфейс AIO по пароль-фразе заблокирован. Чтобы попасть туда, войдите в Nextcloud как администратор и откройте https://cloud.example.com/settings/admin/overview: вверху будет кнопка входа в AIO.
Порт 8080 защищён пароль-фразой, но его всё равно лучше ограничить по IP. Учтите, что правила UFW не действуют на порты, опубликованные Docker, поэтому используйте внешний фаервол. Общие правила: настройка фаервола.
Клиенты
Заголовок раздела «Клиенты»Официальные приложения Nextcloud есть для Windows, macOS, Linux, Android и iOS (nextcloud.com/install). При входе укажите адрес https://cloud.example.com. AIO ограничивает загрузку одним куском 1 ГБ. Клиенты и веб-интерфейс грузят большие файлы частями, поэтому их этот лимит не касается.
В AIO встроен бэкап на BorgBackup: копии инкрементальные, сжатые и зашифрованные.
- В интерфейсе AIO в разделе бэкапов укажите каталог, например
/mnt/backup, или адрес удалённого Borg-репозитория. - Нажмите Create backup.
- Сохраните ключ шифрования, который покажет AIO. Без него восстановить данные нельзя.
- После первого бэкапа включите ежедневный бэкап. Там же можно включить автообновление контейнеров после бэкапа.
Бэкап включает базу, файлы и конфигурацию. Хранилища, подключённые через External storage, в него не входят. Локальный каталог на том же VPS не спасёт при потере сервера, поэтому используйте удалённый Borg-репозиторий или копируйте архив на другую машину: бэкапы.
Восстановление делается там же кнопкой Restore selected backup. На новом сервере достаточно архива и пароля шифрования.
Обновление
Заголовок раздела «Обновление»Обновления появляются в интерфейсе AIO в разделе контейнеров:
- Сделайте бэкап.
- Нажмите Stop containers.
- Если вышло обновление мастер-контейнера, появится кнопка его обновления. Обновите его.
- Нажмите Start and update containers.
Раз в день AIO проверяет обновления и присылает уведомление администраторам Nextcloud.
Команды occ
Заголовок раздела «Команды occ»sudo docker exec --user www-data -it nextcloud-aio-nextcloud php occ statusЧастые проблемы
Заголовок раздела «Частые проблемы»| Симптом | Причина и решение |
|---|---|
| Проверка домена не проходит | A-запись не указывает на сервер, закрыт 443 или Nginx не проксирует на 127.0.0.1:11000. Проверьте DNS и порты |
| Ошибка про internal или reserved ip-address | Домен резолвится во внутренний адрес. Проверьте A-запись, при необходимости добавьте --add-host cloud.example.com:ПУБЛИЧНЫЙ_IP в команду запуска |
Не открывается https://IP:8080 |
Порт закрыт фаерволом или занят. Смените на --publish 8081:8080 |
| Интерфейс AIO не пускает по пароль-фразе | Nextcloud запущен, прямой вход заблокирован. Используйте кнопку в /settings/admin/overview |
| Контейнеры AIO не запускаются на Ubuntu | Проверьте, не стоит ли Docker из snap (команда в разделе «Подготовка»). Snap-версия не поддерживается |
nginx -t пишет duplicate «$connection_upgrade» |
Такой map уже есть в другом конфиге. Удалите блок map из файла nextcloud |
| Загрузка обрывается с ошибкой 413 | В Nginx нет client_max_body_size 0 или стоит Cloudflare Proxy с лимитом 100 МБ |
| Закончилось место | Файлы и локальные бэкапы на одном диске. Перенесите бэкапы в удалённый репозиторий или увеличьте тариф, проверьте df -h |
Чтобы поменять параметры запуска (например, добавить --add-host), остановите и удалите мастер-контейнер (sudo docker stop nextcloud-aio-mastercontainer, затем sudo docker rm nextcloud-aio-mastercontainer) и запустите заново с исправленной командой. Данные при этом сохраняются. Ошибки Docker в целом: ошибки Docker.