Repolode
dsgnr

dsgnr/portchecker.io

Проверка TCP-портов с открытым исходным кодом, REST API и веб-интерфейсом; можно развернуть самостоятельно через Docker, проект создан на Litestar.

Звёзды
198
Форки
10
Открытые issues
1
Последний коммит
6 дней назад

Что это?

portchecker.io проверяет, доступен ли TCP-порт на указанном домене или IP-адресе. Сервис помогает разбираться с настройками сети, проверять правила межсетевого экрана и видеть, какие порты доступны извне.

Проект состоит из двух частей: статического фронтенда на React, который раздаёт Nginx, и API на Python и Litestar, работающего под gunicorn с воркерами uvicorn. Обе части можно запускать отдельно для разработки или вместе через Docker Compose, используя готовые образы из GitHub Container Registry.

По умолчанию API отказывается проверять частные IP-адреса из специальных диапазонов IANA; параметр ALLOW_PRIVATE разрешает такие проверки. API также предоставляет эндпоинт Prometheus /metrics для сбора данных о времени ответа и кодах состояния, а в CI выполняются smoke-тесты и браузерные тесты на Playwright.

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

  • 01Проверяет доступность TCP-порта на любом домене или IP-адресе.
  • 02Предоставляет REST API с документацией по эндпоинтам на /docs.
  • 03Включает веб-интерфейс, который раздаёт Nginx.
  • 04Работает в Docker; доступны готовые образы и файлы Docker Compose.
  • 05Предоставляет эндпоинт метрик Prometheus для мониторинга API.
  • 06При необходимости позволяет проверять частные диапазоны IP-адресов.

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

  • Проверить, открыт ли порт сервиса после изменения правил межсетевого экрана.
  • Убедиться извне сети, что порты сервера доступны так, как задумано.
  • Встроить проверку портов в скрипты или системы мониторинга через REST API.
  • Самостоятельно развернуть проверку портов на собственной инфраструктуре.

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

  1. 1

    Запустите production-стек с помощью Docker Compose (фронтенд на порту 8080, API на порту 8000).

    docker-compose up

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

  • Лицензия GPL-3.0 — это лицензия с авторским левом, требующая открывать производные работы на тех же условиях.
  • Для разработки без Docker нужны Python 3.13 с Poetry и Node 26 или новее, поэтому Docker — более простой вариант.

В подборках

Темы

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

Что такое portchecker.io?
Проверка TCP-портов с открытым исходным кодом, REST API и веб-интерфейсом; можно развернуть самостоятельно через Docker, проект создан на Litestar. portchecker.io проверяет, доступен ли TCP-порт на указанном домене или IP-адресе. Сервис помогает разбираться с настройками сети, проверять правила межсетевого экрана и видеть, какие порты доступны извне.
portchecker.io можно использовать бесплатно? Какая у него лицензия?
portchecker.io распространяется с открытым исходным кодом под лицензией GPL-3.0. Перед использованием в коммерческих продуктах проверьте условия лицензии.
portchecker.io всё ещё поддерживается?
Активно поддерживается. Последний коммит в portchecker.io — 1 нояб. 2026 г..
Для чего можно использовать portchecker.io?
Проверить, открыт ли порт сервиса после изменения правил межсетевого экрана. Убедиться извне сети, что порты сервера доступны так, как задумано. Встроить проверку портов в скрипты или системы мониторинга через REST API. Самостоятельно развернуть проверку портов на собственной инфраструктуре.
Как установить portchecker.io?
Запустите production-стек с помощью Docker Compose (фронтенд на порту 8080, API на порту 8000).: docker-compose up
Где скачать portchecker.io?
Исходный код и инструкции по установке — на GitHub: https://github.com/dsgnr/portchecker.io

Описание создано ИИ на основе README проекта. Статистика GitHub обновляется ежедневно.

Похожие проекты

Быстрый сканер портов на Rust: находит открытые порты и передаёт результаты в Nmap или пользовательские скрипты.

20,7 тыс.+35 за неделю1,4 тыс.RustGPL-3.0Обновлён 3 дня назад