Przewodniki /

Instalacja

/

Obraz Dockera

Obraz Dockera

Korzystając z tego przewodnika, pobierzesz plik compose zawierający wszystko, czego potrzebujesz, aby wdrożyć własny serwer Piwigo za pomocą Dockera.


W tym przewodniku założono, że możesz połączyć się ze swoim serwerem przez SSH i masz już zainstalowaną platformę Docker. Jeśli tak nie jest, postępuj zgodnie z oficjalną dokumentacją platformy Docker, która znajduje się tutaj

Krok 1 - Instalacja kontenera

Połącz się ze swoim serwerem i utwórz folder o nazwie Piwigo:

  • Pobierz plik compose.yaml z Piwigo/piwigo-docker

  • Możesz użyć curl, aby pobrać go bez opuszczania terminala

    curl -O "https://raw.githubusercontent.com/Piwigo/piwigo-docker/refs/heads/main/compose.yaml"

  • Utwórz plik o nazwie .env. Musi on zawierać następujące informacje, z silnym hasłem i strefą czasową po znaku równości bez cudzysłowów.

  • piwigo_port=8080
    db_user_password=
    timezone=
    PIWIGO_UID=
    PIWIGO_GID=

    Za pomocą polecenia truncate możesz wygenerować prawidłowe hasło, używając następującego polecenia:

    printf $(tr -dc '[:alnum:]' </dev/urandom | head -c64)"\n"

    Możesz zmienić udostępniony port, edytując piwigo_port

    Ustaw UID i GID użytkownika i grupy, którym chcesz przyznać dostęp do folderu piwigo w polach PIWIGO_UID i PIWIGO_GID

Uruchom swój kontener przy użyciu docker compose up -d

Krok 2 - Konfiguracja reverse proxy

W przypadku Piwigo Docker będziesz chciał użyć zewnętrznego odwrotnego serwera proxy. Możesz skorzystać z następujących przykładów konfiguracji Nginx:

Piwigo może być hostowane w domenie, subdomenie i/lub ścieżce podrzędnej. Niezależnie od wyboru, zaleca się nieużywanie numeru wersji Piwigo w adresie URL.

server {
	listen 80;
	server_name my_domain.tld;
	location / {
		proxy_pass http://127.0.0.1:8080/;
		proxy_set_header Host $host;
		proxy_set_header X-Real-IP $remote_addr;
		proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
		proxy_set_header X-Forwarded-Proto $scheme;
	}
}

Jeżeli zamierzasz hostować Piwigo na podścieżce (np. my_domain.tld/gallery), musisz przekierować ją do kontenera, dodając proxy_set_header X-Forwarded-Prefix /my_subpath

server {
	listen 80;
	server_name my_domain.tld;
	location /gallery/ {
		proxy_pass http://127.0.0.1:8080/;
		proxy_set_header Host $host;
		proxy_set_header X-Real-IP $remote_addr;
		proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
		proxy_set_header X-Forwarded-Proto $scheme;
		proxy_set_header X-Forwarded-Prefix /gallery;
    }
}

Krok 3. Konfiguracja

Po uruchomieniu kontenera i skonfigurowaniu serwera reverse proxy otwórz przeglądarkę internetową i wejdź na adres, na którym hostujesz Piwigo. Piwigo wykryje, że nic jeszcze nie zostało zainstalowane i przekieruje Cię na stronę instalacji.

Jeśli zmieniłeś piwigo_port w .env, musisz również zmodyfikować sekcję proxy_pass, aby to uwzględnić. Pamiętaj, że Docker z założenia ignoruje wszystkie reguły zapory sieciowej.

Uzupełnij dane połączenia z bazą MySQL poniżej :

  • Host : piwigo-db:3306
  • Użytkownik : piwigodb_user
  • Hasło : Użyj hasła, które zapisałeś w pliku .env
  • Nazwa bazy danych : piwigodb
  • Przedrostek dla nazw tablic Piwigo : piwigo_

Następujące informacje są wymagane do utworzenia konta administratora witryny:

  • Wybrany przez Ciebie identyfikator konta
  • Hasło musisz wprowadzić dwukrotnie, dla sprawdzenia
  • Twój adres e-mail, aby odwiedzający mogli się z Tobą skontaktować

Uruchom akcję "Start instalacji"

Strona instalacji

Będziesz poinformowany o sukcesie lub niepowodzeniu procesu instalacji

Pomyślna instalacja

Krok 4. Pierwsze połączenie

Po zakończeniu instalacji możesz przejść do swojej galerii. Zaloguj się swoim kontem administracyjnym i przejdź do panelu administracyjnego.

Piwigo jest zainstalowane

Wciąż masz pytania?

Pomoc możesz otrzymać na forum lub poszukaj odpowiedzi w dokumentacji