차이

문서의 선택한 두 판 사이의 차이를 보여줍니다.

--- wiki:it:dream_of_enc:metaverse:nodejs [2025/07/29 06:13] – syjang0803
+++ wiki:it:dream_of_enc:metaverse:nodejs [2025/07/30 06:43] (현재) – 바깥 편집 127.0.0.1
@@ 줄 1: / 줄 1: @@
 ====== 🟢 Node.js 백엔드 설정 ======
-Phaser Baduk Metaverse 프로젝트의 Node.js 백엔드 설정과 구성에 대해 자세히 설명합니다.
+Phaser Baduk Metaverse 프로젝트의 ''Node.js'' 백엔드 설정과 구성에 대해 자세히 설명합니다.
 ----
-==== 1. 프로젝트 개요 ====
+===== 1. Node.js란 무엇인가요? =====
-  * 이 프로젝트는 Node.js를 기반으로 하며, 웹 페이지를 서버에서 렌더링하고 클라이언트와의 실시간 통신 기능을 제공합니다.
-  * 주요 기술 스택은 ''Express.js'' (웹 프레임워크)와 ''Socket.IO'' (실시간 통신 라이브러리)입니다.
+''Node.js''는 ''JavaScript''를 서버에서 실행할 수 있게 해주는 런타임 환경입니다. 웹 브라우저에서만 실행되던 ''JavaScript''를 서버에서도 실행할 수 있게 해줍니다.
+**주요 특징:**
+  * ''JavaScript''로 서버를 만들 수 있습니다.
+  * 비동기 처리에 강점이 있습니다.
+  * ''npm''을 통해 다양한 패키지를 사용할 수 있습니다.
+  * 빠른 개발이 가능합니다.
 ----
-==== 2. 서버 구조 및 주요 파일 ====
+===== 2. 프로젝트 개요 =====
+이 프로젝트는 ''Node.js''를 기반으로 하며, 웹 페이지를 서버에서 렌더링하고 클라이언트와의 실시간 통신 기능을 제공합니다.
+**주요 기술 스택:**
+  * **''Express.js''** - 웹 프레임워크
+  * **''Socket.IO''** - 실시간 통신 라이브러리
+  * **''PM2''** - 프로세스 관리 도구
+----
+===== 3. 서버 구조 및 주요 파일 =====
 Phaser Baduk Metaverse 프로젝트의 핵심 서버 파일인 ''server.js''의 구조와 각 부분의 역할에 대해 설명합니다.
-=== 1) 초기 설정 및 모듈 불러오기 ===
+==== 1) 초기 설정 및 모듈 불러오기 ====
-서버 구동에 필요한 ''Express'', ''HTTP'', ''Socket.IO'' 모듈을 불러오고, 애플리케이션 인스턴스를 초기화합니다.
-<code>javascript
+서버 구동에 필요한 모듈들을 불러오고, 애플리케이션 인스턴스를 초기화합니다.
+<file javascript>
 const express = require('express'); // 웹 서버 프레임워크
 const http = require('http');     // HTTP 서버 모듈
 const socketIo = require('socket.io'); // 실시간 웹 소켓 라이브러리
 const path = require('path');     // 파일 경로 처리 유틸리티
+</file>
+**각 모듈의 역할:**
+  * ''express'' - 웹 서버를 쉽게 만들 수 있는 프레임워크
+  * ''http'' - ''HTTP'' 서버를 생성하는 기본 모듈
+  * ''socket.io'' - 실시간 양방향 통신을 위한 라이브러리
+  * ''path'' - 파일 경로를 안전하게 처리하는 유틸리티
+==== 2) 애플리케이션 인스턴스 생성 ====
+<file javascript>
 const app = express(); // Express 애플리케이션 생성
 const server = http.createServer(app); // HTTP 서버 생성 (Express 앱을 기반으로)
 const io = socketIo(server); // Socket.IO 서버 생성 (HTTP 서버에 연결)
