🥇Installera NextCloud + ONLYOFFICE på en server med Docker

Hej, Habr! Jag presenterar en översättning av artikeln „Att ställa in NextCloud och ONLYOFFICE på en enda server med Docker“.

Det är svårt att underskatta nyttan av online-paket av kontorsapplikationer som Google Docs och molnlagring i livet för tekniskt orienterade människor. Teknologier har blivit så utbredda att till och med Microsoft, som länge dominerat marknaden för kontorsapplikationer, nyligen har fokuserat på att utveckla webbapplikationen Office 365 och övertyga användare att gå över till en prenumerationsmodell för sina tjänster. De som är intresserade av processen att installera och konfigurera sin egen lagring är välkomna att läsa vidare.

För en tid sedan bekantade vi oss med lösningar för molnlagring och kontorswebbapplikationer med öppen källkod som enkelt kan implementeras för användning i mikroföretag. Huvudmotivet för att lagra all dokumentation online är att minimera pappershanteringen och implementera positiva affärsmetoder, trots en liten mängd operationer. Å andra sidan är nackdelen att hyra en molnserver för att tillhandahålla denna tjänst är mindre säker än att lagra direkt på företagets område, eftersom du saknar medel för att revidera fysisk åtkomst till din server eller trafik. Därför är end-to-end-kryptering och programvara med öppen källkod också nödvändigt.

Med all tillgänglig information om lösningar med öppen källkod har vi funnit två aktiva projekt (med commits i git-repositoriet de senaste 12 månaderna) som utvecklats för molnlagring: NextCloud och OwnCloud, och det enda aktiva kontorsapplikationspaketet ONLYOFFICE. Båda molnlagringsverktygen har ungefär liknande funktionalitet, och valet att gå med NextCloud baserades på bevis för att det kan integreras med ONLYOFFICE för en sömlös användarupplevelse. Men när vi började implementera tjänsterna blev bristen på information om integrationen av dessa tjänster uppenbar. Vi hittade tre instruktionsvideor om hur man kan utföra integrationen:

Inga av de tre videorna svarade på frågan om hur man installerar ONLYOFFICE-dokumenttjänsten på samma fysiska server som NextCloud med gemensam nginx. Istället använde de teknologier för separation, som att använda separata portar för dokumenttjänstens API. Ett annat föreslaget alternativ var att distribuera en separat server för dokumenttjänsten med manuell konfiguration av den inbyggda nginx-instansen för dokumenttjänsten för att installera åtkomstnyckeln (en i förväg känd åtkomstnyckel som bekräftar åtkomst till datamolnet) och TLS-certifikat. De ovan nämnda metoderna bedömdes som osäkra och inte tillräckligt effektiva, därför integrerade vi NextCloud, ONLYOFFICE och gemensam nginx som delar förfrågningar efter domännamn med hjälp av docker-compose. Här är steg-för-steg-information om hur man gör detta.

Steg 1: nginx-behållare

Detta är en mycket enkel installation, men det här steget kräver mest arbete för att konfigurera omvänd proxyserver. Först skapade vi en docker-compose-konfiguration för bilden nginx:stable.

version: '2'
services:
  nginx:
    image: nginx:stable
    restart: always
    volumes:
      - ./nginx/nginx-vhost.conf:/etc/nginx/conf.d/default.conf:ro
      - ./nginx/certificates:/mycerts
    ports:
      - 443:443
      - 80:80

Detta skapar en behållare med portar 80 och 443 öppna för offentlig tillgång, gör en mappning av konfigurationen till nginx/nginx-vhost.conf och definierar lagringsplatsen för certifikat, genererade antingen som självsignerade certifikat eller med hjälp av Certbot från Let’s Encrypt i /nginx/certificates. Här bör mappar för office.yourdomain.com och cloud.yourdomain.com finnas med filerna fullchain1.pem och privkey1.pem i var och en för certifikatkedjan och serverns privata nyckel respektive. Du kan läsa mer om hur man genererar ett självsignerat certifikat här. www.akadia.com/services/ssh_test_certificate.html (omnamn av .key och .crt till .pem fungerar utan konvertering av filstrukturen för nginx).

Efter detta definierade vi vhost-filen. Först definierar vi beteendet för port 80 som en enkel vidarebefordran till https, eftersom vi inte vill tillåta någon http-trafik.

server {
    listen 80;
    location / {
        return 301
            https://$host$request_uri;
    }
}

Sedan skapade vi två virtuella servrar på port 443 för våra tjänster:

