Python/Backend

WSL 환경에서 FastAPI 서버 접속이 안될 때 해결 방법

jimmy_AI 2025. 6. 12. 22:01
반응형

안녕하세요. 이번 시간에는 윈도우에서 WSL로 리눅스를 사용할 때,

리눅스 환경에서 띄운 FastAPI 서버가 윈도우에서 보이지 않을 때

해결 방법을 간략하게 다루어보도록 하겠습니다.

 

 

해결 방법

1. 먼저, wsl 터미널에서 정상적으로 서버가 띄워졌는지 확인합니다.

예시 명령어는 다음과 같습니다.(docs 페이지를 확인)

curl -i http://127.0.0.1:1226/docs

 

만일, 여기서 200 응답이 돌아오면 서버 자체의 문제는 아닙니다.

 

2. WSL2의 가상 IP 주소를 확인해야 합니다. 명령어는 다음과 같습니다.

ip addr show eth0 | grep 'inet '

 

여기서 IP 주소가 172.xxx.yyy.zzz/20 처럼 보이게 됩니다.

그렇다면, 윈도우에서 다음과 같은 주소로 접속을 시도해봅니다.

http://172.xxx.yyy.zzz:1226/docs

 

이렇게 시도하면 정상적인 접속이 가능할 것입니다.

 

이 글이 문제 해결에 도움이 되셨기를 기원합니다.

잘 봐주셔서 감사드립니다.