🌐 English | 中文 | 한국어

사용자

HY2 SCALE의 모든 프로토콜에 대한 인증과 사용자별 출구 라우팅을 하나의 사용자 데이터베이스가 담당합니다.

모든 프로토콜에서 공유

여기에서 사용자를 추가하면 해당 자격 증명이 다음에서 작동합니다:

• Hysteria 2 서버 (Allow User Auth가 켜졌을 때)
• SOCKS5 (RFC 1929 사용자명/비밀번호)
• HTTP 프록시 (Basic auth)
• Shadowsocks (비밀번호에서 유도된 AEAD 키)
• L2TP/IPsec (MSCHAPv2)
• IKEv2/IPsec (EAP-MSCHAPv2)

WireGuard만 별도의 인증 모델을 사용합니다 — 각 WireGuard 피어는 공개키 인증을 사용하는 Proxies → WireGuard 탭에서 관리됩니다.

사용자별 프록시 인증 — 프로토콜마다 켜고 끄기

사용자 편집 모달의 Proxy Auth 탭은 공유 인증을 사용하는 6개 프록시 — hy2, ss, socks5, http, l2tp, ikev2 — 를 모두 나열하며, 각 행에 활성화 토글이 있습니다. 한 행을 끄면 그 프로토콜에 한해 해당 사용자의 접근이 취소되며, 나머지는 그대로 동작합니다. 비밀번호만으로 인증하는 프록시 (hy2, ss)는 토글 오른쪽에 비밀번호 재정의 입력이 붙어 있고 토글이 꺼지면 입력이 비활성화됩니다 (입력을 비워두면 여전히 메인 비밀번호 사용을 의미합니다).

토글은 즉시 적용됩니다: 사용자의 proxy_disabled를 PUT하면 라이브 설정이 조정되고, 각 프로토콜의 다음 인증 시도에서 해당 항목을 참조합니다 (hy2 / ss는 비밀번호 시도 시점에 검사, socks5 / http는 LookupUser를 통해, l2tp / ikev2는 chap-secrets / ipsec.secrets를 다시 써서 pppd / strongSwan이 서비스 재시작 없이 변경을 반영합니다). 목록 변경은 그 사용자명으로 진행 중인 세션도 끊어내, 이전에 허용되던 프로토콜이 토글이 닫힌 뒤에도 기존 터널로 살아남지 못하게 합니다.

필드

필드	설명
사용자명	로그인 이름 — 전체 사용자 목록에서 고유해야 합니다
비밀번호	전송 전 클라이언트에서 SHA-256으로 해시됩니다
Exit via	사용자별 메시 출구 경로 (아래 참고)
트래픽 제한 (GB)	월별 할당량 — 0이면 무제한
만료일	선택적 만료 타임스탬프. 이후 사용자가 비활성화됩니다
활성화	토글

사용자별 출구 라우팅

exit_via는 노드 표시 이름 (또는 노드 ID)의 /로 구분된 체인입니다. 싱가포르 기반 홈 메시의 예시:

exit_via	트래픽 흐름 …
(비어있음)	sg-home에서 직접 나감
jp	sg-home → jp → 인터넷
us/us-east	sg-home → us → us-east → 인터넷
kr/kr-r1/kr-r1-a	sg-home → kr → kr-r1 → kr-r1-a → 인터넷

사용자 편집 모달의 자동완성은 실시간 토폴로지를 기반으로 합니다 — 중첩 권한이 통과되는 도달 가능한 경로만 제안됩니다.

출구 모드

exit_paths를 여러 개 제공하면 모드를 선택할 수 있습니다:

모드	동작
Direct	단일 경로, 목록의 첫 번째
Quality	적응형 페일오버 — 지연 시간이 가장 낮은 경로를 사용하고 성능 저하 시 페일오버
Aggregate	모든 경로에 걸쳐 로드 밸런싱

트래픽 집계

각 사용자는 롤링 업로드 / 다운로드 카운터를 가집니다. 진행 막대는 할당량의 80 %에서 황색, 100 %에서 빨간색으로 변합니다. 100 %에 도달하면 사용자는 카운터를 리셋하거나 할당량을 올릴 때까지 소프트 비활성화됩니다.

트래픽 리셋은 일괄 작업입니다 — 사용자를 선택한 뒤 일괄 작업 바의 트래픽 리셋을 사용하세요.

활성 기기

사용자 목록 아래의 Active Devices 패널은 (사용자명 + 클라이언트 IP + 프로토콜)로 키가 지정된 모든 실시간 세션을 보여줍니다:

• 세션별 업로드 / 다운로드 처리량
• 프로토콜 배지
• 해당 세션이 출구로 사용 중인 노드
• Kick — 세션을 종료하고 60초 동안 재연결을 차단 (rate-limit 루프)

선택 및 편집

사용자 페이지는 Nodes / Rules / TLS와 동일한 「먼저 선택, 그다음 작업」 패턴을 따릅니다:

• 사용자 행을 단일 클릭하면 선택됩니다 — 사용자 카드 우상단, Import와 + Add User 사이에 녹색 Edit 버튼이 나타납니다.
• 앞쪽 체크박스 셀이 확장되어 있어 패딩이 적용된 영역 어디든 클릭하면 박스가 토글됩니다. 행 본문 클릭은 단독 선택 (단일 행 교체)입니다.
• 카드 본문 바깥의 빈 영역 클릭은 단일 행 선택을 해제합니다. 다중 선택은 유지됩니다. 버튼 / 입력 / 열린 모달 위 클릭은 절대 선택을 풀지 않습니다.

각 행의 사용자명 텍스트는 여전히 사용자별 공유 URL 상세 모달 (hy2 / ss / socks5 / http 연결 URL 목록)을 여는 링크입니다. 이 링크를 클릭해도 행 선택은 토글되지 않습니다.

일괄 작업

여러 사용자를 체크해 일괄 작업 바를 노출합니다:

• 활성화 / 비활성화
• 트래픽 리셋
• 삭제

좁은 뷰포트에서는 바가 ⋯ 오버플로 메뉴로 접힙니다.

가져오기 / 내보내기

• 내보내기 — 모든 사용자를 포함하는 JSON 파일 (비밀번호는 해시됩니다. 내보내기가 비밀번호 덤프는 아닙니다)
• 가져오기 — JSON 파일에서 사용자를 일괄 생성합니다. 사용자명으로 기존 사용자를 업데이트합니다

일반적인 용도: 두 번째 HY2 SCALE 배포에 사용자 목록을 복사.

API

프로그래밍 방식의 엔드포인트 (일괄 트래픽 리셋, 세션 킥 포함)는 API 레퍼런스 → Users를 참고하세요.