Files
K3S/addons/nextcloud
Sergey Antropoff 38aaadbfb1 docs: sync addon docs with explicit external/internal service modes
Обновлена документация под новые аддоны (gitlab, redis, mongodb, kafka, kafka-ui, rabbitmq) и новую модель явного выбора зависимостей. Добавлены и унифицированы описания переключателей *_database_mode и *_redis_mode, обновлена таблица зависимостей аддонов, примеры конфигурации и список vault-секретов.
2026-04-29 23:21:04 +03:00
..

Nextcloud

Self-hosted файловое облако с веб-интерфейсом, мобильным и десктопным клиентами. Поддерживает интеграцию с PostgreSQL, Redis для кэширования и автоматический cron.

Быстрый старт

# group_vars/all/addons.yml
addon_nextcloud: true
nextcloud_ingress_host: "nextcloud.example.com"
nextcloud_ingress_tls: true

Секреты в vault.yml:

vault_nextcloud_admin_password: "secure-password"
vault_nextcloud_db_password: "db-password"   # если addon_postgresql: true
make addon-nextcloud

Параметры

Переменная Умолч. Описание
nextcloud_admin_username admin Логин администратора
nextcloud_ingress_host nextcloud.local Hostname
nextcloud_storage_size 20Gi PVC для файлов
nextcloud_redis_enabled true Redis для кэша (встроенный)
nextcloud_cronjob_enabled true Автоматический cron

Интеграция с PostgreSQL

Выбор задаётся переменной nextcloud_database_mode:

  • auto — внешняя PostgreSQL при addon_postgresql: true, иначе встроенная SQLite;
  • sqlite — всегда встроенная SQLite;
  • external_postgresql — всегда внешняя PostgreSQL (аддон postgresql или совместимый внешний сервис).

По умолчанию в аддоне стоит nextcloud_database_mode: external_postgresql (приоритет PostgreSQL).

Подключение клиентов

Настройки для Nextcloud Desktop/Mobile:

  • Сервер: https://nextcloud.example.com
  • Логин: admin

WebDAV

https://nextcloud.example.com/remote.php/dav/files/USERNAME/

Монтирование через WebDAV (Linux)

sudo mount -t davfs https://nextcloud.example.com/remote.php/dav/files/admin/ /mnt/nextcloud

Внешние хранилища

В Nextcloud Admin → External Storages можно подключить:

  • S3/MinIO
  • SFTP
  • WebDAV
  • NFS

occ — Nextcloud CLI

kubectl exec -n nextcloud deployment/nextcloud -- \
  php occ status

kubectl exec -n nextcloud deployment/nextcloud -- \
  php occ user:list

kubectl exec -n nextcloud deployment/nextcloud -- \
  php occ files:scan --all

Диагностика

kubectl logs -n nextcloud deployment/nextcloud -f
kubectl exec -n nextcloud deployment/nextcloud -- php occ check

Официальные ресурсы