🌐 English | 中文 | 한국어

노드

노드는 HY2 SCALE 메시의 구성 요소입니다. 각 노드는 Hysteria 2 QUIC 서버를 실행하고 다른 노드와 피어로 연결되어 탈중앙 P2P 토폴로지를 형성합니다.

개념

노드란?

HY2 SCALE을 실행하는 모든 기기입니다. 각 노드는 다음을 가집니다:

• 자동 생성된 노드 ID (8자리 16진수)
• 설정 가능한 표시 이름 (예: sg-home)
• 기본 5565 포트에서 리슨하는 Hysteria 2 QUIC 서버
• 출구 노드 플래그 — 설정하면 피어가 이 노드를 통해 인터넷으로 트래픽을 라우팅할 수 있습니다
• 선택적 TUN 기능 — 라우팅 규칙과 TUN 모드 VPN 클라이언트를 위한 Raw IP 패킷 포워딩

노드는 공인 IP를 가진 클라우드 VPS, NAT 뒤의 홈 서버, NAS, 또는 .ipkg 번들을 통한 iKuai v4 라우터가 될 수 있습니다.

P2P 토폴로지

노드는 QUIC 터널을 통해 서로 직접 연결되며, 중앙 컨트롤 플레인이 없습니다.

위 예시는 싱가포르 홈 노드 (sg-home)가 열 개의 원격 노드와 피어링 중인 모습을 보여줍니다. 그중 세 개의 원격 피어는 중첩 검색을 통해 한 계층 더 깊은 서브 피어를 노출합니다.

연결 방향

• 아웃바운드 — 내가 피어에 대해 QUIC 연결을 시작합니다 (피어의 주소 + 서버 비밀번호가 필요합니다).
• 인바운드 — 피어가 나에게 QUIC 연결을 시작합니다.

연결된 후에는 양쪽 방향이 기능적으로 동일합니다. 방향은 단지 누가 누구의 주소를 알아야 하는지만 결정합니다.

두 가지 뷰, 하나의 토폴로지

노드 페이지에는 동등한 두 가지 표현이 있으며, 토폴로지 카드 상단의 툴바 탭으로 전환할 수 있습니다:

그래프 뷰 (기본)

• 팬, 휠 줌, 핀치 줌 (모바일 / 트랙패드)을 지원하는 인터랙티브 SVG 캔버스
• 모든 엣지에 왕복 지연 시간 (녹색 ≤ 100 ms, 황색 ≤ 200 ms, 그 외 빨간색)과 현재 처리량이 라벨로 표시됩니다
• 노드를 드래그해 재배치할 수 있으며, 레이아웃은 서버에 저장되어 로그인된 다른 모든 세션에 SSE로 동기화됩니다
• 목적지 점 (자기 자신의 self 점 포함)을 클릭하면 전체 릴레이 경로가 강조되고 하단에 브레드크럼이 나타납니다 — 브레드크럼의 각 비-self 홉은 클릭 가능한 링크로, 해당 prefix의 원격 뷰를 엽니다 (리스트 뷰의 노드 링크와 동일한 단축키).
• 네이티브 피어는 노란 점, 오프라인 피어는 연한 빨간 점으로 표시됩니다. 네이티브 피어에 닿는 엣지는 평상시 연노랑이며 선택 시 채도가 높아져 경로가 시각적으로 한 그룹으로 보이도록 합니다.
• 툴바 컨트롤: 뷰 리셋, 레이아웃 리셋 (확인 후), 격자 스냅

리스트 / 트리 뷰

• 들여쓰기와 via X 힌트로 깊이를 나타내는 정렬된 피어 트리
• 컬럼: 체크박스, 지연 시간, 방향 배지, 노드 이름 + 주소, 트래픽 업로드 / 다운로드 — 편집은 행별 작은 아이콘이 아닌 선택 상태로 구동됩니다 (아래 참고)
• 체크박스 셀 전체 영역 (패딩 포함)이 그 행 체크박스의 클릭 영역이며, 행 본문 클릭은 단독 선택 (단일 행 교체)으로 동작합니다

피어 추가 (아웃바운드)

+ Add Node 버튼은 두 가지 인터랙션을 지원합니다:

• 클릭 — 아래의 수동 폼을 엽니다.
• 길게 누르기 (≥ 600 ms) — hysteria2:// URL에서 가져오기 다이얼로그를 엽니다. hysteria2://[auth@]host[:port][?params]#name (또는 hy2:// 별칭)을 붙여넣을 수 있습니다. URL은 실시간으로 파싱되며 (host / port / password / SNI / insecure / mport / up / down / fastopen / pinSHA256), 미리보기로 가져올 결과를 보여줍니다. obfs / obfs-password는 조용히 삼키지 않고 「무시되는 필드」로 명시 표시됩니다.

