맥미니에서 24시간 끊기지 않는 Hermes 셋팅 (ft. Tailscale, Hermes Desktop Remote)

┌─────────────────────── 맥미니 (24시간 켜둠) ───────────────────────┐
│                                                                    │
│   launchd (macOS 자동실행 관리자)                                  │
│     ├── ai.hermes.gateway     ← 메신저 봇 (죽으면 자동 재시작)     │
│     └── ai.hermes.dashboard   ← 웹 관리화면 (죽으면 자동 재시작)   │
│                                    │                               │
│                                    └─ 100.x.y.z:9119 에만 바인딩   │
│                                       (= Tailscale 주소에만 열림)  │
└────────────────────────────────────┼───────────────────────────────┘
                                     │  Tailscale 사설망 (암호화)
        ┌────────────────────────────┼────────────────────────────┐
        │                            │                            │
   ┌────▼────┐                  ┌────▼────┐                  ┌────▼────┐
   │  맥북    │                  │ 아이패드 │                  │   폰     │
   │ Hermes  │                  │ 브라우저 │                  │ 브라우저 │
   │ Desktop │                  └─────────┘                  └─────────┘
   │ (remote)│
   └─────────┘
                    ❌ 인터넷의 다른 사람들 — 아예 도달 불가

tailscale ip -4
# 출력 예: 100.101.102.103

# 내 기기 목록 확인 — 여기 뜨는 기기들만 서버에 접근할 수 있게 됩니다
tailscale status

hermes dashboard --host 100.101.102.103 --port 9119

HERMES_DASHBOARD_BASIC_AUTH_USERNAME=원하는아이디
HERMES_DASHBOARD_BASIC_AUTH_PASSWORD=충분히_긴_랜덤_비밀번호
HERMES_DASHBOARD_BASIC_AUTH_SECRET=세션서명용_랜덤_문자열

openssl rand -base64 24   # 두 번 실행해서 각각 PASSWORD / SECRET 에 사용

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
    <key>Label</key>
    <string>ai.hermes.dashboard</string>
​
    <key>ProgramArguments</key>
    <array>
        <string>/Users/YOUR_NAME/.hermes/hermes-agent/venv/bin/python</string>
        <string>-m</string>
        <string>hermes_cli.main</string>
        <string>dashboard</string>
        <string>--host</string>
        <string>100.101.102.103</string>
        <string>--port</string>
        <string>9119</string>
        <string>--no-open</string>
        <string>--skip-build</string>
    </array>
​
    <key>WorkingDirectory</key>
    <string>/Users/YOUR_NAME/.hermes/hermes-agent</string>
​
    <key>EnvironmentVariables</key>
    <dict>
        <key>PATH</key>
        <string>/Users/YOUR_NAME/.hermes/hermes-agent/venv/bin:/Users/YOUR_NAME/.local/bin:/opt/homebrew/bin:/usr/local/bin:/usr/bin:/bin:/usr/sbin:/sbin</string>
        <key>VIRTUAL_ENV</key>
        <string>/Users/YOUR_NAME/.hermes/hermes-agent/venv</string>
        <key>HERMES_HOME</key>
        <string>/Users/YOUR_NAME/.hermes</string>
        <key>PYTHONUNBUFFERED</key>
        <string>1</string>
    </dict>
​
    <key>RunAtLoad</key>
    <true/>
​
    <key>KeepAlive</key>
    <dict>
        <key>SuccessfulExit</key>
        <false/>
    </dict>
​
    <key>StandardOutPath</key>
    <string>/Users/YOUR_NAME/.hermes/logs/dashboard.log</string>
​
    <key>StandardErrorPath</key>
    <string>/Users/YOUR_NAME/.hermes/logs/dashboard.error.log</string>
</dict>
</plist>

launchctl bootstrap "gui/$(id -u)" ~/Library/LaunchAgents/ai.hermes.dashboard.plist
launchctl enable    "gui/$(id -u)/ai.hermes.dashboard"
launchctl kickstart -k "gui/$(id -u)/ai.hermes.dashboard"

# state = running 이면 성공
launchctl print "gui/$(id -u)/ai.hermes.dashboard" | grep -E 'state|pid'
​
# HTTP 응답 확인 (인증을 켜면 302, 껐으면 200)
curl -s -o /dev/null -w '%{http_code}\n' http://100.101.102.103:9119/

# plist 수정 후 반영
launchctl bootout   "gui/$(id -u)/ai.hermes.dashboard"
launchctl bootstrap "gui/$(id -u)" ~/Library/LaunchAgents/ai.hermes.dashboard.plist
​
# 로그 실시간으로 보기 (문제 생기면 1순위)
tail -f ~/.hermes/logs/dashboard.error.log

