개요

Lighthouse는 웹페이지 품질을 개선하는 데 사용할 수 있는 오픈소스 자동화 도구입니다. 공개 웹페이지 또는 인증이 필요한 웹페이지에서 실행할 수 있습니다. 성능, 접근성, 프로그레시브 웹 앱, 검색엔진 최적화 등에 대한 감사를 실시합니다.

Lighthouse 로고

Lighthouse는 Chrome DevTools, 명령줄에서 또는 Node 모듈로 실행할 수 있습니다. 감사할 URL을 제공하면 Lighthouse가 페이지에 대해 일련의 감사를 실행합니다. 페이지의 실적에 대한 보고서를 생성합니다. 여기서 실패한 감사를 페이지를 개선하는 방법에 대한 지표로 사용합니다. 각 감사에는 그 이유를 설명하는 참조 문서가 있습니다. 감사와 이를 수정하는 방법이 중요합니다

Lighthouse CI를 사용하여 사이트의 회귀를 방지할 수도 있습니다.

Lighthouse를 사용하고 기여하는 방법에 대해 자세히 알아보려면 아래 Google I/O 동영상을 확인하세요.

시작하기

자신에게 가장 적합한 Lighthouse 워크플로를 선택하세요.

  • Chrome DevTools 인증이 필요한 페이지를 쉽게 감사하고 사용자 친화적인 형식으로 보고서를 읽을 수 있습니다.
  • 명령줄에서 셸 스크립트를 통해 Lighthouse 실행을 자동화합니다.
  • Node 모듈로 Lighthouse를 지속적 통합 시스템에 통합합니다.
  • 웹 UI에서 Lighthouse를 실행하면 별도의 설치 없이 보고서에 연결할 수 있습니다.

Chrome DevTools에서 Lighthouse 실행

Lighthouse는 Chrome DevTools에 자체 패널이 있습니다. 보고서를 실행하려면 다음 안내를 따르세요.

  1. 데스크톱용 Chrome을 다운로드합니다.
  2. Chrome에서 감사하려는 URL로 이동합니다. 웹에 있는 모든 URL을 감사할 수 있습니다.
  3. Chrome DevTools를 엽니다.
  4. Lighthouse 탭을 클릭합니다.

    Chrome DevTools의 Lighthouse 패널
    감사할 페이지의 표시 영역이 왼쪽에 있습니다. 오른쪽에는 Lighthouse에서 제공하는 Chrome DevTools의 Lighthouse 패널이 있습니다.

  5. 페이지 로드 분석을 클릭합니다. DevTools에 감사 카테고리 목록이 표시됩니다. 모두 사용 설정된 상태로 둡니다.

  6. 감사 실행을 클릭합니다. 30~60초 후에 Lighthouse에서 페이지에 관한 보고서를 제공합니다.

    Chrome DevTools의 Lighthouse 보고서
    Chrome DevTools의 Lighthouse 보고서

Node 명령줄 도구 설치 및 실행

Node 모듈을 설치하려면 다음 단계를 따르세요.

  1. 데스크톱용 Chrome을 다운로드합니다.
  2. Node의 현재 장기 지원 버전을 설치합니다.
  3. Lighthouse를 설치합니다. -g 플래그는 이를 전역 모듈로 설치합니다.
npm install -g lighthouse

감사를 실행하려면 다음 안내를 따르세요.

lighthouse <url>

모든 옵션을 보려면 다음 단계를 따르세요.

lighthouse --help

프로그래매틱 방식으로 Node 모듈 실행

Lighthouse를 프로그래매틱 방식으로 노드 모듈로 실행하는 예는 프로그래매틱 방식으로 사용을 참조하세요.

PageSpeed Insights 실행

PageSpeed Insights에서 Lighthouse를 실행하려면 다음 단계를 따르세요.

  1. PageSpeed Insights로 이동합니다.
  2. 웹페이지 URL을 입력합니다.
  3. 분석을 클릭합니다.

    <ph type="x-smartling-placeholder">
    </ph> PageSpeed Insights UI
    PageSpeed Insights UI

Lighthouse를 Chrome 확장 프로그램으로 실행

확장 프로그램을 설치하려면 다음 단계를 따르세요.

  1. 데스크톱용 Chrome을 다운로드합니다.
  2. Chrome 웹 스토어에서 Lighthouse Chrome 확장 프로그램을 설치합니다.

감사를 실행하려면 다음 안내를 따르세요.

  1. Chrome에서 감사하려는 페이지로 이동합니다.
  2. Lighthouse 확장 프로그램 Lighthouse를 클릭합니다. Chrome 주소 표시줄 옆에 있을 것입니다. 그렇지 않은 경우 Chrome의 확장 프로그램 메뉴를 열고 여기에서 액세스합니다. 클릭하면 Lighthouse 메뉴가 펼쳐집니다.

    Lighthouse 확장 프로그램
    Lighthouse 확장 프로그램 패널

  3. 보고서 생성을 클릭합니다. Lighthouse는 현재 포커스가 맞춰진 페이지에 대해 감사를 실행한 다음 결과 보고서가 포함된 새 탭을 엽니다.

    <ph type="x-smartling-placeholder">
    </ph> Lighthouse 확장 프로그램 보고서
    확장 프로그램의 Lighthouse 보고서

온라인으로 보고서 공유 및 보기

