Установка NextCloud (PostgreSQL + Nginx)

В этой шпаргалке я кратко покажу, как выполняется установка NextCloud – файлового сервера, который предоставляет возможность получения веб доступа к вашим файлам через веб интерфейс.

Предварительные требования

Полный перечень предварительных требований приведен в официальной документации.

Кратко основные требования я приведу ниже:

Параметр	Значение
Операционная система	Ubuntu 22.04 LTS (рекомендуется) Ubuntu 24.04 LTS Red Hat Enterprise Linux 9 (рекомендуется) Debian 12 (Bookworm) SUSE Linux Enterprise Server 15 openSUSE Leap 15.5 CentOS Stream
База данных	MySQL 8.0/8.4 (рекомендуется) or MariaDB 10.6/10.11 (рекомендуется)/11.4 Oracle Database 11g, 18, 21, 23 (для редакции Enterprise) PostgreSQL 13/14/15/16/17 SQLite (только для тестирования)
Веб сервер	Apache 2.4 с модулями mod_php или php-fpm (рекомендуется) nginx с модулем php-fpm
PHP	8.1 (устарело) 8.2 8.3 (рекомендуется) 8.4

Я, как обычно, буду использовать Ubuntu Server 22.04.

Подготовка сервера баз данных

Установим сервер PostgreSQL:

sudo apt install -y postgresql-14

Настроим автоматический запуск и проверим, что сервер запущен:

sudo systemctl enable --now postgresql
sudo systemctl status postgresql

Создадим отдельного пользователя и базу данных:

sudo -u postgres createuser --pwprompt ncuser
sudo -u postgres createdb -O ncuser ncdatabase

Подготовка сервера для установки NextCloud

Теперь подготовим сам сервер:

sudo apt-get install ca-certificates apt-transport-https software-properties-common
sudo add-apt-repository ppa:ondrej/php
sudo apt-get update
sudo apt install -y nginx php8.3-pgsql php8.3-gd php8.3-curl php8.3-mbstring php8.3-intl php8.3-gmp php8.3-bcmath php8.3-xml php8.3-imagick php8.3-zip php8.3-fpm

Проверим статус php-fpm:

sudo systemctl status php8.3-fpm.service

Установка NextCloud

Теперь перейдем непосредственно к установке NextCloud.

Сначала загрузим установщик сервера для коммунити редакции. Перейдите на сервер NextCloud и выполните загрузку дистрибутива:

wget https://download.nextcloud.com/server/releases/latest.tar.bz2

Распакуйте архив:

tar -xjvf latest.tar.bz2

Скопируем все файлы дистрибутива в корневую директорию nginx:

cp -r nextcloud/ /var/www

Теперь необходимо изменить владельца для всего каталога /data/nextcloud:

sudo chown -R www-data:www-data /var/www/nextcloud

Теперь необходимо выполнить настройки веб сервера nginx. Создадим конфигурационный файл для нашего сайта с NextCloud:

sudo nano /etc/nginx/sites-available/nc.itproblog.ru

Пример моего конфигурационного файла:

# Version 2024-07-17

upstream php-handler {
    #server 127.0.0.1:9000;
    server unix:/run/php/php8.3-fpm.sock;
}

# Set the `immutable` cache control options only for assets with a cache busting `v` argument
map $arg_v $asset_immutable {
    "" "";
    default ", immutable";
}

server {
    listen 80;
    listen [::]:80;
    server_name nc.iiproblog.ru;

    # Prevent nginx HTTP Server Detection
    server_tokens off;

    # Enforce HTTPS
    return 301 https://$server_name$request_uri;
}

