Bifrost Logo BifrostNetwork
개발자 문서

며칠이 아닌 몇 분 만에 연동을 완료하세요.

인증, 엔드포인트 구문부터 프로토콜 지원까지, BifrostNetwork 연동에 필요한 모든 정보와 즉시 실행 가능한 3개 언어 코드 예제를 제공합니다.

01

빠른 시작

  1. 계정을 생성하고 대시보드에서 원하는 플랜을 구매하세요 — 대기 시간 없이 즉시 발급됩니다.
  2. 주문 정보에 표시된 연결 문자열(사용자명, 비밀번호 및 게이트웨이 주소)을 복사합니다.
  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)" }
02

인증 방식

모든 요청은 프록시 표준 기본 인증(Basic Auth)을 사용하며 연결 URL에 직접 포함됩니다. 별도의 API 키나 OAuth 인증이 필요 없으며, 사용자명 자체에 플랜과 라우팅 매개변수가 인코딩됩니다.

protocol://username:<pass>@gate.bifrostnetwork.cc:9521

Telegram 봇의 계정 메뉴에서 언제든지 비밀번호를 재설정할 수 있습니다. 이전 비밀번호는 다음 연결 요청 시 자동으로 새 인증 정보로 전환됩니다.

03

엔드포인트 및 세션 구문

사용자명은 하이픈(-)으로 연결된 문자열로, 플랜 코드, 계정 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를 할당받습니다.
04

프로토콜 지원

단일 게이트웨이와 자격 증명으로 세 가지 전송 프로토콜을 모두 지원합니다. 요청별로 자유롭게 선택할 수 있습니다.

SOCKS5

기본 권장 프로토콜. TCP 및 UDP ASSOCIATE를 기본 지원하며 QUIC 트래픽과 완벽히 호환됩니다.

HTTP / HTTPS

표준 CONNECT 터널링 — 모든 HTTP 클라이언트의 프록시 설정에 자격 증명을 그대로 입력하여 사용합니다.

UDP / QUIC

HTTP/3 및 저지연 전송 시나리오를 기본 지원하여 일반 TCP 전용 프록시의 한계를 극복합니다.

05

위치 및 ASN 타겟팅

ISO 국가 코드 또는 ISP의 ASN 번호로 출구 IP 풀을 필터링할 수 있습니다(주거용 플랜에서 ASN 타겟팅 지원). 미지원 조합인 경우 가장 근접한 활성 노드로 자동 대체됩니다.

resi.eco_b28ed8682f-country-us-asn-7018
06

코드 예제

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());
07

문제 해결

증상 원인 및 해결 방법
407 Proxy Auth Required 사용자명 또는 비밀번호를 다시 확인하세요. 대소문자를 구분합니다.
연결 시간 초과 (Connection timeout) DNS 조회가 프록시를 통해 이루어지도록 socks5 대신 socks5h를 사용하세요.
모든 요청에서 IP가 동일함 연결 문자열에서 -session- 매개변수를 제거하거나 새 세션 ID를 생성하여 강제 회전하세요.
지정 국가 풀 비어 있음 해당 지역 노드가 부족할 경우 시스템이 자동으로 가장 가까운 활성 노드를 할당합니다.
08

Chrome 확장 프로그램 사용 가이드

Bifrost Proxy Manager는 Manifest V3 기반 Chrome 확장 프로그램으로, 브라우저 내에서 공식 Bifrost 프록시 또는 모든 HTTP/HTTPS/SOCKS5 프록시에 손쉽게 연결할 수 있습니다.

설치 방법

  1. Chrome 웹 스토어에서 Bifrost Proxy Manager를 설치합니다.
  2. 한 번의 클릭으로 접근할 수 있도록 툴바에 고정합니다.
  3. 아이콘을 클릭하여 팝업을 열고 모드 전환, 프로필 관리 및 연결 상태를 확인합니다.

계정 토큰으로 연결

확장 프로그램을 통해 공식 Bifrost 프록시 네트워크를 이용하려면 연결 문자열 대신 계정 API 토큰이 필요합니다.

  1. 대시보드에 로그인한 후 '설정 → 계정 API Token'에서 토큰을 복사합니다.
  2. 확장 프로그램 팝업을 열고 '설정'으로 이동하여 'Bifrost 계정 API Token'에 붙여넣습니다.
  3. 메인 화면으로 돌아와 '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)에 추가하세요.
지역 선택기에 플랜이 없음 계정 토큰이 만료되었을 수 있습니다. 대시보드에서 새 토큰을 복사하세요.
09

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 서비스 활성화 여부를 확인하고 포트 변경 후 앱을 재시작하세요.
10

다음 단계