.NET 백엔드
로컬 실행 가이드

이 가이드는 개발 경험이 많지 않은 분을 위해 작성됐어요. 명령어의 의미를 몰라도 괜찮으니, 안내된 순서대로 따라해 주세요.

진행할 작업은 두 가지예요. 컴퓨터에 .NET 8 SDK를 설치하고, 결제 서버를 실행해요. 이 문서는 백엔드 서버를 띄우는 가이드이며, 결제 테스트 화면(프론트엔드)은 다루지 않아요.

미리 알아둘 용어

.NET 8 SDK를 컴퓨터에 설치해요. 이미 설치되어 있다면 이 단계는 건너뛰어도 돼요.

설치 따라하기

1. 다운로드 페이지 접속
   웹 브라우저에서 dotnet.microsoft.com/download에 접속한 뒤, ".NET 8" 항목의 "SDK" 버튼을 눌러 주세요. "런타임"이 아닌 SDK를 받아야 해요. 런타임은 실행 전용이고, SDK는 빌드와 실행이 모두 가능해요.
2. 설치 파일 실행
   받은 설치 파일을 실행하고 안내에 따라 설치해요. Windows · macOS 모두 별도 설정 없이 기본값 그대로 설치하시면 돼요.
3. 설치 확인
   터미널을 열고 아래 명령을 입력해 주세요. 8.로 시작하는 버전 숫자가 표시되면 완료예요. (예시: 8.0.408)

   terminal복사

   dotnet --version

이제 서버를 실행해요. 아래 순서를 그대로 따라해 주세요. 명령은 한 줄씩 복사해 터미널에 붙여넣고 Enter를 누르시면 돼요.

1. 터미널 열기
   Windows는 PowerShell, Mac은 터미널 앱을 열어 주세요.
2. 프로젝트 폴더로 이동
   프로젝트를 저장한 폴더 안의 dotnet 폴더로 이동해요. 아래의 <프로젝트 폴더> 부분을 본인이 저장한 실제 경로로 바꿔 주세요.

   terminal복사

   cd "<프로젝트 폴더>/dotnet"

   경로 입력이 익숙하지 않다면, 터미널에 cd (cd 뒤에 공백 한 칸)를 입력한 뒤 dotnet 폴더를 터미널 창으로 드래그해 주세요. 경로가 자동으로 채워져요. Windows는 폴더에서 Shift + 우클릭 → "경로로 복사" 후 붙여넣기 하시면 돼요.
3. 서버 실행 (최초 실행은 잠시 걸려요)
   아래 한 줄로 서버가 실행돼요. 최초 실행 시에는 NuGet 패키지 복원과 빌드가 자동으로 진행되어 1~2분 정도 걸릴 수 있어요. 두 번째부터는 빠르게 실행돼요.

   terminal복사

   dotnet run --urls "http://localhost:8080"

4. 서버 실행 확인
   터미널에 Now listening on: http://localhost:8080 로그가 표시되면 서버가 실행된 거예요. 더 확실한 확인 방법은 다음 04를 참고해 주세요.

이 문서는 서버(백엔드) 실행을 위한 가이드예요. 화면(프론트엔드)이 아닌 서버의 정상 실행 여부를 응답으로 확인해요.

확인 방법

방법 1 · 터미널 메시지: 서버를 실행한 터미널에서 Now listening on: http://localhost:8080 줄이 보이면 서버가 실행된 거예요.

방법 2 · 응답 확인: 브라우저 주소창에 http://localhost:8080/config를 입력하거나, 새 터미널에서 아래 명령을 실행해 주세요. {"site_cd":"T0000"}와 같은 응답이 표시되면 서버와 라우팅이 정상 동작하는 거예요.

curl http://localhost:8080/config

실행 중 자주 만나게 되는 문제와 해결 방법이에요. 대부분 .NET SDK의 PATH 문제이거나, 포트가 이미 사용 중이어서 발생해요.

증상별 해결법

dotnet run --urls "http://localhost:9090"

테스트가 끝나면 다음 방법으로 서버를 종료해 주세요.

서버가 동작 중인 터미널 창에서 Ctrl + C를 눌러 주세요. Windows · macOS · Linux 모두 동일해요. 서버가 종료되며, 터미널이 다시 명령을 입력할 수 있는 상태로 돌아와요.