Files
document-haness/docs/virtualization/final/.techviz/nftables-forward-hook-chain-order/spec.json
T
DongHyeonkaandClaude Opus 5 2109f726fe feat(pipeline): keycloak-session-store 25편·virtualization 59편을 S3→S5→S6 으로 돌린다
기록 84편을 계약 에이전트로 다시 썼다. 기존 71편(kss 25 · virt 46)과, 계약에만
있고 안 쓰여 있던 새 글감 13편이다. 원장 84개를 열어 단계마다 스킬 영수증과 관문
종료 코드를 적었고 verify-pipeline-run.py 가 error 0 으로 닫는다.

SSOT 결함 둘을 고쳤다.

- kss 의 `약 58일` 이 반입 중 `약 59일` 로 바뀌어 있었다. 원 증거 파일이
  「남은 일수: 88일 … 실제 갱신까지 약 58일」로 산수를 직접 적는다. D-4a 쪽
  `약 59일` 은 강제 갱신 뒤(`VALID: 89 days`)라 맞는 값이라 그대로 뒀다.
- virt §198 의 `11.6GB` 는 §178 의 원 측정 `Mem: 11648`(MiB)과 어긋나는데
  원 가이드의 표기 그대로라 고치지 않고 쓰이는 자리에 대조를 적었다.

기록의 수치 오류 셋을 고쳤다 — CASE 요약의 「게스트 셋에 8240MB」(5120+3120 은
둘이다), k3s 편이 같은 것을 여섯·일곱·여덟로 세던 것, no-docker 편의 「셋을 더
든다」(§281 의 표는 네 행이고 디스크 행이 빠져 있었다).

계약을 셋 고쳤다.

