Higangssh/homebutler

Проверяет оповещения о ресурсах по использованию CPU, памяти и диска на соответствие настроенным порогам. Он читает и сравнивает; ничего никуда не отправляется и ничего не записывается, что и делает вместо этого работающий наблюдатель.

Покажи историю записанных предупреждений и исправлений. Записи создаются только пока работает наблюдатель, поэтому пустой список означает, что запись не велась, а не что всё было в порядке.

Создает архив резервного копирования Docker compose для всех сервисов или одного сервиса. Тома читаются во время работы контейнеров, поэтому база данных в процессе записи может оказаться несогласованной; архив не доказывает, что он восстанавливается, и именно это проверяет backup_drill.

Проверяет резервную копию, запуская приложение в изолированной среде Docker и проверяя, что оно отвечает. Вторая копия работает рядом с рабочей, в собственной сети и на собственном порту, и всё, что она создала, удаляется в любом случае. Успех означает, что архив не повреждён и приложение запускается на нём, а не то, что все строки на месте.

Перечисляет существующие архивы резервных копий в заданном каталоге резервного копирования. Читает имена, размеры и даты: наличие архива в каталоге ничего не говорит о том, восстанавливается ли он, а это как раз то, что выясняет backup_drill.

Восстанавливает Docker-тома из архива резервной копии, перезаписывая данные, на которых работает приложение. Деструктивно: подтвердите намерение перед вызовом. Bind-монтирования, объявленные в архиве, здесь всегда отклоняются, потому что агент не может указать путь на хосте, в который ему разрешено записывать.

Проверьте конфигурационный файл, на котором работает этот сервер: какой файл использовался, какое правило его выбрало, что было прочитано из каждого раздела, и всё, что неправильно или молча проигнорировано.

Суммируй образ контейнера Docker, его состояние, политику перезапуска, порты, монтирования, сети и здоровье. Значения переменных окружения никогда не включаются.

Перечисляет контейнеры Docker с их статусом, образом и портами. Включает остановленные контейнеры, поэтому имя, которое здесь появляется, не означает, что контейнер запущен: смотрите состояние.

Выводит логи из Docker-контейнера: только последние строки, по умолчанию 50, и возвращает их, а не следует за потоком.

Перезапустите контейнер Docker по имени. Он останавливается и запускается заново, и результат говорит, что команда перезапуска выполнена успешно, а не то, что приложение внутри снова работает. Сначала прочитайте логи, если не знаете, почему его нужно перезапускать.

Получить статистику использования ресурсов (CPU, память, сеть, блок I/O) для всех запущенных контейнеров Docker

Останавливает контейнер Docker по имени. Здесь ничто не запускает его снова: инструмента запуска нет, поэтому оператор возвращает его сам.

Перечисляет процессы, работающие внутри Docker-контейнера, считывая информацию с хоста. Только чтение: без exec, без TTY

Выполняет диагностику только для чтения, проверяя нагрузку на ресурсы, остановленные контейнеры, публичные порты, гигиену резервных копий и уведомления, а также формирует отчёт о базовой готовности.

Устанавливает self-hosted приложение через docker compose. Автоматически проверяет docker, порты и дубликаты, а отказ возвращается как результат с указанием причин, а не как ошибка.

Перечисли доступные self-hosted приложения, которые можно установить. Каталог встроен в бинарный файл, поэтому перечисление не обращается к сети и дает одинаковый результат на любой машине.

Останавливает установленное приложение и удаляет все данные, включая контейнеры, конфигурацию и тома. Ничто здесь не восстанавливает их, и резервная копия заранее не создаётся: сделайте её перед вызовом, если данные важны.

Проверяет статус установленного приложения, как о нём сообщают его контейнеры. Приложение, которое homebutler не устанавливал, здесь неизвестно.

Останавливает установленное приложение и удаляет его контейнеры. Каталог приложения и его тома остаются на диске; именно install_purge их удаляет.

Экспортировать инвентаризацию/топологию серверов в виде Mermaid-диаграммы локально или JSON локально/удалённо