server {
    listen 443 ssl;
    server_name cloud.yourdomain.com ;
    root /var/www/html;

    ssl_certificate     /mycerts/cloud.yourdomain.com/fullchain1.pem;
    ssl_certificate_key /mycerts/cloud.yourdomain.com/privkey1.pem;
    ssl_protocols       TLSv1 TLSv1.1 TLSv1.2;
    ssl_ciphers         HIGH:!aNULL:!MD5;

    location / {
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
        proxy_set_header Host $http_host;
        proxy_redirect off;
        proxy_pass http://app:80;
    }
}
server {
    listen 443 ssl;
    server_name office.yourdomain.com;
    root /var/www/html;

    ssl_certificate     /mycerts/office.yourdomain.com/fullchain1.pem;
    ssl_certificate_key /mycerts/office.yourdomain.com/privkey1.pem;
    ssl_protocols       TLSv1 TLSv1.1 TLSv1.2;
    ssl_ciphers         HIGH:!aNULL:!MD5;

    location / {
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
        proxy_set_header Host $http_host;
        proxy_redirect off;
        proxy_pass http://onlyoffice:80;
    }
}

Steg 2: dokumenttjänst

Nu måste vi lägga till dokumenttjänstbehållaren i vår docker-compose.yml. Det finns inte mycket att konfigurera här.

services:
...
  onlyoffice:
    image: onlyoffice/documentserver
    restart: always

Men kom ihåg att länka nginx-behållaren med dokumenttjänsten:

services:
...
  nginx:
    ...
    depends_on:
      - onlyoffice

Steg 3: NextCloud

Först lägger vi till nya tjänster:

services:
...
  db:
    image: mariadb
    command: --transaction-isolation=READ-COMMITTED --binlog-format=ROW
    restart: always
    volumes:
      - /data/nextcloud_db:/var/lib/mysql
    environment:
      - MYSQL_ROOT_PASSWORD=#ange något lösenord här
      - MYSQL_PASSWORD=#ange något annat lösenord här
      - MYSQL_DATABASE=nextcloud
      - MYSQL_USER=nextcloud
  app:
    image: nextcloud
    depends_on:
      - db
      - onlyoffice
    restart: always

och lägger till en länk till nginx:

services:
...
  nginx:
    ...
    depends_on:
      - app

Nu är det dags att ladda upp behållarna.

docker-compose up -d

Efter en tid kommer nginx att börja omdirigera dig till NextClouds externa gränssnitt, vilket som standard är konfigurationssidan. Du måste ange användarnamn och lösenord för din första administratörsanvändare samt databasens uppgifter som du angav i docker-compose.yml. När installationen är klar kan du logga in. I vårt fall tog det nästan en minut och krävde en extra uppdatering av inloggningssidan innan vi kunde logga in på molntjänsten.

Inställningsfönstren för NextCloud-tjänsten

Steg 4: anslutning av NextCloud och ONLYOFFICE

I det här steget måste du installera applikationen för NextCloud som kopplar samman funktionaliteten hos ONLYOFFICE. Låt oss börja med apphanteringspanelen uppe till höger i menyn. Hitta applikationen ONLYOFFICE (i avsnittet “Kontor och text” eller med hjälp av sökfunktionen), installera och aktivera den.

Efter detta går du till Inställningar via menyn uppe till höger, och du bör hitta alternativet ONLYOFFICE i vänstermenyn. Gå in i det. Du måste ange adresserna enligt nedan.

Inställningar för integrationsapplikationen

Den första adressen används för att länka till vissa js- och css-filer direkt från den applikation som körs i webbläsaren (detta är anledningen till att vi behöver öppna åtkomst till ONLYOFFICE-tjänsten via nginx). Den hemliga nyckeln används inte eftersom vi litar mer på Docker-isoleringslagret än på en permanent autentiseringnyckel. Den tredje adressen används av NextCloud-containern för direktanslutning till ONLYOFFICE API, och den använder standardvärdnamnet från Docker. Det sista fältet används så att ONLYOFFICE kan göra förfrågningar tillbaka till NextCloud API, med hjälp av den externa IP-adressen eller den interna Docker-adressen, om du använder Docker-nätverk, men i vårt fall används det inte. Se till att din brandvägg är inställd för att tillåta dessa typer av interaktioner.

Efter att du har sparat kommer NextCloud att testa anslutningen och, om allt är korrekt, visa dig inställningar relaterade till integrationen — till exempel vilka filtyper som kan redigeras med denna integration. Anpassa det som du anser är nödvändigt.

Slutsteget: var man hittar redigeraren

Om du går tillbaka till mapparna i ditt molnlagringsutrymme och klickar på “+” för att skapa en ny fil, kommer en ny möjlighet att skapa ett dokument, ett kalkylblad eller en presentation att finnas tillgänglig. Med dem kan du skapa och direkt redigera dessa typer av filer med hjälp av ONLYOFFICE.

Menyn för filskapande