server {
    listen 443 ssl http2;
    listen [::]:443 ssl http2;
    # With NGinx >= 1.25.1 you should use this instead:
    # listen 443      ssl;
    # listen [::]:443 ssl;
    # http2 on;
    server_name nc.itproblog.ru;

    # Path to the root of your installation
    root /var/www/nextcloud;

    # Use Mozilla's guidelines for SSL/TLS settings
    # https://mozilla.github.io/server-side-tls/ssl-config-generator/
    ssl_certificate     /etc/ssl/nginx/itproblog_wild_2025.crt;
    ssl_certificate_key /etc/ssl/nginx/iiproblog_wild_2025.key;

    # Prevent nginx HTTP Server Detection
    server_tokens off;

    # HSTS settings
    # WARNING: Only add the preload option once you read about
    # the consequences in https://hstspreload.org/. This option
    # will add the domain to a hardcoded list that is shipped
    # in all major browsers and getting removed from this list
    # could take several months.
    #add_header Strict-Transport-Security "max-age=15768000; includeSubDomains; preload" always;

    # set max upload size and increase upload timeout:
    client_max_body_size 100G;
    client_body_timeout 300s;
    fastcgi_buffers 64 4K;

    # Enable gzip but do not remove ETag headers
    gzip on;
    gzip_vary on;
    gzip_comp_level 4;
    gzip_min_length 256;
    gzip_proxied expired no-cache no-store private no_last_modified no_etag auth;
    gzip_types application/atom+xml text/javascript application/javascript application/json application/ld+json application/manifest+json application/rss+xml application/vnd.geo+json application/vnd.ms-fontobject application/wasm application/x-font-ttf application/x-web-app-manifest+json application/xhtml+xml application/xml font/opentype image/bmp image/svg+xml image/x-icon text/cache-manifest text/css text/plain text/vcard text/vnd.rim.location.xloc text/vtt text/x-component text/x-cross-domain-policy;

    # Pagespeed is not supported by Nextcloud, so if your server is built
    # with the `ngx_pagespeed` module, uncomment this line to disable it.
    #pagespeed off;

    # The settings allows you to optimize the HTTP2 bandwidth.
    # See https://blog.cloudflare.com/delivering-http-2-upload-speed-improvements/
    # for tuning hints
    client_body_buffer_size 512k;

    # HTTP response headers borrowed from Nextcloud `.htaccess`
    add_header Referrer-Policy                   "no-referrer"       always;
    add_header X-Content-Type-Options            "nosniff"           always;
    add_header X-Frame-Options                   "SAMEORIGIN"        always;
    add_header X-Permitted-Cross-Domain-Policies "none"              always;
    add_header X-Robots-Tag                      "noindex, nofollow" always;
    add_header X-XSS-Protection                  "1; mode=block"     always;

    # Remove X-Powered-By, which is an information leak
    fastcgi_hide_header X-Powered-By;

    # Set .mjs and .wasm MIME types
    # Either include it in the default mime.types list
    # and include that list explicitly or add the file extension
    # only for Nextcloud like below:
    include mime.types;
    types {
        text/javascript mjs;
        application/wasm wasm;
    }

    # Specify how to handle directories -- specifying `/index.php$request_uri`
    # here as the fallback means that Nginx always exhibits the desired behaviour
    # when a client requests a path that corresponds to a directory that exists
    # on the server. In particular, if that directory contains an index.php file,
    # that file is correctly served; if it doesn't, then the request is passed to
    # the front-end controller. This consistent behaviour means that we don't need
    # to specify custom rules for certain paths (e.g. images and other assets,
    # `/updater`, `/ocs-provider`), and thus
    # `try_files $uri $uri/ /index.php$request_uri`
    # always provides the desired behaviour.
    index index.php index.html /index.php$request_uri;

    # Rule borrowed from `.htaccess` to handle Microsoft DAV clients
    location = / {
        if ( $http_user_agent ~ ^DavClnt ) {
            return 302 /remote.php/webdav/$is_args$args;
        }
    }

    location = /robots.txt {
        allow all;
        log_not_found off;
        access_log off;
    }

    # Make a regex exception for `/.well-known` so that clients can still
    # access it despite the existence of the regex rule
    # `location ~ /(\.|autotest|...)` which would otherwise handle requests
    # for `/.well-known`.
    location ^~ /.well-known {
        # The rules in this block are an adaptation of the rules
        # in `.htaccess` that concern `/.well-known`.

        location = /.well-known/carddav { return 301 /remote.php/dav/; }
        location = /.well-known/caldav  { return 301 /remote.php/dav/; }

        location /.well-known/acme-challenge    { try_files $uri $uri/ =404; }
        location /.well-known/pki-validation    { try_files $uri $uri/ =404; }

        # Let Nextcloud's API for `/.well-known` URIs handle all other
        # requests by passing them to the front-end controller.
        return 301 /index.php$request_uri;
    }

    # Rules borrowed from `.htaccess` to hide certain paths from clients
    location ~ ^/(?:build|tests|config|lib|3rdparty|templates|data)(?:$|/)  { return 404; }
    location ~ ^/(?:\.|autotest|occ|issue|indie|db_|console)                { return 404; }

    # Ensure this block, which passes PHP files to the PHP process, is above the blocks
    # which handle static assets (as seen below). If this block is not declared first,
    # then Nginx will encounter an infinite rewriting loop when it prepends `/index.php`
    # to the URI, resulting in a HTTP 500 error response.
    location ~ \.php(?:$|/) {
        # Required for legacy support
        rewrite ^/(?!index|remote|public|cron|core\/ajax\/update|status|ocs\/v[12]|updater\/.+|ocs-provider\/.+|.+\/richdocumentscode(_arm64)?\/proxy) /index.php$request_uri;

        fastcgi_split_path_info ^(.+?\.php)(/.*)$;
        set $path_info $fastcgi_path_info;

        try_files $fastcgi_script_name =404;

        include fastcgi_params;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
        fastcgi_param PATH_INFO $path_info;
        fastcgi_param HTTPS on;

        fastcgi_param modHeadersAvailable true;         # Avoid sending the security headers twice
        fastcgi_param front_controller_active true;     # Enable pretty urls
        fastcgi_pass php-handler;

        fastcgi_intercept_errors on;
        fastcgi_request_buffering off;

        fastcgi_max_temp_file_size 0;
    }

    # Serve static files
    location ~ \.(?:css|js|mjs|svg|gif|ico|jpg|png|webp|wasm|tflite|map|ogg|flac)$ {
        try_files $uri /index.php$request_uri;
        # HTTP response headers borrowed from Nextcloud `.htaccess`
        add_header Cache-Control                     "public, max-age=15778463$asset_immutable";
        add_header Referrer-Policy                   "no-referrer"       always;
        add_header X-Content-Type-Options            "nosniff"           always;
        add_header X-Frame-Options                   "SAMEORIGIN"        always;
        add_header X-Permitted-Cross-Domain-Policies "none"              always;
        add_header X-Robots-Tag                      "noindex, nofollow" always;
        add_header X-XSS-Protection                  "1; mode=block"     always;
        access_log off;     # Optional: Don't log access to assets
    }

    location ~ \.(otf|woff2?)$ {
        try_files $uri /index.php$request_uri;
        expires 7d;         # Cache-Control policy borrowed from `.htaccess`
        access_log off;     # Optional: Don't log access to assets
    }

    # Rule borrowed from `.htaccess`
    location /remote {
        return 301 /remote.php$request_uri;
    }

    location / {
        try_files $uri $uri/ /index.php$request_uri;
    }
}

