Jak uruchomić aplikację Node lub Python na hostingu

Od katalogu z kodem do działającej aplikacji za Twoją stroną: instalacja środowiska, komenda startu, port i podpięcie strony w panelu.

Aktualizacja: Wersja markdown (dla agentów)

Czego potrzebujesz

  • Usługi hostingu z włączoną betą: Hosting → Twoja usługa → Aplikacje → Włącz betę.
  • Kodu aplikacji w katalogu domowym, wgranego przez FTP, SFTP albo git clone w konsoli.
  • Około 1,1 GB wolnego miejsca na projekt Next.js ze środowiskiem i pamięcią podręczną pakietów.

Kroki

  1. Otwórz Hosting → Twoja usługa → Konsola.

  2. Wybierz wersję środowiska i zainstaluj zależności w katalogu projektu. Dla Node:

    cd moja-aplikacja
    mise use node@24
    npm install
    npm run build
    

    Dla Pythona:

    cd moja-aplikacja
    uv python install 3.13
    uv sync
    
  3. Otwórz Aplikacje → Nowa aplikacja.

  4. W polu Nazwa wpisz np. sklep. Tej nazwy nie zmienisz później.

  5. W polu Katalog wpisz ścieżkę względem katalogu domowego, np. moja-aplikacja.

  6. W polu Komenda startu wpisz komendę, która nasłuchuje na 0.0.0.0 i porcie ze zmiennej PORT:

    • Next.js: npm run start -- -H 0.0.0.0 -p $PORT
    • FastAPI z uv: uv run uvicorn main:app --host 0.0.0.0 --port $PORT
    • Bun: bun run server.js
  7. W polu Port wpisz numer portu, np. 3000.

  8. Kliknij Dodaj i uruchom.

  9. Na stronie aplikacji, w sekcji Strona, wybierz stronę i kliknij Podepnij.

Jak sprawdzić, że działa

Stan aplikacji to Działa, a Twoja strona pokazuje aplikację. W sekcji Konsola na stronie aplikacji widać jej wyjście na żywo.

Gdy nie działa

  • Strona informuje, że aplikacja nie odpowiada: aplikacja nasłuchuje na 127.0.0.1 albo na innym porcie niż podany. Popraw komendę startu.
  • Aplikacja restartuje się w kółko: przeczytaj błąd w Konsoli. Najczęściej brakuje zależności albo zbudowanego kodu.
  • Instalacja kończy się błędem zapisu: skończyło się miejsce na dysku. Sprawdź je na stronie usługi.
  • create-next-app odmawia utworzenia projektu: katalog nie jest pusty, np. ma już mise.toml. Utwórz projekt w podkatalogu.

← Wszystkie artykuły