> ## Documentation Index
> Fetch the complete documentation index at: https://andcze.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Domena niestandardowa i rekord SRV

> Podłącz własną domenę do sklepu i ustaw ładny adres serwera Minecraft bez portu.

Domyślnie Twój sklep działa pod adresem nadanym przez ItemShop.dev. Możesz jednak podłączyć **własną domenę** (np. `sklep.twojadomena.pl`), żeby sklep wyglądał profesjonalnie i budził zaufanie graczy. Dodatkowo możesz ustawić **rekord SRV**, dzięki któremu gracze połączą się z serwerem przez ładny adres, bez wpisywania portu.

Wszystko znajdziesz w **Ustawienia → Domena**.

<Frame caption="Zakładka Domena w ustawieniach sklepu">
  <img src="https://mintcdn.com/andcze/6Qp9zwUm8VUzRssf/images/panel/domain.png?fit=max&auto=format&n=6Qp9zwUm8VUzRssf&q=85&s=0f833a7e169291a6d2cdf67dd2758d3e" alt="Panel konfiguracji domeny i rekordu SRV" width="1280" height="720" data-path="images/panel/domain.png" />
</Frame>

<Note>
  Domena to adres, który gracze wpisują w przeglądarce (np. `sklep.twojadomena.pl`). Aby ją podłączyć, musisz mieć dostęp do panelu u swojego **dostawcy domeny** — czyli tam, gdzie domenę kupiłeś.
</Note>

<Info>
  Zakładkę **Domena** widzą tylko osoby z uprawnieniem do edycji sklepu. Jeśli pracujesz w zespole, a współpracownik nie ma takiego uprawnienia, ta zakładka mu się nie pokaże. Jako właściciel widzisz ją zawsze.
</Info>

## Co znajdziesz na tej stronie

Strona składa się z dwóch osobnych kart, które działają niezależnie od siebie:

<Columns cols={2}>
  <Card title="Domena niestandardowa" icon="globe">
    Podłączasz tu własny adres sklepu (np. `sklep.twojadomena.pl`) zamiast adresu nadanego przez ItemShop.dev.
  </Card>

  <Card title="Rekord SRV (Minecraft)" icon="server">
    Generujesz rekord, dzięki któremu gracze łączą się z serwerem **bez wpisywania portu** na końcu adresu.
  </Card>
</Columns>

## Podłączanie własnej domeny

