Neo4j sur VPS : base de données graphe, Cypher et GraphRAG

Neo4j enregistre des nœuds — un client, un produit, un serveur — porteurs d'étiquettes (:Person, :Product) et de propriétés, reliés par des relations orientées et nommées (:KNOWS, :BOUGHT, :DEPENDS_ON). Une relation est stockée comme un lien direct entre deux nœuds : la suivre ne demande aucune recherche d'index, quelle que soit la taille de la base.

On l'interroge en Cypher, un langage qui dessine le motif recherché : (a:Person)-[:KNOWS]->(b:Person). Les chemins de longueur variable (-[:KNOWS*1..3]->), les plus courts chemins et les agrégations s'écrivent en une ligne, là où SQL empile les jointures ou les requêtes récursives.

Un VPS Ubuntu 24.04 avec 2 Go de RAM et 20 Go de disque, Docker et le plugin Compose installés, nginx et Certbot sur l'hôte, et un sous-domaine qui pointe vers le VPS, par exemple neo4j.example.com. Neo4j est le plus rapide quand le graphe tient dans son cache de pages : prévoyez davantage de mémoire pour un graphe de plusieurs dizaines de millions de nœuds.

Neo4j Browser a besoin de deux choses : l'interface HTTP et une connexion Bolt, que le navigateur ouvre en WebSocket. nginx aiguille les deux sur le même nom : les requêtes ordinaires vers 7474, les demandes de WebSocket vers 7687.

map $http_upgrade $neo4j_backend {
    default   127.0.0.1:7474;
    websocket 127.0.0.1:7687;
}
server {
    listen 80;
    server_name neo4j.example.com;
    location / {
        proxy_pass http://$neo4j_backend;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection $http_connection;
        proxy_set_header Host $host;
        proxy_set_header X-Forwarded-Proto $scheme;
        proxy_read_timeout 3600s;
    }
}

certbot --nginx -d neo4j.example.com

Ouvrez ensuite https://neo4j.example.com. Dans Neo4j Browser, saisissez neo4j+s://neo4j.example.com:443 comme Connect URL, l'utilisateur neo4j et votre mot de passe.

Dans Neo4j Browser, créez une contrainte d'unicité, quelques nœuds et leurs relations, puis suivez un chemin de deux niveaux au plus. MERGE ne crée un nœud ou une relation que s'il n'existe pas encore : la requête peut être rejouée sans doublon.

CREATE CONSTRAINT person_name IF NOT EXISTS FOR (p:Person) REQUIRE p.name IS UNIQUE;
MERGE (sara:Person {name: 'Sara'})
MERGE (yassine:Person {name: 'Yassine'})
MERGE (casa:City {name: 'Casablanca'})
MERGE (sara)-[:KNOWS]->(yassine)
MERGE (yassine)-[:LIVES_IN]->(casa);
MATCH (p:Person {name: 'Sara'})-[:KNOWS*1..2]->(f)-[:LIVES_IN]->(c:City)
RETURN f.name, c.name;

Le Browser dessine le résultat ; la commande :guide ouvre ses tutoriels intégrés, et :sysinfo affiche la taille de la base et l'occupation du cache.

Depuis n'importe quel langage, l'API HTTP reçoit une requête Cypher en POST et répond en JSON, avec l'authentification HTTP de base. Une application installée sur le même VPS utilise plutôt un pilote officiel en Bolt, sur bolt://127.0.0.1:7687. Depuis votre poste de développement, un tunnel SSH rend le même port accessible sans l'ouvrir sur Internet.

curl -s -u neo4j:$NEO4J_PASSWORD \
  -H 'Content-Type: application/json' \
  -d '{"statement": "MATCH (p:Person) RETURN p.name LIMIT 5"}' \
  https://neo4j.example.com/db/neo4j/query/v2

from neo4j import GraphDatabase

driver = GraphDatabase.driver("bolt://127.0.0.1:7687", auth=("neo4j", "<mot-de-passe>"))
records, _, _ = driver.execute_query("MATCH (p:Person) RETURN p.name AS name")
print([r["name"] for r in records])

ssh -L 7687:127.0.0.1:7687 [email protected]

Utilisez le schéma bolt:// et non neo4j:// pour une connexion locale : le second demande la table de routage, qui annonce l'adresse publique sur le port 443.

Un RAG classique retrouve des passages proches de la question. Un GraphRAG ajoute les relations : les entités extraites des documents (personnes, contrats, produits) deviennent des nœuds, reliés entre eux et aux passages qui les citent. Neo4j porte les deux dans la même base, grâce à ses index vectoriels.

CREATE VECTOR INDEX chunk_embedding IF NOT EXISTS
FOR (c:Chunk) ON c.embedding
OPTIONS {indexConfig: {`vector.dimensions`: 768, `vector.similarity_function`: 'cosine'}};

La recherche vectorielle trouve les passages pertinents, puis une requête Cypher suit leurs relations pour rassembler le contexte : l'assistant répond avec des faits reliés et la source de chacun. Les embeddings peuvent venir d'un modèle local servi par Ollama sur le même VPS.

En Community Edition, la sauvegarde se fait base arrêtée, avec neo4j-admin database dump : quelques secondes d'interruption pour un graphe de taille moyenne. Programmez-la la nuit.

cd /opt/neo4j
docker compose stop neo4j
docker compose run --rm -v /opt/neo4j/backups:/backups neo4j \
  neo4j-admin database dump neo4j --to-path=/backups --overwrite-destination=true
docker compose start neo4j

Copiez ensuite backups/neo4j.dump hors du VPS. Pour mettre à jour, changez le numéro de version de l'image dans docker-compose.yml, puis docker compose pull && docker compose up -d, juste après une sauvegarde ; lisez les notes de version avant de changer de version majeure.

Depuis le Marketplace de votre espace client, Neo4j s'installe sur un VPS ServOrbit sans écrire une ligne : Neo4j Community Edition est déployé derrière un petit proxy qui sert Neo4j Browser, l'API HTTP et la connexion Bolt sur un seul port, le mot de passe de l'utilisateur neo4j est généré et affiché dans votre espace client, et l'ensemble est publié en HTTPS sur votre domaine ou sur le sous-domaine gratuit du VPS. Le port Bolt reste disponible en local, sur bolt://127.0.0.1:7687, pour vos applications.