В конфигурационном файле выше есть несколько важных параметров:

Параметр	Значение
server в upstream php-handler	Путь к прослушиваемому порту или сокету php-fpm
ServerName	Имя, по которому сервер NextCloud будет доступен
ssl_certificate	Пусть к открытому ключу SSL сертификата
ssl_certificate_key	Пусть к закрытому ключу SSL сертификата
root в server	Корневая директория с файлами дистрибутива NextCloud

Добавляем сертификаты и конфигурируем необходимые разрешения на файлы SSL сертификатов:

sudo mkdir -p /etc/ssl/nginx/
sudo nano /etc/ssl/nginx/itproblog_wild_2025.crt
sudo nano /etc/ssl/nginx/itproblog_wild_2025.key
chown -R www-data:www-data  /etc/ssl/nginx/
chmod -R 400  /etc/ssl/nginx/

Сохраняем внесенные изменения и активируем сайт с NextCloud:

sudo ln -s /etc/nginx/sites-available/nc.iiproblog.ru /etc/nginx/sites-enabled/nc.itproblog.ru

Проверим конфигурацию nginx:

sudo nginx -t

Перезапускаем сервер nginx:

sudo systemctl restart nginx

Мы выполнили все шаги по подготовке и теперь можем продолжить установку через веб. Перейдите по имени, которое вы указали в конфигурационном файле:

https://nc.itproblog.ru

Отобразится стартовая страница мастера установки. Укажите параметры подключения к базе данных и расположение дистрибутива сервера NextCloud:

Дождитесь окончания процесса установки.

Установку рекомендуемых приложений я пропущу:

После завершения процесса установки вы должны попасть на главную страницу сервиса NextCloud:

Установка NextCloud завершена.