Instalacja oraz konfiguracja nextCloud

Poniżej przepis, jak zainstalować oraz skonfigurować nextCloud na serwerze.

ports/pkg

Z wykorzystaniem własnego repozytroium pakietów wykonujemy instalację:

pkg install -y www/nextcloud pecl-redis pecl-memcached devel/pecl-APCu www/php72-opcache

Dodatkowe aplikacje

Jeżeli jest potrzeba, to można doinstalować dodatkowe "aplikacje", które są już w repozytroium paczek:

pkg install -y www/nextcloud-calendar www/nextcloud-contacts www/nextcloud-notes www/nextcloud-tasks

Więcej dodatków jest dostępne poprzez menu Ustawienia w samym nextCloud.

Utworzenie bazy danych

createuser -U pgsql -DEPS chmurek
createdb -U pgsql -E utf-8 -O chmurek cdnxcloud

Sprawdzenie uprawnień do config.php

Jeżeli po zalogowaniu wystąpi błąd "zapisu do katalogu config/", to trzeba sprawdzić uprawnienia:

chown -R www:www /usr/local/www/nextcloud/config/

Konfiguracja w panelu www

Po zalogowaniu do panelu należy wpisać konfigurację:

1. login administratora
2. hasło administratora
3. login do bazy danych
4. hasło do bazy danych
5. nazwa bazy danych

