본문으로 건너뛰기

콘솔에서 서버 출력을 보고, 전원 작업으로 서버를 제어하고, 셸 명령을 실행하는 방법.

Portal의 Console 탭은 실행 중인 서버를 실시간으로 볼 수 있는 창이에요. 출력을 발생하는 대로 스트리밍하고, 서버를 시작, 중지, 재시작하거나 강제로 종료하는 버튼을 제공해요.

배울 내용

  • 실시간 서버 출력을 보는 방법
  • 전원 작업(Start, Stop, Restart, Kill)을 사용하는 방법
  • 콘솔에서 셸 명령을 보내는 방법

실시간 출력 보기

서버가 실행되면 Console 탭이 출력을 실시간으로 보여줘요. 다음 용도로 사용하세요:

  • 애플리케이션이 성공적으로 시작되었는지 확인하기
  • 시작 오류와 스택 트레이스 읽기
  • 로그 출력을 실시간으로 모니터링하기

서버가 시작하자마자 바로 충돌한다면, 콘솔 출력에서 대부분 그 이유를 확인할 수 있어요.


전원 작업

작업효과
Start서버를 시작해요
Stop실행 중인 프로세스에 정상 종료 신호를 보내요
Restart서버를 중지한 뒤 다시 시작해요
Kill프로세스를 즉시 강제로 종료해요

Kill은 서버가 전혀 응답하지 않고 일반 Stop 버튼으로도 멈추지 않을 때만 사용하세요.


셸 명령 보내기

기본적으로 콘솔 입력창은 텍스트를 애플리케이션의 stdin으로 보내요 — 게임 서버나 커스텀 CLI 인터페이스에 유용해요. 대신 임의의 셸 명령(예: ls, node --version, pip install requests)을 실행하려면, 먼저 서버가 이를 받도록 설정해야 해요.

셸 명령 입력 활성화하기

  1. 서버의 Startup 탭으로 이동하세요.
  2. Startup Command를 bash로 바꾸세요.
  3. Console 탭으로 돌아가서 Restart를 클릭하세요.

재시작한 후에는 콘솔 입력창이 셸 명령을 직접 받아요.

시작 명령을 bash로 설정하면 애플리케이션은 자동으로 시작되지 않아요. 콘솔에서 직접 실행하거나, 작업이 끝나면 원래 시작 명령을 복원해야 해요. 시작 설정을 참고하세요.


자주 발생하는 문제 해결

서버가 시작하자마자 충돌해요

콘솔 출력에서 오류 메시지를 확인하세요. 흔한 원인은 다음과 같아요:

  • 잘못된 시작 명령(잘못된 파일 이름이나 잘못된 문법)
  • 진입 파일 누락(먼저 파일을 업로드하세요)
  • 잘못된 Docker 이미지 버전
  • 의존성 누락(bash 모드에서 npm install 또는 pip install -r requirements.txt를 직접 실행해 보세요)

시작 설정과 파일 관리자를 참고하세요.

콘솔에 출력이 전혀 없어요

애플리케이션이 stdout 대신 파일에 로그를 쓰고 있을 수 있어요. 파일 관리자에 로그 파일이 있는지 확인하세요. 일부 프레임워크는 콘솔 출력을 켜기 위해 특정 플래그가 필요해요(예: 조용한 모드 끄기).

콘솔 입력창에 입력할 수 없어요

서버가 실행 중인지(상태가 초록색인지) 확인하세요. 콘솔 입력은 서버 프로세스가 살아 있는 동안에만 활성화돼요.


다음 단계

  • 시작 설정 — 시작 명령이나 Docker 이미지를 수정하세요.
  • 파일 관리자 — 누락된 파일을 업로드하세요.
  • 문제 해결 — 자주 발생하는 문제에 대한 더 많은 도움을 받으세요.