Собирает информацию об инвентаризации/топологии сервера: состояние системы, Docker-контейнеры, порты приложений и системные порты.

Сканирует локальную сеть для обнаружения устройств (IP, MAC, имя хоста). Проверяет каждый адрес в подсети, на что уходит до 30 секунд, поэтому это ответ на чей-то вопрос, а не способ начать.

Отправьте одно тестовое уведомление через каждый настроенный канал и сообщите, какие из них дошли. Настоящее сообщение уходит в каждый канал, так что любой, кто читает эти каналы, увидит его.

Перечисляет открытые сетевые порты с информацией о связанных процессах. Процесс за портом не всегда можно прочитать без прав, и missing_process сообщает об этом, а не оставляет поле молча пустым.

Выводит топ процессов по использованию CPU или памяти, с общим количеством и отдельно выделенными процессами-зомби.

Перезагружает одну явно указанную гостевую систему Proxmox после подтверждения и возвращает принятый UPID задачи.

Перечисляет гостевые системы Proxmox — QEMU и LXC, с возможностью фильтрации по узлу, статусу или типу.

Корректно завершает работу одного явно указанного гостя Proxmox после подтверждения и возвращает UPID принятой задачи.

Запускает одну явно указанную гостевую систему Proxmox после подтверждения и возвращает UPID принятой задачи.

Получает подробный статус узла Proxmox

Отображает закреплённую команду установки для одного скрипта сообщества Proxmox VE. Никогда не загружает и не запускает его; вызывающий просматривает и запускает его самостоятельно на хосте Proxmox.