-</code>
+</file>
-=== 2) 정적 파일 서빙 및 라우팅 ===
+**설명:**
-클라이언트(프론트엔드)에 제공될 정적 파일(HTML, CSS, JS, 이미지 등)을 설정하고, 기본 경로에 대한 라우트를 정의합니다.
+  * ''app'' - ''Express'' 애플리케이션 객체
+  * ''server'' - ''HTTP'' 서버 객체 (''Express'' 앱을 기반으로 생성)
+  * ''io'' - ''Socket.IO'' 서버 객체 (''HTTP'' 서버에 연결)
-<code>javascript
+==== 3) 정적 파일 서빙 및 라우팅 ====
-// 'public' 디렉토리에 있는 정적 파일들을 클라이언트에게 제공 (예: index.html, style.css)
-app.use(express.static(path.join(__dirname, 'public')));
+클라이언트(프론트엔드)에 제공될 정적 파일(''HTML'', ''CSS'', ''JS'', 이미지 등)을 설정하고, 기본 경로에 대한 라우트를 정의합니다.
+<file javascript>
+// 'public' 디렉토리에 있는 정적 파일들을 클라이언트에게 제공
+app.use(express.static(path.join(dirname, 'public')));
 // 루트 경로('/')로 접근 시 'public' 디렉토리 내의 'index.html' 파일 전송
 app.get('/', (req, res) => {
-    res.sendFile(path.join(__dirname, 'public', 'index.html'));
+    res.sendFile(path.join(dirname, 'public', 'index.html'));
 });
-</code>
+</file>
-=== 3) Socket.IO 이벤트 처리 ===
+**설명:**
-클라이언트와 서버 간의 실시간 통신을 담당하는 ''Socket.IO'' 이벤트 핸들러를 설정합니다. 클라이언트 연결 및 게임 참여 이벤트를 처리합니다.
+  * ''express.static()'' - 정적 파일을 웹에서 접근 가능하게 합니다.
+  * ''path.join(dirname, 'public')'' - 현재 디렉토리의 ''public'' 폴더 경로입니다.
+  * ''app.get('/')'' - 루트 경로로 접근했을 때 실행되는 함수입니다.
-<code>javascript
+==== 4) Socket.IO 이벤트 처리 ====
+클라이언트와 서버 간의 실시간 통신을 담당하는 ''Socket.IO'' 이벤트 핸들러를 설정합니다.
+<file javascript>
 // Socket.IO 연결 이벤트 처리
 io.on('connection', (socket) => {
@@ 줄 58: / 줄 99: @@
     });
 });
-</code>
+</file>
+**설명:**
+  * ''io.on('connection')'' - 새로운 클라이언트가 연결될 때 실행됩니다.
+  * ''socket.on('join-game')'' - 클라이언트가 게임 참가 요청을 보낼 때 실행됩니다.
+  * ''socket.join(gameId)'' - 특정 게임방에 소켓을 추가합니다.
+  * ''socket.on('disconnect')'' - 클라이언트 연결이 끊어질 때 실행됩니다.
+==== 5) 서버 포트 설정 및 실행 ====
-=== 4) 서버 포트 설정 및 실행 ===
 환경 변수에서 포트 번호를 가져오거나 기본값(3000)을 사용하여 서버를 지정된 포트에서 실행합니다.
-<code>javascript
+<file javascript>
 // 환경 변수에서 PORT를 가져오거나 기본값 3000 사용
 const PORT = process.env.PORT || 3000;
@@ 줄 70: / 줄 118: @@
 server.listen(PORT, () => {
     console.log(`서버가 포트 ${PORT}에서 실행 중입니다.`);
+    console.log(`http://localhost:${PORT}에서 접속하세요.`);
 });
-</code>
+</file>
+**설명:**
+  * ''process.env.PORT'' - 환경 변수에서 포트 번호를 가져옵니다.
+  * ''|| 3000'' - 환경 변수가 없으면 기본값 3000을 사용합니다.
+  * ''server.listen()'' - 서버를 지정된 포트에서 시작합니다.
+  * 콜백 함수는 서버 시작 성공 시 실행되는 함수입니다.
 ----
