Nodeboard 운영자 콘솔 가이드

Q: 노드 운영자는 자신의 노드에 어떤 사용자가 있는지 볼 수 있나요?

운영자는 자신이 소유한 노드에 대해 각 세션의 클라이언트 키(client_wallet), 터널 가상 IP, 바이트 수, 시각, 등급을 볼 수 있습니다. Nodeboard에서 클라이언트 공인 IP 주소, 목적지, DNS 쿼리, 트래픽 내용은 볼 수 없습니다.

Q: Kick이나 차단이 아직 적용되지 않은 이유는 무엇인가요?

Nodeboard는 명령을 대기열에 넣고, 노드가 이후 하트비트에서 이를 실행합니다. 노드의 Recent AeroNyx Commands에서 명령 상태를 확인하십시오. 상태는 pending에서 sent, executing을 거쳐 completed, failed 또는 timeout으로 바뀝니다.

Q: Capacity Decision waiting은 무슨 뜻인가요?

노드가 판단하기에 충분히 최신인 용량 텔레메트리를 보내지 않았다는 뜻입니다. 노드에서 status 또는 상태 점검을 실행하고 하트비트가 최신인지 확인하십시오. 텔레메트리가 계속 누락되면 노드를 업그레이드하거나 재시작하십시오.

Nodeboard(app.aeronyx.network)는 AeroNyx 노드 운영자가 노드를 등록하고, 상태와 용량을 모니터링하고, 노드별 정책을 설정하고, 자신이 소유한 노드의 VPN 세션을 관리하는 웹 콘솔입니다. 해당 노드에 대해 세션별 및 클라이언트 키별 트래픽 기록(바이트 수, 시각, 등급, 터널 주소)을 보여 주며, 운영자가 세션 연결을 끊고 클라이언트 키를 차단할 수 있게 합니다. 목적지, DNS 쿼리, 패킷 내용은 보여 주지 않습니다.

현재 모든 프로덕션 노드는 AeroNyx가 운영합니다. 노드를 운영하는 사람은 누구나 노드 운영자 정책을 따라야 합니다.

지갑. Phantom(Solana), MetaMask(Ethereum) 또는 OKX(Ethereum 또는 Solana)를 연결합니다. Nodeboard는 백엔드에 일회용 nonce를 요청하고 지갑에 서명을 요청합니다. 서명된 nonce는 사용자가 해당 지갑을 제어한다는 것을 증명하며, 비밀번호는 사용되지 않습니다.
휴대폰. Log in with your phone은 AeroNyx 앱으로 스캔할 QR 코드와 두 화면에서 비교할 짧은 코드를 표시합니다.

계정에서는 해당 계정에 등록된 노드만 볼 수 있습니다. 모든 노드 목록, 세션 목록, 결제 화면, 명령은 소유한 노드로 제한됩니다.

탐색

페이지	용도
Overview	노드군 요약: 전체 노드 수와 온라인 노드 수, 활성 세션, 트래픽, 가동 시간, 운영 요약, 클라이언트 배치 용량, 24시간 트래픽 및 결제 카드, Needs Attention, 최근 이벤트
Nodes	상태, 세션, 배치, 현재 작업이 표시되는 내 노드 목록. 각 항목을 누르면 노드 상세 페이지가 열립니다
Services	서비스별 노드군 전체 보기: 운영자 신호, 프로토콜 기반, 어니언 릴레이 풀 승인, 용량, 전송, 게이트웨이 DNS, 클라이언트 배치, 서비스 위험, 노드 준비 상태, 그리고 재시작 준비 상태, 대기열 및 결과 감사
Sessions	노드 상태와 활성 VPN 터널, 세션 품질, 세션 연결 해제 또는 클라이언트 키 차단 작업
Registration Codes	일회용 코드 생성, 설치 명령 복사, 설치 진행 상황 추적
Alerts / Events	이벤트 스트림과 Incident Closure
Traffic & Billing	노드별, 클라이언트 키별, 세션별, 일별 트래픽과 시간. 검색 및 CSV 내보내기 지원
Settings	노드별 배치와 정책, 노드군 프리셋, 정책 동기화와 감사, 언어
Chat	QR 코드로 앱과 페어링하는 AeroNyx 웹 채팅을 엽니다. 노드 운영과는 별개입니다.

Nodeboard가 사용자에 대해 보여 주는 정보

등록된 각 VPN 노드는 세션이 진행되는 동안과 종료될 때 모든 VPN 세션을 AeroNyx 백엔드에 보고합니다. Nodeboard는 이 기록을 노드 소유자에게 보여 줍니다.

