지식 베이스

개발자용 CLI인 Zinnector® 시작하기

Node 24 이상 버전에 무료 Zinnector® CLI를 설치한 후, 2분 만에 정상 작동을 확인해 보십시오: --version, --help, 사이트 스캐폴딩 생성, Docker 없이 로컬에서 실제 WordPress 실행, 그리고 브라우저에서 열기 — 각 단계별 성공 화면과 함께 제공됩니다.

Zinnector®는 WordPress 개발자를 위한 Zinn Digital®의 무료 MIT 라이선스 명령줄 도구입니다. 이 도구는 사이트의 기본 구조를 생성하고, Node 외에는 아무것도 설치되지 않은 사용자 본인의 컴퓨터에서 실제 WordPress를 실행하며(Docker 없음, MAMP 없음, PATH에 PHP 없음), 빌드한 항목을 배포하려는 호스팅 슬롯과 대조하여 확인한 후 푸시합니다. 이 안내서는 약 2분 만에 빈 상태에서 실행 중인 사이트까지 도달하도록 안내하며, 문제가 발생했을 때 알 수 있도록 각 단계별 성공 상태를 알려드립니다.

준비 사항

Node 24 이상. node --version을 실행하십시오. 반드시 v24 이상이 출력되어야 합니다. nodejs.org에서 최신 LTS 버전을 설치하십시오. Windows에서는 winget install OpenJS.NodeJS.LTS, macOS에서는 brew install node@24입니다.
npm, Node와 함께 제공됩니다. Zinnector®는 자체 캐시에 WordPress 런타임을 다운로드하기 위해 이를 한 번 사용합니다.
git, zinnector push 전용입니다. 배포는 사용자의 저장소에서 실행됩니다.
Docker, 사용자가 --runtime docker로 요청하는 경우에만 필요합니다. 기본 런타임에는 전혀 필요하지 않습니다.

아래 내용 중 계정이 필요한 항목은 없습니다. API 키는 Zinnector®로 배포하기에서 호스팅 슬롯에 도달할 때만 필요합니다.

1단계 — 설치하기

npm install -g zinnector

npm에서 npm WARN EBADENGINE이 출력되는 경우, 현재 Node가 해당 패키지에서 선언한 >=24.18.1보다 이전 버전인 것입니다. 설치는 정상적으로 완료되지만 CLI 실행은 거부됩니다. 먼저 Node를 업그레이드한 후 다시 설치하십시오.

2단계 — 버전 확인하기

zinnector --version

성공: 예를 들어 0.1.2와 같은 버전 번호입니다. "Zinnector® needs Node 24 or newer — this is Node 20.x"라는 메시지가 표시된다면 바이너리는 설치되었으나 Node가 너무 이전 버전인 것입니다. 이 명령은 다른 작업을 수행하지 않고 종료 코드 78로 종료됩니다.

3단계 — 도움말 읽기

zinnector --help

성공: 작업 흐름의 5가지 명령(new, dev, link, check, push)을 명시하는 배너가 나타나고, 이어서 각 명령의 한 줄짜리 용도가 표시됩니다. 모든 명령은 개별적인 --help도 지원합니다. zinnector dev --help는 런타임, PHP 및 포트 플래그를 나열합니다. 예제가 포함된 전체 목록은 명령 참조에서 확인하실 수 있습니다.

4단계 — 사이트 기본 구조 생성하기

zinnector new my-site

성공: Created my-site 제목과 작성된 파일 목록(zinnector.json, plugins/, themes/, mu-plugins/ 헬퍼가 포함된 wp-content 트리, .gitignore 및 README)이 표시된 후 다음에 실행할 명령이 이어집니다. 그 안의 어떤 항목도 플레이스홀더가 아닙니다. 프로젝트는 있는 그대로 부팅됩니다. --template plugin 또는 --template theme은 생성되는 즉시 활성화되는 플러그인 또는 블록 테마의 기본 구조를 생성합니다.

5단계 — 실행하기

cd my-site
zinnector dev

처음 실행할 때 Zinnector®는 5.2부터 8.5까지의 모든 PHP 빌드를 포함하고 있어 약 570MB에 달하는 WordPress 런타임을 다운로드하기 전에 프로젝트 내부가 아닌 자체 캐시 디렉터리에 다운로드할 것인지 한 번 묻습니다. Y로 응답하시거나, 질문을 건너뛰려면 --yes를 전달하십시오. Node 26 이상에서는 런타임의 네이티브 모듈에 Node 24 및 25용으로 사전 빌드된 바이너리만 포함되어 있으므로 오직 런타임 전용 Node 24(약 30MB, nodejs.org의 체크섬으로 검증됨)도 함께 가져옵니다. 컴파일러나 Visual Studio는 필요하지 않습니다.

성공: 프로젝트 이름, PHP 버전, WordPress 버전을 명시하는 블록이 표시된 후 다음이 나타납니다.

✔ running at http://127.0.0.1:9400
  admin: http://127.0.0.1:9400/wp-admin  (already signed in)

6단계 — 열기

브라우저에서 http://127.0.0.1:9400에 접속하십시오. 성공: 요청하신 PHP 버전으로 제공되는 My WordPress Website라는 제목의 새로운 WordPress 사이트입니다. http://127.0.0.1:9400/wp-admin은 이미 로그인된 상태로 대시보드를 엽니다. wp-content/plugins/에 플러그인을 넣거나 wp-content/themes/에 테마를 추가하면 다음 새로고침 시 바로 반영됩니다. 런타임은 해당 디렉터리를 사용자의 프로젝트에서 직접 제공합니다.

중지하려면 Ctrl-C를 누르십시오. zinnector dev --once는 런타임을 부팅하고 실제로 실행 중인 항목(PHP 버전, WordPress 버전, 로드된 확장 프로그램)을 출력한 후 중지합니다. 이는 약속된 사양 대신 실제 작동 결과를 확인하고자 할 때 유용합니다.