XProxy 대시보드 보안: 비밀번호와 IP 화이트리스트

비밀번호, IP 화이트리스트, 도메인 전용 접속으로 XProxy 대시보드를 보호하세요. 설정은 General Settings → System Setting → Security에서 하며, SSH 비밀번호와 대시보드 포트도 같은 페이지에 있습니다.

필요한 것: 로컬 네트워크에서 열린 대시보드. 대시보드 비밀번호, IP 화이트리스트, 도메인 전용 접속은 Free 플랜을 포함한 모든 플랜에 들어 있습니다(요금제).

한눈에 보기

비밀번호부터

Dashboard Auth를 켜고 사용자 이름과 비밀번호를 설정하세요. IP 화이트리스트, Force LAN Auth, Tailscale 옵션은 모두 이 설정이 필요합니다.

접속할 수 있는 대상 좁히기

내 IP를 화이트리스트에 추가하거나, Domain Only를 켜서 IP 주소로 들어오는 방문을 거부하세요.

스스로 잠기지 않도록

설정은 한 번에 하나씩 바꾸세요. 창을 닫기 전에 대시보드가 여전히 열리는지 확인하세요.

대시보드는 어떻게 보호하나요?

무엇을 보호하시겠어요?

2단계 중 1단계

Dashboard Auth를 켜고 로그인 정보 설정하기

General Settings → System Setting을 열고 Security 탭을 클릭하세요. Password Authentication for dashboard에서 1 Dashboard Auth를 켭니다.

4 Username과 5 Password를 입력한 뒤 6 Save를 클릭하세요.

사용자 이름과 비밀번호는 함께 저장됩니다. 하나라도 비어 있으면 패널이 저장을 거부하고 무엇이 빠졌는지 알려 줍니다.

누가 XProxy 대시보드를 열 수 있나요?

box는 모든 방문을 아래 순서대로 확인합니다. 처음으로 맞는 규칙이 방문자를 들여보냅니다.

방문자	필요한 것
box 자체(localhost)	없음.
Tailscale 네트워크의 장치	없음. 단, Tailscale 스위치가 켜져 있을 때만.
올바른 사용자 이름과 비밀번호를 가진 사람	저장한 로그인 정보. 단, Dashboard Auth가 켜져 있을 때만.
로컬 네트워크의 장치(`192.168.x.x`나 `10.x.x.x` 같은 주소)	없음. 단, Force LAN Auth가 켜져 있으면 로그인 필요.
화이트리스트에 있는 IP 주소	없음. 단, IP Auth가 켜져 있을 때만.
그 밖의 모든 사람	거부됩니다. 패널이 401로 응답합니다.

VPS Forwarding을 거쳐 들어오는 방문에는 로컬 네트워크, 화이트리스트, Tailscale 예외가 적용되지 않습니다. 항상 사용자 이름과 비밀번호가 필요합니다.

Force API Auth와 Force LAN Auth는 무엇을 하나요?

스위치	끈 경우	켠 경우
Force API Auth (Basic auth for all API)	로테이션, 상태, 재부팅 링크가 어디서든 로그인 없이 작동합니다.	모든 API 호출에 로그인이 필요합니다. 로컬 네트워크의 장치, 화이트리스트 IP, (허용한 경우) Tailscale 장치는 여전히 로그인 없이 통과합니다.
Force LAN Auth (Enable when selling proxies)	로컬 네트워크의 장치는 로그인 없이 대시보드와 API를 엽니다.	해당 장치도 로그인이 필요합니다.

로테이션 링크와 상태 링크는 IP 변경 방법에서 설명합니다. 로그인 정보는 REST API와 같은 Basic 사용자 이름과 비밀번호입니다.

프록시 로그인과는 다릅니다. 대시보드 로그인은 패널을 보호합니다. 고객이 브라우저나 도구에 입력하는 사용자 이름과 비밀번호는 프록시의 것입니다. 프록시 설정을 참고하세요.

