104 lines
4.1 KiB
TypeScript
104 lines
4.1 KiB
TypeScript
import { NestFactory } from '@nestjs/core';
|
|
import { AppModule } from './app.module';
|
|
import { Logger, RequestMethod, ValidationPipe } from '@nestjs/common';
|
|
import { DocumentBuilder, SwaggerModule } from '@nestjs/swagger';
|
|
import { WinstonModule } from 'nest-winston';
|
|
import helmet from 'helmet';
|
|
import rateLimit from 'express-rate-limit';
|
|
import type { Request as ExpressRequest, Response as ExpressResponse } from 'express';
|
|
|
|
import { HttpExceptionFilter } from './common/filters/http-exception.filter';
|
|
import { TransformInterceptor } from './common/interceptors/transform.interceptor';
|
|
import { winstonConfig } from './shared/logger/winston.config';
|
|
|
|
async function bootstrap() {
|
|
const app = await NestFactory.create(AppModule, {
|
|
logger: WinstonModule.createLogger(winstonConfig),
|
|
});
|
|
|
|
// 리버스 프록시(Nginx, Docker 배포 환경 등) 뒤에서 올바른 클라이언트 IP 식별 지원을 위해 설정합니다.
|
|
const expressApp = app.getHttpAdapter().getInstance();
|
|
expressApp.set('trust proxy', 1);
|
|
|
|
// 글로벌 prefix — 모든 라우트가 /api/* 로 정규화됨 (Flutter, Web 양쪽 baseURL과 일치)
|
|
app.setGlobalPrefix('api', {
|
|
// 헬스체크 / 루트 상태 엔드포인트는 prefix 미적용
|
|
exclude: [{ path: '/', method: RequestMethod.GET }],
|
|
});
|
|
|
|
// 기본 주소('/') 접속 시 상태 확인용 텍스트 응답 추가
|
|
expressApp.get('/', (_req: ExpressRequest, res: ExpressResponse) => {
|
|
res.send('Backend API Server is running 정상 구동 중입니다.');
|
|
});
|
|
|
|
// 1. 보안 헤더 (Helmet) - XSS 방지 및 기본 웹 보안
|
|
app.use(helmet());
|
|
|
|
// 2. 화이트리스트 기반 CORS 정책
|
|
const frontendUrl = process.env.FRONTEND_URL || 'http://localhost:5173';
|
|
const corsOriginEnv = process.env.CORS_ORIGIN;
|
|
|
|
app.enableCors({
|
|
origin: (
|
|
origin: string | undefined,
|
|
callback: (err: Error | null, allow?: boolean) => void,
|
|
) => {
|
|
// 서버간의 통신(origin이 undefined)이거나 명시된 리스트일 때만 허용
|
|
const whitelist = [frontendUrl, 'http://localhost:3000'];
|
|
if (corsOriginEnv) whitelist.push(corsOriginEnv);
|
|
|
|
if (!origin || whitelist.indexOf(origin) !== -1) {
|
|
callback(null, true);
|
|
} else {
|
|
// 클라이언트에는 403 금지 에러로 리턴됨
|
|
callback(new Error('CORS 정책에 의해 차단된 도메인입니다.'));
|
|
}
|
|
},
|
|
credentials: true, // 쿠키 교환 허용
|
|
});
|
|
|
|
// 3. 글로벌 Rate Limiting 적용 (DDoS, 브루트포스 예방)
|
|
app.use(
|
|
rateLimit({
|
|
windowMs: 15 * 60 * 1000, // 15분
|
|
max: 150, // 15분 IP당 최대 150개 요청
|
|
message: {
|
|
success: false,
|
|
error: {
|
|
code: 'SYS_001',
|
|
message: '일시적인 시스템 오류가 발생했습니다. (요청 한도 초과) 잠시 후 다시 시도해 주세요.', // 글로벌 통합 에러 포맷
|
|
}
|
|
},
|
|
}),
|
|
);
|
|
|
|
// 4. 전역 DTO 유효성 파이프 (강력한 검증 단계)
|
|
app.useGlobalPipes(
|
|
new ValidationPipe({
|
|
whitelist: true, // DTO에 불필요한 값이 오면 삭제
|
|
forbidNonWhitelisted: true, // DTO에 없는 필드가 주입되면 400 에러 발생
|
|
transform: true, // 네트워크 데이터를 DTO나 기본 타입으로 자동 변환
|
|
}),
|
|
);
|
|
|
|
// 5. 프론트엔드 연동을 위한 규격화된 에러 & 성공 페이로드 인터셉터 적용
|
|
app.useGlobalFilters(new HttpExceptionFilter());
|
|
app.useGlobalInterceptors(new TransformInterceptor());
|
|
|
|
// 6. Swagger API 문서 설정
|
|
const config = new DocumentBuilder()
|
|
.setTitle('Backend API Documentation')
|
|
.setDescription('The API documentation conforming to the global guidelines')
|
|
.setVersion('1.0')
|
|
.addBearerAuth()
|
|
.build();
|
|
const document = SwaggerModule.createDocument(app, config);
|
|
SwaggerModule.setup('api-docs', app, document);
|
|
|
|
const port = Number(process.env.PORT ?? 3000);
|
|
await app.listen(port, '0.0.0.0');
|
|
Logger.log(`🚀 Backend running on http://localhost:${port}/api`, 'Bootstrap');
|
|
Logger.log(`📘 Swagger docs at http://localhost:${port}/api-docs`, 'Bootstrap');
|
|
}
|
|
bootstrap();
|