IT Tools

Обзор

IT Tools

Личный набор браузерных утилит для разработчика: кодирование Unicode, хеши, форматы данных и другие небольшие операции. Рецепт раздаёт официальную статическую сборку без базы и аккаунтов. Интерфейс выбранной версии не переведён на русский: русские скриншоты показывают английский UI с авторскими русскими примерами.

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

Последний стабильный релиз — 2024-10-22. На 2026-10-25 более нового стабильного релиза не найдено. Используется явный тег; это не обещание свежести зависимостей. Браузерный smoke проверяет Base64 в обе стороны, SHA-256, JSON → YAML и отказ неверному JSON без внешних запросов в этих сценариях.

Оценка конфигурации (2026-10-25): loopback, UID 101, read-only корень, без capabilities и постоянных томов. Защита входа не встроена. Уязвимости образа не сканировались. Не вставляйте рабочие секреты в общий браузер. Настройки VITE фиксируются при сборке и не меняются через runtime env.

Пошаговая инструкция

Установка IT Tools

Нужны Docker Engine, Compose >=2.24, 1 CPU, 128 МБ RAM (256 МБ рекомендуются) и 1 ГБ диска для образа. Проверен amd64; образ также публикует arm64.

cp .env.example .env
docker compose up -d --wait

Откройте http://127.0.0.1:8084. Входа нет. Для удалённого сервера: ssh -L 8084:127.0.0.1:8084 user@server.

Переменные

• IT_TOOLS_VERSION: явный официальный тег 2024.10.22-7ca5933.
• IT_TOOLS_PORT: HTTP-порт loopback, по умолчанию 8084.
• IT_TOOLS_BACKUP_DIR: необязательный каталог backup, иначе ./backups.

Файл config/nginx.conf задаёт непривилегированный порт контейнера 8080 и временные файлы в /tmp. Он доступен UID 101 только для чтения. Приложение статическое: добавление runtime VITE-переменных не меняет сборку.

VPS

На VPS оставьте порт закрытым firewall. Открывайте через SSH-туннель, VPN либо отдельно защищённый HTTPS-шлюз.

LAN / VPN

Для домашней сети используйте туннель или VPN-прокси. Публикация интерфейса даёт доступ всем, кого пропускает сеть; аккаунтов нет.

HTTPS

Задайте DNS и настройте прокси из примеров ниже. Рецепт остаётся на loopback; HTTPS сам по себе не добавляет вход.

Caddy

В proxy/Caddyfile замените домен и порт. Пример для Caddy на том же хосте, с автоматическим TLS.

Nginx

В proxy/nginx.conf замените домен, порт и пути TLS-сертификатов. Это внешний прокси, отдельно от статического сервера контейнера.

Traefik

Подключите proxy/traefik.yaml к file provider, с websecure и letsencrypt. Для контейнерного прокси отдельно настройте сеть: его loopback не указывает на хост.

Data / Данные

Сервер хранит только env, Compose и config/nginx.conf. Избранное, язык, тема и часть ввода находятся в local storage браузера. Не считайте серверный backup копией браузерных данных.

Backup

Запустите ./backup.sh. Он архивирует config, env и Compose без остановки статического сервера. Храните внешнюю копию; если добавили секреты, шифруйте архив. Браузерный профиль сохраняется отдельно.

Restore / Восстановление

./restore.sh backups/it-tools-TIMESTAMP.tar.gz проверяет архив и синтаксис Nginx до замены, делает страховочный backup и запускает сервер с восстановленным config. Используйте доверенный архив и соответствующую версию. Env/Compose автоматически не активируются: сравните их вручную. Браузерные данные не восстанавливаются.

Update / Обновление

Изучите release notes, сохраните настройки, задайте явный тег и выполните docker compose pull && docker compose up -d --wait. Проверьте реальное преобразование в браузере. В текущем upstream нет новых стабильных релизов с 2024 года.

Rollback / Откат

Верните сохранённый тег и проверенный config из backup. Сервера базы нет; браузерное хранилище новая версия может менять отдельно.

Removal / Удаление

docker compose down удаляет контейнер, сохраняя локальные config/env и браузерные данные. Удалите локальные файлы отдельно после backup; очистка сайта в браузере удаляет его предпочтения.

Проверка

./smoke-test.sh использует Docker, Bash, curl, Python 3, Node >=22 и npm. Во временный каталог устанавливается Playwright 1.62.1 и Chromium; нужны системные библиотеки Chromium. Тест изменяет только собственную временную копию рецепта и удаляет её.

Сообщить о проблеме с рецептом

Рассказать, как прошло на вашем сервере

Откроется предзаполненный issue на GitHub. Нужен аккаунт GitHub; после отправки сообщение будет публичным.

Диагностика

Решение проблем

• Не открывается: проверьте loopback-порт и SSH-туннель. Контейнер слушает 8080; опубликованный порт по умолчанию 8084.
• Nginx не запускается: проверьте config/nginx.conf, права чтения UID 101 и временные пути /tmp. Не возвращайте root ради ошибки конфигурации.
• Нет избранного или ввод пропал: состояние хранится в браузере; серверный backup его не содержит. Проверьте origin, профиль и режим приватного просмотра.
• Русского языка нет: выбранный upstream-релиз не содержит русского перевода. Русская документация и примеры не меняют интерфейс.
• Переменная env не влияет: VITE-настройки применяются при сборке, не при старте официального статического образа.
• Restore отклонён: используйте полный собственный архив и соответствующий тег; неверный Nginx и неполные архивы отклоняются до замены.

docker compose ps
docker compose logs --tail=100 it-tools

Не публикуйте рабочие данные из браузера и секреты ваших прокси-настроек. Перед публичным доступом отдельно настройте необходимую защиту шлюза.