네, Tailscale로 가능합니다. box를 Tailscale에 연결하면 상태 옆에 Share Device to another Email 버튼이 나타납니다. 이 버튼은 Tailscale 관리 콘솔을 열며, 그곳에서 상대방의 이메일로 초대를 보냅니다. 자세한 방법은 Tailscale 또는 ZeroTier 원격 접속을 참고하세요.

오류 메시지는 무슨 뜻인가요?

표시되는 메시지	해야 할 일
Need enable Dashboard Authentication when filled Username/Password!	Dashboard Auth를 켜거나, 사용자 이름과 비밀번호를 지우세요.
Need fill Username/Password when enabled Dashboard Authentication!	사용자 이름과 비밀번호를 모두 입력하세요.
Need enable Password Authentication when Whitelist IP Authentication enabled!(Force LAN Auth와 Tailscale도 동일)	먼저 대시보드 로그인 정보를 저장하세요. 이 옵션들은 그 위에서 작동합니다.
403과 함께 Access Denied 페이지	Domain Only가 켜져 있습니다. IP 주소 대신 도메인 이름으로 대시보드를 여세요.
Current password is incorrect	SSH 비밀번호를 바꾸려면 선택한 사용자의 현재 Linux 비밀번호가 필요합니다.
Please choice the port in the range (80-65535)	80~65535 사이의 포트 번호를 고르세요.
API 호출에서 Unauthorized. Your IP: …	목록에 없는 IP에서 호출했습니다. 호출에 로그인 정보를 추가하거나, 해당 IP를 화이트리스트에 추가하세요.

FAQ

XProxy 대시보드에 비밀번호는 어떻게 설정하나요?

General Settings → System Setting → Security를 열고 Dashboard Auth를 켠 다음, 사용자 이름과 비밀번호를 입력하고 Save를 클릭하세요. 이제 로컬 네트워크 밖의 장치는 이 로그인 정보가 필요합니다.

인터넷에서 대시보드를 안전하게 열려면 어떻게 하나요?

최소한 비밀번호는 사용하세요. 사무실처럼 고정된 장소는 IP 화이트리스트에 추가하거나, Domain Only를 켜서 IP 주소로 들어오는 방문을 거부하세요. 포트를 열지 않고 Tailscale로 box에 접속하는 방법도 있습니다. box를 외부에 공개하려면 NAT 포워딩 또는 VPS Forwarding을 참고하세요.

IP 화이트리스트와 도메인 전용 접속은 어떻게 다른가요?

화이트리스트는 지정한 IP 주소를 비밀번호 없이 들여보냅니다. 도메인 전용은 누가 오든 IP 주소로 들어오는 방문을 모두 거부하고 도메인 이름만 허용합니다. 서로 다른 문제를 해결하므로 둘 다 사용할 수 있습니다.

프록시 box의 SSH 비밀번호는 어떻게 바꾸나요?

System Setting → Security → SSH Password Management를 사용하세요. 사용자를 고르고, 현재 비밀번호와 새 비밀번호를 두 번 입력합니다. 새 비밀번호는 6자 이상이어야 합니다.

대시보드 포트를 바꾸면 프록시 포트도 바뀌나요?

아니요. Default dashboard port(바꾸지 않았다면 80)는 패널과 API의 주소일 뿐입니다. 프록시 포트는 별개입니다. 프록시 설정을 참고하세요.

다음 단계는?

외부에서 box에 접속하거나, 코드로 호출하거나, 네트워크에서 box를 다시 찾아보세요.

Tailscale 원격 접속 →REST API →대시보드 열기 →프록시 로그인 및 화이트리스트 →

아직 해결되지 않았나요?기술자가 일회용 PIN으로 기기를 확인해 드립니다. Telegram으로 채팅하셔도 됩니다.

원격 지원 Telegram @xproxyio