데이터	표시 위치
세션 ID	Sessions, Traffic & Billing → Sessions, 노드 상세 → Recent Sessions
클라이언트 키(`client_wallet`): 앱이 VPN 핸드셰이크에서 사용하는 공개 키입니다. 세션이 바뀌어도 동일하게 유지되므로, 한 사용자의 세션들을 시간에 걸쳐 연결합니다. 표에서는 축약되어 표시되며, 검색할 수 있고 내보내기 시에는 전체가 포함됩니다.	Sessions(Client 열), Traffic & Billing → Identities 및 Sessions
백엔드가 클라이언트 키에 대해 찾은 멤버십 등급(없으면 `unknown`)	Traffic & Billing → Identities 및 등급별 분류
터널 가상 IP(VPN 내부의 주소, 예: `100.64.0.0/22` 내)	Sessions, Traffic & Billing → Sessions
수신 및 송신 바이트, 세션 수, 지속 시간	노드별, 클라이언트 키별, 세션별, 일별
클라이언트 키별 최초 확인 및 최종 확인 시각, 세션별 시작, 종료, 마지막 활동 시각	Traffic & Billing, Sessions
링크 품질: 왕복 시간, 패킷 손실, keepalive 결과, 마지막 오류	Sessions, Traffic & Billing → Sessions

Traffic & Billing은 최근 7일, 14일, 30일, 60일 또는 90일을 다룹니다. Export CSV는 현재 탭의 행을 다운로드하며, 탭에 해당 정보가 있으면 전체 클라이언트 키와 가상 IP도 포함됩니다.

노드가 보고하지 않고 Nodeboard가 보여 주지 않는 것: 클라이언트 공인 IP 주소, 목적지 주소나 도메인, DNS 쿼리, URL, 패킷이나 메시지 내용, 개인 키. 채팅 릴레이, 디스커버리, 프로토콜 패널은 집계 카운터만 보여 줍니다.

노드 호스트는 별개의 문제입니다. VPN 노드는 사용자 트래픽의 출구이므로, 서버에 root 권한이 있는 사람은 Nodeboard에 무엇이 표시되든 다른 VPN 서버에서와 같은 방식으로 그 트래픽을 관찰할 수 있습니다. 운영자가 할 수 있는 일은 노드 운영자 정책이 규정합니다. AeroNyx 자체가 이 데이터를 어떻게 다루는지는 Trust Center를 참조하십시오.

운영자의 책임

세션 및 클라이언트 키 데이터는 노드 운영자 정책이 허용하는 대로, 서비스를 운영하고 보호하고 과금하는 용도로만 사용하십시오.
CSV 내보내기 파일은 개인 데이터로 취급하십시오: 필요한 기간 동안만 보관하고, 안전하게 저장하며, 공유하지 마십시오.
클라이언트 키나 가상 IP를 특정 인물과 연결하려 하지 말고, 호스트에서 사용자 트래픽을 검사, 기록 또는 보관하지 마십시오.
세션 연결 해제와 클라이언트 키 차단은 운영상 또는 남용 대응 사유가 있을 때만 하고, 그 이유를 기록하십시오.
로그인용 지갑, 휴대폰, 서버 자격 증명을 안전하게 관리하십시오.

노드 등록

Registration Codes를 열고 Generate Code를 선택합니다. 코드는 15분 동안 유효하며 한 번만 사용할 수 있습니다.
Quickstart command(또는 단계별 미리 보기 및 설치 명령)를 복사하여 서버에서 root로 실행합니다. 코드를 셸 기록에 남기지 않는 방법을 포함한 전체 절차는 AeroNyx 노드 설치 및 등록에 있습니다.
Install Progress를 따라갑니다: not_started → planning → running → completed | failed. 단계 표시는 설치 프로그램이 어디에 있는지(계획, 사전 점검, 의존성, 저장소, 구성, 네트워크, 빌드, systemd, 등록, 시작, 완료) 보여 줍니다. 실패 시에는 실패한 단계와 종료 코드를 보여 줍니다.

코드 상태는 Available, Used, Expired, Revoked입니다. 코드가 만료되면 Nodeboard는 해당 설치 명령을 숨깁니다. AI assistant prompt에는 코드 자체가 포함되어 있으므로, 그 프롬프트를 공유하면 코드도 공유됩니다.

개요와 우선순위 판단

Overview에서 시작하십시오. 노드군 통계, 운영, 배치, 결제 카드는 각각 마지막으로 업데이트된 시각을 표시합니다. 새로 고침이 실패하면 이전 데이터를 유지하고 그 사실을 표시합니다. "이벤트 없음"과 "이벤트를 불러올 수 없음"은 서로 다르게 표시되며, 누락된 데이터는 0으로 표시되지 않습니다.

합리적인 확인 순서:

오프라인 노드 또는 오래된 하트비트.
실패했거나, 시간 초과되었거나, 오래된 명령.
유지 관리 중인데 아직 활성 세션이 있는 노드.
용량 압박: IP 풀, 파일 디스크립터, 연결 추적, 패킷 드롭, 대역폭, 디스크, 메모리, CPU.
아직 동기화되지 않은 정책.
디스커버리 또는 릴레이 준비 상태 문제.