6. serwer bazy danych (domyślnie localhost, ale w przypadku jails trzeba odpowiednio zmodyfikować

Modyfikacje w config.php

W przypadku udostępniania nextCloud pod różnymi adresami, należy w pliku konfiguracyjnym zmodyfikować zmienną trusted_domains:

$CONFIG = array (
# [...]
  'trusted_domains' =>
  array (
    0 => 'cloud.bsdserwis.com',
    1 => 'cloud.codenix.pro',
    2 => 'cloud.codenix.pl',
  ),
# [...]
);

Dodatkowe ustawienia warte dopisania (domyślnie nie występują):

$CONFIG = array (
# [...]
  'loglevel' => 1,
  'maintenance' => false,
  'trashbin_retention_obligation' => 'auto',
  'skeletondirectory' => '/var/www/htdocs/virtuals/chmura/szkielet',
# [...]
);

Wsparcie dla redis/memcached

Zgodnie z zaleceniami nextcloud należy (nawet nie warto) ustawić caches dla operacji plikowych (w szczególności dla chmur mocno obociążonych), czy lokalnych. W tym celu należy skorzystać z redis oraz memcached. Po ich zainstalowaniu oraz uruchomieniu, należy zmodyfikować plik konfiguracyjny:

$CONFIG = array (
# [...]
  'memcache.local' => '\\OC\\Memcache\\APCu',
  'memcache.distributed' => '\\OC\\Memcache\\Memcached',
  'memcache.locking' => '\\OC\\Memcache\\Redis',
  'redis' => array(
        'host' => '127.0.0.1',
        'port' => 6379,
        'timeout' => 0.0,
        'password' => '', // Optional, if not defined no password will be used.
        'dbindex' => 0, // Optional, if undefined SELECT will not run and will use Redis Server's default DB Index.
   ),
  'memcached_servers' =>
  array (
    0 =>
    array (
      0 => '127.0.0.1',
      1 => 63751,
    ),
  ),
# [...]
);

crontab

W ustawieniach panelu administracyjnego należy ustawić wywoływanie zadań cron z crond. W tym celu należy utworzyć crontaba dla użytknextika www:

# --- definicje zmiennych lokalnych ----------------------------------------
#
NULL=/dev/null
LOC_PREFIX=/usr/local
SHELL=/bin/sh
PATH=/etc:/bin:/sbin:/usr/bin:/usr/sbin:/usr/local/bin
HOME=/var/log
LOC_PYTHON=/usr/local/bin/python2
DOW="`/bin/date +%w-%a`"

#
#minute hour    mday    month   wday    command
#
*/15    *       *       *       *       ${LOC_PREFIX}/bin/php ${LOC_PREFIX}/www/nextcloud/cron.php

Powiadomienia mailowe

W celu wysyłania powiadomień mailowych należy wpisać dane w panelu administratora. Zostaną one zapisane w pliku config.php jako:

$CONFIG = array (
# [...]
  'mail_smtpmode' => 'smtp',
  'mail_smtpsecure' => 'tls',
  'mail_sendmailmode' => 'smtp',
  'mail_smtpauthtype' => 'LOGIN',
  'mail_smtpauth' => 1,
  'mail_smtphost' => 'localhost.bsdserwis.com',
  'mail_from_address' => 'chmura',
  'mail_domain' => 'bsdserwis.com',
  'mail_smtpport' => '587',
  'mail_smtpname' => '__user__',
  'mail_smtppassword' => '__haslo__',
);

Należy przypisać adres nadawcy do istniejącej skrzynki mailowej.

Ustawienie w php.ini

W celu umożliwienia wysyłania większych plików (głównie upload) można ustawić następujące wartości w /usr/local/etc/php.ini:

; nextCloud wymaga, aby memory_limit nie był mniejszy
memory_limit = 512M

sys_temp_dir = /var/tmp/apache

upload_tmp_dir = /var/tmp/apache
upload_max_filesize = 5192M
max_file_uploads = 20

; post_max_size >= $upload_max_filesize
post_max_size = 5220M

Należy również pamiętać o ustawieniach dotyczących opcache (zgodnie z zaleceniami samego nextCloud):

; ustawienia dla opcache
[opcache]
opcache.enable=1
opcache.enable_cli=1
opcache.interned_strings_buffer=8
opcache.max_accelerated_files=10000
opcache.memory_consumption=128
opcache.save_comments=1
opcache.revalidate_freq=1

Dodanie schematu do LDAP

Został opublikowany [ 4 ], który dodaje atrybut dotyczący quota dla danego użytkownika (do wykorzystania w panelu php ldap admin). Po wgraniu pliku należy go dołączyć do konfiguracji serwera LDAP:

include         /usr/local/etc/openldap/schema/nextcloud.schema

Nie można zapomnieć o przeładowaniu samego demona slapd:

cd /usr/local/etc/openldap/
make

occ

nextCloud posiada program controler do różnych czynności konfiguracyjnych.

Dodanie zasobów zewnętrznych

Możliwe jest dodanie montowanie zasobów zewnętrznych. W tym celu uruchamiamy polecenie:

cd /usr/local/www/nextcloud
su -m www -c "php occ app:enable files_external"

Dodanie konfiguracji LDAP

cd /usr/local/www/nextcloud

# dodanie aplikacji dla użytknextików w LDAP
su -m www -c "php occ app:enable user_ldap"

Użytkownicy

Domyślnie użytkownicy są lokalni (zdefiniowani w bazie danych). Użytkownicy są przypiswani do grup (również lokalne). Dodatkowo użytkownik może być administratorem dla grupy swojej i/lub też innej.

Po zalogowaniu każdy z użytkowników może ustawić swój profil: zdjęcie, adres email (to ważne, upraszcza pracę z nextCloud).

Integracja z LDAP

Możliwe jest skonfigurowanie użytkowników w bazie OpenLDAP. W tym celu należy aktywować aplikację user_ldap (patrz poprzednia sekcja).

Utworzenie dedykowanego użytknextika LDAP

Warto w bazie LDAP utworzyć specjalne konto na potrzeby nextCloud. Być może będzie konieczność nadania jakiś specjalnych uprawnień dla tego konta. Dane tego konta należy wpisać do konfiguracji LDAP w panelu administratora (WebUI) lub za pomocą narzędzia occ.

Sprawdzenie/modyfikowanie konfiguracji LDAP

Za pomocą occ jest możliwe sprawdzenie ustawień dotyczących LDAP:

cd /usr/local/www/nextcloud
su -m www -c "php occ ldap:show-config"

A także ich modyfikowanie:

cd /usr/local/www/nextcloud
su -m www -c 'php occ ldap:show-config "" ldapEmailAttribute mail'

Pierwszym parametrem jest configID. Niemniej pierwsze utworzone za pomocą occ ldap:create-empty-config posiada... puste ID (nazwę). Dlatego jako pierwszy parametr podany jest pusty ciąg znaków.

Przykładowa konfiguracja

+-------------------------------+---------------------------------------------+
| Configuration                 | s01                                         |
+-------------------------------+---------------------------------------------+
| hasMemberOfFilterSupport      |                                             |
| homeFolderNamingRule          |                                             |
| lastJpegPhotoLookup           | 0                                           |
| ldapAgentName                 | uid=ocadmin,ou=admins,dc=firma,dc=local     |
| ldapAgentPassword             | ***                                         |
| ldapAttributesForGroupSearch  |                                             |
| ldapAttributesForUserSearch   |                                             |
| ldapBackupHost                |                                             |
| ldapBackupPort                |                                             |
| ldapBase                      | ou=nextcloud,dc=firma,dc=local              |
| ldapBaseGroups                | ou=nextcloud,dc=firma,dc=local              |
| ldapBaseUsers                 | ou=nextcloud,dc=firma,dc=local              |
| ldapCacheTTL                  | 600                                         |
| ldapConfigurationActive       | 1                                           |
| ldapDefaultPPolicyDN          |                                             |
| ldapDynamicGroupMemberURL     |                                             |
| ldapEmailAttribute            | mail                                        |
| ldapExperiencedAdmin          | 0                                           |
| ldapExpertUUIDGroupAttr       |                                             |
| ldapExpertUUIDUserAttr        |                                             |
| ldapExpertUsernameAttr        |                                             |
| ldapGidNumber                 | gidNumber                                   |
| ldapGroupDisplayName          | cn                                          |
| ldapGroupFilter               | (&(|(objectclass=posixGroup)))              |
| ldapGroupFilterGroups         |                                             |
| ldapGroupFilterMode           | 0                                           |
| ldapGroupFilterObjectclass    | posixGroup                                  |
| ldapGroupMemberAssocAttr      | memberUid                                   |
| ldapHost                      | dbs.ath.pl                                  |
| ldapIgnoreNamingRules         |                                             |
| ldapLoginFilter               | (&(|(objectclass=nextcloudUser))(uid=%uid)) |
| ldapLoginFilterAttributes     |                                             |
| ldapLoginFilterEmail          | 0                                           |
| ldapLoginFilterMode           | 1                                           |
| ldapLoginFilterUsername       | 1                                           |
| ldapNestedGroups              | 0                                           |
| ldapOverrideMainServer        |                                             |
| ldapPagingSize                | 500                                         |
| ldapPort                      | 389                                         |
| ldapQuotaAttribute            | nextcloudQuota                              |
| ldapQuotaDefault              | 25GB                                        |
| ldapTLS                       | 0                                           |
| ldapUserAvatarRule            | default                                     |
| ldapUserDisplayName           | displayName                                 |
| ldapUserDisplayName2          |                                             |
| ldapUserFilter                | (|(objectclass=nextcloudUser))              |
| ldapUserFilterGroups          |                                             |
| ldapUserFilterMode            | 1                                           |
| ldapUserFilterObjectclass     | inetOrgPerson                               |
| ldapUuidGroupAttribute        | auto                                        |
| ldapUuidUserAttribute         | auto                                        |
| turnOffCertCheck              | 0                                           |
| turnOnPasswordChange          | 0                                           |
| useMemberOfToDetectMembership | 1                                           |
+-------------------------------+---------------------------------------------+

Dodanie grup do bazy OpenLDAP

Jeżeli dodawanie użytkowników do bazy OpenLDAP będzie wykonywane za pomocą panelu php ldap admin, to należy najpierw dodać potrzebne grupy użytkowników. W tym celu należy założyć obiekty typu posixGroup

Dodanie użytkowników do bazy OpenLDAP

Po wykonaniu konfiguracji można zacząć dodawać użytkowników do bazy OpenLDAP z wykorzystaniem php ldap admin. Przykładowy użytkownik wygląda następująco:

dn: cn=Stryjek Krzysztof,ou=users,ou=nextcloud,dc=firma,dc=local
cn: Stryjek Krzysztof
displayname: Stryjek Krzysztof
gidnumber: 500
givenname: Krzysztof
homedirectory: /home/users/kstryjek
jpegphoto:: /9j/4AAQSkZJRgABAQEBLAEsAAD/2wBDAAMCAgMCAgMDAwMEAwMEBQgFBQQEBQoH
 BwYIDAoMDAsKCwsNDhIQDQ4RDgsLEBYQERMUFRUVDA8XGBYUGBIUFRT/2wBDAQMEBAUEBQkFBQk
 [...]
mail: wtps0n@bsdserwis.com
nextcloudquota: 250GB
objectclass: inetOrgPerson
objectclass: posixAccount
objectclass: nextcloudUser
objectclass: top
sn: Stryjek
uid: kstryjek
uidnumber: 1000
userpassword: {SSHA}5v4JdCbTXT5wpJHB0hCta5jIHlToNl2V

Konfiguracja zasobów zewnętrznych

Zaoby zewnętrzne pozwalają na korzystanie z innych filesystemów bez konieczności trzymania ich historii w bazie danych czy też synchronizacji przez klienta OC.

Lokalny filesystem

Ze względów bezpieczeństwa zostaje coraz mocniej ograniczany - kwestie bezpieczeństwa danych, uprawnień etc. Można korzystać z niego, ale już nie ma możliwości dalszego udostępniania go (nawet lokalnym użytkownikom OC).

Aby móc z niego korzystać należy w pliku /usr/local/www/nextcloud/config/config.php dodać opcję:

$CONFIG = array (
  # [...]
  'files_external_allow_create_new_local' => true,
);

SMB/CIFS

Można udostępniać dalej zasoby zewnętrzne zamontowane za pomocą SAMBA. W tym celu konieczne jest zainstalowanie modułu php oraz skonfigurowanie smbclient.

Instlacja dodatkowych pakietów

Za pomocą własnego repozytorium pakietów należy zainstalować moduł php:

pkg install -Uy net/pecl-smbclient

Konfiguracja smb4.conf

Należy wykonać konfigurację klienta samba , tak aby można było swobodnie porozumieć się z serwerem samba4.x¹.

Sprawdzenie poprawności konfiguracji

Za pomocą narzędzia smbclient należy sprawdzić poprawność podłączenia do zasobu zdalnego:

smbclient -U użytkownik //serwer/zasob

Konfiguracja w ustawieniach OC

Po zalogowaniu się jako administrator w panelu webowym należy przejść do Ustawienia -> (Adminsitrator) Magazyn należy skonfigurować nowy zasób SMB:

Konfiguracja nginx

Za pomocą własnego repozytorium konfiguracji należy wgrać plik 012-nextcloud.conf. Konfiguracja zawarta w tym pliku zawiera już definicje nagłówków (bezpieczeństwo), dostępu do plików itd. Konfiguracja samego wirtualnego hosta jest wtedy bardzo krótka (na przykładzie chmury BSD Serwis):

# --- definicja serwera HTTPS ----------------------------------
#
server {
    listen 188.165.252.223:443 http2 ssl;
    listen [2001:41d0:2:c7df::1]:443 http2 ssl;
    server_name cloud.bsdserwis.com;

    ssl_certificate      certs/cloud.bsdserwis.com.chained.pem;
    ssl_certificate_key  certs/cloud.bsdserwis.com.key;
    ssl_dhparam          certs/cloud.bsdserwis.com.2048.dh.pem;
    ssl_prefer_server_ciphers on;
    ssl_stapling on;
    ssl_stapling_verify on;

    # logowanie
    access_log /var/log/nginx/cloud.bsdserwis.com/access.log main;
    error_log /var/log/nginx/cloud.bsdserwis.com/error.log;

    include 012-nextcloud.conf;

    include 000-cmsploit.conf;
    include 004-dot-ht.conf;
    include 004-err-page-404.conf;
    include 004-err-page-5xx.conf;
    include 004-pillaging-dvcs.conf;
    include 005-no-logging.conf;
    include 015-csp-report.conf;

    include expires.conf;
}

UWAGA Ważna jest kolejność dołączania poszczególnych konfiguracji. Jak widać plik 012-nextcloud.conf musi być dołączony jako pierwszy. W przeciwnym przypadku nie działa wgrywanie plików (przez przeglądarkę) z komunikatami o braku miejsca, itp.

Źródła w sieci internet

1. strona domowa nextCloud

2. dokumentacja nextCloud

3. Użytknexticy w LDAP

4. <<Anchor(url>>nextCloud LDAP schema

 (c) 2004 - 2026 BSD Serwis Krzysztof Stryjek. W przypadku błędów, poprawek proszę kontaktować się z administratorem wiki.