VPS i Docker

Docker na VPS — pierwsza aplikacja z Docker Compose krok po kroku

Uruchom prostą stronę w Docker Compose na VPS: plik compose.yaml, trwałe pliki, logi i dostęp przez tunel SSH bez publicznego otwierania portu.

Docker na VPS — pierwsza aplikacja z Docker Compose krok po kroku
KRÓTKA ODPOWIEDŹ

Na przygotowanym VPS z Docker Engine i pluginem Compose możesz opisać usługę w compose.yaml i uruchomić ją poleceniem docker compose up -d. Zacznij od aplikacji dostępnej tylko lokalnie, sprawdź logi oraz dane, a dopiero później planuj publiczną domenę i HTTPS.

Co przygotować przed uruchomieniem kontenera?

Potrzebujesz dostępu SSH, wspieranego systemu i działającego Docker Engine z pluginem Compose. Ten przykład dotyczy prostej strony testowej na własnym VPS. Nie instaluj drugiej kopii Dockera na działającym węźle gier lub serwerze produkcyjnym bez sprawdzenia istniejących usług.

Instalację wykonaj według dokumentacji swojej dystrybucji: Docker dla Ubuntu albo Docker dla Debiana. Nie mieszaj instrukcji repozytoriów. Następnie sprawdź docker version i docker compose version. Jeśli konto nie ma uprawnień do silnika, używaj odpowiedniego dostępu administracyjnego; członkostwo w grupie docker daje szerokie uprawnienia do hosta.

Przygotuj stronę i plik compose.yaml

Utwórz oddzielny katalog projektu. Polecenia wykonuj w nim; nie nadpisuj plików istniejącej aplikacji. Zapis poniżej tworzy małą stronę demonstracyjną.

bash
mkdir -p castpol-demo/site
cd castpol-demo
printf '%s\n' '<!doctype html><html lang="pl"><meta charset="utf-8"><title>Demo VPS</title><h1>Docker działa</h1></html>' > site/index.html

W tym samym katalogu zapisz plik compose.yaml:

yaml
services:
  web:
    image: nginx:stable-alpine
    ports:
      - "127.0.0.1:8080:80"
    volumes:
      - ./site:/usr/share/nginx/html:ro
    restart: unless-stopped

Usługa udostępnia zawartość katalogu site tylko do odczytu. Port 8080 jest związany z adresem lokalnym VPS, więc nie zakładamy publicznego dostępu do demonstracji. Tag obrazu może zmienić zawartość przy przyszłym pobraniu; dla powtarzalnego wdrożenia zapisz sprawdzoną wersję lub digest i planuj aktualizacje.

Uruchom usługę i sprawdź wynik

bash
docker compose config
docker compose up -d
docker compose ps
docker compose logs --tail=50 web
curl -I http://127.0.0.1:8080

Pierwsze polecenie sprawdza konfigurację Compose. Uruchomienie może pobrać obraz i wymaga dostępu do rejestru. W odpowiedzi HTTP sprawdź status, a następnie pobierz stronę przez curl http://127.0.0.1:8080. Sukces na localhost potwierdza tę usługę, nie konfigurację publicznej domeny.

Objaw Co sprawdzić
Nie znaleziono polecenia Compose Czy plugin jest zainstalowany dla używanego środowiska?
Port jest zajęty Czy inna usługa już korzysta z 8080?
Kontener stale się restartuje Logi i poprawność podmontowanych plików
Strona jest pusta lub nie ta Katalog projektu oraz zawartość site/index.html

Jak zobaczyć stronę na swoim komputerze?

Na swoim komputerze otwórz osobne połączenie z tunelem. Zastąp użytkownika i adres danymi VPS; przy innym porcie SSH dodaj właściwą opcję -p.

bash
ssh -N -L 18080:127.0.0.1:8080 UZYTKOWNIK@ADRES_VPS

Dopóki połączenie działa, otwórz http://127.0.0.1:18080 w lokalnej przeglądarce. Nie musisz publicznie otwierać 8080. Jeśli lokalny port 18080 jest zajęty, wybierz inny. Tunel nie nadaje stronie publicznej domeny ani certyfikatu.

Co z danymi i wyłączeniem projektu?

Plik strony pozostaje w katalogu site na hoście. Możesz go zmienić i odświeżyć przeglądarkę. Polecenie docker compose stop zatrzymuje usługę; docker compose down usuwa kontenery i sieć projektu. Nie dopisuj opcji kasujących wolumeny bez zrozumienia skutków dla innych aplikacji.

Własna aplikacja z bazą wymaga szerszego planu trwałych danych i spójnych kopii. Skorzystaj z poradnika backupu Dockera. Sam zapis compose.yaml nie przechowuje bazy ani uploadów.

Jak przejść do aplikacji produkcyjnej?

Przygotuj domenę, HTTPS, reverse proxy, monitoring i kopie. Publikowane porty Dockera mogą omijać typowe reguły UFW, więc nie opieraj ochrony wyłącznie na założeniu, że zapora zablokuje każdy kontener. W ofercie VPS Castpol dobierz zasoby również do bazy i procesów w tle. Dostępny panel Virtualizor służy do maszyny; utrzymanie stosu aplikacji pozostaje osobnym zadaniem.

Źródła i dokumentacja

c.
Castpol Blog

Poradnik wydawany przez Castpol. O blogu · Zgłoś poprawkę

KOLEJNY KROK

Te poradniki uzupełniają temat