📊 raki research
⚙️ Setup

⚙️ Setup — 사이트 직접 호출 활성화

⚠️
최초 1회만 실행 — 그 후 영구 자동
로컬 API server (localhost:8765)를 launchd에 등록. macOS 부팅 시마다 자동 시작.

📋 Status

🔄 확인 중...

🔐 0단계 (Safari 사용자만): HTTPS server 활성화

Safari는 HTTPS → HTTP localhost fetch 차단. self-signed cert로 server를 HTTPS 모드 전환 + Safari에서 cert 한 번만 신뢰.

  1. 아래 버튼으로 server 재시작 명령 복사 → 터미널 실행
  2. Safari 새 탭에서 https://localhost:8765/health 방문
  3. 빨간 경고 페이지 → "이 웹사이트 둘러보기" 또는 "세부사항 표시" → "이 웹 사이트 방문"
  4. {"status":"ok"} JSON 보이면 신뢰 완료 → 이 페이지로 돌아와 health check

  

    ℹ️ 한 번 신뢰하면 cert 만료(10년) 또는 cert 재발급 전까지 영구. Safari·Chrome·Firefox 각자 한 번씩 방문 신뢰 필요.
  


  
🚀 1단계: 한 줄 명령으로 등록

  
아래 버튼을 누르면 다운로드 + 등록 명령어가 클립보드에 자동 복사됩니다. 터미널 한 번만 열어서 ⌘+V → Enter:

  
  


  
✅ 2단계: 확인

  
위 명령어 실행 후 아래 버튼으로 server 동작 확인:

  

  
🛑 server 중지·재시작 (필요 시)

  
# 중지
launchctl bootout gui/$(id -u) ~/Library/LaunchAgents/com.raki.api.plist

# 재시작
launchctl bootout gui/$(id -u) ~/Library/LaunchAgents/com.raki.api.plist 2>/dev/null
launchctl bootstrap gui/$(id -u) ~/Library/LaunchAgents/com.raki.api.plist

# 로그 확인
tail -f ~/projects/raki-research-html/logs/api.log



  
🔒 보안

  
    
    
  • localhost만 listen (외부 접근 X)
    • 
    
  • CORS raki-research-platform.netlify.app + localhost만 허용
    • 
    
  • vault 백업 자동 (각 chain 추가 시 timestamp.bak.yaml)
    • 
    
  • chain_id validation (TODO·중복 차단)
    • 
    
  • 중지: 위 launchctl bootout 명령
    •