Teleport를 통한 Outline(docs) 접속이 Context Deadline Exceeded로 실패했습니다. Outline 서버와 앱 자체는 정상이었고, Teleport 앱 에이전트의 docs 앱 uri가 DHCP 변경 전 주소(.83)를 그대로 참조하고 있던 것이 원인이었습니다. uri를 현재 주소(.82)로 수정하고 앱 에이전트를 재시작해 복구했습니다.
기간
2026-10-16 12:15 KST 인지 (실제 시작 시각 미확인)
2026-10-16 14:58 KST (사용자 확인 시각)
영향 서비스
Teleport 경유 Outline(docs.console.nangman.cloud). 같은 앱 에이전트가 중계하는 NPM, OPNsense, NAS 등 다른 앱은 영향 없음
담당자
리포터: 이성원 / 작업자: 태성우
기술 임팩트
Teleport 앱 에이전트가 더 이상 존재하지 않는 주소(.83:3000)로 Outline에 접속을 시도해 응답을 받지 못했습니다. 연결 거부가 아니라 timeout으로 나타나 네트워크 장애처럼 보였지만, 화곡 서버의 Outline, Redis, Postgres 컨테이너와 Docker 포트 규칙은 모두 정상이었습니다. 복구 과정에서 Auth/Proxy 서버를 잘못 재시작해 다른 앱의 중계가 일시적으로 끊겼으나 설정 변경은 없어 곧바로 회복되었습니다.
서비스 토폴로지
- 사용자 -> Teleport Proxy (console.nangman.cloud, Auth/Proxy 서버)
- Teleport Proxy -> Teleport 앱 에이전트 (docs 앱)
- Teleport 앱 에이전트 -> 화곡 LAN의 Outline (.82:3000, 장애 중에는 .83을 참조)
근본 원인
화곡 서버의 DHCP 주소가 2026-09-28 새벽에 .83에서 .82로 바뀌었습니다. 그러나 Teleport 앱 에이전트의 teleport.yaml에서 docs 앱 uri는 여전히 .83:3000을 가리키고 있었고, 바뀐 주소로 갱신되지 않았습니다. 에이전트는 응답하지 않는 주소로 요청을 보내다가 timeout에 걸렸고, 사용자에게는 Context Deadline Exceeded로 나타났습니다.
기여 요인
- 서비스 서버가 고정 IP나 DHCP 고정 매핑 없이 동적 주소(DHCP)를 사용하고 있었음
- Teleport 앱 설정이 호스트 이름이 아닌 IP를 직접 참조하고 있어 주소 변경이 자동으로 반영되지 않았음
- 서버 IP가 바뀌었을 때 참조처를 점검하는 절차가 없었음
- 장애가 연결 거부가 아닌 timeout으로 나타나 서버와 네트워크 쪽 점검에 시간이 많이 소요됨
- Auth/Proxy 서버와 앱 에이전트 서버의 설정 파일 경로가 같아(teleport.yaml) 복구 중 Auth/Proxy 서버를 잘못 재시작함 (설정은 변경하지 않아 영향은 일시적 중계 끊김)
근거 자료
- 화곡 서버에서 Outline /_health가 200을 반환하고 컨테이너 상태가 healthy임을 확인
- Outline의 Redis 에러가 최근 24시간 0건이고 redis 이름이 정상 해석됨을 확인
- iptables에 3000 포트 DNAT/ACCEPT 규칙이 존재함을 확인
- systemd-networkd 로그에서 서버 주소가 09-28 02:43 KST경 .83에서 .82로 바뀐 것을 확인