Teleskopio: лёгкий веб-клиент для Kubernetes

Teleskopio — это небольшой self-hosted веб-клиент (web Kubernetes client) для управления кластерами Kubernetes из браузера. По духу это альтернатива классической панели Kubernetes Dashboard, которую автор начал писать после того, как устал управлять кластерами из терминала.

Note

Проект находится в стадии беты (актуальная версия — v0.1.4). Сами разработчики предупреждают: software is provided "as is", возможны неточности. Это важный контекст для оценки зрелости — к нему вернёмся в конце.

Зачем это нужно

Официальный Kubernetes Dashboard долгое время оставался спорным выбором: тяжёлый, с собственной моделью доступа и не самым удобным интерфейсом. Teleskopio закрывает ту же нишу, но делает ставку на «маленький и красивый» инструмент: один бинарник, никаких внешних зависимостей и сервисов, готовность к работе в air-gapped-окружениях без единого внешнего запроса.

Возможности

Несмотря на ранний номер версии, набор функций уже заметно шире, чем у типичного pet-project:

  • Несколько кластеров — переключение между конфигурациями: Teleskopio читает переменную $KUBECONFIG и проверяет config.yaml.

  • Аутентификация и роли — простая авторизация по JWT-токену и две роли: Admin (полный доступ) и Viewer (только чтение).

  • Обзор кластера — высокоуровневая картина состояния и активности кластера.

  • Редактор ресурсов — встроенный Monaco Editor с подсветкой синтаксиса для создания и правки объектов.

  • Live-обновления — изменения ресурсов в реальном времени через Kubernetes watchers.

  • Логи и события — просмотр логов подов (pods) и истории событий прямо в интерфейсе.

  • Навигация по владельцам — переход от ресурса к его owner-объекту.

  • CRD — редактор custom resource definitions.

  • Операции над ресурсами — ручной запуск CronJob, масштабирование Deployments и ReplicaSets, мультивыбор объектов для массовых операций (delete, drain, cordon и т.д.).

  • Helm — интеграция с Helm.

  • UX-мелочи — фильтрация любых ресурсов по CTRL + F, быстрый переход по меню CTRL + J, светлая и тёмная темы, выбор шрифтов.

Архитектура и стек

Ключевое архитектурное решение — это нативная реализация на Go, которая общается напрямую с Kubernetes API server, без промежуточных слоёв и без необходимости ставить что-либо дополнительное в систему.

  • Backend — Go и официальный Kubernetes Go-клиент; схемы ресурсов учитываются для каждой версии API.

  • Frontend — React, компоненты на shadcn/ui и Tailwind CSS, иконки lucide, редактор Monaco.

  • Обновления — Kubernetes watchers для мгновенной синхронизации с кластером.

По составу репозитория видно тот же расклад: основной объём кода — TypeScript (~310 КБ) и Go (~60 КБ).

Установка

Поддерживаются основные способы развёртывания: Linux, macOS, Docker и Helm. Отдельно подчёркивается готовность к air-gapped-средам — внешние запросы не выполняются.

Предпросмотр интерфейса

Интерфейс Teleskopio
Интерфейс Teleskopio

Оценка зрелости проекта

Сведём сигналы, по которым можно судить о зрелости Teleskopio.

  • Версия и стабильность. Текущая версия — v0.1.4, проект явно помечен как бета. Это означает: возможны ломающие изменения между релизами, API и поведение ещё не зафиксированы.

  • Активность и ритм релизов. Репозиторий создан в августе 2025 года, последние коммиты — свежие (май 2026). Релизы выходят регулярно: цепочка от v0.0.5 до v0.1.4, всего полтора десятка тегов. Проект живой, а не заброшенный.

  • Сообщество. Около 145 звёзд, 6 форков и всего ~7 открытых issues. Для столь молодого инструмента это здоровый, но небольшой интерес — серьёзного потока внешних контрибьюторов пока нет.

  • Лицензия. Apache 2.0 — пермиссивная и предсказуемая для корпоративного использования (GitHub отображает её как «Other» из-за оформления файла, но внутри это именно Apache 2.0).

  • Bus-factor. Проект развивается силами одного автора (Roman Kiselenko). Это главный риск: судьба инструмента завязана на одного мейнтейнера.

  • Зрелость функций. Базовый CRUD по ресурсам, редактор, логи, watchers и Helm уже на месте. При этом модель безопасности простая (JWT + две роли), а метрик (CPU/память) ещё нет — они, как и MCP-сервер, в планах.

Вердикт

Teleskopio — это аккуратный, функциональный, но ещё ранний инструмент. Он хорошо подойдёт для homelab, небольших команд и air-gapped-окружений, где ценятся отсутствие внешних зависимостей и лёгкость развёртывания. Для крупных мультитенантных production-кластеров его пока стоит рассматривать с осторожностью: ранняя версия, простая авторизация и зависимость от одного мейнтейнера — факторы, которые имеет смысл взвесить. Но как замена ушедшему Kubernetes Dashboard для повседневной работы с кластером проект выглядит многообещающе.

© 2026 meganuke