Spis Treści
Instalacja oraz konfiguracja ownCloud
Poniżej przepis, jak zainstalować oraz skonfigurować ownCloud na serwerze.
ports/pkg
Z wykorzystaniem własnego repozytroium pakietów wykonujemy instalację:
pkg install -y www/owncloud devel/php71-pcntl pecl-redis pecl-memcached
Utworzenie bazy danych
createuser -U pgsql -DEPS chmurek
createdb -U pgsql -O chmurek -E utf-8 cdnxcloud
Sprawdzenie uprawnień do config.php
Jeżeli po zalogowaniu wystąpi błąd "zapisu do kaalogu config/", to trzeba sprawdzić uprawnienia:
chown -R www:www /usr/local/www/owncloud/config/
Konfiguracja w panelu www
Po zalogowaniu do panelu należy wpisać konfigurację:
- login administratora
- hasło administratora
- login do bazy danych
- hasło do bazy danych
- nazwa bazy danych
serwer bazy danych (domyślnie localhost, ale w przypadku jaili trzeba odpowiednio poprawić
Integralność danych
W trakcie instalacji owncloud modyfikowany jest plik core/Controller/LoginController.php i nie zgadza się suma kontrolna. Nie można zmieniać core/signature.json, ponieważ nie będzie się zgadzać i kontrola w ogóle nie przejdzie 
Modyfikacje w config.php
W przypadku udostępniania ownCloud 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 (
# [...]
'forcessl' => true,
'forceSSLforSubdomains' => true,
'ldapIgnoreNamingRules' => false,
'ldapUserCleanupInterval' => 51,
'custom_csp_policy' => 'default-src \'self\'; script-src \'self\' \'unsafe-inline\' \'unsafe-eval\'; style-src \'self\' \'unsafe-inline\'; frame-src *; img-src *; font-src \'self\' data:; media-src *',
'htaccess.RewriteBase' => '/',
'loglevel' => 1,
'maintenance' => false,
'theme' => '',
'trashbin_retention_obligation' => 'auto',
'skeletondirectory' => '/var/www/htdocs/virtuals/chmura/szkielet',
# [...]
);
Wsparcie dla redis/memcached
Zgodnie z zaleceniami owncloud 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\Memcached',
'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żytkownika 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/owncloud/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_smtpauthtype' => 'LOGIN',
'mail_smtpauth' => 1,
'mail_from_address' => 'chmura',
'mail_domain' => 'bsdserwis.com',
'mail_smtphost' => 'localhost.bsdserwis.com',
'mail_smtpport' => '587',
'mail_smtpname' => '__user__',
'mail_smtppassword' => '__haslo__',
);
![/!\](/portalwiedzy192/modernized/img/alert.png "/!\"){kind=small}
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:
# globalnie może być mniejszy, poprzez plik .htaccess ownCloud i tak ustawia poniższy limit
memory_limit = 513M
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
/usr/local/www/owncloud/.htaccess
W pliku .htaccess są wartości pomniejszone do 513M. Można zatem poprawić ustawienia i dostosować do własnych potrzeb:
--- /usr/local/www/owncloud/.htaccess 2018-01-29 09:13:17.000000000 +0100
+++ /usr/local/www/owncloud/.htaccess.new 2018-02-03 12:06:12.763768000 +0100
@@ -49,8 +49,8 @@
</IfModule>
<IfModule mod_php7.c>
- php_value upload_max_filesize 513M
- php_value post_max_size 513M
+ php_value upload_max_filesize 5175M
+ php_value post_max_size 5192M
php_value memory_limit 512M
php_value mbstring.func_overload 0
php_value default_charset 'UTF-8'
Dodanie schematu do LDAP
Został opublikowany schmat LDAP, 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/owncloud.schema
Nie można zapomnieć o przeładowaniu samego demona slpad:
cd /usr/local/etc/openldap/
make
occ
Wraz z wersją 9.0 ownCloud 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/owncloud
su -m www -c "php occ app:enable files_external"
Dodanie konfiguracji LDAP
cd /usr/local/www/owncloud
# dodanie aplikacji dla użytkowników w LDAP
su -m www -c "php occ app:enable user_ldap"
# utworzenie pustej konfiguracji
su -m www -c "php occ ldap:create-empty-config"
Użytkownicy
Domyślnie użytkownicy są lokalni (zdefiniowani w bazie danych). Użytkownicy są przypiswaniu 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 ownCloud).
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żytkownika LDAP
Warto w bazie LDAP utworzyć specjalne konto na potrzeby ownCloud. 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/owncloud
su -m www -c "php occ ldap:show-config"
A także ich modyfikowanie:
cd /usr/local/www/owncloud
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 | | +-------------------------------+---------------------------------------------+ | hasMemberOfFilterSupport | | | hasPagedResultSupport | | | homeFolderNamingRule | | | lastJpegPhotoLookup | 0 | | ldapAgentName | uid=ocadmin,ou=admins,dc=firma,dc=local | | ldapAgentPassword | *** | | ldapAttributesForGroupSearch | | | ldapAttributesForUserSearch | | | ldapBackupHost | | | ldapBackupPort | | | ldapBase | ou=owncloud,dc=firma,dc=local | | ldapBaseGroups | ou=owncloud,dc=firma,dc=local | | ldapBaseUsers | ou=owncloud,dc=firma,dc=local | | ldapCacheTTL | 600 | | ldapConfigurationActive | 1 | | ldapDynamicGroupMemberURL | | | ldapEmailAttribute | mail | | ldapExperiencedAdmin | 0 | | ldapExpertUUIDGroupAttr | | | ldapExpertUUIDUserAttr | | | ldapExpertUsernameAttr | | | ldapGroupDisplayName | cn | | ldapGroupFilter | (&(|(objectclass=posixGroup))) | | ldapGroupFilterGroups | | | ldapGroupFilterMode | 0 | | ldapGroupFilterObjectclass | posixGroup | | ldapGroupMemberAssocAttr | memberUid | | ldapHost | 192.168.1.453 | | ldapIgnoreNamingRules | | | ldapLoginFilter | (&(|(objectclass=inetOrgPerson))(uid=%uid)) | | ldapLoginFilterAttributes | | | ldapLoginFilterEmail | 0 | | ldapLoginFilterMode | 0 | | ldapLoginFilterUsername | 1 | | ldapNestedGroups | 0 | | ldapOverrideMainServer | | | ldapPagingSize | 500 | | ldapPort | 389 | | ldapQuotaAttribute | ownCloudQuota | | ldapQuotaDefault | 250GB | | ldapTLS | 0 | | ldapUserDisplayName | displayName | | ldapUserDisplayName2 | mail | | ldapUserFilter | (|(objectclass=inetOrgPerson)) | | ldapUserFilterGroups | | | ldapUserFilterMode | 1 | | ldapUserFilterObjectclass | inetOrgPerson | | ldapUuidGroupAttribute | auto | | ldapUuidUserAttribute | auto | | turnOffCertCheck | 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=owncloud,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
objectclass: inetOrgPerson
objectclass: posixAccount
objectclass: top
objectclass: ownCloud
owncloudquota: 500GB
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/owncloud/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.x1.
Sprawdzenie poprawności konfiguracji
Za pomocą narzędzia smbclient należy sprawdzić poprawność podłączenia do zasobu zdalnego;
smbclient -U uzytkownik //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:
Personalizowanie strony logowania
Jest oddzieln dokumentacja dotycząca personalizacji strony logowania (patrz źródła). Niemniej na szybko można skorzystać z pluginu wallpaper, który podmienia obrazki na stronie logowania.
Pobranie oraz instalacja aplikacji
wget https://storage.marketplace.owncloud.com/apps/wallpaper-0.1.tar.gz?X-Amz-Content-Sha256=UNSIGNED-PAYLOAD\&X-Amz-Algorithm=AWS4-HMAC-SHA256\&X-Amz-Credential=8BXV1F3LCCSC9Z946NYU%2F20190821%2Fus-east-1%2Fs3%2Faws4_request\&X-Amz-Date=20190821T121212Z\&X-Amz-SignedHeaders=host\&X-Amz-Expires=1200\&X-Amz-Signature=e25bced1ae55ca187cfeeb115185325a0d3eb2e0657b41b522e8c08ebf9bea97 -O /tmp/wallpaper-0.1.tar.gz
tar -xzf /tmp/wallpaper-0.1.tar.gz -C /usr/local/www/owncloud/apps
Modyfikacja pliku info.xml
Konieczne jest poprawienie informacji w pliku info.xml, aby móc aktywować aplikacje w OC (chodzi o max-version):
<?xml version="1.0"?>
<info>
<!-- Mandatory fields -->
<id>wallpaper</id>
<name>Wallpaper</name>
<description>Background for the login screen</description>
<version>0.1</version>
<licence>AGPL</licence>
<screenshot>https://github.com/tomneedham/oc-wallpaper/raw/master/screenshot.png</screenshot>
<category>Customization</category>
<summary>Wallpapers for the login</summary>
<dependencies>
<owncloud min-version="10.0.8" max-version="10.2"/>
</dependencies>
</info>
Aktywacja wallpaper
cd /usr/local/www/owncloud
su -m www -c "php occ app:enable wallpaper"
Konfiguracja apache
Konfiguracja została dodana do repozytorium skryptów, ale zapisana ku pamięci:
# --- definicja katalog/ow ze stronkami -----------------------------
#
<Directory /usr/local/www/owncloud>
AllowOverride All
Require all granted
<IfModule mod_expires.c>
Header set cache-control: public
ExpiresActive on
ExpiresDefault "access plus 1 month"
ExpiresByType text/html "access plus 1 hour"
ExpiresByType application/rss+xml "access plus 1 hour"
ExpiresByType image/png "access plus 3 month"
ExpiresByType image/jpg "access plus 3 month"
ExpiresByType image/jpeg "access plus 3 month"
ExpiresByType video/ogg "access plus 3 month"
ExpiresByType audio/ogg "access plus 3 month"
ExpiresByType video/mp4 "access plus 3 month"
ExpiresByType image/x-icon "access plus 1 year"
ExpiresByType font/ttf "access plus 1 year"
ExpiresByType image/svg+xml "access plus 1 year"
</IfModule>
<IfModule mod_deflate.c>
AddOutputFilterByType DEFLATE text/html text/plain text/xml text/css text/javascript application/javascript
</IfModule>
</Directory>
# -------------------------------------------------------------------
#
# Konfiguracja dla wybranego VirtualHost lub konfiguracji globalnej
#
# -------------------------------------------------------------------
#
Alias /owncloud /usr/local/www/owncloud
AcceptPathInfo On
Zgodnie z dokumentacją ownCloud trzeba dodać następujące konfiguracje do apache:
<IfModule mod_headers.c>
Header merge X-Frame-Options SAMEORIGIN
Header always set Strict-Transport-Security "max-age=15768000; includeSubDomains; preload"
Header merge X-Content-Type-Options nosniff
Header merge X-XSS-Protection "1; mode=block"
Header merge X-Robots-Tag none
</IfModule>
Konfiguracja nginx
Za pomocą własnego repozytorium konfiguracji należy wgrać plik 012-owncloud.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-owncloud.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-owncloud.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
(c) 2004 - 2026 BSD Serwis Krzysztof Stryjek. W przypadku błędów, poprawek proszę kontaktować się z administratorem wiki.
Właściwie sprowadza się to do ustawień logowania, grupy roboczej - pozostałe ustawienia z sekcji global można pominąć. (1)