# 콘솔 & 전원 작업

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

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`로 설정하면 애플리케이션은 자동으로 시작되지 **않아요**. 콘솔에서 직접 실행하거나, 작업이 끝나면 원래 시작 명령을 복원해야 해요. [시작 설정](https://daki.cc/ko/wiki/guides/startup-settings)을 참고하세요.

---

## 자주 발생하는 문제 해결

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

콘솔 출력에서 오류 메시지를 확인하세요. 흔한 원인은 다음과 같아요:
- 잘못된 시작 명령(잘못된 파일 이름이나 잘못된 문법)
- 진입 파일 누락(먼저 파일을 업로드하세요)
- 잘못된 Docker 이미지 버전
- 의존성 누락(`bash` 모드에서 `npm install` 또는 `pip install -r requirements.txt`를 직접 실행해 보세요)

[시작 설정](https://daki.cc/ko/wiki/guides/startup-settings)과 [파일 관리자](https://daki.cc/ko/wiki/guides/file-manager)를 참고하세요.

**콘솔에 출력이 전혀 없어요**

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

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

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

---

## 다음 단계

- [시작 설정](https://daki.cc/ko/wiki/guides/startup-settings) — 시작 명령이나 Docker 이미지를 수정하세요.
- [파일 관리자](https://daki.cc/ko/wiki/guides/file-manager) — 누락된 파일을 업로드하세요.
- [문제 해결](https://daki.cc/ko/wiki/guides/troubleshooting) — 자주 발생하는 문제에 대한 더 많은 도움을 받으세요.

---
Source: https://daki.cc/ko/wiki/guides/console