TL;DR, szybka odpowiedź
11 min czytaniaDomena staje się twoją nazwą użytkownika na Bluesky, gdy udowodnisz, że ją kontrolujesz: rekordem DNS TXT na subdomenie _atproto o wartości did=did:plc:twojdid albo odpowiedzią HTTPS w postaci zwykłego tekstu pod /.well-known/atproto-did, zawierającą sam DID. Specyfikacja AT Protocol ogranicza nazwy do 253 znaków ASCII, w praktyce do 244, i wyklucza domeny najwyższego poziomu .alt, .arpa, .example, .internal, .invalid, .local, .localhost i .onion. Nazwa liczy się dopiero wtedy, gdy dokument DID wskazuje z powrotem na nią.
Czym jest własna domena jako nazwa użytkownika na Bluesky?
Domena, którą posiadasz, staje się twoją nazwą użytkownika (handle) na Bluesky, gdy opublikujesz jeden rekord potwierdzający, że ją kontrolujesz: rekord DNS TXT na subdomenie _atproto albo plik tekstowy serwowany pod /.well-known/atproto-did. Bluesky działa na AT Protocol, a to specyfikacja nazw w tym protokole decyduje, czy twój rekord zadziała. Artykuły pomocy opisują przyciski w aplikacji. Specyfikacja opisuje to, co sieć sprawdza później.
Przeczytaj to, zanim zmienisz cokolwiek w DNS: "Handles are mutable and human-friendly account usernames, in the form of a DNS hostname." Nazwa użytkownika jest nazwą hosta, dlatego mozilla.org działa, a samo mozilla już nie: "'bare' top-level domains are not allowed as handles, even if valid 'hostnames' and 'DNS names.'"
Za każdą nazwą stoi DID, jeden z "the long-term persistent identifiers for accounts in atproto." Wklejasz swój DID do wybranego rekordu, więc tutaj tylko to jest ci potrzebne. Cała reszta o tym, czym jest DID, zasługuje na osobny tekst.
Który rekord opublikować i co w nim wpisać?
Opublikuj jeden z tych dwóch, wstawiając własny DID w miejsce przykładowego.
| Metoda DNS TXT | Metoda HTTPS well-known | |
|---|---|---|
| Lokalizacja | _atproto.example.com | https://example.com/.well-known/atproto-did |
| Mechanizm | Rekord TXT | Odpowiedź HTTP GET |
| Wartość | did=did:plc:ewvi7nxzyoun6zhxrhs64oiz | did:plc:ewvi7nxzyoun6zhxrhs64oiz |
Prefiks did= | Wymagany | Nie może występować |
| Typ treści | Nie dotyczy | text/plain |
| Przekierowania | Nie dotyczy | Dozwolone, "up to a reasonable number of redirect hops" |
| Status w specyfikacji | "recommended and preferred" dla osób | Przeznaczona dla usług rejestrujących nazwy masowo |
Prefiks to najczęstszy błąd przy wklejaniu, a żadna z metod cię przed nim nie ostrzega. Resolwery DNS ignorują "TXT records with values not starting with did=." W HTTPS ten sam prefiks psuje treść odpowiedzi, której specyfikacja oczekuje w formie "the DID... with no prefix or wrapper formatting."
Rekord DNS dla nazwy na domenie głównej example.com:
Type: TXT
Name: _atproto
Value: did=did:plc:ewvi7nxzyoun6zhxrhs64oiz
TTL: 300Dla nazwy na subdomenie, takiej jak alice.example.com, nazwa rekordu to _atproto.alice. Większość paneli DNS sama dopisuje strefę, więc wpisanie pełnego _atproto.alice.example.com daje _atproto.alice.example.com.example.com i błąd, którego nikt nie zgłosi.
Może istnieć tylko jeden rekord: "If multiple valid records with different DIDs are present, resolution should fail." Stary rekord z poprzedniego konta psuje nowy.
Odpowiedź HTTPS, jakiej wymaga specyfikacja, dokładnie w tej postaci:
HTTP/1.1 200 OK
Content-Length: 33
Content-Type: text/plain
Date: Wed, 14 Jun 2023 00:47:21 GMT
did:plc:ewvi7nxzyoun6zhxrhs64oizAkapit dalej, w tej samej sekcji, specyfikacja łagodzi własny wymóg: "The response Content-Type header does not need to be strictly verified." Mimo to serwuj text/plain, bo nie wiesz, który resolwer czyta który wiersz.
Swój DID znajdziesz w aplikacji. Poradnik Bluesky podaje ścieżkę "Settings", potem "Account", potem "Handle", a host rekordu pokazuje jako _atproto z wartością "did=did:plc:[your value here]".
Jakie są zasady składni nazwy użytkownika?
Jest siedem zasad i nazwa musi spełniać wszystkie:
- Cała nazwa składa się wyłącznie ze znaków ASCII i ma najwyżej 253 znaki.
- Segmenty oddzielają kropki ASCII, a segmentów musi być co najmniej dwa.
- Bez kropek na początku i na końcu, bez końcowej kropki ze składni DNS.
- Każdy segment ma od 1 do 63 znaków: litery ASCII
a-z, cyfry0-9i łączniki-. - Segment nie może zaczynać się ani kończyć łącznikiem.
- Ostatni segment, czyli domena najwyższego poziomu, nie może zaczynać się od cyfry.
- Wielkość liter nie ma znaczenia, a nazwy są normalizowane do małych liter.
O ostatniej zasadzie: "the handle input string BlueskyWeb.xyz should be normalized, stored, and displayed as blueskyweb.xyz." Jeśli twoja marka pisze się wielkimi literami, nazwa użytkownika i tak będzie mała.
Referencyjne wyrażenie regularne ze specyfikacji:
/^([a-zA-Z0-9]([a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?\.)+[a-zA-Z]([a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?$/253 to liczba z nagłówków, ale nie ta, pod którą warto projektować. W wytycznych implementacyjnych ukryta jest mniejsza: "handles should be limited to at most 244 characters... because DNS verification works with the prefix _atproto., which adds 9 characters." Wszystko między 245 a 253 znakami jest zgodne z sekcją o składni, ale nie da się tego rozwiązać przez DNS, a wyjście awaryjne znajduje się w innej sekcji: "The HTTPS method will work for such handles."
AdaptlyPost
Rozpocznij 7-dniowy bezpłatny okres próbny
Analityka wszystkich platform
Skrzynka społecznościowa
Asystent oparty na AI
Przykłady, które specyfikacja uznaje za poprawne, obok tych, które odrzuca:
| Poprawna składnia | Niepoprawna składnia | Dlaczego druga kolumna nie przechodzi |
|---|---|---|
jay.bsky.social | jo@hn.test | @ nie jest dozwolonym znakiem |
8.cn | john..test | Pusty segment między kropkami |
a.co | john.0 | TLD zaczyna się od cyfry |
XX.LCS.MIT.EDU | org | Tylko jeden segment |
xn--notarealidn.com | name.org. | Kropka na końcu |
name.t--t | xn--bcher-.tld | Segment kończy się łącznikiem |
Domeny międzynarodowe działają tylko w formie zakodowanej: "Such handles must be stored and transmitted in encoded ASCII form."
Które TLD nigdy nie będą nazwą użytkownika na Bluesky?
Osiem domen najwyższego poziomu jest wykluczonych z góry. Ze specyfikacji: "the initial list of disallowed TLDs includes: .alt, .arpa, .example, .internal, .invalid, .local, .localhost, .onion."
Sposób, w jaki zawodzą, jest celowy i dość osobliwy. Zastrzeżone TLD "should not fail syntax validation... but they must immediately fail any attempt at registration, resolution, etc." Dlatego laptop.local i blah.arpa przechodzą test wyrażenia regularnego, a przy rozwiązywaniu zawsze kończą się błędem. Walidator oparty wyłącznie na regexie uzna taką nazwę za poprawną, dopóki sieć jej nie odrzuci.
Trzy pozycje mają dodatkowe warunki:
.onionjest zablokowana z podanego powodu, a nie na stałe: "Resolution of handles via Tor would require ecosystem-wide support, so they are currently disallowed." Sekcja o przyszłych zmianach dodaje, że ".onion handles would be allowed at some point in the future.".invalidjest zarezerwowana dla jednej wartości specjalnej,handle.invalid, którą API zwraca "to indicate that there is no bi-directionally valid handle for the given DID.".testnie ma na liście wykluczonych, ale też nie da się jej używać. "may be used in atproto development, but should fail in real-world environments."
Zwróć uwagę na słowo "initial". Lista nie jest przedstawiona jako ostateczna, a specyfikacja odsyła do sekcji Wikipedii o domenach zastrzeżonych, zamiast prowadzić własny rejestr. Osiem nazw to wszystko, do czego protokół zobowiązuje się na piśmie, a granica poza nimi leży na stronie, której nikt z projektu AT Protocol nie kontroluje.

Jak rozwiązać nazwę użytkownika do jej DID?
Sprawdź to na prawdziwym koncie, a obie połowy weryfikacji odbędą się na twoich oczach. Wszystkie poniższe wartości zostały rozwiązane 10 września 2026 roku.
Zacznij od rekordu DNS dla bsky.app, własnej nazwy Bluesky:
dig +short TXT _atproto.bsky.app"did=did:plc:z72i7hdynmk6r22z27h6tvur"Usuń prefiks did= i masz DID. Endpoint samego protokołu, który klienci wywołują zamiast samodzielnie odpytywać DNS, zwraca tę samą odpowiedź:
curl -s "https://public.api.bsky.app/xrpc/com.atproto.identity.resolveHandle?handle=bsky.app"{ "did": "did:plc:z72i7hdynmk6r22z27h6tvur" }Teraz pobierz dokument DID, czyli drugą połowę weryfikacji:
curl -s https://plc.directory/did:plc:z72i7hdynmk6r22z27h6tvur{
"@context": ["https://www.w3.org/ns/did/v1", "https://w3id.org/security/multikey/v1", "https://w3id.org/security/suites/secp256k1-2019/v1"],
"id": "did:plc:z72i7hdynmk6r22z27h6tvur",
"alsoKnownAs": ["at://bsky.app"],
"verificationMethod": [
{
"id": "did:plc:z72i7hdynmk6r22z27h6tvur#atproto",
"type": "Multikey",
"controller": "did:plc:z72i7hdynmk6r22z27h6tvur",
"publicKeyMultibase": "zQ3shQo6TF2moaqMTrUZEM1jeuYRQXeHEx4evX9751y2qPqRA"
}
],
"service": [
{
"id": "#atproto_pds",
"type": "AtprotoPersonalDataServer",
"serviceEndpoint": "https://puffball.us-east.host.bsky.network"
}
]
}Wszystko rozstrzyga pole alsoKnownAs z wartością at://bsky.app. Nazwa wskazała DID, a dokument DID wskazuje z powrotem na nazwę. Specyfikacja wymaga obu kierunków: "The link between handle and DID must be confirmed bidirectionally, otherwise anybody could create handle aliases for third-party accounts." Opublikowanie rekordu TXT z cudzym DID nic ci nie da, bo dokument DID tej osoby nie wymienia twojej domeny.
Gdy nazwy nie da się rozwiązać, endpoint odpowiada jednym komunikatem:
{ "error": "InvalidRequest", "message": "Unable to resolve handle" }Przychodzi on ze statusem HTTP 400 i jest taki sam przy braku rekordu, przy poprawnej nazwie na zastrzeżonym TLD i przy domenie, która nie istnieje. Diagnozuj przez dig i curl, a nie na podstawie odpowiedzi API.
Cztery nazwy rozwiązane tego dnia, wszystkie potwierdzone w obu kierunkach w plc.directory:
AdaptlyPost
Rozpocznij 7-dniowy bezpłatny okres próbny
Analityka wszystkich platform
Skrzynka społecznościowa
Asystent oparty na AI
| Nazwa | DID | Metoda, która odpowiedziała |
|---|---|---|
bsky.app | did:plc:z72i7hdynmk6r22z27h6tvur | DNS TXT |
mozilla.org | did:plc:jxrrsbtaptoynkhm2tdvxohg | DNS TXT |
theverge.com | did:plc:7exlcsle4mjfhu3wnhcgizz6 | DNS TXT |
jay.bsky.social | did:plc:mfm3grjeffxyfuxj3uiisfuz | HTTPS well-known |
Ten podział to projekt specyfikacji działający zgodnie z zapisem. Organizacje z panelem DNS korzystają z rekordu TXT. Nazwa odpowiadająca przez HTTPS to subdomena bsky.social, czyli przypadek "large-scale web services which may not have the infrastructure to automate the registration of thousands or millions of DNS TXT records", dla którego powstała ta metoda.
Żądanie https://mozilla.org/.well-known/atproto-did zwraca stronę HTML z błędem 404, a theverge.com zachowuje się tak samo. Obie nazwy rozwiązują się bez problemu. Odpowiedzieć musi tylko jedna metoda, a 404 na ścieżce, której nie używasz, niczym nie grozi.
Gdzie psują się nazwy użytkownika oparte na własnej domenie?
| Objaw | Przyczyna | Rozwiązanie |
|---|---|---|
| Nazwa odrzucona, rekord DNS wygląda dobrze | Nazwa rekordu to _atproto.example.com.example.com, bo panel dopisuje strefę | W polu nazwy wpisz samo _atproto |
| Rozwiązywanie zawodzi po zmianie nazwy | Nadal opublikowany jest stary rekord TXT z innym DID | Usuń go, bo "If multiple valid records with different DIDs are present, resolution should fail" |
| Nazwa dłuższa niż 244 znaki nie działa | _atproto. dodaje 9 znaków i wypycha zapytanie poza 253 | Użyj metody HTTPS, którą specyfikacja wskazuje dla tego przypadku |
| Ścieżka well-known zwraca HTML aplikacji | Trasa typu catch-all we frameworku odpowiada przed plikiem statycznym | Obsłuż tę ścieżkę przed trasą catch-all, z nagłówkiem Content-Type: text/plain |
| Dwie metody dają różne wyniki | Istnieją rekord TXT i plik well-known wskazujące różne DID | Specyfikacja mówi, że "the DNS TXT result should be preferred"; mimo to usuń nieaktualny wpis |
Nazwa wyświetla się jako handle.invalid | Nazwa przestała się rozwiązywać po wcześniejszej weryfikacji | Opublikuj rekord ponownie; specyfikacja ostrzega, że PDS "may prevent repo mutation", gdy konto jest w tym stanie |
| Zmiana jeszcze nie jest widoczna | Pamięć podręczna, bo usługi "cache handle resolution results internally, up to some lifetime" | Poczekaj i rozwiąż nazwę ponownie, a przed zmianą ustaw krótki TTL |
Przekierowania zasługują na osobną uwagę, bo inne specyfikacje well-known ich zakazują, a ta nie: "HTTP redirects (eg, 301, 302) are allowed, up to a reasonable number of redirect hops." Przekierowanie z domeny głównej na www jest w porządku. Przekierowanie kończące się błędem 404 już nie, a tak się dzieje, gdy domena główna przekierowuje na www, gdzie pliku nigdy nie wdrożono.

Co dzieje się z zaplanowanymi postami, gdy zmienia się nazwa użytkownika?
Nic, a powód tkwi w samej konstrukcji. Twoim kontem jest DID, który protokół nazywa trwałym, a nazwa użytkownika to zmienna etykieta rozwiązywana na nowo za każdym razem, gdy klient jej potrzebuje. Przejście z you.bsky.social na yourbrand.com nie narusza DID, więc kolejka zbudowana w narzędziu do planowania postów na Bluesky przetrwa zmianę, podobnie jak liczby w narzędziu do analityki Bluesky. To zachowanie protokołu, a nie coś, co narzędzie do publikacji daje lub odbiera.
Zmieniają się za to dwie rzeczy. Posty, które już opublikujesz, wyświetlają się pod nową nazwą, bo klienci pokazują nazwę rozwiązaną na bieżąco, a nie zamrożoną w chwili publikacji. A każdy tekst ze starą nazwą staje się nieaktualny, co boli najbardziej, gdy publikujesz ten sam post w kilku sieciach naraz, a nazwa z Bluesky siedzi w opisie współdzielonym z X, LinkedInem i Threads. Przed zmianą przeszukaj zaplanowane szkice pod kątem starej nazwy. Pięć minut w kalendarzu treści wobec miesiąca opublikowanych postów do poprawiania później.
Najczęściej zadawane pytania
Czy potrzebuję zarówno rekordu DNS, jak i pliku well-known?
Nie. Wystarczy jeden, a specyfikacja nazywa metodę DNS TXT "the recommended and preferred resolution method for individual handle configuration." Jeśli opublikujesz oba i będą wskazywać różne DID, resolwery wybiorą odpowiedź z DNS. Usuń nieaktualny wpis, zamiast zostawiać konflikt.
Dlaczego rekord TXT wymaga did=, a plik HTTPS nie?
Obie metody są parsowane inaczej. DNS stosuje RFC-1464 do przechowywania atrybutów w rekordach TXT, więc wartość to klucz i wartość, a resolwery ignorują "TXT records with values not starting with did=." Metoda HTTPS zwraca "the DID as the HTTP body with no prefix or wrapper formatting", więc ten sam prefiks sprawia, że treści nie da się odczytać.
Czy do testów mogę użyć domeny .local lub .internal?
Nie. Obie są na liście wykluczonych, a zastrzeżone TLD "must immediately fail any attempt at registration, resolution, etc.", choć przechodzą walidację składni. Do programowania przeznaczona jest domena .test, a i tak specyfikacja oczekuje, że będzie "fail in real-world environments."
Jak długa może być nazwa użytkownika na Bluesky?
253 znaki ASCII według zasad składni, 244 w praktyce. Prefiks _atproto. używany przy weryfikacji DNS "adds 9 characters, and that overall name needs to be valid." Powyżej 244 znaków działa tylko metoda HTTPS.
Czym jest handle.invalid i dlaczego to widzę?
To wartość zwracana przez API, gdy DID nie ma działającej nazwy, używana "to indicate that there is no bi-directionally valid handle for the given DID." Pojawia się, gdy nazwa, która wcześniej się rozwiązywała, przestaje działać. Ponowne opublikowanie poprawnego rekordu ją usuwa.
Czy zmiana nazwy użytkownika psuje linki, które ludzie już udostępnili?
Nie. Poradnik Bluesky podaje, że "Any tags or mentions with your old handle will still point to your account", bo wzmianki przechowują DID, a nie tekst nazwy. Od grudnia 2024 roku twoja poprzednia nazwa .bsky.social jest też zarezerwowana dla ciebie i nie wraca do puli.
Dlaczego opublikowanie cudzego DID w moim rekordzie TXT nie działa?
Protokół sprawdza powiązanie w obu kierunkach. Twój rekord może wskazywać dowolny DID, ale dokument DID musi też wskazywać z powrotem na twoją domenę w polu alsoKnownAs, za pomocą URI at://. Właśnie dlatego dokument DID samego Bluesky zawiera at://bsky.app. Bez pasującego powiązania zwrotnego każdy mógłby tworzyć aliasy dla cudzych kont, więc rekord TXT z cudzym DID do niczego nie prowadzi.
Czy mogę publikować pod własną domeną od razu po dodaniu rekordu?
Nie zawsze od razu. Usługi przez pewien czas przechowują wyniki rozwiązywania nazw w pamięci podręcznej, więc nieaktualna odpowiedź może się utrzymywać, nawet gdy rekord jest już poprawny. TTL w przykładowym rekordzie DNS powyżej wynosi 300 sekund, a ustawienie krótkiego TTL przed zmianą i ponowne rozwiązanie nazwy po niej skraca to oczekiwanie.
Co dzieje się ze starą nazwą .bsky.social po przejściu na własną domenę?
Pozostaje zarezerwowana dla ciebie. Od grudnia 2024 roku Bluesky zatrzymuje twoją poprzednią nazwę .bsky.social, zamiast zwracać ją do puli po przejściu na własną domenę, więc nikt inny nie może jej przejąć.
AdaptlyPost
Rozpocznij 7-dniowy bezpłatny okres próbny
Analityka wszystkich platform
Skrzynka społecznościowa
Asystent oparty na AI
Czy przekierowanie z domeny głównej na www zepsuje weryfikację nazwy?
Samo w sobie nie. Specyfikacja dopuszcza przekierowania HTTP do rozsądnej liczby przeskoków, więc przekierowanie ścieżki well-known z domeny głównej na www jest w porządku. Weryfikacja zawiedzie tylko wtedy, gdy przekierowanie trafi tam, gdzie pliku nigdy nie wdrożono, bo przekierowanie kończące się błędem 404 niczego nie rozwiązuje.
Wykorzystaj to w praktyce z AdaptlyPost
Czy ten artykuł był pomocny?
Chętnie poznamy opinię!
Więcej naszych treści w Google
Jedno kliknięcie oznacza AdaptlyPost jako preferowane źródło, dzięki czemu nasze artykuły pojawiają się wyżej w Najważniejszych wiadomościach, trybie AI i Podsumowaniach AI.
Jeszcze chwila...
AdaptlyPost
Planowanie treści na wszystkich platformach
Wszystkie konta społecznościowe w jednym miejscu dzięki AdaptlyPost.
Analityka wszystkich platform
Skrzynka społecznościowa
Asystent oparty na AI
Powiązane hasła ze słownika


Limity rozmiaru wideo na Bluesky: 300 MB, MP4 i 1920 pikseli
Limit rozmiaru wideo na Bluesky to 300 MB na plik MP4. Aplikacja skaluje wideo do 1920 pikseli na dłuższym boku przy 3 Mbps, a proporcje nie są narzucone.


Dlaczego limit rozmiaru obrazu na Bluesky to 2 000 000 bajtów
Limit rozmiaru obrazu na Bluesky to 2 000 000 bajtów na obraz w poście, ustalone przez maxSize w leksykonie. Awatary i banery kończą się na 1 000 000 bajtów.


Jak opublikować GIF na Bluesky, żeby się nie zatrzymał
Jak GIF trafia do posta na Bluesky: wyszukiwarka KLIPY, przesłane pliki zamieniane w wideo, osadzone obrazy z jedną klatką i to, co wysyła AdaptlyPost.
Powiązane artykuły


Jak threadgate na Bluesky decyduje, kto może odpowiedzieć na post
Threadgate na Bluesky ogranicza odpowiedzi do wspomnianych osób, obserwujących, obserwowanych lub listy. Jak działa ten rekord i postgate blokujący cytaty.


Jak działa generator kanałów Bluesky: od leksykonu do działającego kanału
Generator kanałów Bluesky to jedna usługa HTTPS odpowiadająca na jedno zapytanie XRPC. Leksykony, wpis w dokumencie DID, JWT i luki w dokumentacji.


Dlaczego byteStart i byteEnd w facetach Bluesky liczą bajty, a nie znaki
Przesunięcia byteStart i byteEnd w facetach Bluesky liczą bajty UTF-8, a nie indeksy UTF-16 z JavaScriptu. Ostrzeżenie z leksykonu, przykład i poprawny kod.

