obsidian/infra/network/beryl-ax.md at main

Files

kaffa 1b1c968826 infra/network/beryl-ax: zram swap (zstd) 섹션 추가

휴대용 라우터의 빠듯한 RAM(491MB, swap 없음) 대비 CPU가 95% idle인
환경적 특성에 맞춰 zram 압축 swap을 도입. lzo 기본을 zstd로
전환해 압축률 ~1.5배 향상. 설치/검증/UCI 영구화 절차 정리.

2026-05-02 08:06:22 +09:00

6.2 KiB

Raw Permalink Blame History

title, updated, tags

title

updated

호스트 정보

항목	값
모델	GL.iNet GL-MT3000 (Beryl AX)
Board	`glinet,mt3000-snand` (mediatek/mt7981)
펌웨어	GL.iNet 4.8.1 (OpenWrt 21.02-SNAPSHOT base, kernel 5.4.211)
LAN	192.168.8.0/24 (gateway 192.168.8.1)
WAN	상위 공유기 뒤 더블 NAT (예: TP-Link 192.168.1.1 뒤 192.168.1.198)
Web UI	http://192.168.8.1 (GL.iNet, nginx 80/443) · http://192.168.8.1:8080 (LuCI/uhttpd)
SSH	`root@192.168.8.1`

용도: 출장/이동용 휴대 Wi-Fi 6 라우터. LAN을 만들고 tailscale subnet router로 동작시켜 노트북이 라우터에 붙기만 하면 tailnet에 접근 가능.

Tailscale

항목	값
Tailnet	`otter-buri.ts.net`
Hostname	`gl-mt3000`
Tailscale IP	100.98.170.28
AdvertiseRoutes	`192.168.1.0/24, 192.168.8.0/24`
RouteAll (accept-routes)	true
버전	tailscale 1.80.3 (펌웨어 내장)

tailscaled --port 41641 --state /etc/tailscale/tailscaled.state. tailnet admin console에서 advertise route 둘 다 approve 필요.

LAN → tailnet forward SNAT (필수 설정)

GL.iNet 4.8.1 기본 fw3 zone 정의에는 tailscale0에 masq 옵션이 없다. 그러면 LAN(192.168.8.0/24) → tailscale0 forward 트래픽이 SNAT되지 않아 source가 사설 IP(192.168.8.x) 그대로 tailnet에 나가고, peer가 응답 경로를 못 찾아 일부 노드와 통신이 끊긴다.

증상: LAN 클라이언트에서 ping 100.x.x.x가 timeout, 라우터 자체에서는 동일 peer 정상 통신. ICMP/TCP 모두 같은 패턴. peer가 라우터의 advertise route(192.168.8.0/24)를 OS routing table에 가지고 있는 경우(예: 같은 사용자의 다른 macOS)만 응답 가능.

영구 적용:

uci set firewall.tailscale0.masq='1'
uci add_list firewall.tailscale0.masq_src='192.168.8.0/24'
uci commit firewall
fw3 reload

검증:

iptables -t nat -L zone_tailscale0_postrouting -n -v
# MASQUERADE ... 192.168.8.0/24 룰이 박혀 있어야 함

MagicDNS split-forward

기본 설정에서 tailscale prefs의 CorpDNS: false이고 dnsmasq에도 ts.net forward 룰이 없어 LAN 클라이언트가 MagicDNS를 못 쓴다. ts.net 도메인만 100.100.100.100(Tailscale 내부 DNS proxy)로 보내는 split 방식이 GL.iNet의 기존 dnsmasq를 안 건드리고 가장 안전.

영구 적용:

uci add_list dhcp.@dnsmasq[0].server='/ts.net/100.100.100.100'
uci commit dhcp
/etc/init.d/dnsmasq restart

검증:

nslookup incus-jp1.otter-buri.ts.net 127.0.0.1
# → 100.109.123.1

100.100.100.100은 short name(incus-jp1)에 응답하지 않는다 — FQDN만 처리. short name은 클라이언트의 search domain으로 보완.