수동 폼 필드:

필드	설명
노드 이름 (Node Name)	선택 사항. 비워두면 첫 번째 주소로 폴백됩니다. 온라인 hy2scale 피어를 편집할 때 잠깁니다 (라이브 QUIC 세션의 이름을 바꾸면 키 상태가 고아가 되므로). 네이티브 피어와 오프라인 항목은 항상 변경 가능합니다. /, 공백, 제어 문자는 거부합니다.
주소 (Address(es))	피어의 host:port — 하나 또는 다중 IP 집계를 위해 여러 개 입력. 포트 필드는 hy2 포트 호핑을 위해 쉼표 / 범위 리스트 (5000-6000, 5000,5001,5002)도 받습니다.
연결 모드	Direct (단일 주소), Quality (적응형 페일오버), Aggregate (주소 간 로드 밸런싱)
비밀번호	피어의 Hysteria 2 서버 비밀번호
Fast Open	TCP-Fast-Open 스타일의 0-RTT 요청 최적화 (토글)
Brutal	Hysteria 2 brutal 혼잡 제어 (토글, Fast Open 오른쪽에 붙음). 켜면 아래에 Upload / Download Mbps 입력이 나타나고, 끄면 입력이 숨겨지면서 이전 값은 비워져 의도치 않게 보내지 않도록 합니다.
BBR Profile	Standard / Conservative / Aggressive — Brutal과 독립적으로 동작하므로 토글 시 컬럼이 다시 흐트러지지 않습니다
SNI	TLS SNI (보통 호스트명)
Insecure	TLS 인증서 검증 건너뛰기
CA	피어 인증서 검증을 위한 PEM 인코딩 CA (선택)

Connect (생성) 또는 Save (편집)을 클릭합니다. 편집 모드에서는 Cancel과 Save 사이에 추가로 Export URL 버튼이 표시되며, 이 피어의 hysteria2://... 공유 URL을 클립보드로 복사합니다 (다중 주소 피어는 첫 주소로 폴백 — URL 표준에 다중 주소 슬롯이 없습니다). 클립보드 헬퍼는 HTTP-over-IP에서 숨겨진 textarea + execCommand('copy')로 폴백하므로, IP로만 도달 가능한 관리 노드도 정상적으로 동작합니다.

피어 수신 (인바운드)

인바운드 연결을 받으려면 노드의 주소 + 서버 비밀번호를 피어에게 공유하세요. 상대가 자신의 쪽에서 아웃바운드 피어로 추가합니다.

서버 비밀번호는 Edit Self 모달에서 확인할 수 있습니다 (자신의 노드를 선택한 뒤 Edit 버튼을 사용).

선택 및 편집

노드 페이지 (그리고 HY2 SCALE의 모든 다른 리스트 페이지)는 하나의 「먼저 선택, 그다음 작업」 패턴을 공유합니다:

• 행 본문 어디든 클릭하면 (또는 그래프의 점을 클릭하면) 그 노드를 단일 선택합니다 — 자신의 self 노드도 포함되며, 이 경우 Edit는 Edit Local Node 모달로 라우팅됩니다.
• 앞쪽 체크박스 셀을 클릭하면 (작은 입력이 아니라 패딩이 적용된 영역 어디든) 다중 선택 모드로 전환됩니다. 체크박스는 누적식입니다.
• 정확히 한 행이 선택되면 토폴로지 카드 우상단, Import와 + Add Node 사이에 녹색 Edit 버튼이 나타납니다. 아무것도 선택되지 않았거나 두 행 이상이 선택된 경우에는 숨겨지며, 단일 선택이 중첩된 서브 피어 (그 설정은 부모 노드에 있고 이 페이지에서 편집 불가)일 때도 숨겨집니다.
• 토폴로지 카드 본문 바깥의 빈 클릭 — 페이지 헤딩, 사이드바, 카드 사이 간격, 토폴로지 카드 자체의 헤더 스트립 — 은 단일 행 선택을 해제합니다. 다중 선택은 유지됩니다 (버튼 / 입력 / 열린 모달 위 클릭은 절대 선택을 풀지 않습니다).
• 일괄 작업 (활성화 / 비활성화 / 중첩 / 중첩 해제 / 삭제)은 한 행 이상이 선택되는 즉시 Edit 버튼 왼쪽에 표시됩니다.
• self 행은 특별 처리: 중첩 토글이 숨겨지고 (self에는 중첩 개념이 없음), 활성화 / 비활성화는 대칭을 위해 유지됩니다.

