며칠이 아닌 몇 분 만에 연동을 완료하세요.
인증, 엔드포인트 구문부터 프로토콜 지원까지, BifrostNetwork 연동에 필요한 모든 정보와 즉시 실행 가능한 3개 언어 코드 예제를 제공합니다.
빠른 시작
- 계정을 생성하고 대시보드에서 원하는 플랜을 구매하세요 — 대기 시간 없이 즉시 발급됩니다.
- 주문 정보에 표시된 연결 문자열(사용자명, 비밀번호 및 게이트웨이 주소)을 복사합니다.
- 테스트 요청을 전송합니다. 반환된 주거용 IP가 본인 로컬 IP와 다르면 성공적으로 연결된 것입니다.
$ curl -x socks5h://resi.eco_b28ed8682f-country-us:<pass>@gate.bifrostnetwork.cc:9521 https://httpbin.org/ip
{ "origin": "203.0.113.42 (US Residential Node)" } 인증 방식
모든 요청은 프록시 표준 기본 인증(Basic Auth)을 사용하며 연결 URL에 직접 포함됩니다. 별도의 API 키나 OAuth 인증이 필요 없으며, 사용자명 자체에 플랜과 라우팅 매개변수가 인코딩됩니다.
protocol://username:<pass>@gate.bifrostnetwork.cc:9521 Telegram 봇의 계정 메뉴에서 언제든지 비밀번호를 재설정할 수 있습니다. 이전 비밀번호는 다음 연결 요청 시 자동으로 새 인증 정보로 전환됩니다.
엔드포인트 및 세션 구문
사용자명은 하이픈(-)으로 연결된 문자열로, 플랜 코드, 계정 ID 및 라우팅 수식어로 구성됩니다.
<plan>.base_<account_id>-country-us-session-3439b03c-ttl-300 | 수식어 | 예시 | 설명 |
|---|---|---|
| -country-xx | -country-de | 해당 ISO 국가 코드의 출구 노드로 트래픽을 라우팅합니다. |
| -session-id | -session-3439b03c | 이 ID를 사용하는 요청에 대해 동일한 출구 IP를 유지합니다(고정 세션). |
| -ttl-seconds | -ttl-300 | 고정 세션 유지 시간(초). 기본값은 600초입니다. |
| (-session 생략) | — | 모든 요청마다 자동으로 새로운 회전 IP를 할당받습니다. |
프로토콜 지원
단일 게이트웨이와 자격 증명으로 세 가지 전송 프로토콜을 모두 지원합니다. 요청별로 자유롭게 선택할 수 있습니다.
SOCKS5
기본 권장 프로토콜. TCP 및 UDP ASSOCIATE를 기본 지원하며 QUIC 트래픽과 완벽히 호환됩니다.
HTTP / HTTPS
표준 CONNECT 터널링 — 모든 HTTP 클라이언트의 프록시 설정에 자격 증명을 그대로 입력하여 사용합니다.
UDP / QUIC
HTTP/3 및 저지연 전송 시나리오를 기본 지원하여 일반 TCP 전용 프록시의 한계를 극복합니다.
위치 및 ASN 타겟팅
ISO 국가 코드 또는 ISP의 ASN 번호로 출구 IP 풀을 필터링할 수 있습니다(주거용 플랜에서 ASN 타겟팅 지원). 미지원 조합인 경우 가장 근접한 활성 노드로 자동 대체됩니다.
resi.eco_b28ed8682f-country-us-asn-7018 코드 예제
curl
$ curl -x socks5h://resi.eco_b28ed8682f-country-us-session-288ed66a:<pass>@gate.bifrostnetwork.cc:9521 https://httpbin.org/ip Python (requests)
# pip install "requests[socks]"
import requests
proxy = "socks5h://resi.eco_b28ed8682f-country-us-session-288ed66a:@gate.bifrostnetwork.cc:9521"
r = requests.get("https://httpbin.org/ip", proxies={"http": proxy, "https": proxy})
print(r.json()) Node.js
// npm install socks-proxy-agent
import { SocksProxyAgent } from "socks-proxy-agent";
const agent = new SocksProxyAgent(
"socks5h://resi.eco_b28ed8682f-country-us-session-288ed66a:@gate.bifrostnetwork.cc:9521"
);
const res = await fetch("https://httpbin.org/ip", { agent });
console.log(await res.json()); 문제 해결
| 증상 | 원인 및 해결 방법 |
|---|---|
| 407 Proxy Auth Required | 사용자명 또는 비밀번호를 다시 확인하세요. 대소문자를 구분합니다. |
| 연결 시간 초과 (Connection timeout) | DNS 조회가 프록시를 통해 이루어지도록 socks5 대신 socks5h를 사용하세요. |
| 모든 요청에서 IP가 동일함 | 연결 문자열에서 -session- 매개변수를 제거하거나 새 세션 ID를 생성하여 강제 회전하세요. |
| 지정 국가 풀 비어 있음 | 해당 지역 노드가 부족할 경우 시스템이 자동으로 가장 가까운 활성 노드를 할당합니다. |
Chrome 확장 프로그램 사용 가이드
Bifrost Proxy Manager는 Manifest V3 기반 Chrome 확장 프로그램으로, 브라우저 내에서 공식 Bifrost 프록시 또는 모든 HTTP/HTTPS/SOCKS5 프록시에 손쉽게 연결할 수 있습니다.
설치 방법
- Chrome 웹 스토어에서 Bifrost Proxy Manager를 설치합니다.
- 한 번의 클릭으로 접근할 수 있도록 툴바에 고정합니다.
- 아이콘을 클릭하여 팝업을 열고 모드 전환, 프로필 관리 및 연결 상태를 확인합니다.
계정 토큰으로 연결
확장 프로그램을 통해 공식 Bifrost 프록시 네트워크를 이용하려면 연결 문자열 대신 계정 API 토큰이 필요합니다.
- 대시보드에 로그인한 후 '설정 → 계정 API Token'에서 토큰을 복사합니다.
- 확장 프로그램 팝업을 열고 '설정'으로 이동하여 'Bifrost 계정 API Token'에 붙여넣습니다.
- 메인 화면으로 돌아와 'Bifrost 공식 프록시' 모드를 선택하고 플랜 및 대상 지역을 지정한 뒤 '프록시 활성화'를 클릭합니다.
토큰을 설정하면 팝업이 구매한 플랜, 사용 가능한 지역 및 게이트웨이 정보를 자동으로 불러옵니다.
사용자 정의 프록시 프로필
공식 Bifrost 네트워크 외에 자체 운영 중인 다양한 프록시 간을 전환하려면 '사용자 정의 프로필' 모드를 사용할 수 있습니다.
| 항목 | 설명 |
|---|---|
| 프로토콜 | HTTP, HTTPS 또는 SOCKS5 |
| 호스트 / 포트 | 프록시 게이트웨이 주소 |
| 사용자명 / 비밀번호 | 선택 사항 (인증 없는 프록시는 공란) |
| 프로필 이름 | 식별용 라벨 (예: '회사 VPN', '홈 서버') |
무제한으로 프로필을 저장하고 원클릭으로 간편하게 전환할 수 있습니다.
연결 확인
프록시 활성화 시 팝업 하단에 출구 IP 및 지리적 위치가 자동으로 표시되어 적용 여부를 즉시 확인할 수 있습니다.
우회 목록 (Bypass List)
로컬 및 인트라넷 주소가 프록시를 거치지 않고 직접 연결되도록 '설정 → 우회 목록'에 규칙을 추가할 수 있습니다:
<local>
127.0.0.1
localhost
*.local
192.168.0.0/16 자동 로그인
인증이 필요한 프록시의 경우 chrome.webRequest API를 통해 저장된 자격 증명을 자동 제출합니다:
- 브라우저의 기본 인증 팝업 창이 뜨지 않고 매끄럽게 연결됩니다.
- 자격 증명은 확장 프로그램 로컬 스토리지에만 안전하게 보관됩니다.
문제 해결
| 증상 | 원인 및 해결 방법 |
|---|---|
| 'API 토큰 미설정' 알림 | 설정에서 계정 API 토큰을 추가하거나 사용자 정의 프로필 모드를 사용하세요. |
| 출구 IP가 변경되지 않음 | 브라우저 캐시 연결일 수 있습니다. 페이지를 새로고침하거나 프록시를 껐다 켜보세요. |
| 인증 팝업이 반복해서 뜸 | 프로필에 저장된 사용자명/비밀번호를 다시 확인하고 재입력하세요. |
| 로컬 네트워크 장치 접근 불가 | 해당 IP 또는 대역을 우회 목록(Bypass List)에 추가하세요. |
| 지역 선택기에 플랜이 없음 | 계정 토큰이 만료되었을 수 있습니다. 대시보드에서 새 토큰을 복사하세요. |
BifrostBrowser 안티디텍트 브라우저 가이드
BifrostBrowser는 모든 Bifrost 프록시 사용자에게 무료로 제공되는 지문 보호 브라우저입니다. 각 프로필은 완전히 격리된 독립 환경(쿠키, 캐시, 일관된 하드웨어 및 소프트웨어 지문)을 제공합니다.
설치 안내
다운로드 페이지에서 사용하는 OS에 맞는 설치 프로그램을 다운로드하세요.
| 운영체제 | 설치 파일 |
|---|---|
| macOS (Apple Silicon) | BifrostBrowser.dmg |
| Windows 10/11 (64비트) | BifrostBrowser.exe |
| Linux (Debian 10+ / Ubuntu 20.04+) | BifrostBrowser.deb |
macOS에서 'BifrostBrowser.app이 손상되었기 때문에 열 수 없습니다'라고 표시되는 경우 터미널에서 다음 명령을 실행하세요:
sudo xattr -rd com.apple.quarantine /Applications/BifrostBrowser.app 최초 실행 후 '설정 → BifrostNetwork 계정 Token'에 토큰을 붙여넣고 브라우저 로그인을 클릭하여 계정과 연동합니다.
워크스페이스 개요
- Workspace — Browsers(프로필 목록: 이름, 상태, 프록시, 메모, 최근 사용) 및 Proxies(저장된 프록시 풀).
- Library — Fingerprints(실제 기기 지문 템플릿 라이브러리).
- System — Settings(환경 설정).
Browsers 상단 패널에 전체 프로필 수, 실행 중인 수, 저장된 프록시 수 및 라이브러리 템플릿 수가 실시간 표시됩니다.
새 프로필 생성
Browsers 화면에서 '+ New profile' 또는 'From template'을 클릭하여 새 환경을 생성합니다:
Identity (식별 정보)
- 프로필 이름 — 찾기 쉬운 명칭 (예: shop-kr-1)
- 운영체제 — macOS / Windows / Linux
- GPU / 기기 모델 — 지문 라이브러리에서 선택 (예: win-gt730)
- User-Agent — 선택한 장치에 맞춰 자동 입력
- CPU 코어 / RAM(GB) — 할당할 하드웨어 사양
- 프록시 — 저장된 프록시 바인딩 또는 직접 연결
Locale (지역 설정)
- 시간대 — '프록시 위치 자동 동기화' 또는 수동 지정
- 언어 — 프록시 위치 자동 감지 또는 수동 지정
Noise
Noise (지문 노이즈): Canvas, WebGL, Audio, Client rects, Sensors, Fonts 신호에 대해 실제 값 또는 노이즈 추가를 선택할 수 있습니다. 원격 접속 포트 차단 목록도 기본 제공됩니다.
Privacy (개인정보)
- WebRTC — 자동 또는 수동 지정
- Do Not Track — 끄기 / 켜기
- 지리적 위치 — 자동(프록시 기준) 또는 수동 좌표
Media Devices (미디어 장치)
- 마이크 / 스피커 / 카메라 — 가상 장치 개수 설정
- 메모 — 관리용 텍스트
설정이 완료되면 'Create profile'을 클릭합니다.
지문 라이브러리
Library → Fingerprints에는 실제 기기에서 수집된 지문 스냅샷이 보관되어 있습니다. 카드의 'Use →'를 클릭하여 템플릿 기반 새 프로필을 만들거나 JSON 형식으로 새 지문을 가져올 수 있습니다.
프록시 등록
Proxies 화면에서 'BifrostNetwork 프록시 빠른 생성기'를 사용해 번거로운 문자열 조합 없이 보유 중인 플랜을 즉시 등록할 수 있습니다:
| 항목 | 기능 설명 |
|---|---|
| 플랜 선택 | 계정 토큰 연동 시 활성 플랜 자동 조회 |
| 대상 국가/지역 | 국가 지정 또는 랜덤 출구 |
| 세션 모드 | 요청별 회전 IP 또는 세션 고정 IP |
| ASN (선택) | 특정 통신사/네트워크 지정 (예: AS7018) |
| 프록시 프로토콜 | SOCKS5 (또는 HTTP/HTTPS) |
| 생성 수량 | 한 번에 생성할 프록시 개수 |
'생성 및 일괄 등록'을 클릭하면 즉시 목록에 추가되어 프로필에 연결할 수 있습니다.
자동화 API (Automation API)
BifrostBrowser는 스크립트 제어를 위한 로컬 HTTP API를 제공하여 Playwright, Puppeteer 및 CDP 호환 도구와 쉽게 연동됩니다:
- 127.0.0.1에만 바인딩되어 외부 접근이 원천 차단됩니다.
- 인증 방식: JWT Bearer 토큰 (Authorization: Bearer <token>).
- 기본 포트: 40325 (사이드바 하단에 Base URL 상시 표시).
GET/POST http://127.0.0.1:40325/...
Authorization: Bearer <token> 환경설정 안내
| 설정 항목 | 기능 |
|---|---|
| 계정 Token | Bifrost 계정과 연동하여 플랜 및 프록시 자동 동기화 |
| 기본 시작 페이지 | 프로필 실행 시 첫 접속 URL (기본값: https://ip.sb) |
| 프록시 Geo 검사기 | Test 버튼 클릭 시 위치를 확인할 IP-Geo 서비스 선택 |
| 화면 해상도 | 템플릿 지문 해상도(권장) 또는 실제 모니터 해상도 사용 |
| 자동화 API | 로컬 API 활성화, 포트 및 Bearer 토큰 관리 |
문제 해결
| 증상 | 원인 및 해결 방법 |
|---|---|
| macOS '앱 손상' 경고 | Gatekeeper 격리 상태입니다. 안내된 xattr 명령을 실행하세요. |
| 생성기에 플랜이 없음 | 계정 토큰이 연동되지 않았습니다. 설정에서 등록하세요. |
| 프로필 실행 시 실제 IP 노출 | 프로필에 프록시가 연결되지 않았습니다. 프록시 설정을 확인하세요. |
| 자동화 스크립트 401 오류 | Bearer 토큰이 일치하지 않거나 API 서비스가 비활성화되어 있습니다. |
| 자동화 스크립트 접속 불가 | API 서비스 활성화 여부를 확인하고 포트 변경 후 앱을 재시작하세요. |