Aller au contenu principal

Guide d'installation manuelle du serveur Cursor

Ce guide vous montrera comment installer et configurer manuellement le serveur Cursor sur votre système.

Prérequis​

Configuration système requise​

  • Système d'exploitation : Windows 10+, macOS 10.15+, ou Linux
  • Processeur : 2 cœurs ou plus
  • Mémoire : 4 Go RAM minimum
  • Espace disque : 1 Go d'espace libre
  • Connexion Internet stable

Dépendances logicielles​

  • Node.js 16.x ou supérieur
  • npm 7.x ou supérieur
  • Git
  • Python 3.8+ (pour certaines fonctionnalités)

Étapes d'installation​

1. Cloner le dépôt​

# Cloner le dépôt Cursor
git clone https://github.com/cursor/cursor-server.git
cd cursor-server

2. Installer les dépendances​

# Installer les dépendances npm
npm install

# Installer les dépendances Python (si nécessaire)
pip install -r requirements.txt

3. Configurer les variables d'environnement​

Créez un fichier .env à la racine du projet :

# Configuration du serveur
PORT=3000
NODE_ENV=production

# Configuration de la base de données
DB_HOST=localhost
DB_PORT=5432
DB_NAME=cursor
DB_USER=your_username
DB_PASSWORD=your_password

# Configuration de l'authentification
JWT_SECRET=your_jwt_secret

4. Configurer la base de données​

# Créer la base de données
createdb cursor

# Exécuter les migrations
npm run migrate

5. Compiler le serveur​

# Compiler le code TypeScript
npm run build

# Vérifier la compilation
npm run test

6. Démarrer le serveur​

# Mode production
npm start

# Mode développement
npm run dev

Options de configuration​

1. Paramètres du serveur​

{
  "server": {
    "port": 3000,
    "host": "localhost",
    "timeout": 30000,
    "maxConnections": 100
  }
}

2. Configuration SSL/TLS​

{
  "ssl": {
    "enabled": true,
    "cert": "/path/to/cert.pem",
    "key": "/path/to/key.pem"
  }
}

3. Configuration des logs​

{
  "logging": {
    "level": "info",
    "format": "json",
    "destination": "/var/log/cursor"
  }
}

Dépannage​

1. Problèmes de port​

# Vérifier les ports utilisés
netstat -tulpn | grep LISTEN

# Changer le port dans la configuration
PORT=3001 npm start

2. Erreurs de base de données​

# Vérifier la connexion
psql -h localhost -U your_username -d cursor

# Réinitialiser la base de données
npm run db:reset

3. Problèmes de permissions​

# Vérifier les permissions
ls -la /var/log/cursor

# Corriger les permissions
chmod -R 755 /var/log/cursor

Surveillance et maintenance​

1. Vérification des logs​

# Voir les logs en temps réel
tail -f /var/log/cursor/server.log

# Analyser les erreurs
grep ERROR /var/log/cursor/server.log

2. Surveillance des performances​

# Vérifier l'utilisation des ressources
top -p $(pgrep -f cursor-server)

# Surveiller la mémoire
pm2 monit

3. Sauvegarde​

# Sauvegarder la base de données
pg_dump cursor > backup.sql

# Sauvegarder la configuration
cp .env .env.backup

Considérations de sécurité​

1. Configuration du pare-feu​

# Autoriser le port du serveur
sudo ufw allow 3000/tcp

# Vérifier les règles
sudo ufw status

2. Certificats SSL​

# Générer un certificat auto-signé
openssl req -x509 -nodes -days 365 -newkey rsa:2048 \
  -keyout private.key -out certificate.crt

3. Contrôle d'accès​

{
  "security": {
    "allowedOrigins": ["https://yourdomain.com"],
    "rateLimit": {
      "windowMs": 900000,
      "max": 100
    }
  }
}

Mise à jour et maintenance​

1. Mise à jour du serveur​

# Mettre à jour le code
git pull origin main

# Mettre à jour les dépendances
npm install

# Reconstruire le serveur
npm run build

2. Nettoyage​

# Nettoyer les fichiers temporaires
npm run clean

# Nettoyer les logs
npm run clean:logs

Conclusion​

L'installation manuelle du serveur Cursor vous donne un contrôle total sur votre environnement. Suivez ce guide pour une installation réussie et une configuration optimale.

Ressources supplémentaires :

Dernière mise à jour : Février 2025 - Ce guide couvre Cursor Server version 1.0.0.