Lighthouse 뷰어를 사용하여 온라인에서 보고서를 보고 공유할 수 있습니다.

Lighthouse 뷰어
Lighthouse 뷰어

JSON으로 보고서 공유

Lighthouse 뷰어에는 Lighthouse 보고서의 JSON 출력이 필요합니다. 아래 목록에서는 사용 중인 Lighthouse 워크플로에 따라 JSON 출력을 가져오는 방법을 설명합니다.

  • Lighthouse 보고서 오른쪽 상단의 메뉴 아이콘 메뉴를 열고 JSON으로 저장 버튼 JSON으로 저장을 클릭합니다.
  • 명령줄 실행: shell lighthouse --output json --output-path <path/for/output.json>

보고서 데이터를 보는 방법은 다음과 같습니다.

  1. Lighthouse 뷰어를 엽니다.
  2. JSON 파일을 뷰어로 드래그하거나 뷰어의 아무 곳이나 클릭하여 파일 탐색기를 열고 파일을 선택합니다.

GitHub Gist로 보고서 공유

JSON 파일을 수동으로 전달하고 싶지 않다면 GitHub 보안 비밀로 보고서를 공유할 수도 있습니다. Gist의 한 가지 이점은 무료 버전 제어입니다.

보고서에서 보고서를 gist로 내보내려면 다음 단계를 따르세요.

  1. (이미 뷰어를 사용 중인 경우 이 단계를 건너뛰세요) 오른쪽 상단 메뉴 아이콘 메뉴를 열고 뷰어에서 열기 버튼 뷰어에서 열기를 클릭합니다. 보고서가 https://googlechrome.github.io/lighthouse/viewer/에 있는 뷰어에서 열립니다.
  2. 뷰어에서 오른쪽 상단 메뉴 아이콘 메뉴를 열고 뷰어에서 열기 버튼 Gist로 저장을 클릭합니다. 이 작업을 처음 실행하면 기본 GitHub 데이터에 액세스하고 요점을 읽고 쓸 수 있는 권한을 요청하는 팝업이 표시됩니다.

Lighthouse의 CLI 버전에서 보고서를 gist로 내보내려면 gist를 수동으로 만들고 보고서의 JSON 출력을 gist에 복사하여 붙여넣습니다. JSON 출력이 포함된 gist 파일 이름은 .lighthouse.report.json로 끝나야 합니다. 명령줄 도구에서 JSON 출력을 생성하는 방법의 예는 JSON으로 보고서 공유를 참조하세요.

gist로 저장된 보고서를 보려면 다음 단계를 따르세요.

  • ?gist=<ID>를 뷰어의 URL에 추가합니다. 여기서 <ID>는 gist의 ID입니다. text https://googlechrome.github.io/lighthouse/viewer/?gist=<ID>
  • 뷰어를 열고 gist의 URL을 붙여넣습니다.

Lighthouse 확장성

Lighthouse는 모든 웹 개발자에게 관련성 높고 실행 가능한 안내를 제공하는 것을 목표로 합니다. 이를 위해 Lighthouse를 특정 요구사항에 맞게 조정할 수 있는 두 가지 기능이 있습니다.

스택 팩

개발자는 다양한 기술 (백엔드/CMS/JavaScript 프레임워크)을 사용하여 웹페이지를 빌드합니다. Lighthouse는 일반적인 권장 사항만 표시하는 것이 아니라 이제 사용된 도구에 따라 보다 관련성 있고 실행 가능한 조언을 제공할 수 있습니다.

"스택 팩" Lighthouse에서 사이트가 구축된 플랫폼을 감지하여 구체적인 스택 기반 권장사항을 표시할 수 있게 하세요. 이러한 추천은 커뮤니티의 전문가가 정의하고 선별합니다.

스택 팩을 제공하려면 참여 가이드라인을 검토하세요.

Lighthouse 플러그인

Lighthouse 플러그인을 사용하면 도메인 전문가가 커뮤니티의 특정 요구에 맞게 Lighthouse의 기능을 확장할 수 있습니다. 이제 Lighthouse에서 수집한 데이터를 활용하여 새로운 감사를 만들 수 있습니다. 핵심적으로 Lighthouse 플러그인은 Lighthouse에서 실행되고 보고서에 새 카테고리로 추가되는 일련의 검사를 구현하는 노드 모듈입니다.

자체 플러그인을 만드는 방법에 대한 자세한 내용은 Lighthouse GitHub 저장소에서 플러그인 핸드북을 확인하세요.

Lighthouse 통합

제공하는 제품 / 서비스의 일부로 Lighthouse를 통합하고자 하는 회사나 개인이신가요? 가장 먼저 해야 할 일은 여러분입니다. 가능한 한 많은 사람이 Lighthouse를 사용하기를 바랍니다. 이 Lighthouse 통합 가이드라인 및 브랜드 애셋은 Lighthouse가 브랜드를 보호하면서 내부적으로도 잘 드러나고 있음을 보여주기 위해 마련되었습니다.

Lighthouse에 기여하기

Lighthouse는 오픈소스이며 참여를 환영합니다. 저장소의 Issue Tracker를 확인하여 수정할 수 있는 버그 또는 만들거나 개선할 수 있는 감사를 찾아보세요. 또한 Issue Tracker는 성능 측정항목, 새 감사에 대한 아이디어 또는 Lighthouse와 관련된 다른 모든 사항을 논의하기에 좋은 장소입니다.