Homepage
모던하고 완전히 정적이며 빠르고 안전하며 고도로 커스터마이징 가능한 애플리케이션 대시보드로, Docker 자동 검색 및 100개 이상의 서비스 통합을 지원합니다.
스마트 다운로드
프로젝트 홈페이지 방문
아직 설치 프로그램이 없습니다 — 소스 저장소로 이동하세요
자체 호스팅 서비스 내비게이션 페이지로, Docker 컨테이너를 자동 검색하고 상태를 표시합니다.
주요 기능
- 완전 정적 생성으로 페이지가 즉시 열림
- 모든 API 요청을 프록시로 전달하여 키가 노출되지 않음
- 100+ 서비스 통합(Radarr/Plex/Jellyfin 등) 및 정보 위젯(날씨, 시간) 지원
- Docker 레이블을 통해 서비스를 자동으로 검색하며 수동 구성 불필요
- 40+ 언어 인터페이스, 고도로 커스터마이즈 가능한 테마 및 레이아웃
할 수 없는 것
- •Homepage 자체는 사용자 인증을 제공하지 않으므로, 외부 네트워크에서 접근하려면 반드시 리버스 프록시(예: Nginx, Traefik) 뒤에 배치하고 인증과 HTTPS를 구성해야 합니다. 포트를 공용 인터넷에 직접 노출하지 마십시오.
사용 사례
- 홈랩(Homelab) 서비스 개요 내비게이션 페이지
- 기업 인트라넷의 여러 자체 구축 애플리케이션 진입점 통합
- 개인 NAS에서 Docker 서비스 상태 모니터링
상세 설명
Homepage는 완전히 정적으로 생성되어 로딩이 매우 빠른 현대적인 애플리케이션 대시보드입니다. 모든 API 요청은 프록시를 통해 전달되어 키를 숨기고 보안을 보장합니다. Radarr, Sonarr, Plex, Jellyfin 등 100개 이상의 서비스와 정보 위젯(날씨, 시간, 검색)을 통합하고 있습니다. 구성은 YAML 파일 또는 Docker 레이블 자동 감지를 통해 완료됩니다. 40개 이상의 언어로 전체 인터페이스 국제화를 지원하며, 높은 수준의 커스터마이징(테마, 사용자 정의 CSS/JS, 레이아웃)이 가능합니다. AMD64 및 ARM64 이미지를 제공하며, Docker 배포 또는 소스 코드에서 실행하는 방식을 지원합니다.
문제 해결 & FAQ (2)
문제 해결Homepage를 v1.0.0으로 업그레이드한 후 fiveColumns가 루트 서비스에서 4개의 열만 표시되는 이유는 무엇인가요?
이 문제는 Homepage v1.0.0에서 발생한 회귀 버그입니다: fiveColumns: true가 루트 수준 레이아웃 그룹에서는 무시되지만, 중첩 그룹은 여전히 정상적으로 표시됩니다. 임시 해결 방법으로, 수정 사항이 포함된 dev 태그로 latest 이미지 태그에서 전환한 다음 컨테이너를 pull하고 다시 생성하세요. settings.yaml에는 fiveColumns: true를 그대로 유지하세요. 또는 수정 사항이 포함된 안정 릴리스가 제공되면 해당 버전으로 업그레이드하세요.
문제 해결여러 기기에서 대시보드를 열 때 Homepage에서 Omada 위젯에 'API Error: Unexpected error' / 'Unexpected token <' 오류가 발생하는 문제를 해결하는 방법
이 문제는 동시 Omada 로그인이 Homepage의 공유 쿠키 jar를 덮어쓰면서 발생합니다. 각 뷰어는 5초마다 로그인하며, 이로 인해 진행 중인 요청이 한 세션의 토큰과 다른 세션의 세션 쿠키를 함께 전송할 수 있어 Omada가 JSON 대신 HTML 로그인 페이지를 반환하게 됩니다.
즉시 적용 가능한 해결 방법:
1. Omada 컨테이너가 아닌 Homepage 컨테이너를 재시작하세요:
docker restart homepage또는 Docker Compose 사용 시:
docker compose restart homepage2. 위젯이 수정될 때까지 여러 장치에서 동시에 Homepage를 여는 것을 피하세요. 같은 장치의 여러 탭에서는 이 문제가 그만큼 확실하게 발생하지 않습니다.
3. Omada를 재시작해도 Homepage의 잘못된 상태는 해소되지 않습니다.
영구적인 수정을 위해서는 Omada 위젯이 매 5초 폴링마다 로그인하는 대신 세션을 재사용/캐시하도록 변경하거나, 프로세스 전역 쿠키 jar를 사용하는 대신 요청별로 쿠키/토큰을 격리해야 합니다.
태그
시작하기
소프트웨어 설치
다운로드한 설치 프로그램을 더블 클릭하고 안내에 따르세요
Docker Compose를 사용하여 배포: docker-compose.yml을 생성하며, 내용은 공식 문서 참조
config 폴더를 구성하고, src/skeleton 예제를 참조하세요
docker-compose up -d를 실행하고 http://localhost:3000에 접속하세요
- Docker Compose를 사용하여 배포: docker-compose.yml을 생성하며, 내용은 공식 문서 참조
- config 폴더를 구성하고, src/skeleton 예제를 참조하세요
- docker-compose up -d를 실행하고 http://localhost:3000에 접속하세요
체크섬 없음
이 프로젝트는 GitHub Release 페이지에 SHA-256 체크섬을 게시하지 않았습니다
SHA256 체크섬
체크섬 없음
GitHub Releases에서 직접 다운로드하고 파일 무결성을 직접 확인하세요
이 플랫폼의 모든 SHA-256 체크섬은 프로젝트의 공식 GitHub Release 페이지에서 추출되었으며, 어떠한 변경도 없습니다. GitHub Releases 페이지에서 직접 검증할 수 있습니다.
오픈소스 투명성
GitHub 소스 보기제거 정보
컨테이너 중지 및 삭제: docker-compose down을 실행한 후 설정 디렉토리와 이미지를 삭제하면 됩니다.
추가 의존성 없음
다운로드 후 바로 사용 가능. 추가 런타임이 필요하지 않습니다.
문제 발생? 아래 FAQ 확인
2 FAQs