1. Opret forbindelse til din server
Brug SSH til at oprette forbindelse til din server:
ssh root@<server-ip>
2. Tilgå loginoplysninger
En dedikeret bruger ved navn fastapi er oprettet til at administrere din applikation.
Du finder loginoplysningerne i denne fil: /root/.fastapi-creds
Kør følgende for at se dem:
cat /root/.fastapi-creds
Hvis du vil ændre adgangskoden, brug:
passwd fastapi
3. Skift til appbrugeren
Skift til fastapi-brugerkontoen for at administrere din app:
su - flask
Denne konto indeholder dit FastAPI-projekt og -miljø.
4. Projektstruktur
Her er standardmappestrukturen:
/home/fastapi/fastapi_app/
├── main.py → Your main FastAPI application file
├── venv/ → Virtual environment
└── __pycache__/ → Compiled Python files (auto-generated)
5. Administrer din applikation
Navigér til applikationsmappen:
cd ~/fastapi_app
Aktivér det virtuelle miljø:
source venv/bin/activate
Rediger den primære app-fil:
nano main.py
Genstart FastAPI-tjenesten for at anvende ændringerne:
sudo systemctl restart uvicorn-fastapi
6. Visning af logs
Du kan tjekke logs for Uvicorn og Nginx på følgende måde:
- Uvicorn-logge:
/var/log/uvicorn/ - Nginx fejllog:
/var/log/nginx/error.log - Nginx adgangslog:
/var/log/nginx/access.log
For at se dem:
sudo tail -f /var/log/uvicorn/*
7. Tilgå din API
Når tjenesten kører, er din FastAPI-app tilgængelig i browseren på: http://<server-ip>
Nginx videresender automatisk HTTP-anmodninger til den Uvicorn-socket, der kører din FastAPI-app.
8. Skift domæne eller port
Hvis du vil opdatere servernavnet, porten eller domænet:
- Redigér Nginx-sitekonfigurationen:
sudo nano /etc/nginx/sites-available/uvicorn-fastapi - Testkonfiguration:
sudo nginx -t - Genindlæs Nginx:
sudo systemctl restart nginx
9. Uvicorn-tjeneste
FastAPI-appen kører via en systemd-tjeneste ved navn uvicorn-fastapi.
Det bruger /home/fastapi/fastapi_app/main:app som applikationens indgangspunkt og genstarter automatisk ved fejl.
Sådan administrerer du tjenesten:
systemctl status uvicorn-fastapi
systemctl restart uvicorn-fastapi
Sådan redigerer du tjenesten:
sudo vim /etc/systemd/system/uvicorn-fastapi.service
sudo systemctl daemon-reload
sudo systemctl restart uvicorn-fastapi
sudo systemctl status uvicorn-fastapi
10. Aktivér HTTPS (valgfrit)
Brug Certbot til at aktivere HTTPS.