-==== 3. 의존성 관리 (package.json) ====
+===== 4. 의존성 관리 (package.json) =====
 프로젝트에 필요한 라이브러리 및 스크립트를 정의하는 ''package.json'' 파일의 주요 내용을 설명합니다.
-=== 1) 프로젝트 정보 ===
+==== 1) 프로젝트 정보 ====
 ^ 키 ^ 설명 ^
 | name | 프로젝트 이름 |
@@ 줄 84: / 줄 141: @@
 | main | 프로젝트의 진입점 파일 (여기서는 ''server.js'') |
-=== 2) 스크립트 ===
+==== 2) 스크립트 ====
 자주 사용되는 명령어를 단축하여 정의합니다.
 ^ 스크립트 ^ 설명 ^ 명령어 ^
 | start | 프로덕션 환경에서 서버를 시작합니다. | ''node server.js'' |
@@ 줄 91: / 줄 150: @@
 | pm2 | ''PM2''를 사용하여 서버를 시작합니다. (프로세스 관리용) | ''pm2 start server.js'' |
-=== 3) 의존성 목록 ===
+==== 3) 의존성 목록 ====
 ^ 의존성 ^ 버전 ^ 설명 ^
 | express | 4.18.2 | Node.js 웹 애플리케이션 프레임워크 |
 | socket.io | 4.7.2 | 실시간 양방향 웹 소켓 통신 라이브러리 |
 | cors | 2.8.5 | 교차 출처 리소스 공유 (CORS) 미들웨어 |
+| helmet | 7.0.0 | 보안 헤더 설정 미들웨어 |
+| compression | 1.7.4 | 응답 압축 미들웨어 |
+| express-rate-limit | 6.7.0 | 요청 제한 미들웨어 |
+==== 4) 개발 의존성 목록 ====
-=== 4) 개발 의존성 목록 ===
 ^ 의존성 ^ 버전 ^ 설명 ^