Mac 클라이언트 측 설정

Mac이 DNS를 hardcoded(예: 1.1.1.1, 8.8.8.8)로 쓰고 있으면 라우터 dnsmasq를 거치지 않아 ts.net 풀이가 안 된다. 정책을 바꾸지 않고 ts.net 도메인만 라우터로 보내려면:

sudo mkdir -p /etc/resolver
echo "nameserver 192.168.8.1" | sudo tee /etc/resolver/ts.net

/etc/resolver/<domain>은 macOS 시스템 resolver(getaddrinfo)에서만 적용된다. nslookup/dig은 이 설정을 우회하므로 검증할 때 부적합. dscacheutil -q host -a name <fqdn> 또는 실제 애플리케이션(nc, ssh, ping) 사용.

short name(ssh kaffa@incus-kr1)도 풀리려면 search domain이 라우터 tailnet과 일치해야 한다. macOS Tailscale 클라이언트가 stopped여도 이전 가입했던 tailnet의 search domain(taila*****.ts.net)이 잔재로 남아 있을 수 있다:

sudo networksetup -setsearchdomains Wi-Fi otter-buri.ts.net

이 설정은 macOS 차원에서 고정되어 다른 Wi-Fi에 옮겨도 유지된다(다른 네트워크의 DHCP search domain은 무시됨).

메모리 / zram swap

총 RAM 491MB(스펙 512MB - firmware reserve)에 swap 없는 환경. tailscaled + nginx + GL.iNet UI/cloud agent + dnsmasq 등으로 base 약 285MB 점유, 휴대용 라우터 치고 빠듯. CPU는 Cortex-A53 2-core인데 평소 95% idle이라 자원이 남으므로 zram(압축 RAM swap)으로 실효 가용 메모리를 늘리는 게 합리적.

설치:

opkg install kmod-zram zram-swap
/etc/init.d/zram enable
/etc/init.d/zram start

기본 동작: RAM의 약 50%(여기선 ~239MB)를 zram swap으로 잡음. UCI system.@system[0].zram_size_mb로 수동 지정 가능, 미설정 시 init script가 MemTotal/2048 MB로 자동 계산.

압축 알고리즘 zstd로 전환 (lzo 대비 압축률 ~1.5배, CPU 약간 더 사용 — 95% idle이라 무난):

uci set system.@system[0].zram_comp_algo='zstd'
uci commit system
/etc/init.d/zram restart

지원 알고리즘: lzo, lzo-rle, lz4, zstd. 활성 알고리즘은 cat /sys/block/zram0/comp_algorithm에서 대괄호로 표시됨 ([zstd]).

검증:

cat /proc/swaps              # /dev/zram0 244MB
free -m                      # Swap 244732
cat /sys/block/zram0/comp_algorithm

USB/microSD 기반 swap은 eMMC 쓰기 수명과 latency 문제로 비추천 — zram이 디스크 쓰기 없이 RAM만 활용하므로 임베디드 라우터에 적합.

운영 주의

Beryl LAN을 벗어나면 ts.net 풀이가 timeout (Mac이 192.168.8.1을 못 찾음). 외부 네트워크에선 Mac Tailscale을 다시 켜야 한다 — /etc/resolver/ts.net은 라우터 도달 가능성을 전제로 함
펌웨어 업그레이드 시 "Keep Settings" ON 필수. 위 fw3 masq, dnsmasq split-forward 모두 UCI 설정이라 keep settings로 보존됨
더블 NAT 환경에서 NAT punching이 일부 peer만 성공할 수 있다(예: 한국 인프라끼리 punch 실패, 일본 인프라는 direct 성공). 나머지는 DERP relay로 자동 폴백되므로 통신 자체엔 문제 없음 — 단, 위 SNAT 설정이 있어야 LAN 트래픽이 정상 흐름
LuCI(:8080)와 GL.iNet UI(:80/443)가 동시 운영. 펌웨어 업그레이드는 GL.iNet UI의 Online Upgrade가 가장 단순

6.2 KiB Raw Permalink Blame History