SerpBear na BiedaHostingu - skuteczne narzędzie SEO za 25 zł/rok

Wstęp: Po co to robimy?

SerpBear to darmowe, open-source narzędzie do śledzenia pozycji Twojej strony w Google. Normalnie wymaga VPS-a - ale okazuje się że da się je uruchomić na zwykłym hostingu współdzielonym za 25 zł/rok. Sprawdziliśmy to na BiedaHostingu.

Kluczowy trick: zamiast instalować Node.js i wszystkie zależności na serwerze, budujemy aplikację lokalnie i wysyłamy tylko to co niezbędne do uruchomienia. Standalone build Next.js waży zaledwie ~33 MB - mieści się na pakiecie bieda25.

Czego potrzebujesz:

• Konto na BiedaHostingu (pakiet bieda25 - 250 MB miejsca)
• Node zainstalowany na własnym komputerze lub maszynie wirtualne.
• Dostęp SSH do serwera

Uwaga: Opis instalcji node zadziała na linuxie. Jeżeli masz windowsa - musisz sam zainstalować node.

Jak zainstalować SerpBear krok po kroku - Krok 1 - Instalacja Node.js przez NVM

NVM (Node Version Manager) to najwygodniejszy sposób instalacji Node.js na Linuxie.

Otwórz terminal i wklej:

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
source ~/.bashrc
nvm install 22
nvm use 22
node -v

Powinieneś zobaczyć coś w stylu v22.x.x. Jeśli tak - Node.js działa.

Dlaczego wersja 22? BiedaHosting ma Node.js v22 na serwerze. Warto budować lokalnie na tej samej wersji żeby uniknąć problemów z kompatybilnością.

Krok 2 - Klonowanie i build lokalny

Klonuj repozytorium SerpBear:

git clone https://github.com/towfiqi/serpbear.git
cd serpbear

Dobra wiadomość - SerpBear ma już opcję output: 'standalone' w pliku next.config.js. Nie musisz nic zmieniać. Możesz to sprawdzić:

cat next.config.js

Powinieneś zobaczyć linię output: 'standalone'.

Teraz zainstaluj zależności i zbuduj projekt:

npm install
npm run build

Build zajmie kilka minut. Na końcu zobaczysz tabelę z listą stron - to dobry znak.

Skopiuj statyczne pliki do folderu standalone:

cp -r .next/static .next/standalone/.next/static
cp -r public .next/standalone/public

Sprawdź rozmiar gotowego folderu:

du -sh .next/standalone

Powinno być około 33 MB. Spokojnie mieści się na bieda25.

Spakuj do archiwum ZIP:

cd .next
zip -r serpbear.zip standalone

Krok 3 - Konfiguracja aplikacji nodeJS

Zaloguj do panlu biedahostingu i przejdź do zakładki dodatkowe funkcje -> setup nodeJS application -> create applicaton. Ustawiamy:

  Node.js version na 22.22.0 (recommended)

  Application root na serpbear-app 

  Application startup file na server.js

W polach Environment variables dodajemy zmienne, zgodnie z dokumentacją na stronie serpBear.

USER_NAME=admin
PASSWORD=your_password_here
SECRET=your_random_secret_key_here
APIKEY=your_random_api_key_here
SESSION_DURATION=24
NEXT_PUBLIC_APP_URL=https://serpbear.yourdomain.com

Po utworzeniu aplikacji na dysku powstanie folder serpbear-app i odpowiednia konfiguracja .htaccess, która przekieruje do aplikacji