개발을 위해 가짜 API가 필요하고, 30초 안에 준비되어야 합니다. 호스팅 서비스도 아니고, Docker Compose 스택도 아니며, 클릭할 GUI도 아닙니다. 그저 파일을 읽고 localhost에서 응답을 제공하기 시작하는 명령어 하나면 됩니다.
이것이 바로 경량 목(Mock) 서버가 하는 일입니다. OpenAPI 사양 또는 작은 데이터 파일을 지정하고, 하나의 명령을 실행하면 실제 백엔드가 아직 구축 중인 동안 프런트엔드나 테스트가 사용할 수 있는 실제와 같은 엔드포인트를 얻을 수 있습니다. 최고의 목 서버는 단일 바이너리 또는 npx로 실행 가능한 패키지로 제공되며, 1초 이내에 시작하고 거의 설정이 필요 없습니다. 여기에 있는 일부 더 무거운 옵션들은 JVM에서 실행되며 훨씬 더 많은 기능을 수행합니다. 이들은 고급 요청 매칭 또는 상태 저장 동작이 필요할 때 제 역할을 합니다.
이 가이드는 사용자의 요구가 가장 적은 6가지 CLI 목 서버를 순위별로 소개합니다. 아무것도 설치하지 않고 실행할 수 있는 도구부터 시작하여, 독립 실행형 JVM 서버를 다루고, Apidog CLI를 통한 통합 경로로 마무리합니다. 아래의 모든 설치 및 목 명령은 각 도구의 공식 문서를 통해 확인되었습니다. 명령줄을 넘어 더 넓은 분야를 원한다면, 최고의 API 목 도구 종합 문서에서 GUI 및 호스팅 옵션도 다룹니다.
CLI 목 도구가 "경량"인 이유
경량은 기능 개수가 아닌 설치 공간과 마찰에 관한 것입니다. 이 도구들을 비교할 때 다음 네 가지를 고려하십시오.
- 설치 크기 및 런타임.
npx로 실행할 수 있는 순수 Node 패키지는 몇 메가바이트에 불과합니다. 독립 실행형 JVM 서버는 Java 런타임이 필요한 20MB 이상의 jar 파일입니다. 둘 다 유효하지만, 이 목록의 양극단에 있습니다. - 시작 속도. 좋은 목 서버는 에디터로 돌아가기도 전에 실행됩니다. Node 기반 도구는 1초 이내에 콜드 스타트합니다.
- 첫 응답까지의 설정. 하나의 파일과 하나의 명령으로 아무것도 없는 상태에서 라이브 엔드포인트까지 도달할 수 있습니까? 가장 가벼운 도구들은 그렇다고 말합니다.
- 터미널 우선. 계정, 대시보드, GUI 단계가 필요 없습니다. 도구는 파일을 읽어 제공하며, 셸 스크립트나 CI 작업에 적합합니다.
도구들은 가장 작고 빠른 순서대로 정렬되어 있습니다. Prism, Mockoon CLI, json-server는 npx로 실행할 수 있으며 전역 설치가 필요 없습니다.
Prism (Stoplight)
Prism은 OpenAPI 파일을 하나의 명령으로 라이브 목 서버로 변환합니다. 이미 사양을 가지고 있다면, 이것은 목록에서 가장 적은 노력이 필요한 목 서버입니다. paths, examples 및 스키마를 읽고 일치하는 응답을 제공합니다.
npx @stoplight/prism-cli mock ./openapi.yaml
이는 사양에 있는 모든 작업을 연결하여 http://127.0.0.1:4010에서 서버를 시작합니다. Prism은 응답을 위해 정의한 example을 반환하거나, 정의하지 않았다면 스키마에서 유효한 무작위 응답을 생성합니다. 또한 들어오는 요청을 사양에 대해 유효성 검사하므로, 잘못된 호출은 조용히 통과되는 대신 적절한 422 응답을 받습니다. 전역 설치를 원한다면 npm install -g @stoplight/prism-cli를 사용하고 npx를 생략하십시오.
가장 적합한 경우: 계약에 충실한 목을 유지하고자 하는 사양 우선 팀. Prism은 Apache-2.0 라이선스이며 OpenAPI 3.1, 3.0, 2.0 및 Postman 컬렉션을 지원합니다.
솔직한 한계점: Prism은 상태 비저장입니다. POST는 아무것도 유지하지 않으므로, 생성-읽기 흐름을 흉내낼 수 없습니다. 목은 사양만큼만 좋으며, 빈약한 예시는 빈약한 응답을 의미합니다. 계약에 정확한 목을 만드는 것이 요점일 때 잘 맞으며, REST API 목 도구 워크플로와도 잘 어울립니다.
Mockoon CLI
Mockoon CLI는 무료 Mockoon 데스크톱 앱에서 내보낸 데이터 파일 또는 일반 OpenAPI 사양을 통해 목 API를 실행합니다. 데스크톱 앱은 시각적으로 경로를 구축할 수 있게 해주며, CLI는 CI 또는 서버에서 동일한 환경을 헤드리스로 실행합니다.
npx @mockoon/cli start --data ./mockoon-env.json --port 3000
--data를 Mockoon 환경 파일 또는 OpenAPI JSON/YAML 파일로 지정하면 즉시 제공됩니다. 데이터 파일이 이전 Mockoon 버전에서 온 경우, CLI는 원본을 건드리지 않고 메모리에서 마이그레이션합니다. 영구적인 mockoon-cli 명령을 선호한다면 npm install -g @mockoon/cli로 전역 설치하십시오.
가장 적합한 경우: GUI에서 목을 설계하고 싶지만 헤드리스로 실행하려는 팀. MIT 라이선스이며 배포를 위한 공식 Docker 이미지를 제공합니다.
솔직한 한계점: 가장 풍부한 경로는 데스크톱 앱에서 구축되므로, JSON 환경 파일을 수동으로 편집하는 것은 까다롭습니다. 동반 앱을 전혀 원하지 않는다면, Prism 또는 json-server는 모든 것을 수동으로 작성하는 단일 파일에 유지합니다.
json-server
json-server는 아직 사양이 없을 때 REST API를 가짜로 만드는 가장 빠른 방법입니다. 데이터를 설명하는 일반 JSON 파일을 작성하면, GET, POST, PUT, PATCH, DELETE를 포함한 완전한 REST API를 생성합니다.
echo '{ "posts": [{ "id": 1, "title": "hello" }] }' > db.json
npx json-server db.json
이는 실제 CRUD와 함께 http://localhost:3000/posts를 제공합니다. /posts에 대한 POST는 실제로 레코드를 추가하고 db.json에 다시 기록하므로, Prism 및 WireMock이 기본적으로 제공하지 않는 상태 저장 동작을 무료로 얻을 수 있습니다. 또한 쿼리 파라미터를 통해 필터링, 정렬 및 페이지네이션을 얻을 수 있습니다. 현재 1.x 버전은 기본적으로 파일을 감시하고 변경 시 다시 로드합니다. 항상 PATH에 있기를 원한다면 npm install -g json-server로 전역 설치하십시오.
가장 적합한 경우: 실제 API가 존재하기 전에 1분 안에 작동하는 REST 백엔드가 필요한 프런트엔드 개발자. MIT 라이선스이며 사양이 전혀 필요 없는 RESTful API를 위한 경량 목 서버 옵션 중 하나입니다.
솔직한 한계점: 리소스 스타일의 REST 형태를 가정합니다. 매우 커스텀한 경로, 비 REST 엔드포인트 또는 엄격한 헤더 매칭은 깔끔하게 처리할 수 있는 범위를 벗어납니다. 이는 프로토타이핑 도구이지 계약 유효성 검사 도구가 아닙니다.
MockServer
MockServer는 정밀한 요청 매칭을 위한 강력한 도구입니다. 위의 도구들이 사양이나 데이터 파일을 제공하는 반면, MockServer는 기대를 정의할 수 있게 합니다. 메서드, 경로, 헤더, 쿼리 또는 본문별로 요청을 매칭한 다음, 지연 및 실패를 포함하여 타임아웃 및 오류 처리를 테스트하는 데 필요한 정확한 응답을 반환할 수 있습니다.
java -jar mockserver-netty-5.15.0-no-dependencies.jar -p 1080
이는 1080 포트에서 MockServer를 시작합니다. 그런 다음 REST API에 기대를 전송하여 동작을 구성하거나 프로그래밍 방식으로 제어할 수 있습니다. Node 사용자들은 원본 jar 파일을 건너뛰고 공식 래퍼를 사용할 수 있습니다.
npm install mockserver-node
const mockserver = require('mockserver-node');
mockserver.start_mockserver({ serverPort: 1080 });
가장 적합한 경우: 요청이 어떻게 보여야 하는지, 목이 어떻게 응답해야 하는지에 대해 세밀한 제어가 필요한 통합 테스트. Apache-2.0 라이선스이며 단일 포트에서 HTTP, HTTPS 등을 지원합니다.
솔직한 한계점: JVM 서버이므로 Node 도구보다 무겁고 시작이 느리며, 기대 설정이 사양을 지정하는 것보다 더 장황합니다. 단순히 사양을 제공해야 한다면 과도한 선택이며, 더 이상 필요 없게 된다면 MockServer 대안 비교를 통해 장단점을 확인할 수 있습니다.
WireMock (독립 실행형)
WireMock은 Java 및 JVM 테스트 세계에서 인기 있는 또 다른 확고한 JVM 목 서버입니다. 독립 실행형 jar는 JUnit 테스트에 내장하는 것과 동일한 엔진을 실행하므로, 로컬 개발에서 구축한 목을 테스트 스위트에 직접 사용할 수 있습니다.
java -jar wiremock-standalone.jar --port 8080
이는 8080 포트에서 제공됩니다. WireMock은 mappings/ 디렉터리 또는 JSON API에서 스텁 매핑을 읽으며, 실제 트래픽을 기록하고 스텁으로 재생할 수도 있습니다. 이는 제어할 수 없는 타사 API를 목킹할 때 유용합니다. CI를 위한 공식 wiremock/wiremock Docker 이미지가 있습니다.
가장 적합한 경우: 로컬 개발과 테스트 스위트 간에 하나의 목킹 엔진을 공유하고, 기록 및 재생 기능이 필요한 JVM 팀. Apache-2.0 라이선스입니다.
솔직한 한계점: MockServer와 마찬가지로 Java 런타임이 필요하며 Node 옵션보다 시작이 느립니다. 스텁 매핑 JSON은 강력하지만, 단일 파일 데이터 목보다 배울 것이 더 많습니다. JavaScript 측에서 왔다면, Mock Service Worker (MSW) 대안 비교에서 WireMock이 브라우저 우선 목킹과 어떻게 비교되는지 다룹니다.
Apidog CLI
위의 도구들은 각각 목킹의 한 부분을 해결합니다. Apidog는 통합된 경로를 택합니다. API 설계, 목, 테스트, 문서가 하나의 프로젝트에 존재하며, Apidog CLI가 터미널에서 이 프로젝트를 구동합니다. Apidog는 오픈 소스가 아닙니다. 무료 티어가 있는 상업 제품입니다. 하지만 이 무료 티어와 CLI는 별도의 목 서버, 테스트 러너 및 사양 도구를 함께 엮는 것에 대한 대안을 제공합니다.
Apidog는 정의하는 모든 엔드포인트에서 스마트 목을 자동으로 생성하며, 스키마의 필드 유형과 명명 규칙을 따르는 응답을 제공하여 phone 필드가 무작위 문자열 대신 그럴듯한 전화번호를 반환합니다. 특정 요청에 대한 특정 응답이 필요할 때 목 기대(mock expectation)를 추가합니다. CLI는 해당 목 리소스를 프로젝트의 일부로 관리합니다.
npm install -g apidog-cli
apidog login --with-token <YOUR_TOKEN>
apidog mock --help
mock 명령 그룹은 스크립트 및 CI에서 프로젝트의 목 기대와 함께 작동하며, 엔드포인트, 스키마, 환경 및 테스트 실행을 위한 명령 그룹도 있습니다. 출력은 agentHints.nextSteps 필드가 있는 구조화된 JSON으로, AI 에이전트뿐만 아니라 사람도 사용할 수 있습니다. 전체 명령 표면은 Apidog CLI 완전 가이드에 설명되어 있습니다.
가장 적합한 경우: 세 가지 별도의 도구를 실행하는 것보다 목, 사양 및 테스트를 한곳에 유지하고자 하는 팀. Apidog를 다운로드하여 자신의 프로젝트에서 내장 목 서버와 CLI를 사용해 보세요.
솔직한 한계점: 단일 목적의 바이너리가 아니라 플랫폼이므로, json-server가 아무것도 요구하지 않는 것과 달리 프로젝트와 로그인을 요청합니다. 단일 파일에서 임시 목만 필요하다면 더 가벼운 도구가 더 좋습니다. 하지만 이미 Apidog에서 API를 설계하고 있다면, 목은 이미 그곳에 있습니다.
선택 방법
이미 가지고 있는 것에 맞는 도구를 선택하십시오. OpenAPI 사양이 있다면 Prism 또는 Mockoon CLI가 직접 제공합니다. 아직 아무것도 없다면 json-server가 JSON 파일에서 API를 생성합니다. 정확한 요청 매칭이 필요하다면 MockServer 또는 WireMock을 선택하십시오. 목이 설계 및 테스트 옆에 있기를 원한다면 Apidog를 사용하십시오.
| 도구 | 가장 적합한 경우 | 설치 | 오픈 소스? | 참고 |
|---|---|---|---|---|
| Prism | OpenAPI 사양을 목으로 제공 | npx @stoplight/prism-cli |
예 (Apache-2.0) | 계약 정확, 상태 비저장, 포트 4010 |
| Mockoon CLI | GUI로 구축된 목을 헤드리스로 실행 | npx @mockoon/cli |
예 (MIT) | 환경 파일 또는 OpenAPI 읽기, Docker 이미지 |
| json-server | JSON에서 즉석 REST API | npx json-server |
예 (MIT) | 상태 저장 CRUD, 사양 불필요, 포트 3000 |
| MockServer | 정밀한 요청 매칭 | java -jar mockserver-netty-*.jar |
예 (Apache-2.0) | JVM, npm 래퍼 사용 가능, 포트 1080 |
| WireMock | JVM 개발 + 테스트, 하나의 엔진 공유 | java -jar wiremock-standalone.jar |
예 (Apache-2.0) | 기록 및 재생, Docker 이미지, 포트 8080 |
| Apidog CLI | 목, 사양, 테스트를 하나의 프로젝트에서 | npm install -g apidog-cli |
아니요 (무료 티어) | 자동 스마트 목 + 관리되는 기대 |
대략적인 규칙: 속도를 위해서는 npx 도구를, 정밀한 매칭을 위해서는 JVM 서버를, 여러 개 대신 하나의 워크플로를 원한다면 Apidog를 사용하십시오. 목킹을 전혀 할지 말지 아직 결정 중이라면, API 목킹 사용 사례 설명이 언제 목킹이 효과적인지 다룹니다.
마무리
경량 목킹은 하나의 질문으로 귀결됩니다: 도구에 제공할 것이 이미 무엇이 있습니까? 사양이 있다면 Prism 또는 Mockoon CLI로 이동합니다. 백지 상태라면 json-server로 이동합니다. 엄격한 매칭이 필요하다면 MockServer 또는 WireMock으로 이동합니다. 그리고 여러 도구를 실행하고 연결하는 것을 원치 않는다면, Apidog는 설계 및 테스트 옆에 목을 유지하며, 어쨌든 스크립트화할 동일한 CLI에서 구동됩니다.
이 여섯 가지 도구는 모두 터미널에서 실행되며, CI 작업에 적합하고, 몇 시간 대신 몇 초 만에 가짜 API를 제공합니다. 당신의 경우를 다루는 가장 작은 것을 선택하고, 실제로 필요할 때만 더 많은 기능을 추가하십시오. 통합 버전을 보려면 Apidog를 다운로드하여 한 단계로 API 설계에서 목 서버를 생성하십시오.