Zarządzanie witrynami WordPress w Dockerze

WP Staging CLI potrafi tworzyć i zarządzać środowiskami WordPress opartymi na Dockerze do lokalnego rozwoju i testów. Ten przewodnik pokazuje, jak dodawać, wyświetlać, usuwać i zarządzać witrynami WordPress.

Co otrzymasz

Każda witryna Docker zawiera:

  • PHP-FPM w wybranej przez ciebie wersji PHP
  • Serwer WWW Nginx z HTTPS
  • Bazę danych MariaDB
  • Mailpit do testowania wiadomości e-mail
  • Automatyczne certyfikaty SSL przez mkcert
  • Konfigurację pliku hosts dla lokalnych domen

Wymagania wstępne

  • Docker 20.10.0 lub nowszy
  • Docker Compose 2.19.0 lub nowszy
  • Minimum 2 rdzenie CPU i 4 GB RAM

Dodawanie nowej witryny

Utwórz nową witrynę WordPress z własną lokalną domeną:

wpstaging add https://mysite.local

Lub bez protokołu:

wpstaging add mysite.local

Potrzebujesz WordPress Multisite?

wpstaging add mysite.local --multisite

Po utworzeniu witryny możesz wejść na nią pod adresem https://mysite.local.

Dodawanie witryny z istniejącego pliku Backupu

Utwórz nową witrynę i przywróć ją z pliku Backupu WP Staging w jednym kroku:

wpstaging add mysite.local --from=backup.wpstg

Lub ze zdalnego adresu URL:

wpstaging add mysite.local --from=https://example.com/backup.wpstg

WordPress Multisite:

wpstaging add mysite.local --multisite --from=BACKUP_URL

To zalecany sposób tworzenia lokalnej kopii twojej witryny produkcyjnej. Obsługuje wszystko: konfigurację Dockera, wyodrębnianie Backupu, import bazy danych oraz podmianę adresów URL.

Dostosowywanie konfiguracji witryny

Wersja PHP

Wskaż wersję PHP (domyślnie 8.1):

wpstaging add mysite.local --php=8.2

Dostępne wersje PHP zależą od obsługiwanych obrazów Docker.

Wersja WordPress

Zainstaluj konkretną wersję WordPress (domyślnie najnowszą):

wpstaging add mysite.local --wp=6.4.2

Własne porty

Zmień domyślne porty, jeśli kolidują z innymi usługami:

wpstaging add mysite.local \
  --http-port=8080 \
  --https-port=8443 \
  --db-port=3307

Adres IP kontenera

Domyślnie witryny korzystają z adresów IP z zakresu 127.3.2.x. Możesz wskazać własny adres IP:

wpstaging add mysite.local --container-ip=127.0.0.1

Ścieżka środowiska

Zmień miejsce, w którym przechowywane są środowiska Docker (domyślnie: ~/wpstaging):

wpstaging add mysite.local --env-path=/custom/path

Wszystkie flagi polecenia add

FlagaDomyślnieOpis
--php8.1Wersja PHP
--wplatestWersja WordPress
--fromŚcieżka do pliku Backupu lub adres URL do przywrócenia
--env-path~/wpstagingŚcieżka do przechowywania środowisk Docker
--container-ip127.3.2.1Adres IP kontenera
--http-port80Port HTTP Nginx
--https-port443Port HTTPS Nginx
--db-port3306Port MariaDB
--db-root123456Hasło użytkownika root MariaDB
--mailpit-http-port8025Port interfejsu webowego Mailpit
--disable-mailpitfalseWyłącza kontener Mailpit

Flagi konfiguracji WordPress

FlagaDomyślnieOpis
--db-nameautoNazwa bazy danych WordPress
--db-userautoUżytkownik bazy danych WordPress
--db-passautoHasło bazy danych WordPress
--db-prefixwp_Prefiks tabel WordPress
--db-hostlocalhostNazwa hosta bazy danych WordPress
--db-sslfalseWłącza SSL dla połączenia z bazą danych WordPress
--admin-useradminNazwa użytkownika administratora WordPress
--admin-passadminHasło administratora WordPress
--admin-emailadmin@dev.nullE-mail administratora WordPress
--secure-credentialsfalseGeneruje losowe, bezpieczne dane dostępowe
--multisitefalseWłącza WordPress Multisite

Wyświetlanie witryn

Wyświetl wszystkie witryny WordPress w twoim środowisku Docker:

wpstaging list

Przykładowy wynik:

HOSTNAME            STATUS      PHP     IP
mysite.local        running     8.1     127.3.2.1
dev.local           stopped     8.2     127.3.2.2
test.local          running     8.0     127.3.2.3

Wyświetlanie szczegółów konkretnych witryn

Pobierz szczegółowe informacje o jednej lub kilku witrynach:

wpstaging list mysite.local

Lub o kilku witrynach naraz:

wpstaging list site1.local site2.local

Usuwanie witryn

Usuń konkretną witrynę:

wpstaging del mysite.local

Usuń kilka witryn:

wpstaging del site1.local site2.local

Usuń wszystkie witryny (z potwierdzeniem):

wpstaging del

Uwaga: usunięcie witryny powoduje usunięcie wszystkich jej plików, bazy danych i konfiguracji. Tej operacji nie da się cofnąć.

Włączanie/wyłączanie witryn

Wyłącz witrynę bez jej usuwania:

wpstaging disable mysite.local

Ponownie włącz wyłączoną witrynę:

wpstaging enable mysite.local

Wyłączone witryny zachowują swoje dane, ale ich kontenery nie są uruchamiane.

Resetowanie witryny

Zresetuj witrynę do świeżej instalacji WordPress:

wpstaging reset mysite.local

Usuwa to wszystkie treści WordPress i ponownie instaluje WordPress, zachowując nienaruszoną konfigurację Dockera.

Reset z inną wersją WordPress

Wskaż inną wersję WordPress podczas resetowania:

wpstaging reset mysite.local --wp=6.5

Reset i przywracanie z Backupu

Zresetuj witrynę i przywróć z Backupu WP Staging w jednym kroku:

wpstaging reset mysite.local --from=backup.wpstg
wpstaging reset mysite.local --from=https://example.com/backup.wpstg

Bezpieczne dane dostępowe

Dla większego bezpieczeństwa, zwłaszcza we współdzielonych środowiskach, używaj losowych danych dostępowych:

wpstaging add mysite.local --secure-credentials

Generuje to losowe hasła dla:

  • Użytkownika root MariaDB
  • Użytkownika bazy danych WordPress
  • Użytkownika administratora WordPress

Wygenerowane dane dostępowe są wyświetlane po utworzeniu witryny.

WordPress Multisite

Utwórz instalację WordPress Multisite:

wpstaging add mynetwork.local --multisite

Uwagi dla macOS

Użytkownicy macOS: automatyczne przypisywanie aliasów IP jest domyślnie włączone, dzięki czemu konfiguracja wielu witryn działa bezproblemowo z użyciem zakresu IP loopback 127.3.2.1 – 127.3.2.254. Wymaga to sudo, więc zostaniesz poproszony o hasło.

Wskazówka: skonfiguruj sudo bez hasła dla wpstaging, aby uniknąć ciągłego wpisywania hasła. Instrukcje znajdziesz w FAQ.

Następne kroki

Updated on 23 maja, 2026

Rene Hermenau

Autor: Rene Hermenau

About the author: René Hermenau is the founder of WP STAGING. He works on WordPress backups, staging, migrations, database handling, and safe deployment workflows.