BoxPilot

다중 프로필 관리

원격 구독 URL과 로컬 JSON 파일 두 가지 형태의 설정을 추가, 수정, 삭제, 전환할 수 있습니다. 각 구독은 독립적인 자동 갱신 주기를 지정하여 설정을 유지할 수 있습니다.

연결 제어

Home 페이지의 큰 원형 버튼으로 sing-box를 시작하거나 중지할 수 있으며, 연결 상태는 ‘연결 해제 / 시작 중 / 연결됨’ 세 가지 상태로 시각화됩니다.

이중 프록시 모드

TUN과 Mixed inbound 간에 전환할 수 있으며, 시스템 프록시(레지스트리) 활성화 여부도 버튼 하나로 제어할 수 있습니다.

프록시 그룹 및 노드 선택

selector 그룹은 수동으로 노드를 선택할 수 있게 하며, urltest 그룹은 자동 라우팅 기능을 제공합니다. 노드의 프로토콜 종류가 표시되며 그룹 단위로 지연 테스트를 수행할 수 있습니다.

실시간 모니터링

실시간으로 상향/하향 트래픽 속도를 확인할 수 있고, 로그 탭에서는 All / Warn / Error 단위로 필터링하거나 드래그하여 복사할 수 있습니다. 로그 버퍼는 최대 1000개입니다.

딥링크 및 편의 기능

브라우저에서 sing-box://import-remote-profile 링크를 클릭하면 구독을 바로 추가할 수 있습니다. 로컬 프록시 포트(기본 7788)와 Clash API 포트(기본 7789)는 설정 페이지에서 변경 가능하며, PowerShell/WSL용 프록시 환경변수를 한 번에 복사하는 기능도 제공됩니다. 모든 구성과 설정은 자동으로 영구 저장됩니다.

설치 방법

GitHub Releases 페이지에서 MSI 설치 패키지(권장) 또는 box-pilot.exe 단일 파일을 다운로드할 수 있습니다. MSI 설치 시 sing-box.exe가 함께 포함되며 sing-box:// / boxpilot:// 링크 프로토콜이 자동으로 등록됩니다.

winget 패키지 관리자를 사용하는 경우 다음 명령으로 설치할 수 있습니다.

winget install --id Glide01.BoxPilot --exact

box-pilot.exe 단일 파일을 사용하는 경우 별도의 sing-box.exe를 같은 폴더에 두어야 하며, 링크 프로토콜 등록은 지원되지 않습니다.

기본 사용 절차

1. BoxPilot을 실행하고 UAC 승격 요청에 동의합니다.
2. Profiles 페이지에서 + Add 버튼으로 프로필을 추가합니다. 구독 URL을 붙여 넣거나 로컬 JSON 파일을 선택하거나, 브라우저의 sing-box:// 임포트 링크를 사용할 수 있습니다.
3. Home 페이지로 돌아와 큰 원형 버튼을 눌러 sing-box에 연결합니다.
4. Proxy Mode(TUN / Mixed)와 System Proxy 스위치로 프록시 동작 방식을 제어합니다.
5. Groups 페이지에서 노드를 선택하거나 지연을 측정하고, Logs 페이지에서 sing-box 실시간 출력을 확인하며, Settings 페이지에서 포트 변경과 캐시 삭제를 수행합니다.

활용 예시

여러 원격 구독을 등록해 두고 상황별로 빠르게 전환해 사용하거나, TUN 모드와 시스템 프록시를 조합해 PC 전체 트래픽을 단일 인터페이스에서 일괄 제어할 수 있습니다. 로그와 트래픽 속도를 같은 창에서 실시간으로 확인할 수 있어 연결 상태를 점검하는 용도로도 적합합니다.

제한 및 라이선스 확인사항

BoxPilot 본체는 MIT 라이선스로 배포됩니다. MSI에 함께 포함된 sing-box.exe는 SagerNet/sing-box의 공식 릴리스 바이너리로 자체 GPL-3.0-or-later 라이선스를 따릅니다. 고급 명령줄 옵션은 GUI에서 직접 다루지 않을 수 있으며, 필요한 경우 설정 파일을 수동으로 편집해야 합니다.

Windows 방화벽이나 보안 소프트웨어가 sing-box의 네트워크 접근을 차단할 수 있으므로 예외 규칙을 확인해야 합니다.

소스 빌드 안내

Windows 전용으로 빌드되며, GPUI의 Windows 백엔드가 DirectX 11 + MSVC를 사용하므로 MinGW 크로스 컴파일은 지원되지 않습니다.

cargo build --release --target x86_64-pc-windows-msvc

릴리스산(exe + MSI)은 GitHub Actions의 release.yml 워크플로에 의해 빌드되며, 번들되는 sing-box 버전은 저장소 변수 SINGBOX_VERSION으로 고정됩니다.