Crow’s NestMQTT

MQTT 브로커 연결 및 통신

TCP, TLS, WebSocket(ws://, wss://)을 지원하며, HTTP(S) 포워드 프록시를 통한 WebSocket 연결도 가능합니다. 연결 설정에서 호스트, 포트, TLS 사용 여부, WebSocket 경로 등을 구성할 수 있습니다.

토픽 구독 및 메시지 게시

토픽을 구독하고 메시지를 게시할 수 있습니다. 게시 시 MQTT V5 속성(예: 응답 토픽, 상관 데이터, 사용자 속성)을 설정할 수 있으며, 파일에서 페이로드를 불러올 수도 있습니다.

메시지 실시간 시각화 및 로그 표시

수신된 메시지는 토픽 트리와 히스토리 뷰에 실시간으로 표시됩니다. 페이로드는 content-type에 따라 JSON, 이미지, 비디오, hex 뷰어로 자동 렌더링되며, 원시 텍스트로도 볼 수 있습니다.

고급 기능

• MQTT V5 기능 지원: 향상된 인증, 메시지 만료 표시, 요청/응답 패턴 지원
• 토픽 필터링 및 페이로드 검색
• 메시지 내보내기(JSON 또는 텍스트)
• 토픽별 통계 보기
• 키보드 단축키 및 명령 팔레트 제공

Windows

Microsoft Store에서 설치하거나, PowerShell에서 winget 명령어를 사용할 수 있습니다.

winget install koepalex.CrowsNestMQTT

GitHub Releases에서 .msixbundle 파일을 다운로드하여 설치할 수도 있습니다. 이 경우 Windows 개발자 모드를 활성화해야 합니다.

macOS

Homebrew를 통해 설치할 수 있습니다.

brew tap koepalex/crowsnest
brew install --cask crowsnestmqtt

Linux

GitHub Releases에서 플랫폼별 아카이브를 다운로드하여 실행 파일을 직접 실행합니다. 비디오 재생을 위해 VLC 플러그인 모듈을 설치할 수 있습니다.

sudo apt install vlc-plugin-base

기본 사용법

애플리케이션을 실행한 후, 연결 설정에서 MQTT 브로커 주소와 포트를 입력하고 연결합니다. 토픽 트리에서 구독할 토픽을 선택하거나, 명령 팔레트(Ctrl+Shift+P)를 통해 :subscribe 명령을 사용할 수 있습니다. 메시지를 게시하려면 Ctrl+Shift+M으로 게시 창을 열고 토픽과 페이로드를 입력합니다.

Q: Windows에서 GitHub Releases 패키지를 설치할 수 없습니다.

GitHub Releases의 패키지는 서명되지 않았으므로 Windows에서 설치하려면 개발자 모드를 활성화해야 합니다. 설정 > 시스템 > 개발자용에서 개발자 모드를 켠 후 설치하세요.

Q: macOS에서 앱을 실행할 수 없습니다.

현재 macOS 릴리스는 Apple Developer 서명/공증을 받지 않았습니다. Finder에서 앱을 마우스 오른쪽 버튼으로 클릭하고 ‘열기’를 선택하거나, 터미널에서 xattr -dr com.apple.quarantine /Applications/CrowsNestMQTT.app 명령을 실행하여 격리 속성을 제거하세요.

Q: Azure Event Grid에 연결할 수 없습니다.

Azure Event Grid 연결 문제는 일반적으로 호스트 이름, 클라이언트 ID, RBAC 역할, 구독 필터 설정과 관련이 있습니다. README의 문제 해결 섹션을 참조하세요.