Nextcloud¶

In dit artikel

• Nextcloud. Belangrijkste functies
• Implementatiefuncties
• Aan de slag na het implementeren van Nextcloud als Managed App
• Aan de slag na het implementeren van Nextcloud via de Marketplace: Installatieparameters configureren via Cloud-init
• Aan de slag na het implementeren van Nextcloud
• Het wijzigen van de domeinnaam
• Nextcloud bestellen via de API

Nextcloud. Belangrijkste functies¶

Nextcloud heeft veel functies die het tot een effectief hulpmiddel maken voor het opslaan en verwerken van gegevens:

• Bestandsopslag: Nextcloud stelt u in staat om bestanden op een server op te slaan en ze te openen via een webinterface of via applicaties voor desktopcomputers en mobiele apparaten.
• Bestandsynchronisatie: De mogelijkheid om bestanden tussen verschillende apparaten te synchroniseren maakt de dienst een handig hulpmiddel om onder diverse omstandigheden te werken.
• Versiebeheer: Nextcloud stelt u in staat om meerdere versies van hetzelfde bestand op te slaan. Het stelt u ook in staat om indien nodig eerdere versies te herstellen.
• Toegang tot bestanden via de webinterface: Nextcloud heeft een webinterface waarmee u via een browser toegang heeft tot bestanden, wat het een handig hulpmiddel maakt om op elk apparaat te werken.
• Beheer van agenda's en taken: Nextcloud laat u agenda's en taken maken en beheren, wat het een nuttig hulpmiddel maakt voor organisatie.
• Contactbeheer: Nextcloud stelt u in staat om contacten aan te maken en te beheren, wat het een handig hulpmiddel maakt voor het beheren van communicatie.
• Toegang tot bestanden via applicaties: Nextcloud heeft applicaties voor desktopcomputers en mobiele apparaten waarmee u via die weg toegang heeft tot bestanden.
• Uitbreidbaarheid: Nextcloud heeft veel aanvullende applicaties die kunnen worden geïnstalleerd en gebruikt om de functionaliteit uit te breiden. Dit zijn applicaties voor online samenwerking, bewerken van documenten, projectbeheer, enz.

Implementatiefuncties¶

• Nextcloud is in de kernel opgenomen en er is geen extra installatie vereist. Wij bieden een webinterface waarmee de dienst wordt geïnstalleerd en geconfigureerd.
• De configuratiebestanden bevinden zich in:
  • /opt/nextcloud - Nextcloud-installatie en -configuratie;
  • /opt/nginx - installatie en configuratie van de Nginx-dienst;
  • /opt/nextcloud/compose.yml - voert docker compose uit, wat een reeks Nextcloud + Onlyoffice containers start.
• De generatie van SSL-certificaten is gebaseerd op de jonasal/nginx-certbot assemblage.

• De volgende commando's kunnen nodig zijn om de versies van containers bij te werken en het configuratiebestand te bewerken.

  • Om containers te stoppen, voer het commando uit:

  cd /opt/nextcloud/
  

  Daarna:

  docker compose down
  

  • Om containers te activeren, voer het commando uit:

  cd /opt/nextcloud/
  

  Daarna:

  docker compose up -d
  

• Docker compose up -d voert het compose.yml bestand uit, dat de volgende containers downloadt en start:

  • db - container; PostgreSQL wordt gedownload en de volgende instellingen worden toegepast:
    • De Nextcloud-database (of basis) wordt aangemaakt;
    • De Nextcloud-gebruiker wordt gegenereerd;
    • het wachtwoord voor SSH (dit wordt per e-mail naar uw e-mailadres verzonden zodra de server klaar is voor gebruik na het implementeren van de software);
    • de standaardpoort is 5432.
  • redis - container; slaat aanroepen naar Nextcloud op in het geheugen en pas daarna records in de PostgreSQL-database.
  • app - container; de Nextcloud-dienst heeft de volgende parameters:
    • Toegang tot een applicatie vindt plaats via een webbrowser of mobiele app via de link https://nextcloud(server_id).hostkey.in (bijvoorbeeld https://nextcloud16094.hostkey.in);
    • login: admin;
    • wachtwoord: van SSH;
  • onlyoffice-document-server - container; de OnlyOffice-dienst draait op poort 80.

  Let op

  Deze container start binnen 6 minuten. In die tijd kunt u naar de Nextcloud webinterface gaan, bestanden uploaden en downloaden, maar de mogelijkheid om documenten te bewerken verschijnt pas 6 minuten nadat docker compose up -d is uitgevoerd (het duurt even voordat bepaalde componenten zijn opgestart).

  • nginx - container; de Nginx-dienst die verzoeken accepteert op poorten 80 en 443 en verzoeken doorstuurt naar de Nextcloud-container.

