앙스키 문서

Daemon 설정

앙스키 local daemon의 빌드, 진단, LAN 연결과 TLS 설정

앙스키 Daemon은 모바일과 웹이 연결하는 로컬 HTTPS 서버입니다. 현재 루트 스크립트 기준으로 실행 명령은 pnpm daemon입니다.

설치와 실행

의존성 설치

pnpm install

Daemon 빌드

pnpm daemon:build

루트 스크립트는 packages/agent-daemon/dist/index.js를 실행하므로 처음 한 번은 빌드가 필요합니다.

Daemon 시작

pnpm daemon

기본 실행값은 https://0.0.0.0:7632입니다.

상태 확인

pnpm daemon:status

기본 경로와 파일

Daemon은 런타임 상태를 ~/.angski/에 저장합니다.

~/.angski/
├── config.json
├── daemon.pid
├── daemon.log
├── angski.db
├── tls/
├── sandboxes/
└── ...

TLS

로컬 CA 사용

daemon은 자체 CA와 서버 인증서를 생성합니다. 모바일은 QR 흐름으로, 웹은 CA PEM 또는 fingerprint로 이 인증서를 신뢰합니다.

대표 파일:

  • ~/.angski/tls/ca-cert.pem
  • ~/.angski/tls/server-cert.pem
  • ~/.angski/tls/server-key.pem
  • ~/.angski/tls/sans.json

확인용 엔드포인트

엔드포인트설명
GET /간단한 상태와 uptime
GET /health상세 헬스 메트릭
GET /api/status연결/세션 요약
GET /fingerprint서버 fingerprint

환경 진단

pnpm daemon:doctor

다음을 확인하고 기존 설치의 private 파일 권한도 복구합니다.

  • Node.js 24, Codex CLI와 로그인 상태
  • Chromium과 pnpm
  • config, SQLite DB, 로컬 TLS 인증서
  • ~/.angski 디렉터리 0700, 파일 0600

Chromium 오류는 pnpm daemon:browser:install로 daemon과 버전이 맞는 브라우저를 설치한 뒤 다시 진단합니다.

기존 관리자 token이 너무 짧다면 다음 Daemon 시작 시 안전한 token으로 자동 교체됩니다. 기기별 자격 증명은 계속 유효하며, 과거 관리자 token을 직접 저장한 레거시 연결만 연결 페이지의 새 일회용 QR로 다시 연결해야 합니다.

LAN 밖에서 사용하기

로컬 daemon은 같은 LAN에서만 지원합니다. DDNS와 인터넷 포트 포워딩은 지원하지 않으며, 외부 네트워크에서는 앙스키 클라우드를 사용합니다. 7632, 7633 포트를 라우터에서 인터넷에 공개하지 마세요.

기본 확인값

현재 기준

  • 기본 포트는 7632 - daemon 시작 명령은 pnpm daemon - 환경 진단은 pnpm daemon:doctor - 기준 Node 버전은 24.x

On this page