그래프 뷰에서 점을 선택하면 동일한 우상단 Edit 버튼이 부각됩니다 — 리스트와 그래프가 단일 편집 진입점을 공유합니다.

중첩 검색

중첩 검색을 사용하면 피어의 피어를 볼 수 있습니다 — 한 홉당 메시 한 단계 더 깊이.

각 홉은 해당 피어에 대한 로컬 nested 플래그로 게이팅됩니다:

• sg-home이 us에 중첩을 허용 → us의 피어가 us의 자식으로 표시됩니다
• sg-home이 us/us-east에도 중첩을 허용 → us-east의 피어가 손자로 표시됩니다
• 어떤 홉이든 끄면 그 아래의 모든 것이 UI와 라우팅 플레인에서 동시에 사라집니다

서로 다른 경로에서는 같은 표시 이름이 등장할 수 있지만 (예: A/B/D와 A/B/C/D는 공존 가능), 하나의 경로 안에서는 같은 이름이 두 번 나타날 수 없습니다. UI에서 볼 수 없는 노드는 다이얼할 수도 없습니다 — 표시와 라우팅은 동일한 권한 판정을 공유합니다.

활성화

• 피어를 열고 중첩을 토글 후 저장. 서브 피어가 한 번의 프로브 주기 안에 나타납니다.
• 더 깊은 레벨 (중첩의 중첩)은 각 중간 경로 세그먼트에 nested를 허용해야 합니다 — 서브 피어 행을 열고 그쪽에서도 중첩을 토글하세요.

Bond 집계 (다중 IP)

피어가 여러 주소를 노출할 때 (예: 두 개의 ISP), 모두 주소 항목에 추가하세요. 두 가지 집계 모드가 있습니다:

모드	동작
Quality	모든 링크를 지속적으로 프로빙하고 지연 시간이 가장 낮은 링크로 트래픽을 전달하며, 성능 저하 시 즉시 페일오버합니다
Aggregate	건강한 모든 링크에 걸쳐 패킷을 로드 밸런싱합니다 — 두 ISP의 대역폭을 합산합니다

Direct 모드는 단일 주소인 퇴화된 경우입니다.

네이티브 Hysteria 2 피어

HY2 SCALE은 릴레이 프로토콜을 지원하지 않는 일반 Hysteria 2 서버에도 연결할 수 있습니다. 이러한 서버는 [NATIVE] 배지와 함께 나타나고 직접 트래픽 라우팅을 지원하지만, 중첩 검색에는 참여할 수 없습니다.

토폴로지 표시자

배지 / 색상	의미
파란색 중심 점	자기 노드
노란 점 + 엣지	네이티브 (NATIVE) 피어 (일반 Hysteria 2) — 인접 엣지는 평상시 연노랑이며 선택 시 채도가 높아짐
연한 빨간 점	오프라인 / 도달 불가 피어
실선 엣지	연결됨, 정상
점선 / 희미한 엣지	연결 끊김 또는 도달 불가
지연 시간 라벨	엣지별 왕복 시간 (값에 따라 색상)
방향 배지 (OUT / IN / LOCAL)	연결 방향
[NATIVE] 배지	일반 Hysteria 2 피어
노란 버전 배지	피어가 다른 HY2 SCALE 버전 실행
빨간 × 마커	오프라인 / 도달 불가 피어

출구 라우팅

출구 노드가 활성화된 모든 노드는 트래픽을 인터넷으로 포워딩할 수 있습니다. 사용자별 또는 규칙별 exit_via 경로가 특정 트래픽을 노드 체인을 통해 라우팅합니다:

exit_via: "jp"                   # 한 홉
exit_via: "us/us-east"           # 두 홉
exit_via: "kr/kr-r1/kr-r1-a"     # 세 홉

UI의 자동완성은 현재 토폴로지를 기반으로 동작합니다 — 도달 가능하고 중첩이 허용된 경로만 제안됩니다.

메타데이터 교환

피어는 릴레이 프로토콜 위에서 작은 JSON 문서를 교환합니다:

• 노드 이름과 ID
• 버전 문자열
• 출구 노드 플래그
• 캐시된 서브 피어 목록 (중첩 검색용)
• 지연 시간 프로브

스키마는 확장 가능하므로 향후 기능을 프로토콜 호환성을 깨지 않고 배포할 수 있습니다.

릴레이 프로토콜 스트림

궁금한 분을 위한 내부 QUIC 스트림 ID:

스트림 프리픽스	용도
_relay_register_	노드 등록
_relay_s2c_ctrl_	서버→클라이언트 제어
_relay_list_peers_	피어 목록 교환
_relay_latency_	지연 시간 프로빙
_relay_via_*	라우트 제어
_relay_data_*	데이터 포워딩