OnionHop V3

OnionHop V3는 크로스 플랫폼 데스크톱 앱(Windows, macOS, Linux)으로, 사용자의 트래픽을 Tor를 통해 라우팅합니다. Tor를 로컬 SOCKS 프록시 또는 시스템 전체 터널로 실행할 수 있으며, Smart Connect를 통해 네트워크에 맞는 작동 연결 전략을 자동으로 선택하고, 검열된 네트워크에서 모든 전송 방식에 대해 작동하는 브리지를 스캔 및 적용하며, Snowflake 프록시로 자원봉사할 수도 있습니다.

면책 조항 OnionHop은 "있는 그대로" 제공됩니다. Tor 사용은 일부 국가에서 불법이거나 제한될 수 있습니다. 귀하는 현지 법률 및 규정을 준수할 책임이 있습니다.

V3의 새로운 기능 (v2.7 이후)

V3는 새로운 크로스 플랫폼 UI 스택 위에 완전히 재구축되었으며, 훨씬 더 스마트한 연결 엔진과 훨씬 더 광범위한 검열 저항 전송 방식을 갖추고 있습니다.

• 이제 크로스 플랫폼 — Windows, macOS(서명 및 공증된 유니버설 앱) 및 Linux(AppImage)용 네이티브 데스크톱 빌드를 지원합니다. 각 OS에서 동일한 앱, 네이티브 모양.
• 재설계된 UI — Fluent/네이티브 모양(FluentAvalonia), 밝음/어두움/시스템 테마, 액센트 선택기, Windows에서 통합 크롬리스 제목 표시줄 및 macOS에서 네이티브 윈도우 크롬, 8개 언어(영어, 독일어, 프랑스어, 중국어, 러시아어, 페르시아어, 아제르바이잔어, 소라니 쿠르드어)를 지원합니다.
• Smart Connect — 네트워크 및 국가에 가장 적합한 연결 전략을 자동으로 선택하는 오프라인 검열 "브레인": Tor가 차단된 위치를 인식하고, 해당 지역에서 생존하는 전송 방식을 선호하며, 브리지 연결 가능성을 사전 테스트하고, 전략을 병렬로 경쟁시키며, 죽은 경로에서 빠르게 실패하고, 각 네트워크에서 작동했던 방식을 기억하여 다음 연결이 즉시 이루어지도록 합니다.
• 세 가지 Tor 엔진 — Classic(tor.exe, 완전한 제어: 브리지, 국가/진입/종료 고정, 제어 포트 New Identity), Arti(네이티브 브리지/PT 구성을 갖춘 Rust Tor 구현), ArtiHop(더 낮은 지연 시간을 위해 단축된 2홉 Guard→Exit 회로).
• 더 많은 검열 저항 전송 방식 — obfs4, snowflake(선택적 AMP-캐시 프론팅 포함), webtunnel, conjure, meek, dnstt(DNS만 허용될 때 Tor를 통과시키는 DNS 터널).
• 브리지 스캐너 — 모든 전송 방식의 브리지를 가져와 연결 가능성 테스트, 색상 코드 지연 시간 확인, 네트워크에서 실제로 작동하는 브리지를 한 번 클릭으로 적용할 수 있습니다.
• 더 많은 브리지 소스 — 공식 Tor 브리지 서비스, 검열 저항 OnionHop Bridges Collector(Delta-Kronecker/Tor-Bridges-Collector에서 파생), 내장 커뮤니티 브리지, 소규모 실시간 가져오기가 번들 브리지로 자동 백업되도록 하는 소량 추가 집합.
• 릴레이 브라우저 — 닉네임, 국가, 역할, 플래그 및 대역폭으로 라이브 Tor 릴레이 목록을 검색하고 선호하는 진입/중간/종료 릴레이를 고정할 수 있습니다.
• 명령줄 인터페이스 — 라이브 상태 대시보드, connect/scan/bridges/snowflake/relays 명령 및 설정 지속성을 갖춘 완전한 기능의 TUI(OnionHopV3.Cli). Windows, Linux 및 macOS 패키지는 CI에서 빌드됩니다.
• 더 강력한 누출 방지 — 선택적 전체 DNS-over-Tor, 킬 스위치, TUN 모드에서 UDP 차단, 인앱 WebRTC/UDP 개인정보 보호 알림.
• Snowflake 프록시로 자원봉사 — 설정에서 검열된 사용자가 Tor에 도달할 수 있도록 도울 수 있습니다.
• 삶의 질 향상 — 분리된 시스템 프록시 토글(Tor가 연결된 상태에서 끌 수 있음), TUN 모드에서 반복적인 UAC 프롬프트를 건너뛰기 위한 선택적 영구 관리자 도우미(기본적으로 꺼짐), 인앱 변경 로그, 비트코인 기부 지원.

다운로드

플랫폼에 맞는 최신 빌드를 Releases 에서 받으세요:

macOS .dmg는 전용 코드 서명 저장소인 rana-gmbh/onionhopMac에서 게시됩니다.

