Перейти к содержимому

Статья 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
  1. Создайте A-запись, например cloud.example.com, на IP сервера (DNS). Nextcloud нельзя поставить в подкаталог вида example.com/cloud, нужен отдельный домен или поддомен.
  2. Установите 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 по официальной инструкции.

Дальше выберите один из двух вариантов.

Подходит, если на сервере нет 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, контейнер продолжит работать.

Если на сервере уже есть 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 nginx
certbot --nginx -d cloud.example.com

client_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.

  1. Откройте https://IP_СЕРВЕРА:8080. Используйте именно IP, а не домен: из-за HSTS доступ по домену на этот порт позже может сломаться. Сертификат самоподписанный, примите предупреждение браузера.
  2. AIO покажет пароль-фразу (passphrase). Сохраните её в менеджер паролей и войдите с ней.
  3. Введите домен cloud.example.com и нажмите Submit domain. AIO проверит, что домен указывает на сервер и доходит до Nextcloud.
  4. Выберите дополнительные компоненты (Office, Talk и другие). На небольшом VPS включайте только нужное.
  5. Нажмите Download and start containers и дождитесь запуска всех контейнеров.
  6. 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: копии инкрементальные, сжатые и зашифрованные.

  1. В интерфейсе AIO в разделе бэкапов укажите каталог, например /mnt/backup, или адрес удалённого Borg-репозитория.
  2. Нажмите Create backup.
  3. Сохраните ключ шифрования, который покажет AIO. Без него восстановить данные нельзя.
  4. После первого бэкапа включите ежедневный бэкап. Там же можно включить автообновление контейнеров после бэкапа.

Бэкап включает базу, файлы и конфигурацию. Хранилища, подключённые через External storage, в него не входят. Локальный каталог на том же VPS не спасёт при потере сервера, поэтому используйте удалённый Borg-репозиторий или копируйте архив на другую машину: бэкапы.

Восстановление делается там же кнопкой Restore selected backup. На новом сервере достаточно архива и пароля шифрования.

Обновления появляются в интерфейсе AIO в разделе контейнеров:

  1. Сделайте бэкап.
  2. Нажмите Stop containers.
  3. Если вышло обновление мастер-контейнера, появится кнопка его обновления. Обновите его.
  4. Нажмите Start and update containers.

Раз в день AIO проверяет обновления и присылает уведомление администраторам Nextcloud.

Окно терминала
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.