노드와 노드 상세

노드 상세 페이지는 근거 정보를 여러 섹션으로 묶어 보여 줍니다. Node Details, Hardware Info, AeroNyx Health, Rust Runtime(버전, 커밋, 가동 시간), Node Capacity, AeroNyx Privacy Protocol, Node Discovery, Encrypted Chat Relay, Service Configuration, Install Workflow, Rust Upgrade Workflow, Maintenance Drain, Bandwidth Limit, Policy Enforcement, Recent Sessions, Wallet Ban Policies, Recent AeroNyx Commands, Recent AeroNyx Events, Recent Operational Events(최근 24시간의 정제된 서비스 경고), 그리고 복사 가능한 명령이 있는 Operator Runbook이 포함됩니다.

Capacity Decision

Capacity Decision은 노드가 새 사용자를 받아야 하는지에 답합니다. IP 풀, 정책의 최대 세션 수, 노드 자체의 승인 상태를 결합하여 남은 사용자 슬롯 수를 보수적으로 산출하고, 주요 병목을 명시합니다.

상태	의미
`ready`	현재 텔레메트리 기준으로 노드가 새 세션을 받을 수 있습니다
`watch`	노드가 세션을 받을 수 있지만, 주의가 필요한 리소스가 있습니다
`blocked`	노드가 새 세션을 받아서는 안 됩니다. 예를 들어 서비스가 비활성 상태이거나 노드 자체의 승인 점검이 차단된 경우입니다
`waiting`	용량 텔레메트리가 없거나 판단하기에 충분히 최신이 아닙니다

Sessions: 연결 해제와 차단

Sessions는 활성 및 최근 VPN 터널을 노드, 클라이언트 키, 상태, 지속 시간, 트래픽, 품질, 마지막 활동과 함께 나열합니다. 세션 ID, 클라이언트 키 또는 가상 IP로 검색할 수 있습니다. 품질은 healthy, degraded, stale, error, pending 또는 completed입니다.

Kick은 세션 하나의 연결을 끊는 kick_session 명령을 대기열에 넣습니다.
Ban Wallet은 해당 노드에서 클라이언트 키를 차단하고 일치하는 터널의 연결을 끊는 ban_wallet 명령을 대기열에 넣습니다.
Unban은 노드 상세 페이지의 Wallet Ban Policies 아래에 있습니다(unban_wallet).

각 작업은 확인을 요청하며, 먼저 최신 세션 스냅샷이 여전히 일치하는지 확인합니다. 노드가 이후 하트비트에서 명령을 실행하기 전까지는 아무것도 바뀌지 않으므로, 그때까지 터널은 유지됩니다.

Traffic & Billing

탭: Nodes, Identities(클라이언트 키별), Sessions, Daily. 필터: 일수, 세션 상태, 노드, 그리고 클라이언트 키 또는 세션 ID 검색. 요약 카드에는 트래픽, 활성 세션, 계정의 월간 할당량과 바우처 시간, 바우처 발급 현황이 표시됩니다. 필드는 위의 "Nodeboard가 사용자에 대해 보여 주는 정보"에 나와 있습니다.

설정과 정책

각 노드별 설정: 지역 코드, AeroNyx 출구 풀에 제공되는지 여부, 노드 등급(public 또는 premium), 하트비트 간격, 최대 세션 수, Mbps 단위 대역폭 제한, Maintenance Mode. Maintenance Mode는 기존 세션이 비워지는 동안 새 세션을 중단합니다.

정책은 하트비트를 통해 노드에 전달됩니다. 저장하면 노드의 명령 기록에 apply_policy 명령이 나타나고, 노드가 이를 확인하면 Policy Sync가 pending 또는 unknown에서 synced로 바뀝니다. Fleet Presets는 하나의 정책을 여러 노드에 적용하고 어떤 노드에 주의가 필요한지 보고합니다. Recent Settings Audit은 최근 30일간의 정책 변경을 보여 줍니다.

명령

명령은 Nodeboard가 노드에 작업을 요청하는 방법입니다. 명령은 소유자 범위로 제한되고, 기록되며, 노드의 다음 하트비트 응답으로 전달됩니다.

작업	효과
`system_info`, `collect_logs`	호스트 정보 또는 로그 수집
`refresh_config`, `apply_policy`	구성 새로 고침 또는 현재 정책 확인
`two_hop_smoke`	노드의 로컬 2홉 릴레이 점검을 실행하고 집계 카운터를 반환
`kick_session`, `ban_wallet`, `unban_wallet`	세션 및 클라이언트 키 작업
`restart_service`	`aeronyx-server` 서비스 재시작

