KillKagi 실행 오류 해결: 포트 충돌과 브라우저 미열림 점검

KillKagi는 로컬 서버를 실행한 뒤 브라우저와 OBS Browser Source에서 화면을 여는 방식의 방송 도구입니다.
따라서 실행 파일 자체가 열렸더라도 브라우저가 자동으로 뜨지 않거나, localhost 주소가 연결되지 않거나, OBS에서 검은 화면처럼 보이는 경우가 생길 수 있습니다.

이 글은 사용자가 가장 자주 겪는 문제를 기준으로 정리했습니다. 처음 설치하는 단계부터 다시 보고 싶다면 KillKagi 설치·사용 가이드를 먼저 확인하고, 도구 개요는 KillKagi 소개 페이지에서 볼 수 있습니다.

재현 정보를 먼저 남기기

오류를 해결할 때 가장 중요한 것은 “어디에서 멈췄는지”를 분리하는 것입니다. 문의하거나 스스로 점검할 때 아래 정보를 먼저 적어두면 같은 증상을 반복해서 확인하지 않아도 됩니다.

항목	예시	판단할 수 있는 문제
브라우저에서 열리는 주소	http://localhost:3000	로컬 서버 실행 여부
OBS에 입력한 주소	http://localhost:3000/overlay	Browser Source URL 오타 여부
선택한 모드	SOLO, PARTY	공유 URL 필요 여부
콘솔 메시지	port in use, permission denied	포트 충돌 또는 권한 문제

OBS 쪽 문제인지 확인할 때는 OBS Browser Source 공식 문서의 URL, 크기, 새로고침 옵션과 비교해 보세요. 브라우저에서는 정상인데 OBS에서만 안 보이면 KillKagi보다 Browser Source 설정 문제일 가능성이 큽니다.

먼저 정상 동작 흐름을 확인하기

문제를 찾기 전에 KillKagi가 정상일 때 어떤 순서로 동작하는지 알아두는 것이 중요합니다.

1. killkagi-server.exe를 실행합니다.
2. 콘솔 창이 열리고 로컬 서버가 시작됩니다.
3. 브라우저가 http://localhost:3000 또는 대시보드 주소를 엽니다.
4. Setup 화면에서 채널, 모드, 목표값을 입력합니다.
5. OBS Browser Source에는 /overlay 주소를 넣습니다.

이 흐름 중 하나라도 끊기면 화면이 보이지 않습니다. 그래서 “실행이 안 된다”는 증상도 실제로는 실행 파일 문제, 포트 문제, 브라우저 문제, OBS 설정 문제로 나눠서 봐야 합니다.

1. 실행 파일을 눌러도 아무 반응이 없을 때

가장 먼저 확인할 것은 Windows 보안 경고와 압축 해제 위치입니다.

다운로드한 EXE를 바로 실행했을 때 SmartScreen 경고가 나올 수 있습니다. 이 경우 파일 출처가 download.koreastreamer.com인지 확인한 뒤, 실행을 허용해야 합니다. 브라우저 다운로드 목록에서 차단된 상태라면 파일이 완전히 저장되지 않았을 수도 있습니다.

다음 항목을 순서대로 확인하세요.

• 파일 크기가 비정상적으로 작지 않은지 확인합니다.
• 네트워크 드라이브나 임시 폴더가 아니라 사용자 폴더 아래에 둡니다.
• 파일명에 괄호나 특수문자가 여러 번 붙었다면 한 번 짧게 바꿔 봅니다.
• 백신이 격리했는지 확인합니다.
• 압축 파일 형태로 받은 경우 압축을 완전히 푼 뒤 실행합니다.

특히 방송 직전에 급하게 받은 파일은 다운로드가 중간에 끊긴 상태일 수 있습니다. 이때는 파일을 삭제하고 KillKagi 도구 페이지에서 다시 받는 편이 빠릅니다.

2. 콘솔은 열렸는데 브라우저가 열리지 않을 때

브라우저 자동 실행은 운영체제 환경에 따라 실패할 수 있습니다. 이 경우 프로그램이 죽은 것이 아니라 브라우저만 자동으로 열리지 않은 상태일 수 있습니다.

주소창에 직접 아래 주소를 입력해 보세요.

http://localhost:3000

페이지가 열리면 서버는 정상입니다. 이 경우에는 자동 브라우저 실행만 실패한 것이므로 방송 운영에는 큰 문제가 없습니다.

직접 접속해도 열리지 않는다면 다음 항목을 봅니다.

• 콘솔 창에 오류 메시지가 있는지 확인합니다.
• 이미 다른 프로그램이 3000 포트를 쓰고 있는지 확인합니다.
• Windows 방화벽에서 로컬 네트워크 접근을 막았는지 확인합니다.
• 회사/학교 PC처럼 보안 정책이 강한 환경인지 확인합니다.