Aan de slag na het implementeren van Nextcloud als Managed App¶

Na het implementeren van Nextcloud als een managed app kunt u het volgende vinden in het tabblad My Apps van het serverbeheerderspaneel:

• een applicatielink;
• login en wachtwoord voor toegang;
• informatie met betrekking tot het gebruik en beheer van de dienst.

Voor meer details over het werken met managed apps, zie de instructies.

Aan de slag na het implementeren van Nextcloud via de Marketplace: Installatieparameters configureren via Cloud-init¶

Bij het bestellen van een server met Nextcloud kunt u de belangrijkste installatieparameters vooraf configureren met behulp van cloud-init configuratie tijdens het bestelproces in de fase Automatization. Hiermee kunt u automatisch administratorgegevens, e-mail en het pad voor gegevensopslag instellen:

Configuratieparameters¶

Om Nextcloud via cloud-init te configureren, gebruikt u het volgende formaat:

write_files:
  - path: "/opt/main.yml"
    permissions: "0644"
    content: |
      nextcloud_admin_name: "root"
      nextcloud_admin_pwd: "UW_WACHTWOORD"
      nextcloud_admin_email: "admin@localhost"
      nextcloud_data_path: "/opt/nextcloud-data"

Beschrijving van parameters

• nextcloud_admin_name - naam van het administratoraccount (standaard: admin);
• nextcloud_admin_pwd - wachtwoord van de administrator (specificeer uw sterke wachtwoord);
• nextcloud_admin_email - e-mailadres van de administrator voor meldingen;
• nextcloud_data_path - pad voor het opslaan van Nextcloud-gegevens (standaard: /opt/nextcloud-data).

Aan de slag na het implementeren van Nextcloud¶

Er wordt een melding verzonden naar het e-mailadres dat tijdens de registratie is opgegeven dat de server klaar is voor gebruik nadat de bestelling is betaald. Deze bevat het IP-adres van de VPS, evenals de login en het wachtwoord voor de verbinding. Klanten van ons bedrijf beheren de hardware in het server- en API-beheerderspaneel — Invapi.

U kunt de autorisatiedata vinden in het tabblad Configuration >> Tags van het serverbeheerderspaneel of in de verzonden e-mail.

• Link om toegang te krijgen tot het Nextcloud dashboard met een webinterface: in de webpanel tag;
• Login: admin;
• Wachtwoord: Verstuurd naar uw e-mailadres nadat de server klaar is voor gebruik na de implementatie van de software.

Nadat u bent ingelogd op het Nextcloud-beheerderspaneel, moet u uw login en wachtwoord invoeren:

Nadat u succesvol bent ingelogd, kunt u de dienst gaan gebruiken.

Het wijzigen van de domeinnaam¶

Voordat u begint met het wijzigen van de domeinnaam, wordt het aanbevolen om een back-up te maken van alle bestanden die in de instructies worden genoemd. Om back-ups te maken van de hoofdbestanden, voert u de volgende commando's uit:

1. Maak een map aan voor de back-ups

   mkdir -p /root/nextcloud_backup
   

2. Kopieer het Nginx-configuratiebestand

   cp /opt/nginx/user_conf.d/nextcloud<server ID>.hostkey.in.conf /root/nextcloud_backup/
   

