メインコンテンツまでスキップ

Cursor サーバーを手動でインストールする方法

このガイドでは、Cursor サーバーを手動でインストールおよび設定するための詳細な手順を提供します。このアプローチは、カスタムデプロイメント、エアギャップ環境、または標準インストールでは利用できない特定の設定が必要な場合に有用です。

前提条件​

手動インストールを開始する前に、以下が必要です。

  • 対象システムの管理（root アクセス）
  • Node.js 16.x 以降がインストール済み
  • Git がインストール済み
  • 少なくとも4GB の利用可能なRAM
  • 2GB の空きディスク容量

インストール手順​

1. リポジトリのクローン​

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

2. 依存関係のインストール​

npm install
# またはyarn を使用する場合
yarn install

3. 環境変数の設定​

ルートディレクトリに .env ファイルを作成：

touch .env

以下の設定を追加します。

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

4. サーバーのビルド​

npm run build
# または
yarn build

サーバー設定​

基本設定​

サーバーは環境変数または設定ファイルを通じて設定できます：

// 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分
      max: process.env.MAX_REQUESTS_PER_MINUTE || 60
    }
  }
}

高度な設定​

高度なユースケースでは、以下を変更できます。

  1. 認証設定
  2. レート制限
  3. CORS ポリシー
  4. ログレベル
  5. キャッシュ設定

サーバーの実行​

開発モード​

npm run dev
# または
yarn dev

本番モード​

npm run start
# または
yarn start

PM2 の使用（本番環境推奨）​

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

セキュリティの考慮事項​

  1. API 認証

    • API キー認証の実装
    • 本番環境での HTTPS の使用
    • 適切なCORS 設定の構成

  2. レート制限

    • 適切なリクエスト制限の設定
    • IP ベースのスロットリングの実装
    • 乱用の監視

  3. アクセス制御

    • IP によるサーバーアクセスの制限
    • ファイアウォールルールの使用
    • ロールベースのアクセスの実装

監視とメンテナンス​

ヘルスチェック​

ヘルスチェックエンドポイントの実装：

app.get('/health', (req, res) => {
  res.status(200).json({
    status: 'healthy',
    timestamp: new Date().toISOString(),
    version: process.env.npm_package_version
  });
});

ロギング​

トラブルシューティングのためのロギング設定：

import winston from 'winston';

const logger = winston.createLogger({
  level: process.env.LOG_LEVEL || 'info',
  format: winston.format.json(),
  transports: [
    new winston.transports.File({ filename: 'error.log', level: 'error' }),
    new winston.transports.File({ filename: 'combined.log' })
  ]
});

トラブルシューティング​

一般的な問題と解決策：

接続拒否​

接続拒否エラーが発生した場合

  1. ポートが使用中でないことを確認
  2. ファイアウォール設定を確認
  3. ホスト設定が正しいことを確認

メモリの問題​

サーバーのメモリが不足した場合：

  1. Node.js のヒープサイズを増やす
  2. メモリ使用量を監視
  3. ガベージコレクションを実行

パフォーマンスの最適化​

最適なパフォーマンスのためのヒント

  1. キャッシング

    • Redis キャッシングの実装
    • 適切なメモリキャッシングの使用
    • 頻繁にアクセスされるデータのキャッシュ

  2. データベースの最適化

    • 頻繁に照会されるフィールドのインデックス作成
    • クエリパターンの最適化
    • コネクションプーリングの使用

  3. 負荷分散

    • 複数のサーバーインスタンスの設定
    • ロードバランサーの使用
    • 水平スケーリングの実行

関連リソース​

  • Cursor サーバードキュメント
  • API リファレンス
  • セキュリティのベストプラクティス

結論​

Cursor サーバーの手動インストールは、より大きな制御とカスタマイズオプションを提供します。より多くのセットアップ作業が必要ですが、ニーズに基づいて特定の設定と最適化が可能になります。

関連記事​

  • Cursor サーバーセキュリティガイド
  • サーバーパフォーマンスチューニング
  • カスタムサーバー設定