
Rust로 구현된 고성능 HTTP/HTTPS/SOCKS5 MITM 프록시로, TLS 인터셉션, 규칙 기반 요청 재작성, 트래픽 캡처, 브레이크포인트, 스크립트 샌드박스 및 Web UI를 통한 요청 재전송 기능을 제공합니다.
고성능 HTTP/HTTPS/SOCKS5 프록시 서버
언어: 中文 | English
· 문서 사이트
Bifrost는 Rust로 작성된 고성능, AI 친화적인 프록시 서버로, Whistle에서 영감을 받았습니다. 요청 가로채기, 규칙 수정, TLS 가로채기, 스크립트 확장, 트래픽 조회, 요청 재전송 및 Web UI 관리 기능을 제공합니다.
CLI를 설치하며, macOS와 Windows에서는 데스크톱 앱도 함께 자동 설치됩니다:
방법 1: 스크립트를 사용한 설치
macOS / Linux / Git Bash:
curl -fsSL https://raw.githubusercontent.com/bifrost-proxy/bifrost/main/install-binary.sh | bash
Windows PowerShell:
irm https://raw.githubusercontent.com/bifrost-proxy/bifrost/main/install-binary.ps1 | iex
이 스크립트는 항상 CLI를 설치하며, macOS / Windows에서는 동일 버전의 데스크톱 App을 자동으로 설치합니다. Linux 등 아직 데스크톱 설치 패키지를 제공하지 않는 플랫폼에서는 CLI-only로 유지됩니다. CLI만 필요한 경우 --no-desktop(Bash / Git Bash) 또는 BIFROST_INSTALL_AUTO_DESKTOP=0(Bash / PowerShell)을 사용하여 데스크톱을 건너뛸 수 있습니다. 스크립트는 이어서 CA 인증서를 설치하고 신뢰하도록 하며, 모든 Bifrost AI skills를 설치하고, Bifrost를 백그라운드 서비스로 시작합니다. 설치가 완료되면 관리 콘솔에 바로 접속할 수 있습니다.
Bash 및 PowerShell 설치 스크립트는 모두 GitHub 직접 연결과 내장 미러 소스를 자동으로 감지하여 가장 빠르게 사용 가능한 release 다운로드 주소를 우선 사용합니다. 제한된 네트워크에서는 BIFROST_GITHUB_MIRROR를 통해 우선 미러를 지정할 수도 있습니다. Windows PowerShell 스크립트는 설치 디렉터리를 현재 세션과 Windows 사용자 Path에 추가합니다. Git Bash 스크립트도 Windows에서는 Windows 사용자 Path에 동기화하여 기록하므로, 새로 연 PowerShell/CMD에서 바로 bifrost를 실행할 수 있습니다.
지정 버전 설치
macOS / Linux / Git Bash:
curl -fsSL https://raw.githubusercontent.com/bifrost-proxy/bifrost/main/install-binary.sh | bash -s -- --version v0.0.96
Windows PowerShell:
$installer = irm https://raw.githubusercontent.com/bifrost-proxy/bifrost/main/install-binary.ps1
& ([scriptblock]::Create($installer)) -Version v0.0.96
방법 2: npm을 사용하여 설치
npm i -g @bifrost-proxy/bifrost
추가 설치 방법: docs/getting-started.md
프록시 확인:
bifrost status
启动后访问管理端:
http://127.0.0.1:9900/_bifrost/
휴대폰, 태블릿 또는 다른 컴퓨터에서 프록시를 구성하기 전에, 먼저 Web UI의 Settings -> Certificate -> Availability Check를 여십시오. 현재 컴퓨터의 LAN IP를 선택한 후 QR 코드 또는 링크를 생성하고, 대상 디바이스로 접속하면 다음 세 가지를 자동으로 확인합니다:
확인을 통과하면 페이지에 클릭하여 복사할 수 있는 프록시 주소 <LAN IP>:<포트>가 표시되며, 프록시 QR 코드를 열어 구성을 계속할 수도 있습니다. 확인에 실패하면 페이지에서 iOS/Android에 따라 다음 단계를 안내합니다: CA 설치, iOS의 경우 설정 > 일반 > 정보 > 인증서 신뢰 설정에서 완전 신뢰 활성화, 또는 관리 콘솔에서 해당 디바이스의 프록시 접근을 승인.
bifrost install-skill -y
ASR Daily Agent는 일일 보고서를 독립적인 연구 질문으로 분할하여 명시적으로 구성된 Codex, Traex, Claude Code 또는 사용자 정의 CLI Runner에 의해 실행되도록 지원합니다. ChatGPT Web Runner는 제거되었습니다; 마이그레이션 안내.
전체 Agent 조합, 연구 manifest 및 실패 경계는 design/asr-daily-agent-pipeline.md를 참조하세요.

database_epoch를 제공하여 교체된 데이터베이스를 식별하고 트래픽을 다시 가져오는 데 사용; 일반 재시작은 신원을 유지하며 구버전 메시지와 호환됩니다. 자세한 내용은 design/traffic-db-startup-resequence.md를 참조하세요breakpoint://request / breakpoint://response 규칙에 매칭된 HTTP request/response를 일시 중지하고 headers/body를 편집한 후 계속할 수 있습니다. 자세한 내용은 docs/breakpoint.md를 참조하세요/_bifrost/api/system/memory에 body/ws 파일 writer 점유량 및 핸들 한도에 근접한 경고 상태가 표시됩니다reqScript, resScript, decode 지원저장소를 클론한 후 Git hook 초기화를 한 번 실행하세요:
bash scripts/setup-git-hooks.sh
# 或
make setup
이렇게 하면 현재 저장소에 로컬 core.hooksPath=.githooks가 기록되며, 머신에 전역 hooksPath가 설정되어 있더라도 이후 git commit 시 저장소 내의 .githooks/pre-commit이 우선 실행됩니다. 기본 pre-commit은 작업 영역 형식, 데스크톱 Tauri 형식, 그리고 cargo clippy --workspace --all-targets --all-features -- -D warnings를 검사합니다.
데스크톱은 일상적인 패킷 캡처, 트래픽 확인, 규칙 편집 및 Bifrost 업데이트에 적합하며, CLI 명령을 먼저 외울 필요가 없습니다:
Assets를 선택합니다..dmg를 다운로드합니다. Apple Silicon은 aarch64-apple-darwin, Intel Mac은 x86_64-apple-darwin을 선택합니다..msi를 다운로드합니다. 일반 x64 컴퓨터는 x86_64-pc-windows-msvc, ARM 기기는 aarch64-pc-windows-msvc를 선택합니다..dmg를 연 뒤 Bifrost.app을 Applications로 드래그하고, Windows는 .msi를 더블 클릭하여 마법사에 따라 설치합니다.데스크톱에도 명령줄 기능을 설치하려면 데스크톱 Settings를 열고 Desktop Proxy Core에서 Install CLI & Skills를 클릭하세요. 자세한 튜토리얼은 docs/desktop.md를 참고하세요.
자주 사용하는 명령:
# 查看状态
bifrost status
# 停止服务
bifrost stop
# 管理端远程访问与鉴权(Web UI)
bifrost admin remote status
bifrost admin remote enable
bifrost admin passwd
bifrost admin revoke-all
# 查看流量
bifrost traffic list
bifrost traffic search "keyword" --method POST --host api.openai.com --path /v1/responses
bifrost search "keyword" --req-header
bifrost search "keyword" --res-body
# 添加规则
bifrost rule add local-dev --content "example.com host://127.0.0.1:3000"