✨ 기능
| 기능 | 설명 |
|---|
| 🖥️ | 시스템 상태 | CPU, RAM, 디스크, 네트워크, 가동 시간을 Telegram으로 확인 |
| 🚀 | 부팅 알림 | PC가 부팅되면 Telegram으로 즉시 알림 |
| 👁️ | 프로세스/서비스 감시 | Ollama, PostgreSQL, 개발 서버 등의 상태 모니터링 |
| 📋 | 이벤트 로그 감시 | Windows 오류/심각 이벤트를 Telegram으로 전달 |
| 🔔 | 토스트 알림 전달 | Windows 알림을 프라이버시 필터링·앱별 묶음과 함께 휴대폰 앱으로 암호화 전달(기본 켜짐) |
| 📲 | 앱 푸시 알림 | 경보·부팅·Windows 알림을 Homebase 앱으로 UnifiedPush 종단 암호화(RFC 8291) 전송, 실패 시에만 Telegram |
| 🔒 | 프라이버시 우선 | 비밀번호, OTP, 토큰 마스킹; 민감 앱 차단 |
| 🔇 | 조용한 시간 | /mute 1h로 일시적으로 알림 음소거 |
| 📊 | SQLite 로깅 | 명령 및 알림 이력 영구 저장 |
| 📱 | 휴대폰 실시간 모니터링 | 여러 PC를 QR로 등록하고, 열린 창·창별 CPU/RAM/I/O/네트워크·Claude Code 세션을 실시간으로 확인 (Android, 아래 참고) |
🚀 시작하기
사전 요구사항
- Windows 10/11 (버전 1809 이상)
- Telegram 계정 + BotFather 봇 토큰
- 설치 파일에 .NET 런타임이 포함되어 있어 별도 런타임 설치는 필요 없습니다
설치 — 어느 파일을 받나요?
최신 릴리스에서 상황에 맞는 파일 하나만 받으세요.
| 파일 | 이럴 때 받으세요 |
|---|
Homebase-Setup.exe | ⭐ 대부분 이것 하나면 됩니다. 더블클릭하면 마법사가 토큰·chat ID를 묻고 설치를 끝냅니다 |
Homebase-Setup.zip | 마법사 없이 수동 설치. 압축을 풀고 관리자 PowerShell에서 .\setup.ps1 실행 |
bootstrap.ps1 | 명령 한 줄 설치 (아래 방법 B) |
방법 A — 설치 마법사 (권장)
Homebase-Setup.exe를 받아 더블클릭- Windows SmartScreen 경고("Windows의 PC 보호")가 뜨면 → 추가 정보 → 실행을 누르세요. 서명되지 않은 개인용 앱이라 표시되는 정상 경고입니다
- 마법사가 물어보는 Telegram 봇 토큰과 chat ID 입력
- 설치가 끝나면 Telegram에서 봇에게
/ping 전송
방법 B — 한 줄 설치
관리자 권한 PowerShell에서:
irm https://github.com/jeiel85/homebase/releases/latest/download/bootstrap.ps1 | iex
chat ID를 모르나요? 봇에게 아무 메시지나 보낸 뒤 https://api.telegram.org/bot<봇토큰>/getUpdates를 열어 chat.id 값을 확인하세요.
직접 빌드
.NET 9 SDK가 필요합니다.
dotnet build LocalOpsBot.sln
🤖 명령어
| 명령어 | 설명 |
|---|
/ping | 봇 상태 확인 |
/help | 사용 가능한 명령어 표시 |
/status | 전체 PC 상태 (CPU, RAM, 디스크, 네트워크) |
/uptime | 시스템 가동 시간 |
/disk | 드라이브별 디스크 사용량 |
/process | 감시 중인 프로세스 상태 |
/services | Windows 서비스 상태 |
/events | 최근 Windows 이벤트 로그 |
/alerts | 최근 알림 이력 |
/mute 1h | 일정 시간 동안 알림 음소거 |
/unmute | 알림 다시 활성화 |
/diagnostics | 에이전트 자체 진단 |
📱 휴대폰 앱 (Homebase Mobile)
PC에서 에이전트로 돌리는 작업을 휴대폰에서 실시간으로 지켜봅니다. 집·회사·노트북 PC를 여러 대 등록하고 목록에서 골라 들어가면
그 PC의 열린 창 목록(Chrome은 창마다 활성 탭 제목), 창(프로세스)별 CPU·RAM·I/O·네트워크, 최근 활동한 Claude Code 세션 제목이 1초마다 갱신됩니다.
- 연결 (Tailscale은 선택): QR 한 장에 PC로 가는 경로가 모두 들어 있고, 앱이 휴대폰의 현재 네트워크를 보고 알아서 고릅니다.
- 같은 Wi-Fi·유선(LAN): 가장 빠릅니다. PC의 사설 주소로 TLS 연결하며, 앱은 QR에 담긴 PC 인증서 지문만 신뢰합니다.
Windows가 그 네트워크를 개인(Private) 으로 분류해야 열립니다(공용이면 Connect Phone… 창이 알려 줍니다).
- Tailscale: PC와 휴대폰이 같은 tailnet에 있으면 어디서든 직접 연결합니다.
- Cloudflare Tunnel: Tailscale 없이 밖에서 볼 때 씁니다. PC가 Cloudflare로 outbound 연결만 하므로 공유기 포트를 열지 않습니다.
토큰을 넣지 않으면 계정 없는 Quick Tunnel(임시 주소, PC 재시작마다 바뀜 — 앱이 LAN/Tailscale로 한 번 붙으면 새 주소를 자동으로 배움)을,
Cloudflare 대시보드에서 만든 터널의 토큰과 공개 호스트명을 넣으면 고정 주소를 씁니다.
cloudflared가 필요하며 창에서 바로 설치할 수 있습니다.
어느 경로든 인증은 같은 페어링 토큰(Bearer)이고, 앱 상세 화면 위쪽에 지금 붙은 경로(LAN/Tailscale/Cloudflare)가 표시됩니다.
- 가벼움: 휴대폰이 상세 화면을 보고 있을 때만 수집합니다. 보지 않을 때 추가 부하는 사실상 0입니다.
- 설치: 최신 릴리스의
Homebase-Mobile.apk를 휴대폰에서 받아 설치합니다. 이후 업데이트는 앱이 하루 한 번 확인해 알려 줍니다.
- 연결하기: PC 트레이 아이콘 우클릭 → 설정… → 휴대폰 탭(영어 Windows: Settings… → Phone) → 쓸 경로를 고르고(기본: 전부) ENABLE과 관리자 승인 → 표시된 QR을 앱의 PC 추가로 스캔합니다.
앱이 아직 없다면 휴대폰 기본 카메라로 QR을 찍으세요. 설치 안내 페이지가 열리고, 설치 후 그 페이지의 앱에서 열기로 바로 연결이 이어집니다.
창의 CONNECTION PATHS에서 경로별 상태를 보고, 빠진 구성 요소(Tailscale·cloudflared)는 INSTALL(winget)로 설치합니다.
QR은 5분 동안 한 번만 쓸 수 있고, 같은 창에서 연결된 휴대폰을 해제할 수 있습니다.
- 푸시 알림 (UnifiedPush): PC 경보(프로세스·서비스·HTTP·포트 다운, 이벤트 로그, AI 조언), 부팅 알림, Windows 알림이 앱 알림으로 옵니다.
휴대폰에 UnifiedPush 배포자 앱 하나가 필요합니다. ntfy(무료, 계정 없음)를 Play 스토어나 F-Droid에서 설치하면
Homebase 앱이 처음 PC를 연결할 때 알아서 켭니다(앱 목록 아래 푸시 알림 스위치).
- Google Play 서비스가 없는 휴대폰은 F-Droid판 ntfy를 씁니다. F-Droid판은 ntfy 서버와 상시 연결을 하나 유지하고, 상시 알림을 하나 띄웁니다.
휴대폰이 절전(Doze) 중일 때도 이 연결을 유지하려면 ntfy의 배터리 최적화 예외를 켜야 합니다(설정 → 앱 → ntfy → 배터리 → 제한 없음).
켜지 않으면 절전 중 알림이 유지보수 창까지 늦어집니다. Homebase 앱이 이 상태를 감지해 푸시 알림 행에 안내합니다.
Play판 ntfy는 ntfy.sh 메시지를 FCM으로 깨워 받으므로 이 설정이 필요 없습니다. 내용은 PC에서 휴대폰 키로 암호화(RFC 8291)되어
ntfy 서버는 암호문만 봅니다. 알림 채널이 PC·앱별로 나뉘므로 Android 알림 설정에서 원하는 것만 끌 수 있습니다.
- 전환 기간에는 Telegram이 대체 채널입니다. 푸시를 등록한 휴대폰이 없거나 전송이 실패한 경보만 Telegram으로 갑니다.
Windows 알림은 Telegram으로 보내지 않습니다(평문 클라우드). 예전처럼 받으려면
notificationForwarding.telegramFallback: true.
- Windows 알림 포워딩은 이제 기본 켜짐이며 1Password·Bitwarden·Authy 등은 항상 차단, 6자리 코드·비밀번호·토큰은 마스킹합니다.
같은 앱의 알림은
bundleSeconds(기본 60초) 동안 한 건으로 묶고, 하루 (기본 150건)를 넘으면 버립니다.
ntfy.sh 익명 한도가 휴대폰(구독자) IP당 하루 250건이고 모든 PC가 이를 나눠 쓰기 때문입니다(2026-11-13 확인). PC가 여러 대면 이 값을 줄이세요. 설정 파일에 가 이미 적혀 있으면 그대로 꺼져 있습니다.
🌡️ 온도 모니터링
/status와 조언(/advise)에 CPU·보드 온도가 함께 표시됩니다. 센서 백엔드는 두 가지입니다.
- 기본값 — WMI/ACPI 센서: 커널 드라이버를 로드하지 않아 백신에 탐지되지 않습니다. 다만 메인보드 ACPI 존 온도만 제공하며, 많은 데스크톱은 이 값을 노출하지 않아 온도가 표시되지 않을 수 있습니다.
- 정밀 센서(opt-in) — LibreHardwareMonitor: CPU 코어별·GPU·보드 온도까지 읽지만, 이를 위해 WinRing0 커널 드라이버를 로드합니다. Windows Defender는 이 드라이버를 취약 드라이버(
VulnerableDriver:WinNT/Winring0)로 분류합니다.
정밀 센서를 켜려면 관리자 PowerShell에서:
& "C:\Program Files\Homebase\enable-temperature.ps1"
이 스크립트는 설정을 LibreHardware로 바꾸고, 드라이버에 대한 Defender 예외를 자동 등록한 뒤 서비스를 재시작합니다. 되돌리려면 -Disable을 붙여 실행하세요.
보안 주의: Defender 예외는 백신 탐지만 숨깁니다. 이 PC가 취약 드라이버 차단목록(메모리 무결성/HVCI/Smart App Control — 최신 Windows 11에서 기본 켜짐)을 적용 중이면, 예외와 무관하게 드라이버 로드가 커널 수준에서 차단되어 온도가 여전히 비어 있을 수 있습니다. 그 경우 기본 WMI 센서를 유지하세요.
여기까지가 README 앞부분입니다. 나머지는 원문에서 읽을 수 있습니다. README 전문 보기 ↗
