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 認証を使用し、接続 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

対応プロトコル

単一のゲートウェイと認証情報で 3 つの転送プロトコルすべてに対応しています。リクエストごとに自由に選択可能です。

SOCKS5

デフォルト推奨。TCP および UDP ASSOCIATE をネイティブサポートし、QUIC トラフィックにも完全対応。

HTTP / HTTPS

標準 CONNECT トンネリング。一般的な HTTP クライアントのプロキシ設定にそのまま設定できます。

UDP / QUIC

HTTP/3 や低遅延通信をネイティブサポートし、従来の TCP 専用プロキシの制約を解決します。

05

国・地域と ASN ターゲティング

ISO 国コードまたは ISP の ASN 番号で出口ノードを絞り込めます(レジデンシャルプランで 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 やサブネットをバイパスリストに追加してください。
地域一覧にプランが表示されない トークンの有効期限が切れている可能性があります。ダッシュボードから新しいトークンを取得してください。
09

BifrostBrowser アンチディテクトブラウザの使い方

BifrostBrowser は、すべての Bifrost ユーザーに無料で提供されるフィンガープリント保護(アンチディテクト)ブラウザです。各プロファイルは完全に独立したCookie・キャッシュ・ハードウェア/ソフトウェア指紋環境を持ちます。

インストール

ダウンロードページからお使いの OS に適したインストーラーを取得してください。

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

初回起動時、「Settings → BifrostNetwork Account Token」にダッシュボードで取得したトークンを貼り付け、「Open Browser to Login」をクリックしてアカウントを紐付けます。

ワークスペース概要

  • Workspace — Browsers(プロファイル一覧:名前、ステータス、プロキシ、メモ、最終使用日時)および Proxies(保存済みプロキシプール)。
  • Library — Fingerprints(実機から収集した指紋テンプレートライブラリ)。
  • System — Settings(設定)。

Browsers 画面上部には、総プロファイル数、実行中プロファイル数、保存済みプロキシ数、テンプレート数がリアルタイムで表示されます。

新規プロファイルの作成

Browsers 画面で「+ New profile」または「From template」をクリックして新しい環境を作成します:

Identity(基本情報)

  • プロファイル名 — 管理用の識別名(例: shop-jp-1)
  • OS — macOS / Windows / Linux
  • GPU / デバイスモデル — 指紋ライブラリから選択(例: win-gt730)
  • User-Agent — 選択デバイスに応じて自動補完
  • CPU コア / メモリ(GB) — エミュレートするハードウェア仕様
  • プロキシ — 保存済みプロキシの割り当てまたは直接接続

Locale(地域と言語)

  • タイムゾーン — プロキシの出口地域に自動追従または手動設定
  • 言語 — プロキシの出口地域に自動追従または手動設定

Noise

Noise(指紋ノイズ):Canvas、WebGL、Audio、Client rects、Sensors、Fonts の各シグナルに対して、実機値またはノイズ付加を個別に設定できます。リモートアクセスポート遮断リストも備わっています。

Privacy(プライバシー)

  • WebRTC — Auto または手動設定
  • Do Not Track — Off / On
  • 位置情報 — Auto(プロキシ連動)または手動座標

Media Devices(メディアデバイス)

  • マイク / スピーカー / Webカメラ — 仮想デバイス数の設定
  • メモ — 自由記述欄

設定が完了したら「Create profile」をクリックします。

指紋ライブラリ

Library → Fingerprints には、実機から採取された指紋スナップショットが保存されています。カードの「Use →」をクリックしてテンプレートから直接プロファイルを作成したり、JSON 経由でインポートできます。

プロキシの追加

Proxies 画面で「BifrostNetwork プロキシクイックジェネレーター」を使えば、手動で文字列を構築することなく所有プランから直接生成できます:

項目 説明
プラン選択 アカウントトークン連携で有効なプランを自動取得
対象国・地域 特定の国を指定、またはランダム出口
セッションモード リクエストごとの新規 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>

設定項目一覧

設定項目 機能
Account Token Bifrost アカウントと連携してプランやプロキシを自動取得
Default startup page 起動時に開く URL(デフォルト: https://ip.sb)
Proxy geo checker Test ボタンで使用する IP-Geo 判定サービス
Screen resolution 指紋テンプレートの解像度(推奨)または実際の画面サイズ
Automation API ローカル API の有効化、ポート変更、トークン管理

トラブルシューティング

現象 原因と対策
macOS で「アプリが壊れている」と警告される Gatekeeper の隔離制限です。上記の xattr コマンドを実行してください。
ジェネレーターにプランが表示されない アカウントトークンが未設定です。Settings で登録してください。
プロファイル起動時に実 IP が露出する プロキシが割り当てられていません。プロファイル設定をご確認ください。
自動化スクリプトが 401 エラーを返す Bearer トークンが異なるか、API サービスが無効になっています。
スクリプトが接続できない API サービスが有効か確認し、ポート変更後はアプリを再起動してください。
10

次のステップ