차이

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

--- wiki:it:dream_of_enc:metaverse:nodejs [2025/07/29 07:02] – 바깥 편집 127.0.0.1
+++ wiki:it:dream_of_enc:metaverse:nodejs [2025/07/30 06:43] (현재) – 바깥 편집 127.0.0.1
@@ 줄 4: / 줄 4: @@
 ----
-==== 1. Node.js란 무엇인가요? ====
+===== 1. Node.js란 무엇인가요? =====
 ''Node.js''는 ''JavaScript''를 서버에서 실행할 수 있게 해주는 런타임 환경입니다. 웹 브라우저에서만 실행되던 ''JavaScript''를 서버에서도 실행할 수 있게 해줍니다.
@@ 줄 15: / 줄 15: @@
 ----
-==== 2. 프로젝트 개요 ====
+===== 2. 프로젝트 개요 =====
 이 프로젝트는 ''Node.js''를 기반으로 하며, 웹 페이지를 서버에서 렌더링하고 클라이언트와의 실시간 통신 기능을 제공합니다.
@@ 줄 25: / 줄 25: @@
 ----
-==== 3. 서버 구조 및 주요 파일 ====
+===== 3. 서버 구조 및 주요 파일 =====
 Phaser Baduk Metaverse 프로젝트의 핵심 서버 파일인 ''server.js''의 구조와 각 부분의 역할에 대해 설명합니다.
-=== 1) 초기 설정 및 모듈 불러오기 ===
+==== 1) 초기 설정 및 모듈 불러오기 ====
 서버 구동에 필요한 모듈들을 불러오고, 애플리케이션 인스턴스를 초기화합니다.
@@ 줄 46: / 줄 46: @@
   * ''path'' - 파일 경로를 안전하게 처리하는 유틸리티
-=== 2) 애플리케이션 인스턴스 생성 ===
+==== 2) 애플리케이션 인스턴스 생성 ====
 <file javascript>
@@ 줄 59: / 줄 59: @@
   * ''io'' - ''Socket.IO'' 서버 객체 (''HTTP'' 서버에 연결)
-=== 3) 정적 파일 서빙 및 라우팅 ===
+==== 3) 정적 파일 서빙 및 라우팅 ====
 클라이언트(프론트엔드)에 제공될 정적 파일(''HTML'', ''CSS'', ''JS'', 이미지 등)을 설정하고, 기본 경로에 대한 라우트를 정의합니다.
@@ 줄 65: / 줄 65: @@
 <file javascript>
 // 'public' 디렉토리에 있는 정적 파일들을 클라이언트에게 제공
-app.use(express.static(path.join(__dirname, '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'));
 });
 </file>
@@ 줄 75: / 줄 75: @@
 **설명:**
   * ''express.static()'' - 정적 파일을 웹에서 접근 가능하게 합니다.
-  * ''path.join(__dirname, 'public')'' - 현재 디렉토리의 ''public'' 폴더 경로입니다.
+  * ''path.join(dirname, 'public')'' - 현재 디렉토리의 ''public'' 폴더 경로입니다.
   * ''app.get('/')'' - 루트 경로로 접근했을 때 실행되는 함수입니다.
-=== 4) Socket.IO 이벤트 처리 ===
+==== 4) Socket.IO 이벤트 처리 ====
 클라이언트와 서버 간의 실시간 통신을 담당하는 ''Socket.IO'' 이벤트 핸들러를 설정합니다.
@@ 줄 107: / 줄 107: @@
   * ''socket.on('disconnect')'' - 클라이언트 연결이 끊어질 때 실행됩니다.
-=== 5) 서버 포트 설정 및 실행 ===
+==== 5) 서버 포트 설정 및 실행 ====
 환경 변수에서 포트 번호를 가져오거나 기본값(3000)을 사용하여 서버를 지정된 포트에서 실행합니다.
@@ 줄 129: / 줄 129: @@
 ----
-==== 4. 의존성 관리 (package.json) ====
+===== 4. 의존성 관리 (package.json) =====
 프로젝트에 필요한 라이브러리 및 스크립트를 정의하는 ''package.json'' 파일의 주요 내용을 설명합니다.
-=== 1) 프로젝트 정보 ===
+==== 1) 프로젝트 정보 ====
 ^ 키 ^ 설명 ^
@@ 줄 141: / 줄 141: @@
 | main | 프로젝트의 진입점 파일 (여기서는 ''server.js'') |
-=== 2) 스크립트 ===
+==== 2) 스크립트 ====
 자주 사용되는 명령어를 단축하여 정의합니다.
@@ 줄 150: / 줄 150: @@
 | pm2 | ''PM2''를 사용하여 서버를 시작합니다. (프로세스 관리용) | ''pm2 start server.js'' |
-=== 3) 의존성 목록 ===
+==== 3) 의존성 목록 ====
 ^ 의존성 ^ 버전 ^ 설명 ^
@@ 줄 160: / 줄 160: @@
 | express-rate-limit | 6.7.0 | 요청 제한 미들웨어 |
-=== 4) 개발 의존성 목록 ===
+==== 4) 개발 의존성 목록 ====
 ^ 의존성 ^ 버전 ^ 설명 ^
@@ 줄 168: / 줄 168: @@
 ----
