{
  "ip": "203.0.113.42",            // 실제 클라이언트 공인 IP (체인 끝)
  "edge_ip": "127.0.0.1",          // FastAPI 소켓이 본 직접 연결 (nginx)
  "via_proxy": true,               // X-Real-IP / X-Forwarded-For 헤더 존재 여부
  "forwarded_for": "203.0.113.42", // X-Forwarded-For 헤더 원본
  "x_real_ip": "203.0.113.42"      // X-Real-IP 헤더 원본 (없으면 null)
}

{
  "ip": "203.0.113.42",
  "edge_ip": "127.0.0.1",
  "via_proxy": true,
  "forwarded_for": "203.0.113.42",
  "x_real_ip": "203.0.113.42",
  "lookup": {
    "ip": "203.0.113.42",
    "city": "Seoul",
    "region": "Seoul",
    "country": "KR",
    "loc": "37.5683,126.9778",
    "org": "AS9318 SK Broadband",
    "postal": "04524",
    "timezone": "Asia/Seoul"
  }
}

# JSON 으로 내 공인 IP 확인
curl -s https://www.selfinet.com/api/ip

# 텍스트 한 줄만 — DDNS 클라이언트가 IP 비교에 사용
MY_IP=$(curl -s https://www.selfinet.com/api/ip/txt)
echo "$MY_IP"

# 지리/ASN 까지 한 번에
curl -s https://www.selfinet.com/api/ip/detail | jq

# 다른 IP 조회 (세션 로그인 필요 — 쿠키 파일로 인증)
curl -s -b ~/.selfinet.cookies https://www.selfinet.com/api/ip/lookup/8.8.8.8

# /api/ip/txt 로 현재 IP 를 확인하고 변경됐을 때만 DDNS 업데이트
CACHE=/tmp/selfinet-last-ip
NEW=$(curl -s https://www.selfinet.com/api/ip/txt)
OLD=$(cat "$CACHE" 2>/dev/null || echo "")
if [ "$NEW" != "$OLD" ]; then
  curl -s "https://www.selfinet.com/api/ddns/update?host=myhome.selfinet.com&key={API_KEY}&ip=$NEW"
  echo "$NEW" > "$CACHE"
fi

IP 지오로케이션은 사용자가 어디 있는가 가 아니라 해당 IP 블록을 ISP 가 어디에 등록했는가 를 기준으로 매핑됩니다. 한국 가정용 ISP (SKB / KT / LGU+) 는 광역 IDC 단위로 IP 를 운용해서 국가·광역시 정확도는 90%+ 지만 시·구 정확도는 30~50% 수준으로 떨어집니다. 예: 구로구 SK브로드밴드 가입자가 "Incheon" 으로 잡히는 케이스 — 그 IP 블록의 등록지가 인천 백본이기 때문.

MaxMind / ip-api / ipgeolocation.io 등 다른 IP 지오로케이션 서비스로 교체해도 한국 시·구 단위 정확도는 비슷한 한계가 있습니다. 정확한 위치가 필요하면 https://ipinfo.io/corrections 로 해당 IP 의 위치 수정을 신청할 수 있지만, 동적 IP 라면 의미가 작습니다.

HTTP 헤더만으로는 NAT 너머의 사설 IP (192.168.x.x, 10.x.x.x) 를 알 수 없습니다. 대신 브라우저의 RTCPeerConnection 으로 로컬 네트워크 인터페이스 주소를 시도합니다.

※ mDNS hostname 은 동일 브라우저·프로필 안에서는 안정적인 식별자지만, 시크릿 창이나 다른 브라우저에서는 새 값이 생성됩니다.

1. 사이드바 → 사용자 메뉴 → 계정등급 변경
2. Premium 카드 선택 → "N원 결제하고 Premium 시작" 버튼
3. 토스 결제창에서 카드 정보 입력 → 결제 인증
4. selfinet 페이지로 자동 복귀 → 등급이 premium 으로 변경되고 만료일 안내
5. 만료일 이후 다음 요청 시 자동으로 일반 등급으로 강등 (별도 작업 불필요)

1. backend/.env 에 토스 결제창 v1 SDK 의 공개 테스트 키 페어가 이미 박혀 있습니다 (test_ck_D5G... / test_sk_zXL...). 별도 작업 없이 동작해야 정상.
2. 키가 INVALID_API_KEY 또는 UNAUTHORIZED 로 거부되면 토스 정책 변경 — 아래 절차로 재발급:
   1. 토스페이먼츠 개발자센터 가입 (사업자등록증 필요)
   2. "내 개발 정보" → 테스트 키 (Client / Secret) 발급
   3. backend/.env 의 TOSS_CLIENT_KEY, TOSS_SECRET_KEY 교체
3. 변경 후 sudo systemctl restart selfinet-backend
4. 이 페이지(도움말 → 결제)에 다시 와서 흐름 검증.

• 토스페이먼츠 콘솔에서 사업자 정산 정보 / 카드사 계약 마무리
• 운영 키(live_ck_* / live_sk_*) 발급
• backend/.env 의 TOSS_* 키 교체, 가격 확정 (PREMIUM_PRICE_KRW)
• sudo systemctl restart selfinet-backend
• 본인 카드로 1회 실제 결제 → 환불 → 환불까지 잘 도는지 검증 후 공식 오픈