<Steps>
  <Step title="Wpisz swoją domenę">
    W polu **Twoja domena** wpisz adres, pod którym ma działać sklep, np. `sklep.twojadomena.pl`. Najlepiej użyj subdomeny (czyli adresu z przedrostkiem, jak `sklep.`), zostawiając główną domenę dla swojej strony [WWW](http://WWW). Dopóki pole jest puste, przycisk połączenia pozostaje nieaktywny.
  </Step>

  <Step title="Połącz domenę">
    Kliknij **„Połącz domenę”**. Po zapisaniu panel pokaże **rekordy DNS**, które musisz dodać u swojego dostawcy domeny, oraz wyświetli plakietkę ze statusem domeny. Gdy domena jest już zapisana, przycisk zmienia nazwę na **„Zaktualizuj”** — możesz wpisać inny adres i ponownie kliknąć, by go podmienić.
  </Step>

  <Step title="Dodaj rekordy u dostawcy domeny">
    Zaloguj się do panelu, w którym zarządzasz domeną, znajdź sekcję **DNS** i dodaj rekordy dokładnie tak, jak pokazuje ItemShop.dev — skopiuj nazwę oraz wartość bez zmian.
  </Step>

  <Step title="Sprawdź konfigurację">
    Wróć do panelu i kliknij **„Sprawdź konfigurację”**. Przycisk zweryfikuje, czy domena poprawnie wskazuje na nasze serwery. Jeśli wszystko gra, zobaczysz zielone potwierdzenie i domena zacznie działać.
  </Step>
</Steps>

<Tip>
  Aby skopiować wartość rekordu, po prostu **kliknij ją** — pojawi się przy niej ikona kopiowania, a panel potwierdzi „Skopiowano”. Dzięki temu nie musisz zaznaczać tekstu ręcznie i nie ryzykujesz literówki.
</Tip>

### Jakie rekordy zobaczysz

Panel sam dobiera rekordy do rodzaju adresu, który podałeś, i pokazuje je w przejrzystej tabeli z kolumnami **Typ**, **Nazwa** i **Wartość**:

<Columns cols={2}>
  <Card title="Subdomena (np. sklep.twojadomena.pl)" icon="link">
    Wystarczy **jeden rekord CNAME**. W kolumnie **Nazwa** zobaczysz przedrostek (np. `sklep`), a w **Wartości** adres, na który ma wskazywać.
  </Card>

  <Card title="Domena główna (np. twojadomena.pl)" icon="globe">
    Panel pokaże **dwa rekordy** — jeden dla samej domeny (oznaczony `@`) i jeden dla `www`, żeby działały oba warianty adresu.
  </Card>
</Columns>

<Note>
  Tabela rekordów pojawia się od razu po połączeniu domeny — jeszcze zanim klikniesz „Sprawdź konfigurację”. To podpowiedź, co dodać u dostawcy. Po pierwszym sprawdzeniu panel może doprecyzować rekordy na podstawie tego, co faktycznie wykrył.
</Note>

### Status domeny

Obok pola z domeną widzisz kolorową plakietkę, która na bieżąco mówi, na jakim etapie jest konfiguracja:

<Columns cols={2}>
  <Card title="Brak" icon="circle">
    Nie podłączyłeś jeszcze żadnej domeny — sklep działa pod adresem od ItemShop.dev.
  </Card>

  <Card title="Oczekuje na DNS" icon="clock">
    Domena jest zapisana, ale rekordy DNS jeszcze do nas nie wskazują. To normalny stan tuż po dodaniu — poczekaj na propagację i kliknij „Sprawdź konfigurację”.
  </Card>

  <Card title="Aktywna" icon="circle-check">
    Wszystko gra — domena poprawnie wskazuje na nasze serwery i sklep działa pod Twoim adresem.
  </Card>

  <Card title="Błąd" icon="circle-x">
    Coś jest nie tak z konfiguracją. Sprawdź, czy rekordy zostały dodane dokładnie tak, jak pokazuje panel.
  </Card>
</Columns>

<Note>
  Po kliknięciu **„Sprawdź konfigurację”** pod tabelą pojawi się dodatkowy komunikat: zielony **„DNS wskazuje na nas — domena gotowa”**, gdy wszystko działa, albo żółty **„Jeszcze nie wykryto poprawnych rekordów”**, gdy trzeba poczekać lub poprawić wpisy.
</Note>

<Tip>
  Propagacja DNS, czyli rozejście się zmian po internecie, może potrwać od kilku minut do nawet kilkunastu. Jeśli „Sprawdź konfigurację” od razu nie zadziała, poczekaj chwilę i spróbuj ponownie.
</Tip>

### Masz domenę na Cloudflare?

Pod tabelą rekordów panel sam sprawdza, czy Twoja domena jest obsługiwana przez **Cloudflare**, i pokazuje odpowiednią informację:

<Columns cols={2}>
  <Card title="Wykryto Cloudflare" icon="bolt">
    Pojawia się przycisk **„Dodaj rekordy automatycznie”**. To najprostsza droga — nie musisz nic kopiować ręcznie. Po dodaniu panel od razu ponowi sprawdzenie konfiguracji.
  </Card>

  <Card title="Domena poza Cloudflare" icon="hand">
    Panel poinformuje, że rekordy trzeba dodać **ręcznie** u swojego dostawcy DNS — tak jak opisaliśmy w krokach wyżej.
  </Card>
</Columns>

<Note>
  Przy pierwszym automatycznym dodawaniu Cloudflare może wymagać **połączenia konta**. Zobaczysz wtedy komunikat z prośbą o połączenie z Cloudflare — wykonaj wskazany krok i spróbuj ponownie. Funkcja działa też przy kolejnych uruchomieniach: jeśli rekordy już istnieją, zostaną zaktualizowane, więc możesz spokojnie kliknąć przycisk jeszcze raz.
</Note>

### Usuwanie domeny

Pod kartą domeny znajdziesz dyskretny link **„Usuń domenę”**. Kliknięcie odłącza własny adres od sklepu — pole zostaje wyczyszczone, a sklep wraca do działania pod adresem nadanym przez ItemShop.dev.

<Warning>
  Po usunięciu domeny gracze, którzy zapisali sobie Twój własny adres, przestaną się przez niego dostawać do sklepu. Usuwaj domenę tylko wtedy, gdy świadomie chcesz wrócić do adresu od ItemShop.dev albo podłączyć inny.
</Warning>

## Rekord SRV (Minecraft)

Druga karta na tej stronie to **Rekord SRV (Minecraft)**. Pozwala on graczom łączyć się z serwerem przez ładny adres, **bez dopisywania portu** na końcu. Zamiast podawać adres z numerem portu, gracze wpisują po prostu np. `play.twojadomena.pl`.

<Columns cols={2}>
  <Card title="Host połączenia" icon="globe">
    Adres, który gracze będą wpisywać w grze, np. `play.twojadomena.pl`. Jeśli masz już podłączoną własną domenę, panel sam podpowiada tu adres `play.` z Twoją domeną — możesz go zostawić albo zmienić.
  </Card>

  <Card title="Cel (host serwera)" icon="server">
    **Nazwa hosta** Twojego serwera — nie adres IP (np. `node1.twoj-hosting.pl`). Jeśli masz tylko adres IP, najpierw dodaj u dostawcy rekord typu **A**, który zamieni IP na nazwę, i dopiero ją tutaj podaj.
  </Card>

  <Card title="Port" icon="plug">
    Numer portu, na którym działa Twój serwer Minecraft. Domyślnie wpisany jest standardowy port `25565` — zmień go, jeśli Twój serwer używa innego.
  </Card>
</Columns>

<Steps>
  <Step title="Uzupełnij pola">
    Wpisz **host połączenia**, **cel** (nazwę hosta serwera) oraz **port**. Dopóki host i cel są puste albo port jest nieprawidłowy, przycisk generowania pozostaje nieaktywny.
  </Step>

  <Step title="Wygeneruj rekord SRV">
    Kliknij **„Wygeneruj rekord SRV”**. Panel pokaże gotowy rekord w czytelnej tabeli z polami **Typ**, **Nazwa**, **Priorytet**, **Waga**, **Port** i **Cel**.
  </Step>

  <Step title="Dodaj rekord do domeny">
    Skopiuj poszczególne pola (kliknij każde, by je skopiować) i dodaj rekord u swojego dostawcy domeny. Jeśli korzystasz z **Cloudflare**, panel może dodać rekord automatycznie.
  </Step>
</Steps>

<Note>
  Niektóre panele DNS pokazują rekord SRV jako **jedno pole** zamiast kilku. Dla nich panel udostępnia dodatkowo gotową **Wartość** pod tabelą — wystarczy ją skopiować i wkleić w całości.
</Note>

<Warning>
  W polu **Cel** podaj **nazwę hosta**, a nie adres IP. Rekord SRV nie współpracuje bezpośrednio z adresem IP — dlatego przy samym IP trzeba wcześniej utworzyć rekord A.
</Warning>

<Note>
  Jeśli przy automatycznym dodawaniu rekordu SRV Cloudflare poprosi o **połączenie konta**, zobaczysz stosowny komunikat. Wykonaj wskazany krok i spróbuj ponownie — w razie potrzeby rekord możesz też dodać ręcznie u dostawcy.
</Note>

<Tip>
  Tak jak przy domenie, zmiany w rekordzie SRV mogą potrzebować kilku minut, zanim zadziałają u wszystkich graczy. Jeśli zaraz po dodaniu adres bez portu jeszcze nie łączy, daj DNS chwilę na propagację.
</Tip>

## Najczęstsze pytania

<AccordionGroup>
  <Accordion title="Domena pokazuje „Oczekuje na DNS”, choć dodałem rekordy.">
    To zwykle kwestia czasu. Zmiany w DNS muszą się rozejść po internecie, co potrafi potrwać od kilku minut do kilkunastu. Odczekaj chwilę i kliknij **„Sprawdź konfigurację”** ponownie. Upewnij się też, że nazwa i wartość rekordu zostały skopiowane dokładnie, bez dodatkowych spacji.
  </Accordion>

  <Accordion title="Czy muszę dodawać rekordy ręcznie, jeśli mam Cloudflare?">
    Nie. Gdy panel wykryje Cloudflare, pokaże przycisk **„Dodaj rekordy automatycznie”** — kliknięcie zrobi wszystko za Ciebie. Ręczne dodawanie jest potrzebne tylko wtedy, gdy domena nie jest obsługiwana przez Cloudflare.
  </Accordion>

  <Accordion title="Podałem domenę główną, a panel pokazuje dwa rekordy. Czy dodać oba?">
    Tak. Dla domeny głównej panel tworzy rekord dla samego adresu (oznaczony `@`) oraz dla `www`, żeby działały oba warianty. Dodaj oba u swojego dostawcy.
  </Accordion>

  <Accordion title="W polu „Cel” rekordu SRV mam tylko adres IP serwera.">
    Rekord SRV potrzebuje **nazwy hosta**, nie adresu IP. Najpierw dodaj u dostawcy rekord typu **A**, który zamieni Twoje IP na nazwę (np. `node1.twojadomena.pl`), a potem użyj tej nazwy jako celu.
  </Accordion>

  <Accordion title="Chcę wrócić do adresu od ItemShop.dev.">
    Kliknij link **„Usuń domenę”** pod kartą domeny. Sklep natychmiast wróci do działania pod adresem nadanym przez ItemShop.dev, a pole domeny się wyczyści.
  </Accordion>
</AccordionGroup>

## Dobre praktyki

<Tip>
  * **Stawiaj na subdomenę** — adres typu `sklep.twojadomena.pl` wymaga jednego prostego rekordu i zostawia główną domenę dla strony [WWW](http://WWW).
  * **Kopiuj kliknięciem** — wartości rekordów kopiujesz jednym kliknięciem; to najpewniejszy sposób, by uniknąć literówek.
  * **Daj DNS chwilę** — po dodaniu rekordów odczekaj kilka minut, zanim uznasz, że coś nie działa, i dopiero potem klikaj „Sprawdź konfigurację”.
  * **Masz Cloudflare? Skorzystaj z automatu** — przycisk „Dodaj rekordy automatycznie” oszczędza czas i eliminuje pomyłki.
  * **W rekordzie SRV podawaj nazwę hosta, nie IP** — przy samym IP najpierw utwórz rekord A, a dopiero potem użyj nazwy jako celu.
  * **Pilnuj statusu** — zielona plakietka „Aktywna” to znak, że domena działa; przy „Oczekuje na DNS” lub „Błąd” wróć do rekordów i sprawdź wpisy.
  * **Usuwaj domenę świadomie** — odłączenie adresu od razu odcina graczy korzystających z Twojej własnej domeny.
</Tip>