The Proxmox VE Community Scripts (formerly known as tteck's Proxmox VE Scripts) is a massive, curated collection of open-source scripts designed to simplify the installation of applications inside Proxmox LXC containers and VMs. Important Note: The catalog contains over 200 scripts and is frequently updated (software is added and removed based on community maintenance). The list below outlines the complete categories and the most popular, currently maintained scripts as of 2024/2025. You can view the live, searchable list at the official website: [https://community-scripts.github.io/CommPage/](https://community-scripts.github.io/CommPage/) Here is the categorized catalog of what is available: --- ### 1. AI & Machine Learning - Cog (self-hosted AI) - ComfyUI (Stable Diffusion UI) - Fabric (AI-powered CLI) - Flowise (build LLM apps) - Hollm (AI assistant) - InvokeAI (Stable Diffusion toolkit) - LocalAI (local OpenAI-compatible API) - Lobe (AI chat interface) - Maid (AI chat) - Ollama (run LLMs locally) - Open WebUI (formerly Ollama WebUI) - Stable Diffusion Web UI (Automatic1111) - Txt2Tts (Text-to-Speech) ### 2. Analytics & Data - Apache Kafka - Grafana (visualization) - HiveMQ (MQTT broker) - InfluxDB (time-series database) - N8n (workflow automation) - Node-RED (flow-based programming) - Strapi (headless CMS) - Wazuh (security analytics) ### 3. Build Tools & Development - Adguard (DNS sinkhole) - Code Server (VS Code in browser) - Docker (Docker inside an LXC) - GitLab - Nest (Node.js framework) - Portainer Agent - Rustdesk (remote desktop) - Umami (web analytics) ### 4. Databases - Apache CouchDB - Chroma (vector DB) - InfluxDB - MariaDB - MongoDB - MySQL - PostgreSQL - Redis - Sentry (error tracking) ### 5. Gaming - Aster (game server manager) - Fleet (game server) - Minecraft Bedrock / Minecraft Java - Palworld - Steam CMD (server manager) - Survival (game server) - Terraria - Valheim ### 6. Home Automation & Smart Home - Docker (often used for HA) - ESPHome - Home Assistant (Core and OS) - Homebridge - Homepage (dashboard) - Matter (bridge) - OpenHAB - Scrypted (NVR/Camera) - TasmoAdmin - ZoneMinder (CCTV) ### 7. Media & Entertainment - Audiobookshelf (audiobook/podcast server) - Emby - Jellyfin - Lidarr (music) - Plex - Radarr (movies) - Sonarr (TV shows) - Tautulli (Plex monitoring) - Tdarr (media transcoding) - Zoraxy (reverse proxy for media) ### 8. Network & DNS - AdGuard Home - Caddy (web server) - Crowdsec (security tool) - Docker (for networking tools) - Nginx Proxy Manager - OpenVPN - Pi-hole - Tailscale - Traefik - Uptime Kuma - WireGuard ### 9. Security & Privacy - Authelia (auth) - Bitwarden (password manager) - Crowdsec - Duplicati (backup) - Filebrowser - Gitea (Git server) - Immich (photo backup) - Vaultwarden (Bitwarden server) ### 10. Storage & Backup - Cockpit (server management) - Duplicati - Filebrowser - Glances (monitoring) - Netdata (monitoring) - Nextcloud (file sync) - Syncthing - Uptime Kuma ### 11. Virtualization & OS - Alpine - Debian - Docker - Fedora - LXC (various distros) - Proxmox Backup Server - Rocky Linux - Ubuntu - Wubuntu --- ### How to Use the Scripts The scripts are designed to be run directly in the Proxmox Shell (SSH). The standard format is: bash bash -c "$(wget -qLO - https://github.com/community-scripts/ProxmoxVE/raw/main/vm/... )" Or for LXC containers, using the pveam tool or direct execution. However, the easiest and safest way is to use the Proxmox VE Helper Scripts website: 1. Go to https://community-scripts.github.io/CommPage/ 2. Search for the application you want. 3. Copy the exact command provided (it will look something like bash -c "$(wget -qLO - https://github.com/community-scripts/ProxmoxVE/raw/main/ct/...)"). 4. Paste it into your Proxmox root shell and follow the prompts. Note on changes: The community frequently adds new scripts and occasionally retires those that are no longer maintained upstream. If you are looking for a specific application (e.g., Findarr, Kavita, Mastodon, Nginx Proxy Manager), it is best to search the website or the vm and ct folders in the GitHub repository directly.

Получи версию Proxmox VE, статус кластера и ресурсы.

Получает 50 последних задач Proxmox для узла.

Проверяет одну асинхронную задачу Proxmox по узлу и непрозрачному UPID.

Генерирует отчёт о состоянии в стиле дворецкого со сравнением снимков, предупреждениями, заметными изменениями и предлагаемыми действиями. Сохраняет снимок, если не установлен параметр no_save, что сдвигает окно, от которого измеряется каждое последующее сравнение, поэтому цикл, вызывающий это, не оставляет ничего для сравнения.

Получает состояние системы, включая загрузку ЦП, память, использование диска и время работы, для машины, на которой выполняется этот бинарный файл. Внутри контейнера это контейнер, а не хост под ним.

Отправляет magic-пакет Wake-on-LAN, чтобы разбудить машину. Пакет отправляется по принципу «отправил и забыл»: успешный результат означает, что пакет отправлен, а не то, что что-то проснулось.

Добавляет контейнер Docker, модуль systemd или приложение PM2 в список наблюдения. Эта операция записывает список, и наблюдение за ним не начинается. Супервизор нужно устанавливать отдельно, и сделать это может только оператор. Повторное добавление цели возвращает added=false, а не ошибку.

Запускает однократную проверку перезапусков на отслеживаемых целях и сообщает о перезапусках, обнаруженных с момента последней проверки. Только цели docker можно проверить таким образом; цели systemd и pm2 отмечаются как пропущенные, а не считаются здоровыми.

Перечисляет записанные инциденты перезапуска, сначала самые новые. Захваченные логи исключаются, если не установлен include_logs, потому что каждый инцидент содержит сто строк вывода дважды.

Перечисляет наблюдаемые цели, их тип и результат последней проверки.

Удаляет цель из списка наблюдения, оставляя её записанные инциденты на месте. Меняется только список: то, что за ней наблюдало, продолжает работать, пока оператор не остановит его.