3. Kopieer het Docker Compose-bestand

   cp /opt/nextcloud/compose.yml /root/nextcloud_backup/
   

4. Kopieer het configuratiescript

   cp /opt/nextcloud/set_configuration.sh /root/nextcloud_backup/
   

5. Kopieer het Nextcloud-configuratiebestand

   cp /var/lib/docker/volumes/app_data/_data/config/config.php /root/nextcloud_backup/
   

Deze commando's maken back-ups van alle belangrijke bestanden die gewijzigd zullen worden tijdens het proces van het wijzigen van de domeinnaam. In het geval van problemen kunt u de originele configuratie herstellen vanuit deze back-ups.

Herstellen vanuit back-ups en verwijderen na succesvolle migratie¶

Als het proces van het wijzigen van de domeinnaam mislukt en u de originele configuratie moet herstellen, voert u de volgende commando's uit:

1. Herstel het Nginx-configuratiebestand

   cp /root/nextcloud_backup/nextcloud<server ID>.hostkey.in.conf /opt/nginx/user_conf.d/
   

2. Herstel het Docker Compose-bestand

   cp /root/nextcloud_backup/compose.yml /opt/nextcloud/
   

3. Herstel het configuratiescript

   cp /root/nextcloud_backup/set_configuration.sh /opt/nextcloud/
   

4. Herstel het Nextcloud-configuratiebestand

   cp /root/nextcloud_backup/config.php /var/lib/docker/volumes/app_data/_data/config/
   

5. Start containers opnieuw op

   cd /opt/nextcloud
   docker compose down
   docker compose up -d
   

6. Start nginx opnieuw op

   docker restart nginx-certbot
   

Deze commando's herstellen alle configuratiebestanden naar hun originele staat en starten de benodigde diensten opnieuw op.

Zodra u er zeker van bent dat het wijzigen van de domeinnaam succesvol was en alles correct werkt (het wordt aanbevolen om minstens 24-48 uur te wachten voor volledige tests), kunt u de back-ups veilig verwijderen:

1. Controleer de inhoud van de back-upmap

   ls -la /root/nextcloud_backup/
   

2. Verwijder de volledige back-upmap

   rm -rf /root/nextcloud_backup/
   

Vóór verwijdering wordt het aanbevolen om de inhoud van de map te controleren om er zeker van te zijn dat u alleen de noodzakelijke bestanden verwijdert.

Bestanden configureren¶

1. Maak verbinding met de server via SSH:

   ssh root@IP_ADDRESS
   

2. Wijzig de hostname (optioneel):

   hostnamectl set-hostname nextcloud_server
   

3. Bewerk /etc/hosts:

   nano /etc/hosts
   

   Voeg een regel toe die het nieuwe domein koppelt aan het IP-adres van de server:

   IP_ADDRESS UW_DOMAINNAAM
   

   (vervang het IP-adres en de domeinnaam door uw eigen waarden)

Nginx configureren¶

1. Zoek en bewerk het Nginx-configuratiebestand:

   nano /opt/nginx/user_conf.d/nextcloud<server ID>.hostkey.in.conf
   

   Vervang alle instanties van de oude domeinnaam (nextcloud<server ID>.hostkey.in) door de nieuwe (UW_DOMAINNAAM):

   • Regel 4: server_name nextcloud<server ID>.hostkey.in; > server_name UW_DOMAINNAAM;
   • Regel 15: server_name nextcloud<server ID>.hostkey.in; > server_name UW_DOMAINNAAM;
   • Regel 17: ssl_certificate /etc/letsencrypt/live/nextcloud<server ID>.hostkey.in/fullchain.pem; > ssl_certificate /etc/letsencrypt/live/UW_DOMAINNAAM/fullchain.pem;
   • Regel 18: ssl_certificate_key /etc/letsencrypt/live/nextcloud<server ID>.hostkey.in/privkey.pem; > ssl_certificate_key /etc/letsencrypt/live/UW_DOMAINNAAM/privkey.pem;
   • Regel 19: ssl_trusted_certificate /etc/letsencrypt/live/nextcloud<server ID>.hostkey.in/chain.pem; > ssl_trusted_certificate /etc/letsencrypt/live/UW_DOMAINNAAM/chain.pem;

