1. Csatlakozzon a szerveréhez
Használja az SSH-t a szerverhez való csatlakozáshoz:
ssh root@<server-ip>
2. Bejelentkezési adatok
Az alkalmazás kezelésére egy fastapi nevű dedikált felhasználó lett létrehozva.
A bejelentkezési adatokat ebben a fájlban találja: /root/.fastapi-creds
Megtekintéséhez futtassa:
cat /root/.fastapi-creds
Ha meg szeretné változtatni a jelszót, használja a következő parancsot:
passwd fastapi
3. Váltson át az alkalmazás felhasználójára
Váltson át a fastapi felhasználói fiókra az alkalmazás kezeléséhez:
su - flask
Ez a fiók tartalmazza a FastAPI projektjét és környezetét.
4. A projekt felépítése
Az alapértelmezett könyvtárszerkezet a következő:
/home/fastapi/fastapi_app/
├── main.py → Your main FastAPI application file
├── venv/ → Virtual environment
└── __pycache__/ → Compiled Python files (auto-generated)
5. Az alkalmazás kezelése
Keresse meg az alkalmazás könyvtárát:
cd ~/fastapi_app
A virtuális környezet aktiválása:
source venv/bin/activate
Szerkessze a fő alkalmazás fájlt:
nano main.py
Indítsa újra a FastAPI szolgáltatást a változások alkalmazásához:
sudo systemctl restart uvicorn-fastapi
6. Naplók megtekintése
Az Uvicorn és az Nginx naplóit az alábbiak szerint ellenőrizheti:
- Uvicorn naplófájlok:
/var/log/uvicorn/ - Nginx hiba napló:
/var/log/nginx/error.log - Nginx hozzáférési napló:
/var/log/nginx/access.log
Megtekintésükhöz:
sudo tail -f /var/log/uvicorn/*
7. Az API-hoz való hozzáférés
A szolgáltatás elindulása után a FastAPI alkalmazás a böngészőben a következő címen érhető el: http://<server-ip>
Az Nginx automatikusan továbbítja a HTTP-kérelmeket a FastAPI alkalmazást futtató Uvicorn sockethez.
8. A domain vagy a port megváltoztatása
Ha frissíteni szeretné a szerver nevét, portját vagy domainjét:
- Nginx webhely konfigurációjának szerkesztése:
sudo nano /etc/nginx/sites-available/uvicorn-fastapi - Tesztkonfiguráció:
sudo nginx -t - Nginx újratöltése:
sudo systemctl restart nginx
9. Uvicorn szolgáltatás
A FastAPI alkalmazás egy uvicorn-fastapi nevű systemd szolgáltatáson keresztül fut.
Használja /home/fastapi/fastapi_app/main:app alkalmazás belépési pontjaként, és hiba esetén automatikusan újraindul.
A szolgáltatás kezelése:
systemctl status uvicorn-fastapi
systemctl restart uvicorn-fastapi
A szolgáltatás szerkesztése:
sudo vim /etc/systemd/system/uvicorn-fastapi.service
sudo systemctl daemon-reload
sudo systemctl restart uvicorn-fastapi
sudo systemctl status uvicorn-fastapi
10. HTTPS engedélyezése (opcionális)
Használja a Certbotot az HTTPS engedélyezéséhez.