Nextcloud¶

In dit artikel

• Nextcloud. Belangrijkste functies
• Implementatiefuncties
• Installatieparameters configureren via Cloud-init
• Aan de slag na het implementeren van Nextcloud
• Wijzigen van de domeinnaam
• Nextcloud bestellen via de API

Nextcloud. Belangrijkste functies¶

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

• Bestandsopslag. Nextcloud stelt u in staat bestanden op een server op te slaan en er toegang toe te krijgen via een webinterface of via toepassingen voor desktopcomputers en mobiele apparaten.
• Bestandsynchronisatie. De mogelijkheid om bestanden tussen verschillende apparaten te synchroniseren, maakt de dienst een handig instrument voor het werken in verschillende omstandigheden.
• Versiebeheer. Nextcloud stelt u in staat meerdere versies van hetzelfde bestand op te slaan. Het stelt u ook in staat eerdere versies te herstellen indien nodig.
• Toegang tot bestanden via de webinterface. Nextcloud heeft een webinterface die u toegang tot bestanden via een browser geeft, waardoor het een handig instrument is om op elk apparaat te werken.
• Beheer van agenda's en taken. Nextcloud stelt u in staat agenda's en taken te maken en beheren, waardoor het een nuttig instrument is voor organisatie.
• Contactbeheer. Nextcloud stelt u in staat contacten te maken en beheren, waardoor het een handig instrument is voor het beheren van communicatie.
• Toegang tot bestanden via toepassingen. Nextcloud heeft toepassingen voor desktopcomputers en mobiele apparaten waarmee u via deze toepassingen toegang tot bestanden kunt krijgen.
• Uitbreidbaarheid. Nextcloud heeft veel aanvullende toepassingen die kunnen worden geïnstalleerd en gebruikt om de functionaliteit uit te breiden. Dit zijn toepassingen voor online samenwerking, documentbewerking, projectbeheer, enz.

Implementatiefuncties¶

• Nextcloud is in de kernel opgenomen en er is geen aanvullende installatie nodig. Wij bieden een webinterface via welke 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 - voer docker compose uit, die een reeks Nextcloud- en Onlyoffice-containers start.
• Het genereren van SSL-certificaten is gebaseerd op de jonasal/nginx-certbot-assembly.

• Deze opdrachten kunnen nodig zijn om de versies van containers bij te werken en het configuratiebestand te bewerken.

  • Om containers te stoppen, voert u de opdracht uit

  cd /opt/nextcloud/
  

  Vervolgens

  docker compose down
  

  • Om containers in te schakelen, voert u de opdracht 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 gemaakt:
    • 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, die oproepen naar Nextcloud in het geheugen opslaat en pas daarna in de PostgreSQL-database. PostgreSQL
  • app - container, de Nextcloud-dienst heeft de volgende parameters:
    • Toegang tot een toepassing wordt uitgevoerd vanuit een webbrowser of mobiele app via de koppeling https://nextcloud(server_id).hostkey.in (bijvoorbeeld https://nextcloud16094.hostkey.in);
    • inloggegevens: admin;
    • wachtwoord: van ssh;
  • onlyoffice-document-server - container, de OnlyOffice-dienst draait op poort 80.

  Let op

  Deze container start binnen 6 minuten. In deze tijd kunt u naar de Nextcloud-webinterface gaan, bestanden uploaden en downloaden, maar de mogelijkheid om documenten te bewerken verschijnt pas 6 minuten na het uitvoeren van docker compose up -d (het duurt even voordat sommige componenten zijn gestart).

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

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 op het Automatization-stadium. Hiermee kunt u automatisch administratorreferenties, e-mail en gegevensopslagpad 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"

Parameterbeschrijving

• nextcloud_admin_name - naam van het administratoraccount (standaard: admin);
• nextcloud_admin_pwd - administratorwachtwoord (geef uw sterke wachtwoord op);
• nextcloud_admin_email - administrator-e-mail 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 inloggegevens en het wachtwoord voor de verbinding. Klanten van ons bedrijf beheren de hardware in de server- en API-beheerpanelen — Invapi.

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

• Koppeling voor toegang tot het Nextcloud-dashboard met een webinterface: in de webpanel-tag;
• Inloggegevens: admin;
• Wachtwoord: Verzonden naar uw e-mailadres nadat de server klaar is voor gebruik na het implementeren van de software.

Na het overschakelen naar het Nextcloud-beheerpaneel moet u uw inloggegevens en wachtwoord invoeren:

Na een succesvolle inlogging kunt u de dienst gaan gebruiken.

Wijzigen van de domeinnaam¶

Voordat u begint met het wijzigen van de domeinnaam, wordt aanbevolen om een back-up te maken van alle bestanden die in de instructies worden gespecificeerd. Voer de volgende opdrachten uit om back-ups van de belangrijkste bestanden te maken:

1. Maak een directory voor 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 opdrachten maken back-ups van alle cruciale bestanden die tijdens het proces van het wijzigen van de domeinnaam worden gewijzigd. In geval van problemen kunt u de oorspronkelijke configuratie uit deze back-ups herstellen.

Herstellen uit back-ups en verwijderen na succesvolle migratie¶

Als het proces van het wijzigen van de domeinnaam mislukt en u de oorspronkelijke configuratie moet herstellen, voert u de volgende opdrachten 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. Herstart containers

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

6. Herstart nginx

   docker restart nginx-certbot
   

Deze opdrachten stellen alle configuratiebestanden terug in hun oorspronkelijke staat en starten de benodigde diensten opnieuw op.

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

1. Controleer de inhoud van de back-updirectory

   ls -la /root/nextcloud_backup/
   

2. Verwijder de gehele back-updirectory

   rm -rf /root/nextcloud_backup/
   

Voordat u verwijdering uitvoert, wordt aanbevolen om de inhoud van de directory te controleren om ervoor te zorgen dat u alleen de benodigde bestanden verwijdert.

Bestanden configureren¶

1. Verbind met de server via SSH:

   ssh root@IP_ADDRESS
   

2. Wijzig de hostnaam (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 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. Herstart de Nginx-container:

   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 regels die het 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 vooral op de volgende 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. Ga naar de Nextcloud-directory:

   cd /opt/nextcloud
   

2. Stop en verwijder bestaande containers:

   docker compose down
   

   Deze opdracht 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 is gedefinieerd, is dit normaal—Nextcloud is al geïnstalleerd.

Controleren en debuggen¶

1. Verifieer dat Nextcloud toegankelijk is via de nieuwe domeinnaam:

   Open uw browser op 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, verifieer 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¶

• Na het aanbrengen van wijzigingen is het essentieel om de cache van uw browser te wissen;
• Alle gebruikersreferenties 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 begint te werken;
• Zorg ervoor dat het A-record in DNS wijst naar het juiste IP-adres van uw server;
• Het PTR-record (reverse DNS) is niet cruciaal voor de werking van Nextcloud, maar kan worden bijgewerkt via het beheerpaneel voor volledige consistentie.

Nextcloud bestellen via de API¶