Classic ASP 백엔드
로컬 실행 가이드

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

진행할 작업은 두 가지예요. Windows에 내장된 IIS와 ASP 기능을 켜고, 프로젝트의 asp 폴더를 IIS에 등록해 서버를 실행해요. 이 문서는 백엔드 서버를 띄우는 가이드이며, 결제 테스트 화면(프론트엔드)은 다루지 않아요.

미리 알아둘 용어

IIS와 ASP는 별도로 다운로드하지 않아도 돼요. Windows에 이미 들어 있는 기능을 켜기만 하면 돼요. 이미 켜져 있다면 이 단계는 건너뛰어도 돼요.

클릭 경로 따라하기

1. 제어판 열기
   시작 메뉴에서 제어판을 검색해 열어 주세요. 또는 Win + R → control 입력 → Enter로도 열 수 있어요.
2. "Windows 기능 켜기/끄기" 열기
   제어판 → 프로그램 → 프로그램 및 기능 → 왼쪽의 "Windows 기능 켜기/끄기"를 클릭해 주세요. 시작 메뉴에서 "Windows 기능"을 검색하셔도 돼요.
3. IIS 항목 찾기
   목록에서 인터넷 정보 서비스를 찾아 왼쪽 화살표를 눌러 펼쳐 주세요.
4. ASP 체크
   펼친 항목에서 아래 경로를 따라 내려가며 체크해 주세요.
   인터넷 정보 서비스 → World Wide Web 서비스 → 응용 프로그램 개발 기능 → ASP
   ASP 왼쪽 네모에 체크 표시가 생기면 돼요. ASP.NET과 혼동하지 말아 주세요. ASP가 맞아요.
5. 확인 → 설치 대기
   확인 버튼을 누르면 Windows가 기능을 설치해요. 잠시 기다리시면 완료돼요. (인터넷 연결은 필요 없어요.)
6. IIS 동작 확인
   설치 완료 후 브라우저에서 http://localhost를 입력해 주세요. IIS 기본 환영 페이지("Internet Information Services" 화면)가 보이면 완료예요.

IIS를 켰다면 이제 프로젝트 파일을 등록해요. 아래 순서대로 따라해 주세요.

1. 프로젝트의 asp 폴더를 IIS 경로로 복사
   프로젝트에서 asp 폴더 전체를 아래 경로에 복사해 주세요. (파일 탐색기에서 복사·붙여넣기)

   PowerShell복사

   C:\inetpub\wwwroot\kcp

   즉, asp 폴더 안의 파일들이 C:\inetpub\wwwroot\kcp\ 안에 들어 있어야 해요.
   예시: C:\inetpub\wwwroot\kcp\index.html, C:\inetpub\wwwroot\kcp\payment_return.asp 등
2. IIS 관리자 열기
   시작 메뉴에서 IIS를 검색하거나, Win + R → inetmgr 입력 → Enter로 IIS 관리자를 열어 주세요.
3. kcp 폴더를 애플리케이션으로 등록
   IIS 관리자 왼쪽 트리에서 내 컴퓨터 이름 → Sites → Default Web Site를 펼쳐 주세요. 그 안에 kcp 폴더가 보여요.
   kcp를 우클릭 → "응용 프로그램으로 변환(Convert to Application)"을 클릭해 주세요. 팝업이 뜨면 기본값 그대로 확인을 눌러 주세요. kcp 아이콘에 작은 지구본 표시가 생기면 완료예요.
4. 사이트가 실행 중인지 확인
   IIS 관리자 왼쪽 트리에서 Sites → Default Web Site를 클릭해 주세요. 오른쪽 패널 상태 영역에 "시작됨(Started)"이라고 표시되면 사이트가 정상 동작 중이에요. Default Web Site가 중지 상태라면 오른쪽 패널의 "사이트 시작(Start)"을 클릭해 주세요.

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

Classic ASP(IIS)는 Python처럼 터미널에 "Running" 메시지가 나오지 않아요. IIS는 Windows 서비스로 동작하므로, 아래 두 가지 방법으로 확인해요.

확인 방법

방법 1 · IIS 관리자: IIS 관리자 왼쪽 트리에서 Sites → Default Web Site를 클릭했을 때 상태가 "시작됨(Started)"으로 표시되면 서버가 동작 중이에요. 그 아래 kcp 항목에 작은 지구본 아이콘이 있으면 애플리케이션 등록도 정상이에요.

방법 2 · 서버 응답 확인: 브라우저 주소창에 아래를 입력해 주세요. {"site_cd":"TXXXX"} 형식의 JSON이 표시되면 IIS와 ASP가 정상 동작하는 거예요.

http://localhost/kcp/config.asp

실행 중 자주 만나게 되는 문제와 해결 방법이에요. 대부분 IIS 기능 미설치, ASP 미체크, 404, 또는 권한 문제예요.

증상별 해결법

테스트가 끝나면 다음 방법으로 IIS 사이트를 중지하거나, 필요하다면 IIS 기능 자체를 끌 수 있어요.

종료 방법

1. IIS 관리자에서 사이트만 중지 (권장)
   IIS 관리자 왼쪽 트리 → Sites → Default Web Site 클릭 → 오른쪽 패널의 "사이트 중지(Stop)"를 클릭해 주세요. 다시 사용하실 때는 "시작(Start)"을 누르시면 돼요.
2. IIS 서비스 전체 중지 (PowerShell)
   PowerShell을 관리자 권한으로 열고 아래 명령을 입력해 주세요.

   PowerShell복사

   # IIS 서비스 중지
   iisreset /stop
   
   # IIS 서비스 재시작
   iisreset /start

3. IIS 기능 자체 끄기 (완전 비활성화)
   더 이상 IIS를 사용할 일이 없을 때만 사용해 주세요. "Windows 기능 켜기/끄기" → 인터넷 정보 서비스의 체크를 해제하고 확인하시면 돼요. 나중에 다시 켜려면 02단계를 반복하시면 돼요.