시작하기

1. 설치 — 위의 OS에 맞는 빌드를 설치합니다. Windows 설치 프로그램과 macOS/Linux 번들은 자체 포함되어 있으며 .NET 9 런타임이 번들로 제공됩니다.

2. 모드 선택

   • 프록시 모드(권장, 관리자 권한 불필요): Tor를 로컬에서 실행하고 OS 시스템 프록시를 Tor의 로컬 SOCKS5 엔드포인트로 지정합니다. 프록시 인식 앱에 가장 적합한 호환성을 제공합니다.
   • TUN/VPN 모드(관리자 권한 필요): sing-box를 통해 시스템 전체 라우팅(Windwos에서는 Wintun, macOS/Linux에서는 시스템 TUN 사용); 프록시 설정을 무시하는 앱에 필요합니다. 누출 방지(DNS는 Tor를 통해, UDP 차단).

3. 연결

   • Smart Connect를 켜두면 OnionHop이 자동으로 최상의 전략을 선택합니다. 또는 Tor 엔진 / 종료 위치 / 브리지를 직접 선택할 수 있습니다.
   • 검열된 네트워크에서는 브리지를 활성화하거나 스캐너를 열어 해당 지역에서 작동하는 브리지를 찾으세요.
   • 연결을 클릭하세요.

참고

• .onion 사이트는 Tor 인식 클라이언트(Tor 브라우저 권장) 또는 SOCKS 원격 DNS(예: Firefox의 "SOCKS v5 사용 시 프록시 DNS")가 필요합니다.
• 국가/릴레이 고정 및 제어 포트 New Identity 기능은 Classic 엔진이 필요합니다. Arti와 ArtiHop은 OnionHop 브리지/PT 구성을 지원하지만, 수동 회로 제어에는 Classic이 가장 완벽한 선택입니다.

Tor 엔진

국가 고정, 릴레이 고정 또는 제어 포트 New Identity가 필요한 경우 Classic을 사용하세요. Rust 런타임을 원하고 Classic 전용 제어 기능이 필요하지 않은 경우 Arti 또는 ArtiHop을 사용하세요.

모드 설명

프록시 모드 (권장)

Tor를 로컬에서 실행하고 OS 프록시를 Tor의 SOCKS5 엔드포인트로 설정합니다. 관리자 권한이 필요하지 않습니다. Tor 연결을 끊지 않고 시스템 프록시를 전환할 수 있습니다.

TUN/VPN 모드 (관리자 권한 필요)

Tor + sing-box를 실행하고 OS 수준에서 트래픽을 라우팅합니다(Windwos에서는 Wintun, macOS/Linux에서는 시스템 TUN). 관리자 권한이 필요합니다. 가장 누출 방지에 효과적입니다.

하이브리드 (분할 터널링)

TUN/VPN 모드에서만 가능 — 선택한 앱만 Tor를 통해 라우팅하고 나머지는 직접 연결합니다.

권한

• 네트워크 접근 — IP 확인, Onionoo 릴레이/국가 데이터, GitHub 릴리스 메타데이터, 브리지 소스 및 종속성 다운로드.
• 관리자 / 루트 — 시스템 네트워킹을 변경하는 기능에만 필요: TUN/VPN 모드, 킬 스위치 또는 시스템 DNS/프록시 변경.
• 폴더 접근 — 설정, 로그, 런타임 데이터, 다운로드된 Tor/전송 바이너리, 브리지 캐시 및 선택한 로그 내보내기 위치 저장.

설정 및 런타임 데이터는 OS 애플리케이션 데이터 폴더에 저장됩니다(예: Windows의 %AppData%\OnionHop\settings.json, macOS의 ~/Library/Application Support/OnionHop/).

빌드 (개발)

전제 조건:

• .NET SDK 9
• Inno Setup 6 (Windows 설치 프로그램)
• (선택 사항) ArtiHop 엔진 빌드를 위한 Rust 툴체인, Snowflake 프록시 / webtunnel / dnstt 클라이언트 빌드를 위한 Go — 종속성 스크립트에 의해 가져오거나 빌드됩니다. 툴체인이 없으면 해당 엔진/기능은 건너뜁니다.

런타임 종속성 가져오기 (Tor, 플러그 가능 전송, sing-box, Wintun, ArtiHop, Snowflake 프록시):

# Windows
powershell -NoProfile -ExecutionPolicy Bypass -File download-deps.ps1

# Linux
./download-deps.sh

빌드 및 실행:

# Windows 설치 프로그램 (자체 포함, x64) -> installer/output/OnionHop-Setup-v3.exe
powershell -NoProfile -ExecutionPolicy Bypass -File installer/build-installer-v3.ps1

# 소스에서 실행
dotnet run --project OnionHop/src/OnionHopV3.App -c Release

ArtiHop 2홉 엔진은 자체 공개 저장소인 center2055/ArtiHop에서 빌드됩니다. 컴파일된 바이너리만 번들로 제공되며, 소스 코드는 포함되지 않습니다.