2026 렌탈 Mac mini M4 16GB MiroFish: 스택 하한, 포트 3000/5001, LLM 시크릿, 에이전트 게이트, 12단계 스모크
MiroFish는 오픈소스 다중 에이전트 「디지털 샌드박스」 예측 엔진입니다. 현실 시드를 넣고 에이전트가 상호작용한 뒤 시나리오 리포트를 냅니다. 팀은 16GB 통합 메모리 Mac mini M4를 렌탈해 Node 프론트와 Python 백엔드를 책상에 추가하지 않습니다. 본 플레이북은 상류 README를 재무 친화 계약으로 바꿉니다. 스택 하한, 포트 3000·5001, LLM 시크릿, 16GB 에이전트 게이트, 6리전 각주, 12단계 스모크입니다.
첫 배포 시 AI 서버 3레인(MiroFish는 전용 오케스트레이션), Node 22+ OpenClaw 제로아워 계약, 시뮬레이션 swap 급등 시 통합 메모리 플레이북을 함께 보세요. 하드웨어는 Apple Mac mini 사양을 따릅니다.
고지: Mac 렌탈은 KvmZone 서비스입니다. MiroFish 요건은 상류 GitHub, 하드웨어는 Apple 공식 사양을 인용합니다.
렌탈 Mac mini M4에 MiroFish를 두는 이유
MiroFish는 16GB에서 70B 로컬 모델 호스트가 아닙니다. 병행 에이전트·Node/Vite·Python API가 통합 메모리를 쓰는 오케스트레이터입니다. 렌탈은 장시간 시뮬레이션을 노트북에서 분리하고 LLM_API_KEY를 청구 가능한 서버에 둡니다.
| 이유 | 내용 |
|---|---|
| 듀얼 런타임 | 상류 문서대로 프론트 3000, API 5001 |
| 상주 데몬 | 원샷 CLI가 아니라 일 단위 프로세스 유지 |
| 시크릿 분리 | Gemini API 클라이언트와 같은 키 위생 |
| 컴플라이언스 | 상류 AGPL-3.0—프로덕션 재배포·네트워크 포크 전 법무 검토 |
스택 하한 매트릭스(clone 전 pin)
상류 하한을 통과한 뒤 clone합니다. OpenClaw와 공유 시 MiroFish 18+보다 22+를 우선하세요.
| 구성 | 상류 하한 | 렌탈 Mac 증거 |
|---|---|---|
| Node.js | 18+(공유 호스트 22+) | node -v 22.x |
| Python | ≥3.11, ≤3.12 | python3 --version 구간 내 |
| uv | 최신 | uv --version |
| APFS 여유 | 첫 clone 전 ≥25GB | df -h / |
설치는 SSH만—macOS 권한 프롬프트는 SSH vs VNC 워크플로를 참고하세요.
포트·디스크·16GB 에이전트 게이트
상류는 localhost:3000(UI), localhost:5001(API)입니다. 16GB에서는 에이전트 수를 청구·메모리 계약으로 봅니다.
| 면 | 기본 | 16GB 게이트 |
|---|---|---|
| 프론트 UI | 3000 | 루프백; SSH 터널 밖 노출 시 역프록시 |
| 백엔드 API | 5001 | 방화벽을 Runbook에 기록; 파일럿은 동일 호스트 |
| 에이전트 수 | 상류 LLM 비용 경고 | 파일럿 40 미만, 시뮬레이션 1레인/호스트 |
| 로그·캐시 | 실행마다 증가 | 로그 512MB 상한, 주간 로테이션 |
디스크: 여유 <18GB면 새 시드 중지, <12GB면 산출물 삭제 또는 렌탈 기간 매트릭스에 따라 1TB. 메모리: 30분 파일럿 후 swap >15%면 제2 호스트.
LLM API 시크릿과 SSH 위생
서버에서 .env.example→.env, 모드 0400, git 커밋 금지. 상류 README의 LLM_API_KEY, LLM_BASE_URL, LLM_MODEL_NAME, ZEP_API_KEY를 가정합니다.
- 키는 앱 git 체크아웃 밖에 두고 LLM 청구 급등 시 로테이션합니다.
- 공유 호스트에서는 MiroFish
.env와 OpenClaw webhook 시크릿을 분리합니다. npm run setup:all,npm run dev는 SSH 워크플로로 운영합니다.- 스모크 통과 후
launchdKeepAlive를 권장하고 재시작 절차를 Runbook에 남깁니다.
MiroFish 파일럿용 6리전 POP
KvmZone 노드: 홍콩, 일본(도쿄), 한국(서울), 싱가포르, US East, US West. GitHub 배지 지역이 아니라 리포트를 읽는 사람·LLM 청구 TZ에 가까운 노드를 고릅니다.
| 프로필 | 리전 | 병독 |
|---|---|---|
| CN 업무시간 시나리오 | 홍콩 또는 싱가포르 | AI 서버 레인 |
| JP 컴플라이언스·리뷰 TZ | 도쿄 | Gemini 클라이언트 |
| KR 자동화(서울 리뷰어 인접) | 한국(서울 노드)—요금 페이지에서 Compare | 병렬 렌탈 |
| US 태평양 저녁 배치 | US West | OpenClaw 제로아워 |
| EU 인수인계 | US East | 제2 호스트 |
Runbook 라벨 고정 전 요금 페이지에서 6리전을 Compare하세요. CPU 표보다 egress·리뷰 TZ가 중요합니다.
12단계 MiroFish 스모크
clone 후, Node/Python 업그레이드 후, LLM 키 로테이션 후 실행합니다. 재무 주간 ID와 스크린샷을 함께 보관하세요.
| 단계 | 게이트 | 합격 |
|---|---|---|
| 1 | SSH | 비대화 셸 |
| 2 | 스택 | Node 22+, Python 3.11–3.12, uv |
| 3 | Clone | 최고속 APFS에 상류 repo |
| 4 | .env | 로그에 키 미출력 |
| 5 | 백엔드 | 5001 응답 |
| 6 | 프론트 | 3000 UI 로드 |
| 7 | 건강 | 최소 시드 시뮬레이션 완료 |
| 8 | 에이전트 | 파일럿 상한 40 미만 |
| 9 | 메모리 | swap <15% |
| 10 | 로그 | 로테이션(512MB) |
| 11 | 리전 | Runbook에 KvmZone 노드(서울 등) 기록 |
| 12 | 재무 | 실행 URL+요금 캡처를 주간 ID와 보관 |
8–9단계 실패 시 LLM 지연 전 메모리 압력을 먼저 보세요.
FAQ
관련 글
- Mac mini M4 AI 서버 3레인 — MiroFish 위치
- OpenClaw 제로아워 계약 — Node 22+
- 통합 메모리·swap 플레이북
- Gemini 3.5 Flash API 클라이언트
- 렌탈 기간·병렬 디스크 매트릭스
- SSH vs VNC 보안 워크플로