Een Typesense Ubuntu-server naar een andere server migreren: back-up en herstel

Het migreren van uw zelf-gehoste Typesense-instantie naar een nieuwe server is een cruciale taak, of u nu hardware upgradet, naar een andere cloudprovider verhuist of gewoon serveronderhoud uitvoert.

Deze handleiding begeleidt u door de juiste stappen om uw Typesense-gegevens veilig en betrouwbaar te back-uppen, over te zetten en te herstellen.

Kernconcepten

Typesense slaat uw gegevens op in het pad dat is gedefinieerd door de data-dir parameter (bijv. /var/lib/typesense). Deze gegevens kunnen echter niet veilig worden geback-upt terwijl de server draait, omdat de bestanden dan open blijven staan voor schrijfbewerkingen.

Om corruptie te voorkomen, biedt Typesense een Snapshot API om consistente back-ups te maken.

1. Maak een back-up met behulp van de Snapshot API

De beste optie als uw Typesense-instantie normaal functioneert.

Roep de Snapshot API aan om een bestandssysteem-veilige snapshot te maken:

curl -X POST 'http://localhost:8108/snapshot' \ -H 'X-TYPESENSE-API-KEY: UW_BEHEERDER_API_SLEUTEL' \ -H 'Content-Type: application/json' \ -d '{"snapshot_pad": "/tmp/typesense-snapshot"}'

Archiveer vervolgens de snapshot-map:

tar -czvf backup.tar.gz -C /tmp typeense-snapshot

(Optioneel) Ruim de snapshot-map op:

rm -rf /tmp/typesense-snapshot

2. Alternatief: Stop Typesense en kopieer de gegevensdirectory

Als de Snapshot API niet beschikbaar is (bijvoorbeeld omdat Typesense niet reageert):

Stop de Typesense-server:

sudo systemctl stop typesense-server.service

Archiveer vervolgens de gegevensdirectory rechtstreeks:

tar -czvf backup.tar.gz -C /var/lib typesense

Belangrijk: Doe dit pas nadat u de server hebt gestopt, om de consistentie van het bestand te garanderen.

3. De back-up overbrengen naar een andere server met behulp van SCP + SSH-sleutels

Genereer SSH-sleutels (indien u dit nog niet heeft gedaan) op uw lokale computer:

ssh-keygen -t ed25519 -C "[email protected]"

Sla het op de standaardlocatie op (~/.ssh/id_ed25519) en laat de wachtwoordzin leeg voor automatisering.

Kopieer de openbare sleutel naar de nieuwe server:

ssh-copy-id -i ~/.ssh/id_ed25519.pub gebruiker@nieuwe-server-ip

Zet de backup over met SCP:

scp -i ~/.ssh/id_ed25519 backup.tar.gz gebruiker@nieuw-server-ip:/tmp/

Als dit niet werkt, controleer dan eerst of de inhoud van ed25519.pub naar een nieuwe regel in het bestand is verplaatst:

~/.ssh/geautoriseerde_sleutels

4. Herstel de back-up op de nieuwe server

Het kan zijn dat je nog steeds moet Installeer Typesense op de nieuwe server, stel SSL in, enz.

Stop vervolgens alle actieve Typesense-instanties:

sudo systemctl stop typesense-server.service

Maak de bestaande gegevensdirectory schoon (controleer of dit daadwerkelijk uw nieuwe, lege server is en niet uw oude server met gegevens):

sudo rm -rf /var/lib/typesense/*

Pak de back-up uit:

sudo tar -xzf /tmp/backup.tar.gz -C /var/lib/

Zorg ervoor dat de geëxtraheerde gegevens zich op het juiste pad bevinden, bijvoorbeeld: /var/lib/typesense.

Start Typesense opnieuw en verwijder het back-up tar-bestand:

sudo systemctl start typesense-server.service rm /tmp/backup.tar.gz

Typesense detecteert de momentopname bij het opstarten en bouwt de in-memory indices opnieuw op.

Eindcontrolelijst

• Back-up gemaakt met Snapshot API of na het stoppen van Typesense
• Gegevens gearchiveerd en geverifieerd
• SSH-sleutelgebaseerde toegang geconfigureerd
• SCP-overdracht veilig voltooid
• Typesense is succesvol opnieuw opgestart op de nieuwe server

Professionele tips

• Test uw back-up voordat u deze in productie gebruikt. Probeer deze te herstellen naar een staging-server.
• Automatiseer regelmatige snapshots met behulp van cron + krul + teer.
• Gebruik veilige API-sleutels en geef de Typesense-beheersleutel nooit prijs in openbare scripts.
• Controleer altijd de Typesense-logs nadat u de service hebt gestart: journalctl -u typensense-server.service

Conclusie

Het migreren van een Typesense-instantie hoeft niet eng te zijn. Met een gedegen begrip van hoe het snapshotmechanisme werkt en een beetje SSH-magie, kunt u uw gegevens betrouwbaar en veilig tussen servers verplaatsen.

Als u problemen ondervindt met de snapshot-API, kunt u nog steeds een koude afsluiting en een handmatige back-up uitvoeren. Volg gewoon de stappen zorgvuldig.

Het is geheel op eigen risico.

Laatst bijgewerkt op 30 juli 2025