- kss 의 sourceRepository 리비전이 cdac9b8 이었는데 그 커밋에는 docs/guides/**
  28개가 아예 없다. 9465582b 로 바꾸고, 반입한 바이트가 어느 커밋과도 같지 않다는
  것을 측정값과 함께 적었다 — 반입은 커밋이 아니라 그 시점의 작업 트리에서 떠 온
  것이다(kss 297/306 · virt 12/14 가 작업 트리와 같고, 200 커밋을 거슬러 전수
  대조했을 때 가장 가까운 커밋도 28개가 어긋났다).
- virt 계약이 「2026-09-11 재배분」이라고 적는데 SSOT 는 재배분 날짜를 적지 않고
  재배분 뒤 값은 이미 2026-09-10 측정에 찍혀 있다.
- kss 후보 대장이 지나친 절 아홉에 처분을 적었다(warn 9 → 0). 새 글감은 0건이고
  넷은 앵커가 h3 슬러그의 접두가 아니라 중간 토막이라 검사기가 못 본 것이었다.

style_profile.mjs 의 결함 둘을 고쳤다 — frontmatter 가 문장으로 세어져
(실측 398자짜리 「문장」 하나) 평균 길이를 기준 안으로 밀어 올리고 있었고,
engPerSent 의 분자는 목록을 포함한 글에서, 분모는 목록을 걷어낸 글에서 세고
있었다(Question 기록에서 11.94 → 3.86).

verify-pipeline.py 전 항목 PASS · error 0 · unittest 334건 OK.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
2026-09-17 11:01:55 +09:00

290 lines
10 KiB
JSON

{
"version": "1.1",
"id": "nftables-forward-hook-chain-order",
"title": "같은 forward 훅에 붙은 base 체인 둘이 우선순위 순으로 이어서 평가되고, 앞 체인의 accept 는 뒤 체인의 reject 를 막지 못한다",
"question": "밖에서 온 packet 하나가 forward 훅에서 어느 규칙을 어떤 순서로 지나 어디서 끝났고, insert 로 넣은 구멍은 그 순서의 어디에 들어가는가",
"type": "network",
"direction": "LR",
"audience": [
"iptables 감각으로 nftables 규칙을 쓰다 밖에서만 막히는 것을 보는 사람",
"libvirt NAT 뒤의 게스트에 밖에서 들어오는 경로를 여는 사람"
],
"summary": "밖에서 온 packet 은 priority filter - 10 인 forward 체인의 ct state new accept 를 지나고도 평가가 끝나지 않아 libvirt_network guest_input 으로 이어지고, 거기서 체인 끝 reject 에 닿아 connection refused 가 되며, insert 로 넣은 구멍은 같은 체인의 맨 앞에 서서 같은 packet 을 엣지 nginx 로 보낸다.",
"alt": "밖에서 온 packet 이 forward 훅에 붙은 base 체인 둘을 우선순위 순으로 지나는 경로도. 앞 체인의 accept 뒤에 libvirt guest_input 이 이어지고, 구멍을 넣기 전 경로는 그 체인 끝 reject 로, 넣은 뒤 경로는 체인 맨 앞의 구멍을 지나 엣지 nginx 로 갈라진다.",
"long_description": "왼쪽에서 오른쪽으로 읽는다. 왼쪽 끝이 밖에서 친 curl 이 만든 inbound packet 이고 forward 훅으로 들어간다. 첫 점선 상자가 DNAT 파일에 둔 base 체인이다. priority filter - 10 이라 먼저 돌고, 그 안의 ct state new accept 가 이 packet 을 통과시킨다. 다음 점선 상자가 libvirt 가 만든 ip libvirt_network 테이블의 guest_input 체인이다. 앞 체인의 accept 는 평가를 끝내지 않으므로 같은 packet 이 이 체인으로 이어진다. 그 안의 상자 둘은 같은 체인의 맨 앞과 맨 끝이다. 구멍을 넣기 전에는 맨 앞이 비어 있어 packet 이 ct state established,related accept 에 걸리지 못한 채 체인 끝 reject 에 닿았고 connection refused 로 끝났다. 그 reject 규칙의 카운터가 4 패킷 240 바이트다. insert 로 구멍을 넣으면 그 규칙이 맨 앞에 서서 같은 packet 을 먼저 받아 192.168.122.10 의 엣지 nginx 로 보낸다. 실선이 구멍을 넣은 뒤의 경로이고 점선이 넣기 전의 경로다. 이 그림은 그 규칙이 libvirt 네트워크를 다시 세우면 사라진다는 것은 말하지 않는다.",
"source_context": {
"document": "docs/virtualization/final/document.md",
"document_sha256": "60d902c7aed218ba637b48603a3bd0e6b193fea59c9de97ffdb8e05d5087aedd",
"anchor": {
"kind": "heading",
"value": "180. nftables 는 앞 체인의 `accept` 로 뒤 체인의 `reject` 를 막지 못한다",
"line": 7805
}
},
"composition": {
"profile": "component-flow",
"diagram_only": true,
"reference_ids": [
"payment-event-flow"
],
"rationale": "이 절이 세운 것은 방향이 있는 경로 하나다 — 밖에서 온 packet 이 base 체인 둘을 우선순위 순으로 지나 두 결말 가운데 하나에 닿는다. 두 체인은 소유가 다른 실제 containment 라 groups 로 둘렀다. comparison 은 관계선을 지워도 뜻이 남는 자리의 문법인데 여기서는 지우면 「앞 체인의 accept 를 지나고도 뒤 체인에 닿는다」가 통째로 사라져 규칙 목록만 남는다. sequence 는 주고받는 참가자가 둘 이상일 때의 문법이고 여기서 움직이는 것은 packet 하나뿐이다.",
"focus_node": "tail-reject"
},
"groups": [
{
"id": "our-forward-chain",
"label": "forward · priority filter - 10",
"kind": "system",
"role": "zone",
"description": "DNAT 를 정의한 파일에 둔 base 체인. 같은 훅에서 libvirt 체인보다 먼저 돈다.",
"evidence": [
{
"start_line": 7829,
"end_line": 7830
}
],
"assumption": false
},
{
"id": "libvirt-guest-input",
"label": "ip libvirt_network · guest_input",
"kind": "system",
"role": "zone",
"description": "libvirt 가 자기 테이블 안에 만드는 base 체인. 같은 훅에서 뒤에 돈다.",
"evidence": [
{
"start_line": 7818,
"end_line": 7824
}
],
"assumption": false
}
],
"nodes": [
{
"id": "inbound-packet",
"label": "inbound packet",
"kind": "packet",
"role": "source",
"shape": "box",
"details": [
"curl http://100.83.212.4"
],
"description": "밖에서 친 curl 이 만든 packet. 호스트가 직접 듣는 리스너가 없어 FORWARD 로 간다.",
"evidence": [
{
"start_line": 7814,
"end_line": 7814
},
{
"start_line": 7809,
"end_line": 7809
}
],
"assumption": false
},
{
"id": "our-accept",
"label": "ct state new accept",
"kind": "rule",
"role": "service",
"shape": "box",
"group": "our-forward-chain",
"description": "우리가 먼저 돌게 해 둔 체인의 규칙. 이 체인은 통과시키지만 평가를 끝내지는 않는다.",
"evidence": [
{
"start_line": 7829,
"end_line": 7833
}
],
"assumption": false
},
{
"id": "inserted-accept",
"label": "inserted accept",
"kind": "rule",
"role": "service",
"shape": "box",
"group": "libvirt-guest-input",
"emphasis": "primary",
"details": [
"nft insert rule",
"daddr 192.168.122.10",
"tcp dport {80,443}"
],
"description": "insert 로 guest_input 맨 앞에 넣은 구멍. add 로 넣으면 맨 뒤라 reject 뒤에 선다.",
"evidence": [
{
"start_line": 7835,
"end_line": 7840
}
],
"assumption": false
},
{
"id": "tail-reject",
"label": "reject",
"kind": "rule",
"role": "service",
"shape": "box",
"group": "libvirt-guest-input",
"emphasis": "primary",
"details": [
"chain tail",
"counter packets 4",
"bytes 240"
],
"description": "guest_input 체인을 끝내는 규칙. 앞의 ct state established,related accept 에 걸리지 못한 packet 이 여기 닿는다. 이 카운터가 밖에서 친 curl 횟수와 일치해 범인 확정에 쓰였다.",
"evidence": [
{
"start_line": 7821,
"end_line": 7823
},
{
"start_line": 7826,
"end_line": 7827
}
],
"assumption": false
},
{
"id": "edge-nginx",
"label": "edge nginx",
"kind": "service",
"role": "sink",
"shape": "box",
"details": [
"192.168.122.10"
],
"description": "게스트에서 도는 엣지. 호스트에서 친 요청에는 이미 404 로 응답하고 있었다.",
"evidence": [
{
"start_line": 7813,
"end_line": 7813
},
{
"start_line": 7839,
"end_line": 7840
}
],
"assumption": false
},
{
"id": "connection-refused",
"label": "connection refused",
"kind": "result",
"role": "sink",
"shape": "box",
"description": "drop 이 아니라 reject 라 기다리지 않고 즉시 돌아온 결과.",
"evidence": [
{
"start_line": 7814,
"end_line": 7814
},
{
"start_line": 7816,
"end_line": 7816
}
],
"assumption": false
}
],
"edges": [
{
"id": "packet-to-our-chain",
"from": "inbound-packet",
"to": "our-accept",
"label": "forward hook",
"kind": "data",
"style": "solid",
"evidence": [
{
"start_line": 7814,
"end_line": 7814
},
{
"start_line": 7829,
"end_line": 7830
}
],
"assumption": false
},
{
"id": "our-chain-after-insert",
"from": "our-accept",
"to": "inserted-accept",
"label": "after insert",
"kind": "data",
"style": "solid",
"evidence": [
{
"start_line": 7831,
"end_line": 7833
},
{
"start_line": 7835,
"end_line": 7836
}
],
"assumption": false
},
{
"id": "our-chain-before-insert",
"from": "our-accept",
"to": "tail-reject",
"label": "before insert",
"kind": "data",
"style": "dashed",
"evidence": [
{
"start_line": 7831,
"end_line": 7833
},
{
"start_line": 7821,
"end_line": 7823
}
],
"assumption": false
},
{
"id": "inserted-to-edge",
"from": "inserted-accept",
"to": "edge-nginx",
"label": "accept",
"kind": "result",
"style": "solid",
"evidence": [
{
"start_line": 7835,
"end_line": 7840
}
],
"assumption": false
},
{
"id": "reject-to-refused",
"from": "tail-reject",
"to": "connection-refused",
"label": "reject",
"kind": "result",
"style": "dashed",
"evidence": [
{
"start_line": 7823,
"end_line": 7823
},
{
"start_line": 7814,
"end_line": 7816
}
],
"assumption": false
}
],
"legend": [],
"metadata": {
"rationale": "network 으로 고른 이유는 이 절이 답하는 물음이 「packet 하나가 어느 규칙을 어떤 순서로 지나는가」이기 때문이다. 상자는 체인이 아니라 규칙 하나씩이다 — 체인을 상자로 두면 「앞 체인 accept 다음에 뒤 체인」이라는 자리 관계가 안 보이고, 그 자리가 이 사건의 전부다. 실선은 구멍을 넣은 뒤의 경로이고 점선은 넣기 전의 경로다. 색이 아니라 선 모양으로 갈랐다. guest_input 의 ct state established,related accept 는 상자로 세우지 않았다 — 세우면 그 체인 그룹이 두 칸을 차지하고 bbox 가 그룹 밖인 엣지 nginx 를 삼켜 엣지가 libvirt 체인 안에 있는 것처럼 보였다(렌더 확인). 그 규칙의 원문은 기록 본문 코드블록에 그대로 있다. ExecStartPost 로 규칙을 되살리는 수명은 시간 축이라 본문에 두었다."
}
}