2. Hernoem het configuratiebestand:

   mv /opt/nginx/user_conf.d/nextcloud<server ID>.hostkey.in.conf /opt/nginx/user_conf.d/UW_DOMAINNAAM.conf
   

3. Start de Nginx-container opnieuw op:

   docker restart nginx-certbot
   

Nextcloud configureren¶

1. Bewerk het Docker Compose-bestand:

   nano /opt/nextcloud/compose.yml
   

   Vervang alle instanties van de oude domeinnaam door de nieuwe (UW_DOMAINNAAM). Let op de regels die de volgende bevatten:

   • Regel 40: - OVERWRITECLIURL=https://nextcloud<server ID>.hostkey.in/
   • Regel 41: - OVERWRITEHOST=nextcloud<server ID>.hostkey.in

2. Bewerk het Nextcloud-configuratiescript:

   nano /opt/nextcloud/set_configuration.sh
   

   Vervang alle instanties van de oude domeinnaam door de nieuwe. Let in het bijzonder op de regels:

   • Regel 11: if ! grep -q "nextcloud<server ID>.hostkey.in" trusted_domain.tmp; then
   • Regel 13: docker exec -u www-data app-server php occ --no-warnings config:system:set trusted_domains $TRUSTED_INDEX --value="nextcloud<server ID>.hostkey.in"
   • Regel 23: docker exec -u www-data app-server php occ --no-warnings config:system:set onlyoffice StorageUrl --value="https://nextcloud<server ID>.hostkey.in/

Wijzigingen toepassen¶

1. Navigeer naar de Nextcloud-map:

   cd /opt/nextcloud
   

2. Stop en verwijder bestaande containers:

   docker compose down
   

   Dit commando stopt en verwijdert alle containers die zijn gedefinieerd in het compose.yml bestand, maar behoudt alle gegevens in volumes.

3. Start Nextcloud-containers op:

   docker compose up -d
   

4. Voer het configuratiescript uit:

   bash /opt/nextcloud/set_configuration.sh
   

   Als het script een foutmelding geeft dat het commando "maintenance:install" niet gedefinieerd is, is dit normaal—Nextcloud is al geïnstalleerd.

Controleren en debuggen¶

1. Controleer of Nextcloud toegankelijk is via de nieuwe domeinnaam:

   Open uw browser naar https://UW_DOMAINNAAM

   

2. Als er problemen zijn, controleer dan de logs:

   docker logs nginx-certbot
   docker logs app-server
   

3. Configureer trusted_domains handmatig indien nodig:

   docker exec -u www-data app-server php occ --no-warnings config:system:set trusted_domains 1 --value="UW_DOMAINNAAM"
   docker exec -u www-data app-server php occ --no-warnings config:system:set overwrite.cli.url --value="https://UW_DOMAINNAAM/"
   

4. Als OnlyOffice wordt gebruikt, controleer dan de instellingen:

   docker exec -u www-data app-server php occ --no-warnings config:system:set onlyoffice StorageUrl --value="https://UW_DOMAINNAAM/"
   

Belangrijke opmerkingen¶

• Na het maken van wijzigingen is het essentieel om uw browsercache te legen;
• Alle gebruikersgegevens blijven hetzelfde als voor het wijzigen van de domeinnaam;
• Als uw DNS-provider tijd nodig heeft voor het bijwerken van records, kan er enige vertraging optreden voordat de nieuwe domeinnaam werkt;
• Zorg ervoor dat het A-record in de DNS wijst naar het juiste IP-adres van uw server;
• Het PTR-record (reverse DNS) is niet kritiek voor de werking van Nextcloud, maar kan worden bijgewerkt via het beheerderspaneel voor volledige consistentie.

Nextcloud bestellen via de API¶

Om deze software te installeren via de API, volgt u deze instructies.