OnionHop V3

OnionHop V3는 트래픽을 Tor를 통해 라우팅하는 현대적인 크로스 플랫폼 데스크톱 앱(Windows, macOS, Linux)입니다. 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 터널).
Bridge Scanner — 모든 전송 방식의 브리지를 가져와 도달 가능성을 테스트하고, 색상으로 구분된 지연 시간을 확인하며, 네트워크에서 실제로 작동하는 브리지를 원클릭으로 적용합니다.
더 많은 브리지 소스 — 공식 Tor 브리지 서비스, 검열 저항 OnionHop Bridges Collector(Delta-Kronecker/Tor-Bridges-Collector에서 파생됨), 내장 커뮤니티 브리지, 그리고 소규모 실시간 가져오기가 자동으로 번들 브리지로 백업되도록 하는 thin-set 보충 기능.
릴레이 브라우저 — 별명, 국가, 역할, 플래그, 대역폭으로 실시간 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**에서 플랫폼에 맞는 최신 빌드를 받으세요:

플랫폼	파일	비고
Windows	`OnionHop-Setup-v3.exe`	설치 프로그램(자체 포함, .NET 런타임 번들)
Windows	`OnionHopV3-Portable-…win-x64.zip`	포터블, 설치 불필요
Linux	`OnionHop-x86_64.AppImage`	`chmod +x` 후 실행
macOS	`OnionHop-3.x-macOS.dmg`	서명 및 공증됨; 유니버설(Apple Silicon + Intel) — macOS 저장소에서 제공
Windows CLI	`OnionHop-CLI-Setup-3.x.exe` / 포터블 ZIP	터미널 인터페이스
Linux CLI	`OnionHopCLI-…linux-x64.tar.gz`	터미널 인터페이스
macOS CLI	`OnionHopCLI-…macos-arm64.tar.gz`(Apple Silicon) / `…macos-x64.tar.gz`(Intel)	터미널 인터페이스; 서명 및 공증됨 — DMG와 마찬가지로 macOS 저장소에서 제공

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

시작하기

설치 — OS에 맞는 빌드(위 참조)를 설치하세요. Windows 설치 프로그램과 macOS/Linux 번들은 자체 포함되어 있으며 .NET 9 런타임이 번들로 제공됩니다.
모드 선택
- 프록시 모드(권장, 관리자 권한 불필요): Tor를 로컬에서 실행하고 OS 시스템 프록시를 Tor의 로컬 SOCKS5 엔드포인트로 지정합니다. 프록시를 인식하는 앱에 가장 적합합니다.
- TUN/VPN 모드(관리자): sing-box를 통한 시스템 전체 라우팅(Windows에서는 Wintun, macOS/Linux에서는 시스템 TUN)입니다. 프록시 설정을 무시하는 앱에 필요합니다. 유출 방지(DNS는 Tor를 통해, UDP 차단).
연결
- Smart Connect를 켜 두면 OnionHop이 최적의 전략을 자동으로 선택합니다. 또는 Tor 엔진 / Exit Location / Bridges를 직접 선택할 수 있습니다.
- 검열된 네트워크에서는 Bridges를 활성화하거나 Scanner를 열어 해당 지역에서 작동하는 브리지를 찾으세요.
- Connect를 클릭하세요.

참고

.onion 사이트는 Tor를 인식하는 클라이언트(Tor Browser 권장) 또는 SOCKS 원격 DNS(예: Firefox의 "Proxy DNS when using SOCKS v5")가 필요합니다.
국가/릴레이 고정과 컨트롤 포트 New Identity는 Classic 엔진이 필요합니다. Arti와 ArtiHop은 OnionHop 브리지/PT 설정을 지원하지만, 수동 회로 제어에는 Classic이 여전히 가장 완전한 선택입니다.

Tor 엔진

엔진	홉	관리자	브리지 / 고정 / NEWNYM	비고
Classic (`tor.exe`)	3	아니오(프록시)	브리지, 고정, NEWNYM	가장 많은 기능; 검열 + 수동 회로 제어에 권장
Arti	3	아니오	브리지/PT	Rust Tor 구현(SOCKS 런타임)
ArtiHop	2 (Guard→Exit)	아니오	브리지/PT	낮은 지연 시간, 약한 익명성

국가 고정, 릴레이 고정, 컨트롤 포트 New Identity가 필요할 때는 Classic을 사용하세요. Rust 런타임을 원하고 Classic 전용 제어가 필요하지 않을 때는 Arti 또는 ArtiHop을 사용하세요.

모드 설명

프록시 모드(권장)

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

TUN/VPN 모드(관리자)

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

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

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

권한

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

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

빌드 (개발)

필수 조건:

.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 installer (self-contained, x64) -> installer/output/OnionHop-Setup-v3.exe
powershell -NoProfile -ExecutionPolicy Bypass -File installer/build-installer-v3.ps1

# Run from source
dotnet run --project OnionHop/src/OnionHopV3.App -c Release

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

라이선스

이 프로그램은 자유 소프트웨어입니다: 자유 소프트웨어 재단이 발표한 GNU 일반 공중 사용 허가서(GNU General Public License)의 조건에 따라, 라이선스 버전 3 또는 (사용자의 선택에 따라) 이후 버전에 따라 재배포 및/또는 수정할 수 있습니다.

이 프로그램은 유용하게 사용되기를 바라며 배포되지만, 어떠한 보증도 제공하지 않습니다. 상품성 또는 특정 목적에 대한 적합성에 대한 묵시적 보증조차도 제공하지 않습니다. 자세한 내용은 GNU 일반 공중 사용 허가서를 참조하세요.

OnionHop v3.7.8