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 uit 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 er toegang toe te krijgen via een webinterface of via applicaties voor desktopcomputers en mobiele apparaten.
• Bestandssynchronisatie. De mogelijkheid om bestanden tussen verschillende apparaten te synchroniseren, maakt de service tot een handig hulpmiddel om onder verschillende 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 toegang heeft tot bestanden.
• Uitbreidbaarheid. Nextcloud heeft veel extra applicaties die kunnen worden geïnstalleerd en gebruikt om de functionaliteit uit te breiden. Dit zijn applicaties voor online samenwerking, documentbewerking, projectbeheer, enz.

Implementatiefuncties¶

• Nextcloud is opgenomen in de kernel en er is geen aanvullende installatie vereist. Wij bieden een webinterface waarmee de service wordt geïnstalleerd en geconfigureerd.
• De configuratiebestanden bevinden zich in:
  • /opt/nextcloud - Nextcloud-installatie en -configuratie;
  • /opt/nginx - installatie en configuratie van de Nginx-service;
  • /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.

• Deze 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/
  

  Vervolgens

  docker compose down
  

  • Om containers in te schakelen, voer het commando uit:

  cd /opt/nextcloud/
  

  Vervolgens

  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 base) wordt aangemaakt;
    • De Nextcloud-gebruiker wordt gegenereerd;
    • het wachtwoord voor SSH (dit wordt per e-mail naar uw e-mailadres gestuurd zodra de server klaar is voor gebruik na het implementeren van de software);
    • de standaardpoort is 5432.
  • redis - container, die oproepen naar Nextcloud in het geheugen opslaat en pas daarna records in de PostgreSQL-database.
  • app - container, de Nextcloud-service 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;
    • password: van SSH;
  • onlyoffice-document-server - container, de OnlyOffice-service 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 kost enige tijd om bepaalde componenten op te starten).

  • nginx - container, de Nginx-service die verzoeken op poorten 80 en 443 accepteert 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 server control panel:

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

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

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

Wanneer u een server met Nextcloud bestelt, 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: "YOUR_PASSWORD"
      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 gestuurd 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-control panel — Invapi.

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

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

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

Nadat u succesvol bent ingelogd, kunt u de service 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 van back-ups en verwijderen na een succesvolle migratie¶

Als het proces van het wijzigen van de domeinnaam mislukt en u de originele configuratie moet herstellen, voer dan 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 services opnieuw op.

Zodra u er zeker van bent dat het wijzigen van de domeinnaam succesvol was en alles correct werkt (het wordt aanbevolen om ten minste 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. Verbind 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 YOUR_DOMAIN_NAME
   

   (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 (YOUR_DOMAIN_NAME):

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

2. Hernoem het configuratiebestand:

   mv /opt/nginx/user_conf.d/nextcloud<server ID>.hostkey.in.conf /opt/nginx/user_conf.d/YOUR_DOMAIN_NAME.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 (YOUR_DOMAIN_NAME). 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 in het compose.yml bestand zijn gedefinieerd, maar behoudt alle gegevens in volumes.

3. Start Nextcloud-containers:

   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://YOUR_DOMAIN_NAME

   

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="YOUR_DOMAIN_NAME"
   docker exec -u www-data app-server php occ --no-warnings config:system:set overwrite.cli.url --value="https://YOUR_DOMAIN_NAME/"
   

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://YOUR_DOMAIN_NAME/"
   

Belangrijke opmerkingen¶

• Nadat u wijzigingen heeft aangebracht, is het essentieel om uw browsercache te wissen;
• 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 DNS naar het juiste IP-adres van uw server verwijst;
• Het PTR-record (reverse DNS) is niet kritiek voor de werking van Nextcloud, maar kan worden bijgewerkt via het control panel voor volledige consistent성.

Nextcloud bestellen via de API¶

Om deze software te installeren met behulp van de API, volgt u deze instructies.