프로젝트 소개

Heimdall은 LinuxServer.io에서 개발한 애플리케이션 대시보드 및 런처입니다. 이 도구의 목적은 모든 웹 애플리케이션과 링크를 위한 단일 페이지를 제공하여, 사용자가 브라우저 북마크에 의존하지 않고 셀프 호스팅 서비스와 웹사이트를 정리할 수 있도록 하는 것입니다. 브라우저 시작 페이지로 사용할 수 있으며, 선택적으로 Google, Bing 또는 DuckDuckGo가 포함된 검색바를 포함할 수 있습니다. 대시보드를 통해 사용자는 모든 사이트나 애플리케이션에 대한 링크를 추가할 수 있습니다. 지원되는 애플리케이션은 제목으로 인식되며, Foundation 앱은 자동으로 아이콘과 기본 타일 색상을 제공합니다. Enhanced 앱은 애플리케이션 API를 사용하여 NZBGet 및 SABnzbd의 큐 크기나 다운로드 속도와 같은 실시간 통계를 대시보드에 직접 표시할 수 있습니다. Heimdall은 Laravel 11 기반으로 구축되었으며, 일반적인 PHP 확장 기능과 SQLite 및 zip 지원이 포함된 PHP 8.4 이상의 버전이 필요합니다. 설치는 저장소를 클론하거나 아카이브를 압축 해제한 후 웹 서버 문서 루트를 public 폴더로 지정하고, .env 파일을 생성하여 애플리케이션 키를 생성함으로써 수행할 수 있습니다. x86-64, armhf, arm64를 위한 멀티 아키텍처 Docker 이미지가 제공됩니다. 이 프로젝트는 Apache, Nginx 및 LinuxServer.io의 SWAG 이미지를 포함한 리버스 프록시에 대한 구성 가이드를 포함하고 있습니다. 사용자 정의 배경 이미지를 지원하며, PHP 업로드 제한 및 fileinfo에 대한 참고 사항이 있습니다. 검색 제공자는 YAML 파일에 저장되며, 대시보드 앱을 이름으로 검색하는 Tiles 옵션을 포함하여 사용자 정의가 가능합니다. Heimdall은 중국어, 일본어, 한국어, 스페인어, 프랑스어, 독일어, 포르투갈어, 러시아어 등 여러 언어로 번역되었습니다. 번역 파일은 resources/lang에 위치하며 풀 리퀘스트를 통해 기여할 수 있습니다. 보안을 위해 Heimdall은 SSRF 위험을 완화하고자 기본적으로 사설 또는 예약된 IP 주소로의 요청을 차단합니다. ALLOW_INTERNAL_REQUESTS 환경 변수를 통해 내부 요청을 활성화할 수 있습니다. 또한 앱 목록을 호스팅하거나 다운로드하고 APP_SOURCE를 설정하여 오프라인으로 실행하는 방법도 문서화되어 있습니다. 이 애플리케이션은 MIT 라이선스 하에 오픈 소스로 제공됩니다. Laravel, FontAwesome 5, jQuery, Huebee, Pexels, Trianglify가 크레딧에 포함됩니다. 지원은 Discord와 GitHub 이슈를 통해 제공됩니다.