1. Připojte se k vašemu serveru
Pro připojení k serveru použijte SSH:
ssh root@<server-ip>
2. Přístup k přihlašovacím údajům
Pro správu vaší aplikace byl vytvořen vyhrazený uživatel s názvem fastapi.
Přihlašovací údaje naleznete v tomto souboru: /root/.fastapi-creds
Chcete-li je zobrazit, spusťte:
cat /root/.fastapi-creds
Pokud si přejete změnit heslo, použijte:
passwd fastapi
3. Přepněte na uživatele aplikace
Chcete-li spravovat svou aplikaci, přepněte na uživatelský účet fastapi:
su - flask
Tento účet obsahuje váš projekt FastAPI a prostředí.
4. Struktura projektu
Zde je výchozí rozložení adresáře:
/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
Chcete-li použít změny, restartujte službu FastAPI:
sudo systemctl restart uvicorn-fastapi
6. Prohlížení protokolů
Logy pro Uvicorn a Nginx můžete zkontrolovat následovně:
- Záznamy Uvicorn:
/var/log/uvicorn/ - Protokol chyb 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šemu 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 do soketu Uvicorn, na kterém je spuštěna aplikace FastAPI.
8. Změna domény nebo portu
Pokud chcete aktualizovat název serveru, port nebo doménu:
- Upravit konfiguraci webu Nginx:
sudo nano /etc/nginx/sites-available/uvicorn-fastapi - Testovací konfigurace:
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 automaticky se restartuje při selhání.
Pro správu služby:
systemctl status uvicorn-fastapi
systemctl restart uvicorn-fastapi
Chcete-li upravit službu:
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é)
K povolení HTTPS použijte Certbot.
