Serwer dedykowany: Instalacja Plausible na systemie
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 czy czas wizyty, za pomocą przejrzystego i intuicyjnego panelu głównego. Dzięki łatwości obsługi, szybkiemu działaniu i infrastrukturze opartej w UE, Plausible to nowoczesna i świadoma prywatności alternatywa dla Google Analytics.
Myślisz o samodzielnym hostingu tej usługi? Przeprowadzimy Cię krok po kroku przez cały proces instalacji i konfiguracji 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ń CPU | 4 rdzenie CPU |
| 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 rozpoczęciem instalacji:
Zależności: Docker
System operacyjny: Najnowsza wersja Ubuntu/Debian wspierająca Docker 26+
Zadbaj o to, by wszystkie zależności były zainstalowane, a system operacyjny był 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
Dzięki temu Twój system będzie miał najnowsze poprawki bezpieczeństwa i aktualizacje oprogramowania przed dalszymi krokami.
Instalacja zależności
Po zakończeniu aktualizacji możesz przejść do instalacji zależności.
Git
Dane Plausible będą pobierane z GitHub, więc najpierw musisz mieć zainstalowany Git. Wykonaj polecenie:
sudo apt install git-all
Docker
Plausible będzie uruchamiane w kontenerze Docker na Twoim serwerze, 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 spełnisz wszystkie wymagania i przygotujesz system, możesz przejść do instalacji aplikacji Plausible.
Najpierw sklonuj repozytorium Community Edition i utwórz 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 je dostosować. 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 zaczną działać, otwórz przeglądarkę pod adresem domeny podanej w BASE_URL i stwó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 zachowania 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 Site Settings > Integrations, aby dokończyć połączenie i przejść przez proces uwierzytelniania.
Jeśli nie masz jeszcze klienta OAuth lub nie znasz procesu, oficjalna Wiki Plausible oferuje szczegółowy poradnik krok po kroku. Wyjaśnia, jak stworzyć 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, by pobierać dane o wyszukiwanych frazach – to naprawdę fajna opcja.
Jeśli masz już konto Google Cloud z klientem OAuth, po prostu wklej GOOGLE_CLIENT_ID i GOOGLE_CLIENT_SECRET do pliku .env, zrestartuj Dockera (docker compose up -d) i postępuj zgodnie z instrukcjami w Plausible w Site Settings > Integrations.
Podsumowanie i dodatkowe zasoby
Gratulacje! Właśnie pomyślnie zainstalowałeś i skonfigurowałeś Plausible na swoim serwerze dedykowanym. Polecamy też rzucić okiem na poniższe materiały, które mogą Ci pomóc i wesprzeć podczas dalszej konfiguracji serwera:
- Plausible.io - Oficjalna strona
- github.com/Plausible/analytics - Ogłoszenia, dyskusje, zgłaszanie problemów
Masz pytania, których tu nie ma? Jeśli potrzebujesz pomocy lub masz dodatkowe pytania, śmiało kontaktuj się z naszym supportem – jesteśmy dostępni codziennie, by Ci pomóc! 🙂