1. Připojte se k serveru
Připojte se k serveru pomocí SSH:
ssh root@<server-ip>
2. Přístup k přihlašovacím údajům
Pro správu vaší aplikace byl vytvořen dedikovaný uživatel fastapi.
Přihlašovací údaje najdete v tomto souboru: /root/.fastapi-creds
Zobrazíte je příkazem:
cat /root/.fastapi-creds
Pokud chcete změnit heslo, použijte:
passwd fastapi
3. Přepnutí na uživatele aplikace
Přepněte se na účet uživatele fastapi pro správu aplikace:
su - flask
Tento účet obsahuje váš projekt FastAPI a jeho prostředí.
4. Struktura projektu
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 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. Zobrazení protokolů
Logy Uvicorn a Nginx zobrazíte takto:
- Protokoly Uvicorn:
/var/log/uvicorn/ - Chybový log Nginx:
/var/log/nginx/error.log - Přístupový log Nginx:
/var/log/nginx/access.log
Chcete-li je zobrazit:
sudo tail -f /var/log/uvicorn/*
7. Přístup k vaší API
Jakmile služba běží, vaše aplikace FastAPI je dostupná v prohlížeči na adrese: http://<server-ip>
Nginx automaticky přesměrovává požadavky HTTP na socket Uvicorn, který obsluhuje vaši aplikaci FastAPI.
8. Změna domény nebo portu
Pokud chcete aktualizovat název serveru, port nebo doménu:
- Upravte konfiguraci Nginx site:
sudo nano /etc/nginx/sites-available/uvicorn-fastapi - Testovací konfigurace:
sudo nginx -t - Přenačíst Nginx:
sudo systemctl restart nginx
9. Služba Uvicorn
Aplikace FastAPI běží jako systemd služba s názvem uvicorn-fastapi.
Používá /home/fastapi/fastapi_app/main:app jako vstupní bod aplikace s automatickým restartem při selhání.
Správa služby:
systemctl status uvicorn-fastapi
systemctl restart uvicorn-fastapi
Úprava služby:
sudo vim /etc/systemd/system/uvicorn-fastapi.service
sudo systemctl daemon-reload
sudo systemctl restart uvicorn-fastapi
sudo systemctl status uvicorn-fastapi
10. Aktivace HTTPS (volitelné)
K povolení HTTPS použijte Certbot.
