curl: (56) Recv failure: 상대편이 연결을 끊음 (curl: (56) Recv failure: Connection reset by peer)

 

FastAPI를 활용하여 서버를 띄우고 도커로 배포를 진행했습니다. 빌드 후 서버를 배포했으나, 해당 포트로 접근이 되지 않는 상황이 발생했습니다. 혹시나 하는 마음에 서버 내에서 curl 명령어를 사용해 요청을 보내봤지만, 다음과 같은 메시지가 출력되었습니다:

'curl: (56) Recv failure: 상대편이 연결을 끊음'

이 부분은 도커 파일에 CMD 부분을 수정하면서 해결했다.

 

FROM python:3.12.4

WORKDIR /app

COPY ./requirements.txt .

RUN pip install --upgrade pip && \
    pip install -r requirements.txt

COPY . /app/

EXPOSE 8000



CMD ["uvicorn", "main:app", "--host", "0.0.0.0", "--port", "8000"]

 

이와 같이 CMD 명령어를 명확히 지정함으로써 FastAPI 서버가 올바르게 실행되도록 했다. 이로 인해 외부에서 해당 포트로의 접근이 가능해졌고, 서버로부터 정상적으로 응답을 받을 수 있었다.

도커를 활용한 서버 배포 과정에서 CMD 명령어의 중요성을 다시 한번 깨달으며, 작은 부분 하나하나가 시스템 전체의 동작에 큰 영향을 미칠 수 있음을 실감했다.