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ą.
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:
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
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.
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.