-| nodemon | 3.0.1 | 개발 중 파일 변경을 감지하여 서버를 자동으로 재시작하는 유틸리티 |
+| nodemon | 2.0.22 | 개발 시 코드 변경 감지하여 서버 자동 재시작 |
+| jest | 29.5.0 | JavaScript 테스트 프레임워크 |
+| supertest | 6.3.3 | HTTP 테스트 라이브러리 |
+----
+===== 5. 환경 설정 =====
+==== 1) 환경 변수 설정 ====
+프로젝트 루트에 ''.env'' 파일을 생성하여 환경 변수를 설정합니다:
+<file bash>
+# 서버 포트 설정
+PORT=3000
+# 데이터베이스 연결 정보
+MONGODB_URI=mongodb://localhost:27017/baduk_metaverse
+# JWT 시크릿 키
+JWT_SECRET=your-secret-key-here
+# 환경 설정
+NODE_ENV=development
+</file>
+**주요 환경 변수:**
+  * ''PORT'' - 서버가 실행될 포트 번호
+  * ''MONGODB_URI'' - ''MongoDB'' 데이터베이스 연결 문자열
+  * ''JWT_SECRET'' - ''JWT'' 토큰 암호화에 사용할 시크릿 키
+  * ''NODE_ENV'' - 현재 환경 (''development''/''production'')
+==== 2) 환경 변수 사용법 ====
+<file javascript>
+// dotenv 패키지를 사용하여 .env 파일 로드
+require('dotenv').config();
+// 환경 변수 사용
+const PORT = process.env.PORT || 3000;
+const MONGODB_URI = process.env.MONGODB_URI;
+const JWT_SECRET = process.env.JWT_SECRET;
+</file>
+**설명:**
+  * ''require('dotenv').config()'' - ''.env'' 파일을 로드합니다.
+  * ''process.env.변수명'' - 환경 변수 값을 가져옵니다.
+  * ''|| 기본값'' - 환경 변수가 없을 때 기본값을 사용합니다.
+----
+===== 6. 프로젝트 구조 =====
+**권장하는 프로젝트 폴더 구조:**
+<file>
+baduk-metaverse/
+├── server.js              # 메인 서버 파일
+├── package.json           # 프로젝트 설정 파일
+├── .env                   # 환경 변수 파일
+├── .gitignore            # Git 무시 파일 목록
+├── public/               # 정적 파일 폴더
+│   ├── index.html        # 메인 HTML 파일
+│   ├── css/              # CSS 파일들
+│   ├── js/               # 클라이언트 JavaScript 파일들
+│   └── images/           # 이미지 파일들
+├── routes/               # 라우트 파일들
+│   ├── games.js          # 게임 관련 라우트
+│   ├── users.js          # 사용자 관련 라우트
+│   └── statistics.js     # 통계 관련 라우트
+├── controllers/          # 컨트롤러 파일들
+│   ├── BadukGameController.js
+│   ├── UserController.js
+│   └── StatisticsController.js
+├── models/               # 데이터 모델 파일들
+│   ├── BadukGame.js
+│   ├── User.js
+│   └── BadukGameState.js
+├── middleware/           # 미들웨어 파일들
+│   ├── auth.js           # 인증 미들웨어
+│   └── errorHandler.js   # 에러 처리 미들웨어
+├── utils/                # 유틸리티 파일들
+│   ├── BadukMoveValidator.js
+│   └── helpers.js
+└── tests/                # 테스트 파일들
+    ├── server.test.js
+    └── game.test.js
+</file>
+**각 폴더의 역할:**
+  * ''public/'' - 클라이언트에게 제공할 파일들
+  * ''routes/'' - ''URL'' 경로별 처리 로직
+  * ''controllers/'' - 비즈니스 로직 처리
+  * ''models/'' - 데이터 구조 정의
+  * ''middleware/'' - 요청 처리 중간 단계
+  * ''utils/'' - 공통 유틸리티 함수들
+  * ''tests/'' - 테스트 코드들
+----
+===== 7. 개발 환경 설정 =====
+==== 1) Node.js 설치 ====
+**Windows에서 Node.js 설치:**
+  * ''Node.js'' 공식 웹사이트 (''https://nodejs.org'') 방문
+  * ''LTS'' 버전 다운로드 및 설치
+  * 설치 완료 후 터미널에서 확인:
+<file bash>
+node --version
+npm --version
+</file>
+==== 2) 프로젝트 초기화 ====
+<file bash>
+# 새 폴더 생성 및 이동
+mkdir baduk-metaverse
+cd baduk-metaverse
+# npm 프로젝트 초기화
+npm init -y
+# 필요한 패키지 설치
+npm install express socket.io cors helmet compression express-rate-limit
+# 개발용 패키지 설치
+npm install --save-dev nodemon
+</file>
+==== 3) 기본 서버 파일 생성 ====
+''server.js'' 파일을 생성하고 기본 코드를 작성합니다:
+<file javascript>
+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('disconnect', () => {
+        console.log('클라이언트 연결 해제:', socket.id);
+    });
+});
+// 서버 시작
+const PORT = process.env.PORT || 3000;
+server.listen(PORT, () => {
+    console.log(`서버가 포트 ${PORT}에서 실행 중입니다.`);
+});
+</file>
+==== 4) package.json 스크립트 설정 ====
 <file json>
 {
-  "name": "phaser-baduk-metaverse",
+  "name": "baduk-metaverse",
   "version": "1.0.0",
-  "description": "Phaser.js 기반 바둑 메타버스 게임",
+  "description": "Phaser Baduk Metaverse 프로젝트",
   "main": "server.js",
   "scripts": {
     "start": "node server.js",
     "dev": "nodemon server.js",
-    "pm2": "pm2 start server.js"
+    "test": "jest"
   },
   "dependencies": {
     "express": "^4.18.2",
     "socket.io": "^4.7.2",
-    "cors": "^2.8.5"
+    "cors": "^2.8.5",
+    "helmet": "^7.0.0",
+    "compression": "^1.7.4",
+    "express-rate-limit": "^6.7.0"
   },
   "devDependencies": {
-    "nodemon": "^3.0.1"
+    "nodemon": "^2.0.22",
+    "jest": "^29.5.0"
   }
 }
