1. 서버에 연결하세요
SSH를 사용하여 서버에 연결하십시오:
ssh root@<server-ip>
2. 로그인 자격 증명 정보 접근
애플리케이션을 관리하기 위해 fastapi라는 전용 사용자가 생성되었습니다.
로그인 자격 증명은 이 파일에서 찾을 수 있습니다: /root/.fastapi-creds
이를 보려면 다음을 실행하십시오:
cat /root/.fastapi-creds
비밀번호를 변경하려면 다음을 사용하십시오:
passwd fastapi
3. 앱 사용자로 전환
앱 관리를 위해 fastapi 사용자 계정으로 전환하세요:
su - flask
이 계정에는 FastAPI 프로젝트와 환경이 포함되어 있습니다.
4. 프로젝트 구조
기본 디렉터리 구조는 다음과 같습니다:
/home/fastapi/fastapi_app/
├── main.py → Your main FastAPI application file
├── venv/ → Virtual environment
└── __pycache__/ → Compiled Python files (auto-generated)
5. 지원서 관리
애플리케이션 디렉터리로 이동하십시오:
cd ~/fastapi_app
가상 환경 활성화:
source venv/bin/activate
메인 앱 파일을 편집하세요:
nano main.py
변경 사항을 적용하려면 FastAPI 서비스를 재시작하십시오:
sudo systemctl restart uvicorn-fastapi
6. 로그 보기
Uvicorn과 Nginx의 로그를 다음과 같이 확인할 수 있습니다:
- 유비콘 로그:
/var/log/uvicorn/ - Nginx 오류 로그:
/var/log/nginx/error.log - Nginx 접속 로그:
/var/log/nginx/access.log
그것들을 보려면:
sudo tail -f /var/log/uvicorn/*
7. API 접근
서비스가 실행되면 FastAPI 애플리케이션은 브라우저에서 다음 주소로 접근할 수 있습니다: http://<server-ip>
Nginx는 FastAPI 애플리케이션을 실행 중인 Uvicorn 소켓으로 HTTP 요청을 자동으로 전달합니다.
8. 도메인 또는 포트 변경
서버 이름, 포트 또는 도메인을 업데이트하려면:
- Nginx 사이트 구성 편집:
sudo nano /etc/nginx/sites-available/uvicorn-fastapi - 테스트 구성:
sudo nginx -t - Nginx 재시작:
sudo systemctl restart nginx
9. 유비콘 서비스
FastAPI 애플리케이션은 uvicorn-fastapi라는 이름의 systemd 서비스를 통해 실행됩니다.
그것은 사용합니다 /home/fastapi/fastapi_app/main:app 애플리케이션 진입점으로 사용되며, 실패 시 자동으로 재시작됩니다.
서비스를 관리하려면:
systemctl status uvicorn-fastapi
systemctl restart uvicorn-fastapi
서비스를 편집하려면:
sudo vim /etc/systemd/system/uvicorn-fastapi.service
sudo systemctl daemon-reload
sudo systemctl restart uvicorn-fastapi
sudo systemctl status uvicorn-fastapi
10. HTTPS 활성화 (선택 사항)
Certbot을 사용하여 HTTPS를 활성화하세요.