3. 포트 충돌이 의심될 때

KillKagi가 로컬 서버를 열려면 특정 포트를 사용할 수 있어야 합니다. 다른 개발 서버, Node.js 앱, Vite, React 개발 서버가 이미 3000 포트를 사용 중이면 충돌이 날 수 있습니다.

PowerShell에서 아래 명령으로 확인할 수 있습니다.

netstat -ano | findstr :3000

출력이 있다면 마지막 숫자가 프로세스 ID입니다. 작업 관리자에서 해당 PID를 찾아 종료하거나, 이미 켜진 개발 서버를 끄고 KillKagi를 다시 실행합니다.

포트 충돌은 개발자 PC에서 특히 자주 발생합니다. 방송용 PC와 개발용 PC를 같이 쓰는 경우라면, 방송 시작 전에 로컬 서버가 여러 개 켜져 있지 않은지 확인하는 습관을 들이는 것이 좋습니다.

4. OBS에서 오버레이가 검은 화면으로 보일 때

브라우저에서는 대시보드가 잘 보이는데 OBS에서 오버레이만 안 보이면 OBS Browser Source 설정 문제일 가능성이 높습니다.

우선 OBS에서 브라우저 소스 URL을 확인합니다.

http://localhost:3000/overlay

확인할 항목은 다음과 같습니다.

• URL 끝에 공백이 들어가지 않았는지 확인합니다.
• 너비와 높이를 충분히 크게 잡습니다. 예: 1920 x 1080
• “소스가 활성화될 때 브라우저 새로고침” 옵션을 켭니다.
• 캐시 문제가 의심되면 Browser Source를 삭제하고 다시 추가합니다.
• OBS를 관리자 권한으로 실행했을 때 달라지는지 확인합니다.

오버레이가 투명 배경을 사용하면 화면이 비어 보이는 것처럼 느껴질 수 있습니다. 테스트할 때는 Setup에서 목표값을 넣고 실제 진행도 텍스트가 표시되는지 먼저 확인하세요. OBS Browser Source 자체 설정은 OBS 브라우저 소스 오버레이 연결 방법에서 더 자세히 다룹니다.

5. 공유 오버레이 URL이 보이지 않을 때

공유 오버레이 URL은 모든 모드에서 항상 필요한 기능이 아닙니다.

SOLO 모드에서는 보통 내 PC의 로컬 오버레이만 사용합니다. 이 경우 OBS에 localhost 주소를 넣으면 충분합니다. 반대로 여러 채널을 합산하거나 파티 방송처럼 여러 사람이 같은 화면을 봐야 한다면 CHANNEL_SUM 또는 PARTY 모드가 필요합니다.

공유 URL이 보이지 않는다면 아래를 확인하세요.

• 현재 모드가 SOLO인지 확인합니다.
• 추가 채널을 입력해야 하는 모드인지 확인합니다.
• relay 서버 연결 안내가 있는지 확인합니다.
• 대시보드를 새로고침해도 같은지 확인합니다.

공유 URL이 꼭 필요한 방송이라면 방송 시작 전에 한 명의 PC뿐 아니라 참가자 PC에서도 미리 열어 보는 것이 안전합니다.

6. 종료 후 다시 실행이 안 될 때

KillKagi는 콘솔 창이 서버 역할을 합니다. 창 닫기 버튼으로 바로 끊거나 작업 관리자에서 강제 종료하면 포트가 잠깐 남아 있는 것처럼 보일 수 있습니다.

권장 종료 순서는 아래와 같습니다.

1. 콘솔 창을 선택합니다.
2. Ctrl + C를 누릅니다.
3. 종료 로그가 나온 뒤 창이 닫히는지 확인합니다.
4. OBS Browser Source를 새로고침하거나 OBS를 재실행합니다.
5. 다시 killkagi-server.exe를 실행합니다.

방송 도구는 “잘 켜는 것”만큼 “잘 끄는 것”도 중요합니다. 다음 방송까지 같은 설정을 유지하려면 템플릿을 저장한 뒤 종료하는 습관을 권장합니다.

방송 전 빠른 점검표

방송 직전에는 긴 문서를 다시 읽기 어렵습니다. 아래 항목만 빠르게 확인해도 대부분의 문제를 줄일 수 있습니다.

• EXE 파일이 정상 다운로드되었는가
• http://localhost:3000이 브라우저에서 열리는가
• OBS Browser Source URL이 /overlay로 끝나는가
• 포트 3000을 다른 프로그램이 쓰고 있지 않은가
• 모드가 방송 형태와 맞는가
• 공유 URL이 필요한 합방이면 참가자 PC에서도 열어 봤는가
• 종료는 Ctrl + C로 했는가

관련 글

• KillKagi 설치·사용 가이드
• OBS 브라우저 소스 오버레이 연결 방법
• KillKagi 소개 페이지