Phaser Baduk Metaverse 프로젝트의 Node.js 백엔드 설정과 구성에 대해 설명합니다.

이 프로젝트는 Node.js를 기반으로 한 서버 사이드 렌더링과 실시간 통신을 제공합니다.

메인 서버 파일 (server.js):

const express = require('express');
const http = require('http');
const socketIo = require('socket.io');
const path = require('path');
 
const app = express();
const server = http.createServer(app);
const io = socketIo(server);
 
// 정적 파일 서빙
app.use(express.static(path.join(__dirname, 'public')));
 
// 라우트 설정
app.get('/', (req, res) => {
    res.sendFile(path.join(__dirname, 'public', 'index.html'));
});
 
// Socket.IO 이벤트 처리
io.on('connection', (socket) => {
    console.log('새로운 클라이언트 연결:', socket.id);
 
    socket.on('join-game', (gameId) => {
        socket.join(gameId);
        console.log(`플레이어가 게임 ${gameId}에 참가했습니다.`);
    });
 
    socket.on('disconnect', () => {
        console.log('클라이언트 연결 해제:', socket.id);
    });
});
 
const PORT = process.env.PORT || 3000;
server.listen(PORT, () => {
    console.log(`서버가 포트 ${PORT}에서 실행 중입니다.`);
});

package.json 주요 의존성:

{
  "name": "phaser-baduk-metaverse",
  "version": "1.0.0",
  "description": "Phaser.js 기반 바둑 메타버스 게임",
  "main": "server.js",
  "scripts": {
    "start": "node server.js",
    "dev": "nodemon server.js",
    "pm2": "pm2 start server.js"
  },
  "dependencies": {
    "express": "^4.18.2",
    "socket.io": "^4.7.2",
    "cors": "^2.8.5"
  },
  "devDependencies": {
    "nodemon": "^3.0.1"
  }
}

환경 변수 설정:

# .env 파일
NODE_ENV=development
PORT=3000
DB_PATH=./db.json

개발 환경 실행:

# 개발 모드 (nodemon 사용)
npm run dev
 
# 프로덕션 모드
npm start

게임 데이터 저장소 (db.json):

{
  "games": {},
  "users": {},
  "rooms": {},
  "statistics": {
    "totalGames": 0,
    "activePlayers": 0
  }
}

로그 레벨 설정:

// 개발 환경에서 상세 로그 출력
if (process.env.NODE_ENV === 'development') {
    console.log('🔧 개발 모드로 실행 중');
    console.log('📊 메모리 사용량:', process.memoryUsage());
}

에러 핸들링:

process.on('uncaughtException', (err) => {
    console.error('❌ 처리되지 않은 예외:', err);
    process.exit(1);
});
 
process.on('unhandledRejection', (reason, promise) => {
    console.error('❌ 처리되지 않은 Promise 거부:', reason);
});

메모리 관리:

// 주기적인 메모리 정리
setInterval(() => {
    if (global.gc) {
        global.gc();
        console.log('🧹 가비지 컬렉션 실행');
    }
}, 30000); // 30초마다

클러스터 모드:

const cluster = require('cluster');
const numCPUs = require('os').cpus().length;
 
if (cluster.isMaster) {
    console.log(`마스터 프로세스 ${process.pid} 실행 중`);
 
    // 워커 프로세스 생성
    for (let i = 0; i < numCPUs; i++) {
        cluster.fork();
    }
 
    cluster.on('exit', (worker, code, signal) => {
        console.log(`워커 ${worker.process.pid} 종료`);
        cluster.fork(); // 새로운 워커 생성
    });
} else {
    // 워커 프로세스에서 서버 실행
    require('./server.js');
}

• Express.js 웹 프레임워크
• Socket.IO 실시간 통신
• PM2 프로세스 관리

— 이 페이지는 자동으로 생성되었습니다.