@@ 줄 124: / 줄 357: @@
 ----
-==== 4. 환경 설정 ====
+===== 8. 서버 실행 및 테스트 =====
-애플리케이션의 동작 방식을 제어하는 환경 변수 설정 및 서버 실행 방법을 설명합니다.
-=== 1) 환경 변수 파일 (.env) ===
+==== 1) 개발 모드로 서버 실행 ====
-민감한 정보나 환경별로 달라지는 설정값은 '''.env''' 파일에 저장하여 관리합니다. 이 파일은 버전 관리 시스템에 포함되지 않도록 하는 것이 일반적입니다.
 <file bash>
-# .env 파일 예시
+npm run dev
-NODE_ENV=development // 현재 실행 환경 (development, production 등)
-PORT=3000            // 서버가 사용할 포트 번호
-DB_PATH=./db.json    // 데이터베이스 파일 경로
 </file>
-=== 2) 서버 실행 명령어 ===
+**설명:**
-개발 및 프로덕션 환경에서 서버를 실행하는 방법을 설명합니다.
+  * ''nodemon''을 사용하여 서버를 실행합니다.
-  * 개발 모드: ''nodemon''을 사용하여 코드 변경 시 서버가 자동으로 재시작됩니다.
+  * 코드 변경 시 자동으로 서버가 재시작됩니다.
-    <code>bash
+  * 개발 중에 매우 유용합니다.
-    npm run dev
-    </code>
-  * 프로덕션 모드: ''node'' 명령어로 직접 실행하며, 안정적인 서비스 운영에 적합합니다.
-    <code>bash
-    npm start
-    </code>
-----
+==== 2) 프로덕션 모드로 서버 실행 ====
-==== 5. 데이터 관리 ====
-게임 및 사용자 관련 데이터를 저장하고 관리하는 ''db.json'' 파일의 구조를 설명합니다.
-=== 1) 게임 데이터 저장소 (db.json) ===
+<file bash>
-게임의 상태, 사용자 정보, 방 정보, 통계 등을 저장하는 데 사용될 수 있는 JSON 파일 구조입니다. 실제 프로젝트에서는 데이터베이스(예: MongoDB, PostgreSQL)를 사용할 수 있습니다.
+npm start
+</file>
-<file json>
+**설명:**
-{
+  * ''node''를 사용하여 서버를 실행합니다.
-  "games": {}, // 현재 진행 중이거나 완료된 게임 정보
+  * 코드 변경 시 수동으로 서버를 재시작해야 합니다.
-  "users": {}, // 사용자 계정 및 프로필 정보
+  * 실제 서비스 환경에서 사용합니다.
-  "rooms": {}, // 생성된 게임 방 정보
-  "statistics": { // 전반적인 게임 통계
+==== 3) 서버 테스트 ====
-    "totalGames": 0, // 총 게임 수
-    "activePlayers": 0 // 현재 접속 중인 플레이어 수
+**브라우저에서 테스트:**
-  }
+  * 브라우저 열기
-}
+  * ''http://localhost:3000'' 접속
+  * 서버가 정상적으로 응답하는지 확인
+**터미널에서 테스트:**
+<file bash>
+curl http://localhost:3000
 </file>
 ----
