About
Tool No. 47 of Pikkola
Most debugging happens in the gap between what a server meant to send and what the browser actually read. This page puts the two sides next to each other: a reference for the code, a builder for the headers, and a parser that reads a real response back.
What it does
- Lists forty status codes from 1xx to 5xx, each with what it means, what usually causes it, and the next move for the front end and for the back end.
- Lets you search by number, by name, or by the symptom in front of you, and filter by class, by whether a client may retry, and by whether a cache may store the response.
- Builds CORS, Cache-Control and Set-Cookie headers from switches and values, and names the combinations a browser or a cache refuses.
- Writes the header block and the same intent as Nginx, Cloudflare Workers, Express and Caddy snippets.
- Parses raw response headers, explains each one, judges it against a security checklist, and names the headers that never arrived.
- English, Korean and Japanese, a light and a dark theme, and a phone layout that does not scroll sideways.
How retry and cache are decided
Retry answers a narrow question: may a client send the same request again without asking anyone? 408, 425, 429 and 502 to 504 are marked yes, because the request reached a server that could not finish it and nothing in the request is known to be wrong. 409, 412 and 500 are marked conditional: a retry is correct after the client re-reads the state or attaches an idempotency key, and wrong before that.
Cache answers whether a response may be reused at all by default. 200, 203, 204, 206 and 301 may be. 404, 405, 410 and 501 are heuristically cacheable, which is why a deleted page can stay away for a while even with no cache header. 302, 307 and 308 depend on what the response says, so the table marks them as needing a header. A 5xx is never reused.
Why the builder warns
Every warning here is a combination that fails in a real browser or a real cache, not a preference. A wildcard origin with credentials is rejected outright. SameSite=None without Secure is rejected outright. A public response with Set-Cookie may be stored with the cookie inside. A preflight answer over 7200 seconds is quietly capped by Chrome. The row tells you which of those you have.
The preview is what the server should send; the snippets are the same intent written for four servers. They differ on purpose, because Nginx drops outer add_header lines in a location that has its own, Caddy replaces an app's Set-Cookie when it sets one, and a Worker has to copy headers onto a new Response. The note under each snippet says what to watch.
What the parser judges
It reads what came back: HSTS and its max-age, a policy that still allows unsafe-inline, a nosniff that says something else, a frame rule missing on both sides, a referrer policy that passes the full address, a cookie without HttpOnly, a wildcard origin with credentials, a server header carrying a version. Missing headers are named too, because a page without a policy is the most common finding of all.
It judges only the response. It cannot know what your app meant to send, whether a route exists, why an origin answered 502, or whether the HTML would break a stricter policy. Those need the request, the logs and a person.
What it deliberately does not do
- It does not send a request. There is no field for a URL, and the content policy sets connect-src to none.
- It does not store anything on a server. What you typed stays in this browser.
- It does not pretend a snippet is a deployment. Each server scopes headers differently, and the note under each one says how.
- It does not collect analytics, set cookies, or load a font or a script from another host.
Why it is free
Pikkola builds small tools that do one job and keeps them free, with no account and no advertising. A static page that computes in the browser costs almost nothing to serve, so there is no reason to charge for it.
Contact
A status code described wrongly, a header check that should exist, a snippet that breaks on your server: hello@pikkola.com. Send the response headers you pasted and what you expected to see.
소개
피콜라의 47번째 도구
디버깅은 대개 서버가 보내려던 것과 브라우저가 실제로 읽은 것 사이의 틈에서 일어납니다. 이 페이지는 그 두 쪽을 나란히 둡니다. 코드를 위한 레퍼런스, 헤더를 만드는 빌더, 실제 응답을 다시 읽는 파서입니다.
하는 일
- 1xx부터 5xx까지 상태 코드 마흔 개를 뜻, 흔한 원인, 그리고 프론트엔드와 백엔드 각각의 다음 수와 함께 적었습니다.
- 번호로, 이름으로, 눈앞의 증상으로 찾고, 분류와 재시도 가능 여부, 캐시 가능 여부로 걸러 봅니다.
- 스위치와 값으로 CORS, Cache-Control, Set-Cookie 헤더를 만들고 브라우저나 캐시가 거부하는 조합을 짚습니다.
- 같은 의도를 헤더 블록으로, 그리고 Nginx, Cloudflare Workers, Express, Caddy 스니펫으로 씁니다.
- 원본 응답 헤더를 읽어 하나씩 설명하고 보안 점검표로 판정하며, 오지 않은 헤더도 이름을 부릅니다.
- 영어, 한국어, 일본어와 밝은 테마, 어두운 테마, 옆으로 넘어가지 않는 휴대폰 화면까지.
재시도와 캐시를 가르는 기준
재시도는 좁은 질문에 답합니다. 클라이언트가 아무에게도 묻지 않고 같은 요청을 다시 보내도 되는가. 408, 425, 429와 502부터 504까지는 가능으로 표시했습니다. 요청이 서버에 닿았고 끝내지 못했으며, 요청 자체가 틀렸다고 알려진 것이 없기 때문입니다. 409, 412, 500은 조건부입니다. 클라이언트가 상태를 다시 읽거나 멱등 키를 붙인 뒤에는 재시도가 맞고, 그전에는 틀립니다.
캐시는 응답을 기본값만으로 다시 써도 되는지를 답합니다. 200, 203, 204, 206, 301은 될 수 있습니다. 404, 405, 410, 501은 휴리스틱하게 캐시될 수 있어, 지운 페이지가 캐시 헤더 없이도 한동안 보이지 않을 수 있습니다. 302, 307, 308은 응답이 무엇을 말하느냐에 달려 있어 헤더가 필요하다고 표시했습니다. 5xx는 다시 쓰지 않습니다.
빌더가 경고하는 이유
여기서 경고하는 것은 모두 실제 브라우저나 실제 캐시에서 실패하는 조합입니다. 취향이 아닙니다. 자격 증명이 붙은 와일드카드 오리진은 그대로 거부되고, Secure 없는 SameSite=None도 그대로 거부됩니다. Set-Cookie가 붙은 public 응답은 쿠키까지 저장될 수 있고, 7200초를 넘는 프리플라이트 응답은 크롬이 조용히 자릅니다. 어느 것에 해당하는지 행이 알려 줍니다.
미리보기는 서버가 보내야 할 것이고, 스니펫은 같은 의도를 네 서버에 맞게 쓴 것입니다. 일부러 다릅니다. Nginx는 자기 add_header가 있는 location에서 바깥 add_header를 버리고, Caddy는 Set-Cookie를 직접 넣으면 앱의 것을 덮어쓰며, Worker는 새 Response에 헤더를 옮겨 적어야 합니다. 스니펫 아래 주석이 무엇을 살펴야 하는지 말합니다.
파서가 판정하는 것
돌아온 것을 읽습니다. HSTS와 그 max-age, unsafe-inline을 아직 허용하는 정책, nosniff가 아닌 다른 값을 가진 헤더, 양쪽 모두 빠진 프레임 규칙, 전체 주소를 넘기는 리퍼러 정책, HttpOnly 없는 쿠키, 자격 증명과 함께 온 와일드카드 오리진, 버전을 담은 Server 헤더입니다. 오지 않은 헤더도 짚습니다. 정책 없는 페이지가 가장 흔한 발견이기 때문입니다.
응답만 판정합니다. 앱이 무엇을 보내려 했는지, 라우트가 있는지, 오리진이 왜 502를 냈는지, 더 엄격한 정책에서 HTML이 깨질지는 알 수 없습니다. 그것에는 요청과 로그와 사람이 필요합니다.
일부러 하지 않는 것
- 요청을 보내지 않습니다. URL을 넣을 칸이 없고, 콘텐츠 정책이 connect-src를 none으로 둡니다.
- 서버에 아무것도 저장하지 않습니다. 입력한 글은 이 브라우저에 남습니다.
- 스니펫이 곧 배포라고 말하지 않습니다. 서버마다 헤더가 적용되는 범위가 다르고, 스니펫마다 그 방법을 적어 두었습니다.
- 분석도, 쿠키도 없고, 다른 호스트의 폰트나 스크립트도 불러오지 않습니다.
왜 무료인가
피콜라는 일 하나를 맡은 작은 도구를 만들고 무료로 둡니다. 계정도 광고도 없습니다. 브라우저에서 계산하는 정적 페이지는 띄우는 비용이 거의 들지 않으니 값을 받을 이유도 없습니다.
연락
상태 코드 설명이 틀렸거나, 있어야 할 헤더 검사가 빠졌거나, 어떤 스니펫이 서버에서 깨지면 hello@pikkola.com으로 알려 주세요. 붙여 넣은 응답 헤더와 기대한 결과를 함께 적어 주시면 좋습니다.
概要
Pikkola の 47番目のツール
不具合探しは、多くがサーバーの送ろうとしたものと、ブラウザーが実際に読んだものの隙間で起きます。このページはその二つを並べます。状態コードの一覧、ヘッダーを作る作成器、実際の応答を読み返す解析器です。
できること
- 1xx から 5xx まで状態コード四十件に、意味、よくある原因、そしてフロントとサーバーそれぞれの次の手を書いています。
- 番号で、名前で、目の前の症状で探し、分類、再試行の可否、キャッシュの可否で絞れます。
- スイッチと値から CORS、Cache-Control、Set-Cookie のヘッダーを作り、ブラウザーやキャッシュが拒む組み合わせを示します。
- 同じ意図をヘッダーの塊として、また Nginx、Cloudflare Workers、Express、Caddy の断片として書きます。
- 生の応答ヘッダーを読み、一つずつ説明し、保安の点検表で判定し、届かなかったヘッダーも名指しします。
- 英語、韓国語、日本語、明るいテーマと暗いテーマ、横に流れない携帯の画面。
再試行とキャッシュの決め方
再試行は狭い問いに答えます。クライアントが誰にも尋ねずに同じ要求を送り直してよいか。408、425、429、502 から 504 は可としました。要求はサーバーに届いて終えられず、要求そのものが誤りとは分かっていないからです。409、412、500 は条件付きです。クライアントが状態を読み直すか冪等キーを付けた後なら再試行は正しく、その前は誤りです。
キャッシュは、既定のままで応答を再利用してよいかを答えます。200、203、204、206、301 は可能です。404、405、410、501 は推測でキャッシュされ得るので、削除したページがヘッダー無しでもしばらく出ないことがあります。302、307、308 は応答の内容次第で、ヘッダーが要ると示しました。5xx は再利用しません。
作成器が警告する理由
ここでの警告はすべて、実際のブラウザーや実際のキャッシュで落ちる組み合わせです。好みではありません。資格情報付きのワイルドカードのオリジンはそのまま拒まれ、Secure の無い SameSite=None もそのまま拒まれます。Set-Cookie の付いた public の応答はクッキーごと保たれ得て、7200 秒を超えるプリフライトの答えは Chrome が静かに切ります。どれに当たるかを行が告げます。
見本はサーバーが送るべきもので、断片は同じ意図を四つのサーバー向けに書いたものです。わざと違います。Nginx は自分の add_header がある location で外側の add_header を捨て、Caddy は Set-Cookie を自分で入れるとアプリのものを上書きし、Worker は新しい Response へヘッダーを写す必要があります。断片の下の注記が、何を見るべきかを述べます。
解析器が判定すること
返ってきたものを読みます。HSTS とその max-age、unsafe-inline をまだ許す方針、nosniff でない値のヘッダー、両側に無い枠の規則、完全な住所を渡すリファラーの方針、HttpOnly の無いクッキー、資格情報と共のワイルドカードのオリジン、版を載せた Server ヘッダーです。届かなかったヘッダーも示します。方針の無いページが最もよくある発見だからです。
判定するのは応答だけです。アプリが何を送ろうとしたか、経路があるか、オリジンがなぜ 502 を返したか、より厳しい方針で HTML が壊れるかは分かりません。それには要求と記録と人が必要です。
意図してしないこと
- 要求を送りません。URL を入れる欄が無く、方針が connect-src を none にしています。
- サーバーに何も保ちません。入力した文字はこのブラウザーに残ります。
- 断片が配備そのものとは言いません。サーバーごとにヘッダーの掛かる範囲が違い、断片ごとにその方法を書いています。
- 分析も、クッキーも無く、別のホストのフォントやスクリプトも読み込みません。
なぜ無料か
Pikkola は一つの仕事を担う小さな道具を作り、無料で置きます。アカウントも広告もありません。ブラウザーで計算する静的なページは、置く費用がほとんど掛からないので、値段を取る理由もありません。
連絡
状態コードの説明が違う、あるべきヘッダーの検査が無い、断片がサーバーで壊れる。hello@pikkola.com まで知らせてください。貼った応答ヘッダーと、期待した結果を添えてもらえると助かります。