Standalone (셀프호스트)
스탠드얼론 모드는 ADHDev 전체를 한 대의 머신에서 실행합니다. 로컬 대시보드, 로컬 HTTP/WebSocket API, session-host 런타임을 단일 프로세스로 묶습니다 — 계정 없음, 클라우드 연결 없음, P2P 없음, TURN 없음.
ADHDev의 AGPL-3.0 오픈소스 표면이며 @adhdev/daemon-standalone으로 게시됩니다.
언제 사용하나
제어하려는 모든 것이 눈앞의 머신에 있거나, 직접 접근 가능한 자체 LAN 상의 머신에 있을 때 스탠드얼론이 올바른 선택입니다.
이것은 클라우드 대시보드의 셀프호스트 대체재가 아닙니다. 스탠드얼론은 의도적으로 다음을 포함하지 않습니다:
- 푸시 알림 — 승인, 완료, 연결 해제 알림이 휴대폰으로 가지 않습니다
- 인터넷을 통한 원격 접근 — 시그널링 서버가 없으므로 네트워크 외부에서의 연결이 없습니다
- 멀티 머신 플릿 — 하나의 스탠드얼론 서버는 자기 머신만 관리합니다
이것들은 클라우드 기능입니다. 필요하다면 클라우드 데몬에 대해 시작하기를 참고하세요.
시작하기
npm install -g adhdev
adhdev standaloneadhdev standalone은 얇은 래퍼입니다: CLI가 설치된 npm 채널에 맞춰 @adhdev/daemon-standalone 패키지를 해석하고 실행합니다. OSS 패키지를 직접 실행할 수도 있습니다:
npm install -g @adhdev/daemon-standalone
adhdev-standalone또는 전역 설치 없이:
npx @adhdev/daemon-standalone그런 다음 http://localhost:3847을 여세요.
정상 동작: 대시보드가 로드되고 로컬 머신이 표시됩니다. 로그인 화면은 없습니다 — 스탠드얼론에는 계정이 없습니다.
TIP
공개 설치 테스트가 된 경로는 macOS와 Windows입니다. Linux도 스탠드얼론에서 동작할 수 있지만, 지원되는 경로로 제시하기에는 충분히 검증되지 않았습니다.
포트와 바인딩
스탠드얼론 서버는 대시보드와 HTTP/WebSocket API를 하나의 포트에서 제공하며, 기본값은 3847이고 127.0.0.1(루프백 전용)에 바인딩됩니다.
adhdev standalone --port 4000LAN 접근
네트워크의 다른 기기에서 대시보드에 접근하려면 루프백이 아닌 주소로 바인딩하세요:
adhdev standalone --host 0.0.0.0 --token <some-secret>--host는 명시적인 주소를 받습니다 — IPv4 주소, IPv6 주소, 또는 localhost. 불리언 형태는 없습니다: 값 없는 맨 --host나 인식되지 않는 값은, 요청하지도 않은 바인딩이 조용히 일어나는 대신 눈에 보이는 시작 실패가 됩니다.
WARNING
--host 0.0.0.0(또는 IPv6 any-address ::)은 모든 인터페이스에 바인딩합니다. 스탠드얼론은 기본적으로 인증이 없으므로, 그 포트에 도달할 수 있는 누구든 당신의 에이전트를 완전히 제어하게 됩니다. 공개 바인딩에는 항상 --token을 함께 쓰세요. 인증 없이 공개 바인딩하면 서버가 시작 시 경고를 출력합니다.
--token은 대시보드가 연결하기 전에 해당 토큰을 요구합니다. 스탠드얼론이 가진 유일한 인증 메커니즘입니다.
플래그
| 플래그 | 용도 |
|---|---|
--port, -p <port> | HTTP/WS 서버 포트 (기본값 3847) |
--host, -H <address> | 명시적 바인드 주소 — IPv4, IPv6, 또는 localhost (기본값 127.0.0.1) |
--token <token> | 대시보드 사용 시 이 토큰을 요구 |
--dev | 프로바이더 스크립트 작성·테스트를 위한 DevConsole 활성화 |
--public <path> | 대시보드 배포본의 사용자 지정 경로 |
--no-open | 시작 시 브라우저를 열지 않음 |
--help, -h | 사용법 표시 |
스탠드얼론에서 동작하는 것
대시보드가 뜨고 나면 로컬 에이전트 표면은 클라우드 모드와 동일하게 동작합니다:
- CLI 에이전트와 ACP 에이전트 감지 및 실행
- 대시보드에서 채팅 읽기, 메시지 보내기, 승인 프롬프트 응답
- 세션 목록, 전환, 터미널 뷰
- 로컬 모드의 MCP 서버 —
http://localhost:3847과 통신합니다
스탠드얼론 vs 클라우드
| 스탠드얼론 | 클라우드 | |
|---|---|---|
| 계정 필요 | 아니오 | 예 |
| 전송 | 자기 머신에서의 직접 HTTP/WS | P2P WebRTC, 차단된 NAT에는 TURN |
| 인터넷에서 접근 가능 | 아니오 | 예 |
| 대시보드당 머신 수 | 하나 | 플랜에 따라 다름 |
| 푸시 알림 | 아니오 | 예 |
| 인증 | 선택적 --token | OAuth, API 키, 머신 시크릿 |
| 라이선스 | AGPL-3.0 | 독점 |
더 깊은 설정
OSS 저장소에 스탠드얼론 내부 구조의 레퍼런스 문서가 있습니다 — 패스워드 인증, 저장된 호스트 기본값, 로컬 설정 파일 위치, 로컬 API 표면, session-host 런타임: