Localhost: co to jest, jak go otworzyć i co zrobić, gdy nie działa

Localhost to nazwa, pod którą komputer widzi sam siebie. Gdy wpiszesz w przeglądarce http://localhost, połączysz się z serwerem uruchomionym na tym samym urządzeniu, a nie z jakąkolwiek stroną w internecie. Za nazwą localhost stoi adres IP 127.0.0.1 (w IPv6 ::1). Programiści i twórcy stron używają go, żeby testować aplikacje i strony, zanim trafią na prawdziwy serwer.

Szybkie linki do localhost

Kliknij adres, pod którym działa Twój serwer. Link otworzy się w nowej karcie. Jeśli na danym porcie nic nie jest uruchomione, przeglądarka pokaże błąd połączenia: zobacz niżej, co wtedy zrobić.

• http://localhost: port 80, domyślny serwer WWW (XAMPP, Apache, Nginx)
• http://localhost/phpmyadmin: panel bazy danych w XAMPP i podobnych pakietach
• http://localhost:8080: alternatywny port WWW (Tomcat, Jenkins, wiele serwerów deweloperskich)
• http://localhost:3000: Node.js, Express, Next.js, React
• http://localhost:5173: Vite (Vue, React, Svelte)
• http://localhost:4200: Angular
• http://localhost:8000: Django, wbudowany serwer PHP, Python http.server
• http://localhost:5000: Flask
• http://localhost:8888: MAMP na macOS

Co to jest localhost i adres 127.0.0.1?

Każde urządzenie w sieci ma adres IP. Oprócz adresu, którym komputer przedstawia się innym, każdy system ma też specjalny adres pętli zwrotnej (ang. loopback). Ruch wysłany na ten adres nie wychodzi z komputera: system od razu kieruje go z powrotem do siebie. Dzięki temu możesz połączyć się z programem działającym lokalnie tak samo, jak łączysz się ze stroną w internecie.

• 127.0.0.1 to standardowy adres pętli zwrotnej w IPv4. Cały zakres od 127.0.0.0 do 127.255.255.255 jest zarezerwowany do tego celu.
• ::1 to adres pętli zwrotnej w IPv6.
• localhost to nazwa, która wskazuje na te adresy. Domena .localhost jest zarezerwowana, więc nikt nie może jej zarejestrować jako zwykłej strony.

Do localhost nie potrzebujesz internetu. Działa nawet po odłączeniu kabla i Wi-Fi, bo dane w ogóle nie opuszczają komputera.

Localhost a 127.0.0.1: czym się różnią?

Zwykle prowadzą w to samo miejsce, ale nie są tym samym. 127.0.0.1 to konkretny adres IPv4. localhost to nazwa, którą system dopiero zamienia na adres, a na nowszych systemach często w pierwszej kolejności na IPv6, czyli ::1.

Ma to znaczenie w praktyce: jeśli serwer nasłuchuje tylko na 127.0.0.1, a przeglądarka lub program łączy się z localhost przez ::1, dostaniesz błąd połączenia, choć serwer działa. Wtedy wpisz zamiast localhost adres http://127.0.0.1:port albo uruchom serwer tak, żeby nasłuchiwał na obu adresach.

Porty: localhost:80, 8080, 3000 i inne

Numer po dwukropku to port, czyli „drzwi”, pod którymi czeka konkretny program. Na jednym komputerze może działać naraz kilka serwerów, każdy na innym porcie. Gdy nie podasz portu, przeglądarka użyje domyślnego: 80 dla http:// i 443 dla https://.

Port	Typowe zastosowanie
80	serwer WWW: Apache, Nginx, XAMPP
443	serwer WWW z HTTPS
8080	alternatywny port WWW, Tomcat, Jenkins, serwery proxy
3000	Node.js, Express, Next.js, React
5173	Vite
4200	Angular
8000	Django, php -S, python -m http.server
5000	Flask (na macOS port bywa zajęty przez AirPlay)
8888	MAMP
3306	baza MySQL lub MariaDB (nie otwiera się w przeglądarce)

Jak uruchomić WordPressa na localhost?

Lokalna kopia WordPressa to najbezpieczniejsze miejsce na testowanie motywów, wtyczek i aktualizacji. Masz kilka sposobów:

• Local (localwp.com): najprostszy dla początkujących. Instaluje WordPressa jednym kliknięciem, każda strona dostaje własny adres, np. mojastrona.local.
• XAMPP: pakiet z Apache, PHP i MariaDB. Pliki WordPressa wrzucasz do folderu htdocs, bazę zakładasz w phpMyAdmin, a stronę otwierasz pod http://localhost/nazwa-folderu.
• MAMP: podobny pakiet, popularny na macOS.
• Docker (np. wp-env): dla programistów, którzy chcą mieć takie samo środowisko jak na serwerze.
• WordPress Playground (playground.wordpress.net): WordPress uruchomiony w całości w przeglądarce, bez instalacji. Dobry do szybkich testów.

Gdy strona jest gotowa, przenosisz ją na hosting. Przy wyborze pomoże Ci ranking hostingów.

„Localhost odmówił połączenia”: co zrobić?

Komunikat ERR_CONNECTION_REFUSED („localhost odmówił połączenia”) oznacza, że pod tym adresem i portem nic nie odpowiada. Sprawdź po kolei:

1. Czy serwer jest uruchomiony? W XAMPP moduł Apache musi mieć zielony status. Przy Node.js lub Vite terminal z serwerem musi być otwarty.
2. Czy port się zgadza? Serwer zwykle pisze w terminalu adres, pod którym działa, np. Local: http://localhost:5173.
3. Spróbuj 127.0.0.1 zamiast localhost. To rozwiązuje problem z IPv6 opisany wyżej.
4. Czy port nie jest zajęty przez inny program? Sprawdź to poleceniem poniżej. Jeśli port jest zajęty, zamknij tamten program albo uruchom serwer na innym porcie.
5. Zapora i antywirus. Czasem blokują serwer lokalny, szczególnie Apache na porcie 80. Zezwól programowi na komunikację albo zmień port.

Jak sprawdzić, który program zajmuje port (przykład dla portu 3000):

Windows (wiersz poleceń):  netstat -ano | findstr :3000
macOS i Linux (terminal):   lsof -i :3000

Na Windowsie ostatnia kolumna wyniku to numer procesu (PID). Znajdziesz go w Menedżerze zadań na karcie Szczegóły.

Jak otworzyć localhost na telefonie albo pokazać go komuś?

Wpisanie localhost na telefonie otworzy telefon, a nie Twój komputer. Żeby zobaczyć lokalną stronę na innym urządzeniu w tej samej sieci Wi-Fi:

1. Sprawdź adres IP komputera w sieci lokalnej (Windows: polecenie ipconfig, macOS: Ustawienia, Sieć). Zwykle wygląda jak 192.168.1.15.
2. Uruchom serwer tak, żeby nasłuchiwał na wszystkich interfejsach (adres 0.0.0.0), np. w Vite z opcją --host.
3. Na telefonie wpisz http://192.168.1.15:5173 (Twój adres i port).

Jeśli chcesz pokazać lokalną stronę komuś spoza Twojej sieci, użyj tunelu, np. ngrok albo Cloudflare Tunnel. Tworzą one tymczasowy publiczny adres, który prowadzi do Twojego localhost. Wyłącz tunel, gdy skończysz.

Plik hosts: własne nazwy zamiast localhost

Plik hosts mówi systemowi, na jaki adres IP zamienić daną nazwę, zanim zapyta serwery DNS. Dzięki niemu możesz otwierać lokalny projekt pod ładną nazwą, np. mojastrona.test. Domena .test jest zarezerwowana do testów, więc nie koliduje z prawdziwymi stronami.

• Windows: C:\Windows\System32\drivers\etc\hosts (otwórz Notatnik jako administrator)
• macOS i Linux: /etc/hosts (edycja przez sudo)

Domyślnie plik zawiera wpisy dla localhost. Własną nazwę dopisujesz w nowej linii:

127.0.0.1   localhost
::1         localhost
127.0.0.1   mojastrona.test

Po zmianie na Windowsie warto wyczyścić pamięć DNS poleceniem ipconfig /flushdns. Ten sam mechanizm służy do blokowania stron: wpis kierujący domenę na 0.0.0.0 lub 127.0.0.1 sprawia, że strona przestaje się otwierać. Nie wklejaj jednak do pliku hosts gotowych list z nieznanych źródeł. Złośliwe programy potrafią w ten sposób przekierować Cię na fałszywe strony.

Czy localhost jest bezpieczny?

Tak, dopóki serwer nasłuchuje tylko na 127.0.0.1: wtedy nikt poza Tobą się z nim nie połączy. Ostrożność zachowaj, gdy uruchamiasz serwer na 0.0.0.0 albo tunelujesz go do internetu. Wtedy widzą go inne urządzenia w sieci, na przykład w kawiarni czy hotelu. Nie trzymaj w lokalnej kopii strony prawdziwych haseł i danych klientów, jeśli nie musisz.

Najczęstsze pytania

Jak sprawdzić, czy localhost działa?

Wpisz w terminalu lub wierszu poleceń ping localhost albo ping 127.0.0.1. Odpowiedzi z czasem poniżej milisekundy oznaczają, że pętla zwrotna działa. To jednak nie sprawdza, czy działa serwer WWW. To zobaczysz dopiero po otwarciu adresu w przeglądarce.

Co to jest localhost:8080?

To adres serwera działającego na Twoim komputerze na porcie 8080. Używa go wiele programów, gdy port 80 jest zajęty albo wymaga uprawnień administratora, np. Tomcat czy Jenkins.

Co to jest localhost/phpmyadmin?

To adres panelu phpMyAdmin w pakietach takich jak XAMPP. Zarządzasz w nim lokalnymi bazami danych, na przykład bazą WordPressa. Więcej przeczytasz we wpisie o bazie danych WordPress.

Czy localhost działa bez internetu?

Tak. Ruch do localhost nie wychodzi poza komputer, więc internet nie jest potrzebny. Bez internetu nie zadziałają tylko elementy, które strona pobiera z zewnątrz, np. czcionki z Google czy skrypty z CDN.