1. Opret forbindelse til din server
Brug SSH til at oprette forbindelse til din server:
ssh root@<server-ip>
2. Få adgang til loginoplysninger
En dedikeret bruger ved navn fastapi er blevet oprettet 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 appbrugeren
Skift til fastapi-brugerkontoen for at administrere din app:
su - flask
Denne konto indeholder dit FastAPI-projekt og miljø.
4. Projektets struktur
Her er standard mappelayoutet:
/home/fastapi/fastapi_app/
├── main.py → Your main FastAPI application file
├── venv/ → Virtual environment
└── __pycache__/ → Compiled Python files (auto-generated)
5. Håndtering af din applikation
Naviger til applikationsmappen:
cd ~/fastapi_app
Aktiver det virtuelle miljø:
source venv/bin/activate
Rediger hovedappfilen:
nano main.py
Genstart FastAPI-tjenesten for at anvende ændringer:
sudo systemctl restart uvicorn-fastapi
6. Visning af logs
Du kan kontrollere logfiler for Uvicorn og Nginx som følger:
- Uvicorn logs:
/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-webstedets konfiguration:
sudo nano /etc/nginx/sites-available/uvicorn-fastapi - Test konfiguration:
sudo nginx -t - Genindlæs Nginx:
sudo systemctl restart nginx
9. Uvicorn Service
FastAPI-appen kører via en systemd service ved navn uvicorn-fastapi.
Det bruger /home/fastapi/fastapi_app/main:app som applikationsindgangspunkt 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. Aktiver HTTPS (valgfrit)
Brug Certbot til at aktivere HTTPS.