Lightpanda Browser
SHA-256Zig로 처음부터 만든 헤드리스 브라우저로, Headless Chrome보다 메모리를 16배 적게 사용하고 9배 더 빠르며, AI 자동화를 위해 탄생했습니다.
스마트 다운로드
Download 버전 다운로드
v1.0.1 · 69.8 MB
AI를 위해 특별히 설계된 초경량 헤드리스 브라우저
주요 기능
- Zig로 처음부터 자체 개발한 브라우저 엔진으로, Chromium 기반 래퍼가 아닙니다
- 메모리 사용량은 Headless Chrome의 약 16분의 1에 불과하며, 속도는 약 9배 빠릅니다
- CDP 및 WebDriver BiDi 프로토콜과 호환되며, Puppeteer 및 Playwright에 직접 연결할 수 있습니다
- AI Agent 모드를 내장하여 자연어로 브라우저를 조작할 수 있으며, 주요 대규모 언어 모델과 로컬 모델을 지원합니다
- 네이티브 MCP 서비스로 Claude 등 AI 클라이언트가 웹 페이지를 직접 조작할 수 있습니다
할 수 없는 것
- •네이티브 Windows 버전이 없으므로 Windows 사용자는 WSL2를 통해 사용해야 합니다; Linux 사전 컴파일 버전은 glibc에 의존하므로 Alpine 등 musl 시스템에서는 직접 실행할 수 없으며 소스 코드에서 컴파일해야 합니다; 완전히 새로운 엔진이므로 복잡한 JavaScript에 크게 의존하는 페이지에 대한 호환성이 실제 Chrome만큼 좋지 않을 수 있으니, 핵심 비즈니스 출시 전에 반드시 대상 웹사이트를 먼저 테스트하세요; AGPL-3.0 라이선스는 전염성이 있으므로 클로즈드 소스 상업적 통합 전에 컴플라이언스 위험을 평가해야 합니다.
사용 사례
- AI Agent의 대규모 웹 페이지 탐색, 클릭 및 데이터 수집
- Headless Chrome을 대체하는 저비용 크롤러 및 자동화 스크립트 실행
- MCP를 통해 대규모 모델 애플리케이션에 웹 페이지 읽기 및 조작 기능 제공
- 메모리가 제한된 서버 또는 컨테이너 환경에서의 웹 페이지 자동화 작업
상세 설명
Lightpanda는 Zig 언어로 처음부터 새로 작성된 오픈 소스 헤드리스 브라우저로, AI 에이전트와 웹 자동화를 위해 설계되었습니다. Puppeteer와 Headless Chrome, Playwright 등 Chromium 기반 솔루션과 달리 기존 브라우저의 껍데기를 씌운 것이 아니라 완전히 새로 구현된 엔진입니다. 실제 웹페이지 수집 테스트에서 메모리 사용량은 Headless Chrome의 16분의 1(123MB 대 2GB)에 불과하고 실행 속도는 약 9배 빨라, 대규모 크롤링과 AI 웹 브라우징의 서버 비용을 크게 절감할 수 있습니다. CDP와 WebDriver BiDi 프로토콜을 완전히 지원하며, 기존 Puppeteer, Playwright 스크립트를 거의 수정 없이 바로 연동할 수 있습니다. 내장 AI Agent 모드는 자연어로 브라우저를 구동할 수 있도록 지원하며, Anthropic, OpenAI, Gemini, OpenRouter 및 Ollama 로컬 모델과 호환되고, 대규모 모델 없이도 재생 가능한 deterministic 스크립트를 내보낼 수 있습니다. 네이티브 MCP 서비스를 통해 Claude 등 AI 클라이언트가 웹 조작 능력을 직접 얻을 수 있습니다. Linux, macOS 바이너리와 Docker 이미지를 제공하며, Windows 사용자는 WSL2를 통해 사용할 수 있습니다. AGPL-3.0 라이선스로 오픈 소스로 공개되어 있습니다.
문제 해결 & FAQ (1)
문제 해결Lightpanda에서 request interception이 활성화된 상태에서 HTTP 401 응답 시 fetch()가 'TypeError: fetch error'로 reject되는 이유는 무엇인가요?
이것은 Lightpanda 버그입니다(1.0.1 및 main @3476970a에 존재). Fetch.enable({handleAuthRequests: true})를 사용하면 — 이는 Puppeteer의 page.setRequestInterception(true)가 전송하는 것입니다 — Lightpanda는 응답에 WWW-Authenticate/Proxy-Authenticate 헤더가 없더라도 모든 401/407 응답을 HTTP 인증 챌린지로 처리합니다. 빈 챌린지(source: "", scheme: "")와 함께 Fetch.authRequired를 발생시키며, 클라이언트가 Default 또는 CancelAuth(Puppeteer의 기본값)로 응답하면 Lightpanda는 401을 페이지에 전달하는 대신 AbortAuthChallenge로 요청을 중단합니다. 따라서 헤더 없이 401만 반환하는 쿠키/세션 인증을 사용하는 SPA에서는 fetch()가 reject됩니다. 해결 방법: (1) handleAuthRequests: false로 raw CDP를 통해 인터셉션을 활성화합니다 — 그러면 http_request_auth_required 리스너가 등록되지 않고, 전송이 보류되지 않으며, 401이 페이지에 도달합니다. (2) API를 제외하는 URL 패턴으로 Fetch.enable의 범위를 지정합니다. 예: Fetch.enable({patterns: [{urlPattern: '*/assets/*'}], handleAuthRequests: true}) — 패턴과 일치하지 않는 요청은 인터셉션을 우회하여 실제 401을 받습니다. Chrome은 두 가지 점에서 다릅니다: 실제 챌린지 헤더가 존재할 때만 Fetch.authRequired를 발생시키고, Default/CancelAuth 응답의 경우 인증 흐름을 취소하면서도 원래의 401 응답은 여전히 전달합니다. Lightpanda를 Chrome과 동일하게 동작하도록 하는 수정 사항은 issue #4018에서 추적하세요.
태그
시작하기
소프트웨어 설치
배포판에 맞는 패키지를 설치 (dpkg / rpm / AppImage)
Homebrew로 설치: brew install lightpanda-io/browser/lightpanda, 또는 GitHub nightly 릴리스 페이지에서 해당 플랫폼의 바이너리 파일 다운로드
터미널에서 lightpanda version을 실행하여 설치가 성공했는지 확인
lightpanda fetch --dump html URL로 웹페이지 콘텐츠를 직접 가져오기
- Homebrew로 설치: brew install lightpanda-io/browser/lightpanda, 또는 GitHub nightly 릴리스 페이지에서 해당 플랫폼의 바이너리 파일 다운로드
- 터미널에서 lightpanda version을 실행하여 설치가 성공했는지 확인
- lightpanda fetch --dump html URL로 웹페이지 콘텐츠를 직접 가져오기
SHA-256 체크섬 확인됨
GitHub 공식 Release 페이지에서 추출된 체크섬
SHA256 체크섬
1fcca0ae7684f470780de611a56e9a8ea612d5ff21e37dbb48905ebac5b918a7이 체크섬은 GitHub Release 페이지에서 추출되었습니다. 다운로드 후 파일 무결성을 확인하세요.
이 플랫폼의 모든 SHA-256 체크섬은 프로젝트의 공식 GitHub Release 페이지에서 추출되었으며, 어떠한 변경도 없습니다. GitHub Releases 페이지에서 직접 검증할 수 있습니다.
오픈소스 투명성
GitHub 소스 보기제거 정보
Homebrew를 통해 설치한 경우 brew uninstall lightpanda를 실행하면 됩니다. 수동으로 다운로드한 바이너리 파일은 해당 파일을 직접 삭제하면 됩니다. Docker 사용자는 docker rm lightpanda와 docker rmi lightpanda/browser를 차례로 실행하여 컨테이너와 이미지를 삭제하면 됩니다. 소프트웨어는 시스템에 다른 파일을 남기지 않습니다.
추가 의존성 없음
다운로드 후 바로 사용 가능. 추가 런타임이 필요하지 않습니다.
문제 발생? 아래 FAQ 확인
1 FAQ