#!/usr/bin/env bash
# Hermes 웹 대시보드 24/7 launchd 서비스 배포 (Tailscale IP 바인딩). 멱등 — 재실행 안전.
set -euo pipefail
​
REPO_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
PLIST_SRC="$REPO_DIR/ai.hermes.dashboard.plist"
LABEL="ai.hermes.dashboard"
PLIST_DST="$HOME/Library/LaunchAgents/$LABEL.plist"
HERMES_AGENT="$HOME/.hermes/hermes-agent"
WEB_DIR="$HERMES_AGENT/web"
DIST="$HERMES_AGENT/hermes_cli/web_dist"   # vite outDir — web/dist 아님!
BIND_IP="100.101.102.103"                  # ← 본인 Tailscale IP
PORT="9119"
​
echo "==> Pre-flight"
[ -x "$HERMES_AGENT/venv/bin/python" ] || { echo "✗ hermes venv python 없음"; exit 1; }
[ -f "$PLIST_SRC" ] || { echo "✗ plist 원본 없음: $PLIST_SRC"; exit 1; }
​
# 바인딩 IP가 이 호스트의 실제 Tailscale IP와 같은지 점검 (다르면 경고)
TS_IP="$(/Applications/Tailscale.app/Contents/MacOS/Tailscale ip -4 2>/dev/null || tailscale ip -4 2>/dev/null || true)"
if [ -n "$TS_IP" ] && [ "$TS_IP" != "$BIND_IP" ]; then
  echo "⚠ Tailscale IP($TS_IP) != plist 바인딩 IP($BIND_IP). plist를 갱신 후 진행하세요." >&2
fi
​
echo "==> web dist 확인 ($DIST)"
if [ ! -f "$DIST/index.html" ]; then
  echo "   dist 없음 — 빌드 (npm install && npm run build)…"
  ( cd "$WEB_DIR" && npm install && npm run build )
else
  echo "   dist 존재 — 빌드 생략 (강제 재빌드: '$DIST' 삭제 후 재실행)"
fi
[ -f "$DIST/index.html" ] || { echo "✗ dist 빌드 실패"; exit 1; }
​
echo "==> 잔여 대시보드 프로세스 정리 (메신저 봇은 건드리지 않음)"
hermes dashboard --stop || true
​
echo "==> plist 설치 -> $PLIST_DST"
mkdir -p "$HOME/Library/LaunchAgents"
cp "$PLIST_SRC" "$PLIST_DST"
​
echo "==> launchd 서비스 (재)로드"
launchctl bootout   "gui/$(id -u)/$LABEL" 2>/dev/null || true
launchctl bootstrap "gui/$(id -u)" "$PLIST_DST" 2>/dev/null || launchctl load -w "$PLIST_DST"
launchctl enable    "gui/$(id -u)/$LABEL" 2>/dev/null || true
launchctl kickstart -k "gui/$(id -u)/$LABEL" 2>/dev/null || true
​
echo "==> 검증 (바인딩 대기…)"
sleep 4
launchctl print "gui/$(id -u)/$LABEL" 2>/dev/null | grep -E "state =|pid =" | head || true
code="$(curl -s -o /dev/null -w '%{http_code}' "http://$BIND_IP:$PORT/" || true)"
echo "   http://$BIND_IP:$PORT/ -> HTTP $code"
echo "✓ 완료. Tailscale 기기 브라우저에서 http://$BIND_IP:$PORT 접속 (이름 말고 IP로!)"

chmod +x infra/launchd/install-dashboard.sh
./infra/launchd/install-dashboard.sh

http://100.101.102.103:9119

{
  "mode": "remote",
  "remote": {
    "url": "http://100.101.102.103:9119",
    "authMode": "oauth"
  }
}

tail -20 ~/.hermes/logs/desktop.log
# "Remote Hermes backend is ready" 가 보이면 성공

ln -sfn ~/.hermes/hermes-agent/apps/desktop/node_modules/electron \
        ~/.hermes/hermes-agent/node_modules/electron
cd ~/.hermes/hermes-agent/apps/desktop && npm run pack

ditto ~/.hermes/hermes-agent/apps/desktop/release/mac-arm64/Hermes.app /Applications/Hermes.app
xattr -cr /Applications/Hermes.app
codesign --force --deep --sign - /Applications/Hermes.app
codesign --verify /Applications/Hermes.app     # "valid on disk" 확인

# 1) 서비스가 running 인가
launchctl print "gui/$(id -u)/ai.hermes.dashboard" | grep -E 'state|pid'
​
# 2) 대시보드가 응답하는가 (인증 켰으면 302, 껐으면 200)
curl -s -o /dev/null -w '%{http_code}\n' http://100.101.102.103:9119/
​
# 3) 엉뚱한 이름으로는 막히는가 (400이 나와야 정상)
curl -s -o /dev/null -w '%{http_code}\n' -H 'Host: bogus.example.com' http://100.101.102.103:9119/
​
# 4) 메신저 봇도 살아있는가
hermes gateway status
​
# 5) 진짜 안 죽는지 — 강제로 죽여보고 되살아나는지 확인 (KeepAlive 테스트)
pkill -f 'hermes_cli.main dashboard' ; sleep 15
launchctl print "gui/$(id -u)/ai.hermes.dashboard" | grep -E 'state|pid'   # 새 pid로 running