refactor: 문서 사람처럼 작성하기

This commit is contained in:
donghyeon-ka
2026-09-22 16:24:58 +09:00
parent 1549e62b5e
commit f3bed70991
158 changed files with 4381 additions and 832 deletions
@@ -1,7 +1,7 @@
---
kind: QUESTION
slug: guest-input-hole-under-the-iptables-backend
title: libvirt 의 firewall_backend 가 iptables 일 때도 guest_input 에 구멍이 필요한가
title: libvirt firewall_backend가 iptables일 때도 guest_input 예외 규칙이 필요한가
topic: lab-environment-build
topicName: 실험대 환경 구성
project: virtualization
@@ -14,7 +14,7 @@ source:
- final/document.md#180-nftables-는-앞-체인의-accept-로-뒤-체인의-reject-를-막지-못한다
---
# libvirt 의 firewall_backend 가 iptables 일 때도 guest_input 에 구멍이 필요한가
# libvirt firewall_backend가 iptables일 때도 guest_input 예외 규칙이 필요한가
nftables 백엔드에서는 libvirt의 `guest_input` 체인 끝 `reject`가 외부 요청을 `connection refused`로 끊는 것을 2026-09-21에도 다시 재현했다. 다만 `firewall_backend=iptables` 비교는 아직 수행하지 않았다. 전역 libvirt firewall backend를 바꾸고 네트워크를 다시 세우면 현재 edge 진입점까지 끊길 수 있어, 기존 서비스가 함께 있는 이 host에서는 백엔드를 임의 전환하지 않았다.
@@ -22,12 +22,12 @@ nftables 백엔드에서는 libvirt의 `guest_input` 체인 끝 `reject`가 외
- 실제 구축에서 외부 요청이 가장 오래 막힌 지점은 libvirt가 만든 `guest_input` 체인이었다.
- 호스트에서 curl http://192.168.122.10 을 치면 엣지 nginx 가 404 로 응답했다.
- 밖에서 curl http://100.83.212.4 을 치면 connection refused 가 왔다. 드롭이면 기다리다 죽으니, 타임아웃이 아니라 즉시 거절이라는 점이 단서였다.
- 외부에서 `curl http://100.83.212.4`을 실행하면 `connection refused`가 반환됐다. 패킷이 drop된 경우처럼 타임아웃까지 기다리지 않고 즉시 거절됐다는 점 때문에 reject 규칙을 먼저 확인했다.
- libvirt 는 자기 테이블 ip libvirt_network 의 guest_input 체인을 reject 로 끝낸다. 그 앞에는 established,related 를 accept 하는 규칙이 있다.
- 그 reject 규칙의 카운터가 4 패킷 240 바이트였고 밖에서 친 curl 횟수와 정확히 일치했다. 범인은 그 숫자로 확정했다.
- reject 규칙의 카운터는 4 packets / 240 bytes였고 외부에서 실행한 `curl` 횟수와 정확히 일치했다. 이 값으로 해당 규칙이 외부 요청을 거절하고 있음을 확인했다.
- DNAT 파일에는 priority filter - 10 으로 먼저 도는 forward 체인이 있고 거기에 ct state new accept 를 넣어 두었다. 그런데도 패킷은 뒤 체인에서 거절됐다.
- nftables 는 같은 훅에 붙은 base 체인을 우선순위 순으로 전부 평가한다. 앞 체인의 accept 는 이 체인은 통과라는 뜻이고, 평가를 즉시 끝내는 것은 drop 이다. iptables 감각으로 쓰면 정확히 여기서 틀린다.
- 구멍은 libvirt 체인 맨 앞에 뚫었다. insert 가 맨 앞이고 add 가 맨 뒤다.
- nftables 구성에서는 Edge VM 80·443 허용 규칙을 libvirt `guest_input` 체인의 reject보다 앞에 `insert`했다.
- 그 규칙은 휘발성이다. 처음에는 DNAT 유닛의 `ExecStartPost`로 다시 넣는 방식을 썼다. 그러나 2026-09-21 worker 재구축에서 libvirt가 `guest_input`을 다시 구성한 뒤 기존 accept 규칙들이 `reject` 뒤로 밀렸고 외부 80/443이 다시 실패했다. 따라서 `ExecStartPost` 한 번은 persistence 해법으로 충분하지 않다는 것까지 확인됐다.
- 이 호스트는 nftables 백엔드다. firewall_backend 가 iptables 일 때도 같은지는 재지 않았다고 「nftables 는 앞 체인의 `accept` 로 뒤 체인의 `reject` 를 막지 못한다」에서는 미확인으로 표시했다.
@@ -41,21 +41,21 @@ nftables 백엔드에서는 libvirt의 `guest_input` 체인 끝 `reject`가 외
## 아직 모르는 backend 차이
- firewall_backend 를 iptables 로 둔 호스트에서 밖에서 게스트로 가는 FORWARD 경로를 무엇이 끝내는지.
- 그때 forward 체인의 ct state new accept 가 실제로 먹는지, 아니면 거기서도 libvirt 쪽 규칙에 구멍을 따로 뚫어야 하는지.
- 구멍이 필요하다면 그 방법이 nftables 에서 쓴 insert 맨 앞 규칙과 어떻게 다른지, 그리고 그 규칙도 네트워크를 다시 세우면 날아가는지.
- iptables 백엔드에서도 별도의 Edge VM 허용 규칙이 필요한지 확인한다.
- 허용 규칙이 필요하다면 nftables 백엔드에서 사용한 규칙과 무엇이 다른지, libvirt 네트워크 재구성 뒤에도 유지되는지 확인한다.
## 환경별로 달라지는 범위
- 잴 수 있는 호스트가 한 대다. 「이 부의 출처와 범위」에 적은 test-server 는 Arch Linux, i5-1135G7 논리 코어 8, RAM 11,648MiB, QEMU 11.1.1 · libvirt 12.7.0 이다.
- 이더넷 없이 WiFi 만 있어 브리지를 못 쓰고 libvirt NAT(virbr0) + 호스트 진입 구조를 택했다. 밖에서 들어온 패킷이 FORWARD 를 타는 것이 그 구성 때문이라, 네트워크 모드가 달라지면 이 물음이 묻는 상황도 달라진다.
- 백엔드를 바꾸려면 libvirt 네트워크를 다시 세워야 하고, 그때 guest_input 에 뚫어 둔 구멍이 날아간다. 엣지 게스트가 밖에서 들어오는 요청을 받는 진입점이므로 되돌릴 절차를 먼저 준비한다.
- iptables backend 비교 원문은 아직 없다. nftables backend의 과거 `4 packets / 240 bytes` 수치는 당시 본문에 옮긴 덤프에만 남아 있고, 2026-09-21에는 같은 backend에서 외부 요청 실패와 `reject` 카운터 증가를 다시 확인했다. 두 시점의 숫자를 하나의 실행처럼 합치지 않는다.
- 백엔드를 바꾸려면 libvirt 네트워크를 다시 구성해야 하고, 현재 `guest_input`에 런타임으로 추가한 허용 규칙은 사라질 수 있다. 엣지 게스트가 밖에서 들어오는 요청을 받는 진입점이므로 되돌릴 절차를 먼저 준비한다.
- iptables backend에서 같은 비교를 수행한 기록은 아직 없다. nftables backend의 과거 `4 packets / 240 bytes` 수치는 당시 덤프에만 남아 있고, 2026-09-21에는 같은 backend에서 외부 요청 실패와 `reject` 카운터 증가를 다시 확인했다. 두 시점의 숫자를 하나의 실행처럼 합치지 않는다.
## 어떻게 비교할까
### 1. 구멍을 뺀 채 백엔드만 iptables 로 바꾸고 밖에서 한 번 친다
### 1. 별도 허용 규칙 없이 iptables 백엔드의 외부 요청 경로를 확인한다
백엔드를 바꾸면서 libvirt 네트워크를 다시 세우면 현재 `guest_input`에 넣은 허용 규칙은 사라지므로, 별도 구멍이 없는 상태에서 비교를 시작할 수 있다. 그 상태에서 밖에서 엣지로 curl 을 치고 응답인지 connection refused 인지, 그리고 거기까지 걸린 시간을 적는다. 같은 시각에 libvirt 가 만든 규칙을 그대로 덤프해 어느 규칙이 패킷을 끝내는지 본다. 규칙마다 카운터가 붙어 있으면 그 값이 친 횟수와 맞는지도 함께 읽는다. nftables 에서 범인을 지목한 것이 그 카운터였다.
백엔드를 바꾸면서 libvirt 네트워크를 다시 세우면 현재 `guest_input`에 넣은 허용 규칙은 사라지므로, 별도 허용 규칙이 없는 상태에서 비교를 시작할 수 있다. 그 상태에서 밖에서 엣지로 curl 을 치고 응답인지 connection refused 인지, 그리고 거기까지 걸린 시간을 적는다. 같은 시각에 libvirt 가 만든 규칙을 그대로 덤프해 어느 규칙이 패킷을 끝내는지 본다. 규칙마다 카운터가 붙어 있으면 그 값이 친 횟수와 맞는지도 함께 읽는다. nftables 백엔드에서도 reject 규칙의 카운터와 요청 횟수가 일치해 차단 지점을 확인할 수 있었다.
「nftables 는 앞 체인의 `accept` 로 뒤 체인의 `reject` 를 막지 못한다」에 적은 그 forward 체인은 지금 DNAT 파일에 없다. 「단계 03 — 엣지 nginx 라우팅과 호스트 DNAT」에서는 싣는 파일에 남은 체인은 prerouting 하나이고, accept 는 유닛의 ExecStartPost 가 libvirt 체인 안에 넣는다. 그래서 아래 셋 가운데 마지막을 재려면 그 체인을 먼저 되돌려 놓아야 한다.
@@ -65,20 +65,20 @@ nftables 백엔드에서는 libvirt의 `guest_input` 체인 끝 `reject`가 외
패킷을 끝낸 규칙 : 어느 테이블의 어느 체인인가
forward 체인의 accept : 먹었는가 먹지 않았는가
### 2. 구멍을 남겨 둔 채 백엔드만 바꾼다 — 제외
### 2. 기존 허용 규칙을 남긴 채 백엔드만 바꾼다 — 제외
구멍이 이미 열려 있으면 요청은 통과하고, 그 통과가 구멍 덕분인지 백엔드가 원래 막지 않아서인지 가려지지 않는다.
기존 허용 규칙이 남아 있으면 요청이 통과했을 때 iptables 백엔드 자체의 기본 동작과 허용 규칙의 효과를 구분할 수 없다.
### 3. libvirt 가 iptables 백엔드에서 만드는 규칙을 문서로 읽어 견준다 — 제외
호스트를 건드리지 않아도 되지만 답이 나오지 않는다. 「nftables 는 앞 체인의 `accept` 로 뒤 체인의 `reject` 를 막지 못한다」에서도 규칙 목록이 아니라 카운터가 범인을 지목했으니, 우선순위가 다른 base 체인 둘이 한 훅에 붙었을 때 어느 쪽이 패킷을 끝내는지는 이 구성에서 돌려 봐야 나온다.
호스트 설정을 바꾸지 않고 문서만 비교하는 방법으로는 실제 패킷 처리 결과를 알 수 없다. nftables 백엔드에서도 규칙 목록만 본 것이 아니라 reject 카운터와 요청 횟수를 대조해 차단 지점을 확인했다. iptables 백엔드에서도 같은 방식으로 실제 요청과 규칙 카운터를 함께 확인해야 한다.
## 다음 확인
1. libvirt 의 firewall_backend 를 iptables 로 두고 네트워크를 다시 세운다. 이때 guest_input 에 뚫어 둔 구멍이 날아가므로 구멍 없는 상태에서 시작한다.
1. libvirt 의 firewall_backend 를 iptables 로 두고 네트워크를 다시 세운다. 이때 런타임으로 추가한 `guest_input` 허용 규칙이 사라지므로 별도 허용 규칙이 없는 상태에서 시작한다.
2. 밖에서 엣지로 curl 을 치고 결과가 응답인지 connection refused 인지, 그리고 거기까지 걸린 시간을 적는다.
3. 같은 시각에 libvirt 가 만든 규칙을 그대로 덤프해 어느 규칙이 패킷을 끝내는지와 그 카운터가 친 횟수와 맞는지를 본다.
4. 출력 원문과 함께 실행한 명령, 작업 디렉터리, 실행 시각, 종료 코드를 기록한다. backend 전환 전후의 ruleset과 외부 요청 결과를 한 실행 단위로 묶어야 나중에 비교할 수 있다.
5. 백엔드를 nftables 로 되돌린 뒤 현재 외부 경로가 원래 상태로 복구됐는지 직접 확인한다. `ExecStartPost`는 libvirt의 이후 체인 재작성까지 보장하지 못하므로, 유닛 `active`만 보지 않고 `guest_input`에서 edge용 `accept`가 `reject`보다 앞에 있는지와 외부 80/443 응답을 함께 본다.
`iptables` 백엔드에서 별도 허용 규칙 없이 외부 요청이 응답을 받으면 현재의 `guest_input` 구멍은 nftables 백엔드에 한정된 조치로 본다. 여전히 거절되면 패킷을 끝낸 규칙과 필요한 허용 방법을 함께 남긴다. 지금 확인된 범위는 nftables 백엔드뿐이다.
`iptables` 백엔드에서 별도 허용 규칙 없이 외부 요청이 응답을 받으면 현재의 `guest_input` 허용 규칙은 nftables 백엔드에서만 필요했던 조치로 판단할 수 있다. 여전히 거절되면 패킷을 끝낸 규칙과 필요한 허용 방법을 함께 남긴다. 지금 확인된 범위는 nftables 백엔드뿐이다.
@@ -60,7 +60,7 @@ renewal 설정이 `dns-cloudflare`를 직접 가리킨다. 이 질문의 답이
### 2. HTTP-01 — 현재 관측과 불일치
원본 가이드 04에는 `--webroot` 경로가 남아 있었지만, 현재 renewal 설정이 그것을 사용한다는 증거는 없다. historical document branch로만 남긴다.
원본 가이드 04에는 `--webroot` 경로가 남아 있었지만, 현재 renewal 설정이 그것을 사용한다는 증거는 없다. 과거 가이드에 남아 있던 경로로만 구분한다.
## 현재 실험대는 DNS-01로 갱신한다
@@ -60,7 +60,7 @@ source:
### 1. 크기를 먼저 확정하고 그 파일 한 장을 한 번 옮긴다
qemu-img info 와 du 로 가상 크기와 실제 점유를 따로 적는다. 제4부에서 형식과 세 크기를 묻는 물음이 같은 출력을 쓰기 때문에 한 번만 돌려 두 물음이 나눠 쓴다. 그다음 게스트를 멈춘 상태에서 그 파일을 다른 기계로 복사하고 시작 시각과 종료 시각과 평균 전송률을 적는다.
`qemu-img info`와 `du`로 가상 크기와 실제 호스트 할당량을 먼저 기록한다. 같은 출력은 이미지 형식과 사용량 확인에도 함께 사용할 수 있다. 그다음 게스트를 멈춘 상태에서 파일을 다른 기계로 복사하고 시작 시각, 종료 시각, 평균 전송률을 기록한다.
옮기는 것이 파일 한 장이 아니다. 「단계 01 — 게스트 세 대」에 적은 이 실험대의 게스트 디스크 셋은 전부 base.qcow2 위의 오버레이라, 오버레이만 건너가면 헤더에 절대경로로 적힌 그 base 를 받는 쪽에도 같은 경로로 두어야 한다.
@@ -20,7 +20,7 @@ source:
# virsh save 의 RAM 덤프 크기와 소요 시간은 할당 메모리에 어떻게 비례하는가
2026-09-21 `kc-lab-1`에서 current memory를 5120 MiB와 4096 MiB 두 값으로 두고 `virsh save → restore`를 실제로 반복했다. **save 파일은 ‘RAM 크기만큼’ 그대로 생기지 않았다.** 5120 MiB 상태에서는 약 3.33 GB, 4096 MiB 상태에서는 약 3.22 GB였고, 1 GiB의 current-memory 차이가 save 파일 크기에 1 GiB로 그대로 반영되지 않았다.
2026-09-21 `kc-lab-1`에서 current memory를 5120 MiB와 4096 MiB 두 값으로 두고 `virsh save → restore`를 실제로 반복했다. save 파일은 ‘RAM 크기만큼’ 그대로 생기지 않았다. 5120 MiB 상태에서는 약 3.33 GB, 4096 MiB 상태에서는 약 3.22 GB였고, 1 GiB의 current-memory 차이가 save 파일 크기에 1 GiB로 그대로 반영되지 않았다.
## 5120MiB와 4096MiB 비교 결과