수명 주기: pending → sent → executing → completed | failed | timeout. 아직 pending 또는 sent 상태인 명령은 취소할 수 있습니다. 백엔드 제한 시간(기본 300초)을 넘어서도 sent 또는 executing 상태로 남아 있는 명령은 timeout으로 표시됩니다. 한 노드에 같은 종류의 활성 명령이 두 개 있을 수 없습니다.

Nodeboard에서 노드 재시작

restart_service는 노드의 모든 사용자 연결을 끊습니다. Services → Fleet Restart Readiness는 롤아웃 재시작이 필요하고, Maintenance Mode가 켜져 있으며, 활성 세션이 0으로 비워진 경우에만 노드를 재시작 준비 완료로 취급합니다. Restart Action Queue는 Enable maintenance, Queue restart, Cancel command를 제공합니다. 명령 API는 명시적인 재시작 확인을 요구하지만, 자체적으로 세션을 확인하지는 않으므로 먼저 세션을 비우십시오. 재시작 후 Maintenance Mode를 끄기 전에 최신 하트비트, 새 런타임 버전, 상태 점검, 정책 동기화를 확인하십시오. 업그레이드는 서버에서 업그레이드 워크플로로 실행합니다. AeroNyx 노드 운영 및 점검을 참조하십시오.

Alerts / Events와 Incident Closure

Event Stream은 노드 상태, 세션 오류, 운영자 명령, 정책 변경을 일수, 심각도, 유형, 노드로 필터링하여 나열합니다.

Incident Closure는 선택한 기간의 관련 이벤트를 그룹으로 묶고, 각 그룹에 영향 설명, 권장 조치, 복구 상태를 부여합니다.

상태	의미
`open`	조치가 필요한 이벤트를 아직 검토해야 합니다
`watch`	현재 차단 요인은 없지만 문제가 반복되었습니다
`recovered`	최신 이벤트가 복구를 나타내거나, 정보성 이벤트입니다

명령이 완료되었다는 것만으로는 종결이 아닙니다. 하트비트가 최신이고, 상태 점검과 정책 동기화가 복구되었으며, 영향받은 용량 또는 릴레이 신호가 돌아왔을 때 인시던트를 종결하십시오.

코드와 자격 증명은 서로 대체할 수 없습니다

자격 증명	용도
등록 코드	노드 하나를 계정에 등록합니다. 1회 사용, 15분.
지갑 서명 또는 휴대폰 로그인	Nodeboard에 로그인합니다
익명 VPN 바우처	앱 사용자가 서비스를 이용할 수 있음을 증명하게 해 줍니다. 운영자 자격 증명이 아닙니다

코드, 개인 키, 복구 자료를 이벤트, URL, 스크린샷, 지원 티켓에 절대 넣지 마십시오.

자주 묻는 질문

노드 운영자는 자신의 노드에 어떤 사용자가 있는지 볼 수 있나요?

운영자는 자신이 소유한 노드에 대해 각 세션의 클라이언트 키(client_wallet), 터널 가상 IP, 바이트 수, 시각, 등급을 볼 수 있습니다. Nodeboard에서 클라이언트 공인 IP 주소, 목적지, DNS 쿼리, 트래픽 내용은 볼 수 없습니다.

Nodeboard에는 어떻게 로그인하나요?

Phantom, MetaMask 또는 OKX로 일회용 nonce에 서명하거나, AeroNyx 앱으로 QR 코드를 스캔하여 로그인합니다. 비밀번호는 없습니다.

Kick이나 차단이 아직 적용되지 않은 이유는 무엇인가요?

Nodeboard는 명령을 대기열에 넣고, 노드가 이후 하트비트에서 이를 실행합니다. 노드의 Recent AeroNyx Commands에서 명령 상태를 확인하십시오. 상태는 pending에서 sent, executing을 거쳐 completed, failed 또는 timeout으로 바뀝니다.

Capacity Decision `waiting`은 무슨 뜻인가요?

노드가 판단하기에 충분히 최신인 용량 텔레메트리를 보내지 않았다는 뜻입니다. 노드에서 status 또는 상태 점검을 실행하고 하트비트가 최신인지 확인하십시오. 텔레메트리가 계속 누락되면 노드를 업그레이드하거나 재시작하십시오.

사용자 연결을 끊지 않고 Nodeboard에서 노드를 재시작할 수 있나요?

아니요. 재시작은 노드의 모든 세션 연결을 끊습니다. Maintenance Mode를 켜고, 활성 세션이 0이 될 때까지 기다린 다음, 재시작을 대기열에 넣으십시오.

CSV 내보내기 파일은 개인 데이터인가요?

예. 전체 클라이언트 키, 가상 IP, 사용 시각이 포함되어 있습니다. 노드 운영자 정책에 따라 취급하고 필요한 기간 동안만 보관하십시오.

로그인

탐색