-==== 6. 디버깅 및 에러 핸들링 ====
+===== 9. 디버깅 및 로깅 =====
-서버의 디버깅을 돕고, 예상치 못한 에러 발생 시 안정적으로 처리하는 방법에 대해 설명합니다.
-=== 1) 로그 레벨 설정 ===
+==== 1) 콘솔 로깅 ====
-개발 환경에서 상세한 로그를 출력하여 디버깅을 용이하게 합니다.
-<code>javascript
+<file javascript>
-// Node.js 환경 변수 'NODE_ENV'가 'development'일 경우 상세 로그 출력
+// 기본 로깅
-if (process.env.NODE_ENV === 'development') {
+console.log('일반 메시지');
-    console.log('🔧 개발 모드로 실행 중');
+console.error('에러 메시지');
-    // 현재 Node.js 프로세스의 메모리 사용량 출력
+console.warn('경고 메시지');
-    console.log('📊 메모리 사용량:', process.memoryUsage());
-}
-</code>
-=== 2) 전역 에러 핸들링 ===
+// 객체 로깅
-처리되지 않은 예외(Exception)나 Promise 거부(Rejection)가 발생했을 때 애플리케이션이 비정상적으로 종료되는 것을 방지하고, 에러를 기록합니다.
+const gameData = { id: 1, name: '바둑 게임' };
+console.log('게임 데이터:', gameData);
-<code>javascript
+// 시간과 함께 로깅
-// 처리되지 않은 동기 예외 발생 시 호출
+console.log(`${new Date().toISOString()} - 서버 시작됨`);
-process.on('uncaughtException', (err) => {
+</file>
-    console.error('❌ 처리되지 않은 예외:', err);
-    process.exit(1); // 애플리케이션 종료 (상태 코드 1: 오류)
+==== 2) 로깅 미들웨어 ====
+<file javascript>
+// 요청 로깅 미들웨어
+app.use((req, res, next) => {
+    console.log(`${new Date().toISOString()} - ${req.method} ${req.url}`);
+    next();
 });
-// 처리되지 않은 Promise 거부(reject) 발생 시 호출
+// 에러 로깅 미들웨어
-process.on('unhandledRejection', (reason, promise) => {
+app.use((err, req, res, next) => {
-    console.error('❌ 처리되지 않은 Promise 거부:', reason);
+    console.error('서버 에러:', err);
-    // 이 경우 애플리케이션을 종료할지 여부는 상황에 따라 다를 수 있습니다.
+    res.status(500).json({ error: '서버 내부 오류가 발생했습니다.' });
 });
-</code>
+</file>
+==== 3) 디버깅 도구 ====
+**Node.js 내장 디버거 사용:**
+<file bash>
+node --inspect server.js
+</file>
+**Chrome DevTools에서 디버깅:**
+  * Chrome 브라우저 열기
+  * %%chrome://inspect%% 접속
+  * "Open dedicated DevTools for Node" 클릭
 ----
-==== 7. 성능 최적화 ====
+===== 10. 성능 최적화 =====
-Node.js 애플리케이션의 성능을 향상시키기 위한 기법들을 설명합니다.
-=== 1) 메모리 관리 (가비지 컬렉션) ===
+==== 1) 압축 설정 ====
-주기적으로 가비지 컬렉션을 명시적으로 실행하여 메모리 사용량을 최적화할 수 있습니다. 이는 특히 메모리 누수가 의심될 때 유용합니다.
+<file javascript>
+const compression = require('compression');
+// 응답 압축 미들웨어
+app.use(compression());
+</file>
+==== 2) 캐싱 설정 ====
+<file javascript>
+// 정적 파일 캐싱
+app.use(express.static(path.join(dirname, 'public'), {
+    maxAge: '1d', // 1일간 캐시
+    etag: true    // ETag 사용
+}));
+</file>
+==== 3) 요청 제한 ====
+<file javascript>
+const rateLimit = require('express-rate-limit');
+// API 요청 제한
+const limiter = rateLimit({
+    windowMs: 15 * 60 * 1000, // 15분
+    max: 100, // IP당 최대 100개 요청
+    message: '너무 많은 요청이 발생했습니다.'
+});
+app.use('/api/', limiter);
+</file>
+----
+===== 11. 보안 설정 =====
+==== 1) Helmet 미들웨어 ====
+<file javascript>
+const helmet = require('helmet');
-<code>javascript
+// 보안 헤더 설정
-// 30초마다 가비지 컬렉션(GC)을 명시적으로 실행
+app.use(helmet({
-setInterval(() => {
+    contentSecurityPolicy: {
-    // Node.js에서 'global.gc'를 사용하려면 'node --expose-gc' 옵션으로 실행해야 합니다.
+        directives: {
-    if (global.gc) {
+            defaultSrc: ["'self'"],
-        global.gc(); // 가비지 컬렉션 강제 실행
+            styleSrc: ["'self'", "'unsafe-inline'"],
-        console.log('🧹 가비지 컬렉션 실행');
+            scriptSrc: ["'self'", "'unsafe-inline'"],
+            imgSrc: ["'self'", "data:", "https:"],
+            connectSrc: ["'self'", "ws:", "wss:"]
+        }
     }
-}, 30000); // 30000 밀리초 = 30초
+}));
-</code>
+</file>
-=== 2) 클러스터 모드 ===
+==== 2) CORS 설정 ====
-Node.js는 단일 스레드 기반이지만, ''cluster'' 모듈을 사용하여 CPU 코어 수만큼 워커 프로세스를 생성하여 멀티코어 CPU의 이점을 활용하고, 서버의 안정성과 처리량을 향상시킬 수 있습니다.
 <file javascript>
