1. Připojte se k serveru
Pro připojení k serveru použijte SSH:
ssh root@<server-ip>
2. Přístupové přihlašovací údaje
Pro správu vaší aplikace byl vytvořen speciální uživatel s názvem fastapi.
Přihlašovací údaje najdete v tomto souboru: /root/.fastapi-creds
Chcete-li je zobrazit, spusťte:
cat /root/.fastapi-creds
Pokud chcete změnit heslo, použijte:
passwd fastapi
3. Přepněte na uživatele aplikace
Přepněte se na uživatelský účet fastapi, abyste mohli spravovat svou aplikaci:
su - flask
Tento účet obsahuje váš projekt FastAPI a prostředí.
4. Struktura projektu
Zde je výchozí struktura adresářů:
/home/fastapi/fastapi_app/
├── main.py → Your main FastAPI application file
├── venv/ → Virtual environment
└── __pycache__/ → Compiled Python files (auto-generated)
5. Správa vaší aplikace
Přejděte do adresáře aplikace:
cd ~/fastapi_app
Aktivujte virtuální prostředí:
source venv/bin/activate
Upravte hlavní soubor aplikace:
nano main.py
Restartujte službu FastAPI, aby se změny projevily:
sudo systemctl restart uvicorn-fastapi
6. Prohlížení protokolů
Protokoly pro Uvicorn a Nginx můžete zkontrolovat následujícím způsobem:
- Záznamy Uvicorn:
/var/log/uvicorn/ - Chybový protokol Nginx:
/var/log/nginx/error.log - Přístupový protokol Nginx:
/var/log/nginx/access.log
Chcete-li je zobrazit:
sudo tail -f /var/log/uvicorn/*
7. Přístup k vaší API
Jakmile je služba spuštěna, vaše aplikace FastAPI je k dispozici ve vašem prohlížeči na adrese: http://<server-ip>
Nginx automaticky předává HTTP požadavky na socket Uvicorn, na kterém běží vaše aplikace FastAPI.
8. Změna domény nebo portu
Pokud chcete aktualizovat název serveru, port nebo doménu:
- Upravte konfiguraci webu Nginx:
sudo nano /etc/nginx/sites-available/uvicorn-fastapi - Konfigurace testu:
sudo nginx -t - Znovu načíst Nginx:
sudo systemctl restart nginx
9. Služba Uvicorn
Aplikace FastAPI běží prostřednictvím služby systemd s názvem uvicorn-fastapi.
Používá /home/fastapi/fastapi_app/main:app jako vstupní bod aplikace a v případě selhání se automaticky restartuje.
Správa služby:
systemctl status uvicorn-fastapi
systemctl restart uvicorn-fastapi
Chcete-li službu upravit:
sudo vim /etc/systemd/system/uvicorn-fastapi.service
sudo systemctl daemon-reload
sudo systemctl restart uvicorn-fastapi
sudo systemctl status uvicorn-fastapi
10. Povolte HTTPS (volitelné)
Použijte Certbot k povolení HTTPS.