-==== 5. 환경 설정 ====
+===== 5. 환경 설정 =====
-=== 1) 환경 변수 설정 ===
+==== 1) 환경 변수 설정 ====
 프로젝트 루트에 ''.env'' 파일을 생성하여 환경 변수를 설정합니다:
@@ 줄 194: / 줄 194: @@
   * ''NODE_ENV'' - 현재 환경 (''development''/''production'')
-=== 2) 환경 변수 사용법 ===
+==== 2) 환경 변수 사용법 ====
 <file javascript>
@@ 줄 212: / 줄 212: @@
 ----
-==== 6. 프로젝트 구조 ====
+===== 6. 프로젝트 구조 =====
 **권장하는 프로젝트 폴더 구조:**
@@ 줄 260: / 줄 260: @@
 ----
-==== 7. 개발 환경 설정 ====
+===== 7. 개발 환경 설정 =====
-=== 1) Node.js 설치 ===
+==== 1) Node.js 설치 ====
 **Windows에서 Node.js 설치:**
@@ 줄 273: / 줄 273: @@
 </file>
-=== 2) 프로젝트 초기화 ===
+==== 2) 프로젝트 초기화 ====
 <file bash>
@@ 줄 290: / 줄 290: @@
 </file>
-=== 3) 기본 서버 파일 생성 ===
+==== 3) 기본 서버 파일 생성 ====
 ''server.js'' 파일을 생성하고 기본 코드를 작성합니다:
@@ 줄 305: / 줄 305: @@
 // 정적 파일 서빙
-app.use(express.static(path.join(__dirname, 'public')));
+app.use(express.static(path.join(dirname, 'public')));
 // 기본 라우트
 app.get('/', (req, res) => {
-    res.sendFile(path.join(__dirname, 'public', 'index.html'));
+    res.sendFile(path.join(dirname, 'public', 'index.html'));
 });
@@ 줄 328: / 줄 328: @@
 </file>
-=== 4) package.json 스크립트 설정 ===
+==== 4) package.json 스크립트 설정 ====
 <file json>
@@ 줄 357: / 줄 357: @@
 ----
-==== 8. 서버 실행 및 테스트 ====
+===== 8. 서버 실행 및 테스트 =====
-=== 1) 개발 모드로 서버 실행 ===
+==== 1) 개발 모드로 서버 실행 ====
 <file bash>
@@ 줄 370: / 줄 370: @@
   * 개발 중에 매우 유용합니다.
-=== 2) 프로덕션 모드로 서버 실행 ===
+==== 2) 프로덕션 모드로 서버 실행 ====
 <file bash>
@@ 줄 381: / 줄 381: @@
   * 실제 서비스 환경에서 사용합니다.
-=== 3) 서버 테스트 ===
+==== 3) 서버 테스트 ====
 **브라우저에서 테스트:**
@@ 줄 394: / 줄 394: @@
 ----
-==== 9. 디버깅 및 로깅 ====
+===== 9. 디버깅 및 로깅 =====
-=== 1) 콘솔 로깅 ===
+==== 1) 콘솔 로깅 ====
 <file javascript>
@@ 줄 412: / 줄 412: @@
 </file>
-=== 2) 로깅 미들웨어 ===
+==== 2) 로깅 미들웨어 ====
 <file javascript>
@@ 줄 428: / 줄 428: @@
 </file>
-=== 3) 디버깅 도구 ===
+==== 3) 디버깅 도구 ====
 **Node.js 내장 디버거 사용:**
@@ 줄 437: / 줄 437: @@
 **Chrome DevTools에서 디버깅:**
   * Chrome 브라우저 열기
-  * ''chrome://inspect'' 접속
+  * %%chrome://inspect%% 접속
   * "Open dedicated DevTools for Node" 클릭
 ----
-==== 10. 성능 최적화 ====
+===== 10. 성능 최적화 =====
-=== 1) 압축 설정 ===
+==== 1) 압축 설정 ====
 <file javascript>
@@ 줄 452: / 줄 452: @@
 </file>
-=== 2) 캐싱 설정 ===
+==== 2) 캐싱 설정 ====
 <file javascript>
 // 정적 파일 캐싱
-app.use(express.static(path.join(__dirname, 'public'), {
+app.use(express.static(path.join(dirname, 'public'), {
     maxAge: '1d', // 1일간 캐시
     etag: true    // ETag 사용
@@ 줄 462: / 줄 462: @@
 </file>
-=== 3) 요청 제한 ===
+==== 3) 요청 제한 ====
 <file javascript>
@@ 줄 478: / 줄 478: @@
 ----
-==== 11. 보안 설정 ====
+===== 11. 보안 설정 =====
-=== 1) Helmet 미들웨어 ===
+==== 1) Helmet 미들웨어 ====
 <file javascript>
@@ 줄 499: / 줄 499: @@
 </file>
-=== 2) CORS 설정 ===
+==== 2) CORS 설정 ====
 <file javascript>
@@ 줄 513: / 줄 513: @@
 </file>
-=== 3) 입력 데이터 검증 ===
+==== 3) 입력 데이터 검증 ====
 <file javascript>
@@ 줄 535: / 줄 535: @@
 ----
-==== 12. 다음 단계 ====
+===== 12. 다음 단계 =====
 ''Node.js'' 기본을 배웠다면 다음을 학습해보세요:
@@ 줄 553: / 줄 553: @@
 //이 페이지는 자동으로 생성되었습니다.//
 ---