adinhodovic/compass

Что это?

Ключевые возможности

• 01Автоматически находит сервисы в Docker, Kubernetes, Tailscale и Headscale.
• 02Поддерживает статическую конфигурацию и источники JSON API.
• 03Показывает состояние и статус обновления источников.
• 04Предоставляет поиск, фильтрацию, теги и метаданные сервисов.
• 05Поставляется с Docker-образом и Helm chart для Kubernetes.

Сценарии использования

• Создание единого дашборда для сервисов, запущенных на нескольких Docker-хостах в homelab.
• Сбор ссылок на внутренние сервисы Kubernetes в одном месте для команды.
• Просмотр сервисов, доступных в сети Tailscale или Headscale, с одной страницы.

Быстрый старт

1. 1

   Создайте compass.yaml с источником Docker

2. 2

   Запустите контейнер Compass с помощью Docker

   docker run --rm -p 8080:8080 --group-add $(getent group docker | cut -d: -f3) -v /var/run/docker.sock:/var/run/docker.sock:ro -v $PWD/compass.yaml:/etc/compass/compass.yaml:ro adinhodovic/compass:latest -c /etc/compass/compass.yaml
3. 3

   Для Kubernetes создайте compass.yaml с источником Kubernetes

4. 4

   Установите Compass с помощью Helm

   helm install compass oci://ghcr.io/adinhodovic/charts/compass -n compass --create-namespace --set-file config=compass.yaml

Что важно знать

• !Для обнаружения Docker необходимо подключить сокет Docker, что предоставляет доступ к конфиденциальным ресурсам хоста.
• !Обнаружение Kubernetes зависит от разрешений RBAC внутри кластера, предоставленных Helm-чартом.

В подборках

Темы

Частые вопросы

Что такое compass?

Самостоятельно размещаемая стартовая страница, которая автоматически находит и перечисляет сервисы, дашборды и документы из Docker, Kubernetes и Tailscale. Compass — стартовая страница для homelab и самостоятельно размещаемых сервисов. Вместо того чтобы вручную поддерживать карточки для каждого сервиса, достаточно добавить источник в YAML-конфиг, и Compass отобразит предоставляемые им данные в интерфейсе с серверным рендерингом.

compass можно использовать бесплатно? Какая у него лицензия?

compass распространяется с открытым исходным кодом под лицензией Apache-2.0. Перед использованием в коммерческих продуктах проверьте условия лицензии.

compass всё ещё поддерживается?

Активно поддерживается. Последний коммит в compass — 5 нояб. 2026 г..

Для чего можно использовать compass?

Создание единого дашборда для сервисов, запущенных на нескольких Docker-хостах в homelab. Сбор ссылок на внутренние сервисы Kubernetes в одном месте для команды. Просмотр сервисов, доступных в сети Tailscale или Headscale, с одной страницы.

Как установить compass?

Создайте compass.yaml с источником Docker Запустите контейнер Compass с помощью Docker: docker run --rm -p 8080:8080 --group-add $(getent group docker | cut -d: -f3) -v /var/run/docker.sock:/var/run/docker.sock:ro -v $PWD/compass.yaml:/etc/compass/compass.yaml:ro adinhodovic/compass:latest -c /etc/compass/compass.yaml Для Kubernetes создайте compass.yaml с источником Kubernetes Установите Compass с помощью Helm: helm install compass oci://ghcr.io/adinhodovic/charts/compass -n compass --create-namespace --set-file config=compass.yaml

Где скачать compass?

Исходный код и инструкции по установке — на GitHub: https://github.com/adinhodovic/compass