Zum Hauptinhalt springen

Manuelle Installation des Cursor-Servers

Dieser Leitfaden bietet detaillierte Anweisungen zur manuellen Installation und Konfiguration des Cursor-Servers. Diese Methode ist nützlich für benutzerdefinierte Bereitstellungen, Air-Gapped-Umgebungen oder wenn spezifische Konfigurationen erforderlich sind, die in der Standardinstallation nicht verfügbar sind.

Voraussetzungen​

Bevor Sie mit der manuellen Installation beginnen, stellen Sie sicher, dass Sie Folgendes haben:

  • Administrator/Root-Zugriff auf das Zielsystem
  • Node.js 16.x oder höher installiert
  • Git installiert
  • Mindestens 4 GB verfügbarer RAM
  • 2 GB freier Festplattenspeicher

Installationsschritte​

1. Repository klonen​

git clone https://github.com/getcursor/cursor-server.git
cd cursor-server

2. Abhängigkeiten installieren​

npm install
# oder wenn Sie yarn bevorzugen
yarn install

3. Umgebungsvariablen konfigurieren​

Erstellen Sie eine .env-Datei im Root-Verzeichnis:

touch .env

Fügen Sie folgende Konfiguration hinzu:

PORT=3000
HOST=localhost
NODE_ENV=production
LOG_LEVEL=info
MAX_REQUESTS_PER_MINUTE=60

4. Server bauen​

npm run build
# oder
yarn build

Server-Konfiguration​

Basiskonfiguration​

Der Server kann über Umgebungsvariablen oder eine Konfigurationsdatei konfiguriert werden:

// config.ts
export default {
  server: {
    port: process.env.PORT || 3000,
    host: process.env.HOST || 'localhost',
    cors: {
      origin: '*',
      methods: ['GET', 'POST']
    }
  },
  security: {
    rateLimit: {
      windowMs: 60 * 1000, // 1 Minute
      max: process.env.MAX_REQUESTS_PER_MINUTE || 60
    }
  }
}

Erweiterte Konfiguration​

Für fortgeschrittene Anwendungsfälle können Sie Folgendes anpassen:

  1. Authentifizierungseinstellungen
  2. Ratenlimits
  3. CORS-Richtlinie
  4. Logging-Level
  5. Cache-Konfiguration

Server ausführen​

Entwicklungsmodus​

npm run dev
# oder
yarn dev

Produktionsmodus​

npm run start
# oder
yarn start

PM2 verwenden (empfohlen für Produktion)​

npm install -g pm2
pm2 start npm --name "cursor-server" -- start

Sicherheitsüberlegungen​

  1. API-Authentifizierung

    • API-Schlüssel-Authentifizierung implementieren
    • HTTPS in Produktion verwenden
    • Angemessene CORS-Einstellungen konfigurieren

  2. Ratenlimitierung

    • Angemessene Anfragelimits konfigurieren
    • IP-basierte Drosselung implementieren
    • Missbrauch überwachen

  3. Zugriffskontrolle

    • Serverzugriff nach IP einschränken
    • Firewall-Regeln verwenden
    • Rollenbasierte Zugriffskontrolle implementieren

Überwachung und Wartung​

Gesundheitsprüfung​

Implementieren Sie einen Gesundheitsprüfungs-Endpunkt: