1. Opret forbindelse til din server
Brug SSH til at oprette forbindelse til din server:
ssh root@<server-ip>
2. Adgang til loginoplysninger
Der er oprettet en dedikeret bruger ved navn fastapi til at administrere din applikation.
Du kan finde loginoplysningerne i denne fil: /root/.fastapi-creds
For at se dem skal du køre:
cat /root/.fastapi-creds
Hvis du ønsker at ændre adgangskoden, skal du bruge:
passwd fastapi
3. Skift til app-brugeren
Skift til fastapi-brugerkontoen for at administrere din app:
su - flask
Denne konto indeholder dit FastAPI-projekt og -miljø.
4. Projektstruktur
Her er standardmappenes layout:
/home/fastapi/fastapi_app/
├── main.py → Your main FastAPI application file
├── venv/ → Virtual environment
└── __pycache__/ → Compiled Python files (auto-generated)
5. Administration af din ansøgning
Naviger til programkataloget:
cd ~/fastapi_app
Aktivér det virtuelle miljø:
source venv/bin/activate
Rediger hovedappfilen:
nano main.py
Genstart FastAPI-tjenesten for at anvende ændringerne:
sudo systemctl restart uvicorn-fastapi
6. Visning af logfiler
Du kan kontrollere logfiler for Uvicorn og Nginx på følgende måde:
- Uvicorn-logfiler:
/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. Adgang til din API
Når tjenesten kører, er din FastAPI-app tilgængelig i din browser på: http://<server-ip>
Nginx videresender automatisk HTTP-anmodninger til Uvicorn-socket, der kører din FastAPI-app.
8. Ændring af domæne eller port
Hvis du vil opdatere servernavnet, porten eller domænet:
- Rediger Nginx-webstedskonfiguration:
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 indgangssted og genstarter automatisk ved fejl.
For at administrere tjenesten:
systemctl status uvicorn-fastapi
systemctl restart uvicorn-fastapi
For at redigere 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.