-const cluster = require('cluster'); // Node.js 클러스터 모듈
+const cors = require('cors');
-const numCPUs = require('os').cpus().length; // 시스템의 CPU 코어 수
-// 현재 프로세스가 마스터 프로세스인지 확인
+// CORS 설정
-if (cluster.isMaster) {
+app.use(cors({
-    console.log(`마스터 프로세스 ${process.pid} 실행 중`);
+    origin: process.env.NODE_ENV === 'production'
+        ? ['https://yourdomain.com']
+        : ['http://localhost:3000'],
+    credentials: true
+}));
+</file>
+==== 3) 입력 데이터 검증 ====
+<file javascript>
+// 입력 데이터 검증 예제
+app.post('/api/games', (req, res) => {
+    const { gameType, settings } = req.body;
-    // CPU 코어 수만큼 워커 프로세스 생성
+    // 필수 필드 검증
-    for (let i = 0; i < numCPUs; i++) {
+    if (!gameType) {
-        cluster.fork(); // 새로운 워커 프로세스 생성
+        return res.status(400).json({ error: '게임 타입이 필요합니다.' });
     }
-    // 워커 프로세스가 종료될 때 (예: 예외 발생 또는 수동 종료)
+    // 데이터 타입 검증
-    cluster.on('exit', (worker, code, signal) => {
+    if (typeof gameType !== 'string') {
-        console.log(`워커 ${worker.process.pid} 종료 (코드: ${code}, 시그널: ${signal})`);
+        return res.status(400).json({ error: '게임 타입은 문자열이어야 합니다.' });
-        cluster.fork(); // 안정적인 서비스를 위해 새로운 워커 재시작
+    }
-    });
-} else {
+    // 추가 처리...
-    // 워커 프로세스는 실제 서버 로직을 실행
+});
-    // 이 경우 'server.js' 파일이 워커 프로세스 내에서 다시 로드되어 서버가 실행됩니다.
-    require('./server.js');
-}
 </file>
 ----
-==== 8. 관련 문서 ====
+===== 12. 다음 단계 =====
-  * [[wiki:it:dream_of_enc:metaverse:express|Express.js 웹 프레임워크]]
-  * [[wiki:it:dream_of_enc:metaverse:socketio|Socket.IO 실시간 통신]]
+''Node.js'' 기본을 배웠다면 다음을 학습해보세요:
-  * [[wiki:it:dream_of_enc:metaverse:pm2|PM2 프로세스 관리]]
+  * **''Express.js''** - 웹 프레임워크 심화 학습
+  * **''Socket.IO''** - 실시간 통신 구현
+  * **데이터베이스 연동** - ''MongoDB'', ''MySQL'' 등
+  * **인증 시스템** - ''JWT'', ''Passport.js'' 등
+  * **테스트 작성** - ''Jest'', ''Mocha'' 등
+**추천 학습 순서:**
+  - [[wiki:it:dream_of_enc:metaverse:express|🚀 Express.js 웹 프레임워크]]
+  - [[wiki:it:dream_of_enc:metaverse:socketio|🔌 Socket.IO 실시간 통신]]
+  - [[wiki:it:dream_of_enc:metaverse:pm2|⚡ PM2 프로세스 관리]]
 ---
 //이 페이지는 자동으로 생성되었습니다.//
 ---