VPS: Instalacja Plausible na systemie operacyjnym
Ten poradnik został stworzony z wykorzystaniem następujących produktów:
(Szczegóły mogą się różnić w zależności od produktów różnych dostawców, ale główne koncepcje pozostają takie same)
Wprowadzenie
Plausible to lekka, open-source’owa platforma analityki internetowej, która działa bez ciasteczek i w pełni przestrzega przepisów o ochronie prywatności. Dostarcza kluczowe metryki, takie jak liczba odwiedzających, odsłony stron i czas wizyty, za pomocą przejrzystego, intuicyjnego panelu głównego. Dzięki łatwości obsługi, szybkiemu działaniu i infrastrukturze opartej w UE, Plausible jest nowoczesną i świadomą prywatności alternatywą dla Google Analytics.
Myślisz o samodzielnym hostingu tej usługi? Przeprowadzimy Cię przez każdy krok konfiguracji i ustawień oraz podpowiemy, na co zwrócić uwagę.
Wymagania wstępne
Przed instalacją Plausible upewnij się, że Twoje środowisko hostingowe spełnia poniższe wymagania, aby zapewnić płynną instalację i optymalną wydajność.
| Sprzęt | Minimum | Rekomendacja ZAP-Hosting |
|---|---|---|
| CPU | 1 rdzeń vCPU | 4 rdzenie vCPU |
| RAM | 2 GB | 4 GB |
| Miejsce na dysku | 10 GB | 25 GB |
Oprogramowanie wymaga zainstalowania wszystkich niezbędnych zależności oraz działania na wspieranym systemie operacyjnym. Upewnij się, że Twój serwer spełnia poniższe wymagania przed przystąpieniem do instalacji:
Zależności: Docker
System operacyjny: Najnowsza wersja Ubuntu/Debian wspierająca Docker 26+
Sprawdź, czy wszystkie zależności są zainstalowane, a system operacyjny jest aktualny, aby uniknąć problemów z kompatybilnością podczas instalacji Plausible.
Przygotowanie
Przed konfiguracją Plausible musisz przygotować swój system. Obejmuje to aktualizację systemu operacyjnego do najnowszej wersji oraz instalację wszystkich wymaganych zależności. Te przygotowania zapewnią stabilne środowisko i pomogą uniknąć problemów podczas lub po instalacji.
Aktualizacja systemu
Aby mieć pewność, że Twój system działa na najnowszym oprogramowaniu i z poprawkami bezpieczeństwa, zawsze zacznij od aktualizacji systemu. Wykonaj polecenie:
sudo apt update && sudo apt upgrade -y
To zapewni, że Twój system ma najnowsze poprawki bezpieczeństwa i wersje oprogramowania przed dalszą instalacją.
Instalacja zależności
Po zakończeniu aktualizacji możesz przystąpić do instalacji zależności.
Git
Dane Plausible będą pobierane z GitHub, więc najpierw musisz zainstalować Git. Wykonaj polecenie:
sudo apt install git-all
Docker
Plausible będzie uruchamiane w kontenerze Docker na Twojej maszynie, więc Docker musi być zainstalowany. Wykonaj polecenia:
curl -fsSL https://get.docker.com -o get-docker.sh
sh get-docker.sh
Pełny poradnik instalacji i obsługi Dockera znajdziesz w naszym poradniku Docker.
Instalacja
Gdy wszystkie wymagania są spełnione, a przygotowania zakończone, możesz przejść do instalacji aplikacji Plausible.
Najpierw sklonuj repozytorium Community Edition i utwórz niezbędny plik konfiguracyjny:
$ git clone -b v3.0.1 --single-branch https://github.com/Plausible/community-edition Plausible-ce
Następnie utwórz plik środowiskowy (.env) i zdefiniuj podstawowe zmienne. BASE_URL musi wskazywać na faktyczną domenę, która ma już rekord DNS kierujący na Twój serwer. Wygeneruj też losowy SECRET_KEY_BASE o długości co najmniej 64 bajtów:
touch .env
echo "BASE_URL=https://Plausible.example.com" >> .env
echo "SECRET_KEY_BASE=$(openssl rand -base64 48)" >> .env
echo "HTTP_PORT=80" >> .env
echo "HTTPS_PORT=443" >> .env
Sprawdź zawartość pliku poleceniem cat .env, aby potwierdzić poprawność wartości. Powinno to wyglądać tak:
BASE_URL=https://Plausible.example.com
SECRET_KEY_BASE=As0fZsJlUpuFYSthRjT5Yflg/NlxkFKPRro72xMLXF8yInZ60s6xGGXYVqml+XN1
HTTP_PORT=80
HTTPS_PORT=443
Te domyślne porty pozwalają Let’s Encrypt automatycznie wystawić certyfikaty TLS. Jeśli planujesz uruchomić Plausible za reverse proxy, możesz dostosować te wartości. Dodatkowo utwórz plik compose.override.yml, aby wystawić odpowiednie porty dla kontenera Plausible:
cat > compose.override.yml << EOF
services:
Plausible:
ports:
- 80:80
- 443:443
EOF
Na koniec uruchom wymagane usługi za pomocą Docker Compose:
docker compose up -d
Gdy kontenery działają, otwórz przeglądarkę pod adresem domeny podanej w BASE_URL i utwórz pierwsze konto użytkownika.
Konfiguracja
Plausible można zintegrować z Google Search Console, aby wzbogacić analitykę o dane z zapytań wyszukiwania. Dzięki temu zobaczysz, które słowa kluczowe generują ruch na Twojej stronie, co daje głębszy wgląd w zachowanie odwiedzających.
Jeśli masz konto Google Cloud i skonfigurowanego klienta OAuth, wystarczy dodać swoje dane (GOOGLE_CLIENT_ID i GOOGLE_CLIENT_SECRET) do pliku .env. Po zapisaniu zmian zrestartuj usługi Dockera poleceniem docker compose up -d. W panelu Plausible przejdź do Ustawienia strony > Integracje, aby dokończyć połączenie i przejść przez proces uwierzytelniania.
Jeśli nie masz jeszcze klienta OAuth lub nie znasz procesu, oficjalne Wiki Plausible oferuje szczegółowy poradnik krok po kroku. Wyjaśnia, jak utworzyć projekt w Google Cloud, włączyć wymagane API, skonfigurować klienta OAuth i dodać wygenerowane dane do Plausible: Plausible Wiki: Google Integration.
Jeśli korzystasz z Google Search Console, możesz skonfigurować integrację Google, aby pobierać dane o wyszukiwanych frazach, co jest naprawdę fajne.
Jeśli masz już konto Google Cloud z klientem OAuth, po prostu wklej GOOGLE_CLIENT_ID i GOOGLE_CLIENT_SECRET do pliku .env, zrestartuj usługę Docker poleceniem docker compose up -d i postępuj zgodnie z instrukcjami w Plausible w Ustawienia strony > Integracje.
Podsumowanie i dodatkowe zasoby
Gratulacje! Właśnie pomyślnie zainstalowałeś i skonfigurowałeś Plausible na swoim VPS. Polecamy też zapoznać się z poniższymi zasobami, które mogą Ci pomóc i wesprzeć podczas konfiguracji serwera:
- Plausible.io - Oficjalna strona
- github.com/Plausible/analytics - Ogłoszenia, dyskusje, zgłaszanie problemów
Masz pytania, które nie zostały tu poruszone? Jeśli potrzebujesz dalszej pomocy, śmiało kontaktuj się z naszym zespołem wsparcia, który jest dostępny codziennie, by Ci pomóc! 🙂