Zinnector®

WordPress 호스팅을 위한 개발자 CLI

Zinnector®는 Docker나 MAMP 없이 Node만 설치된 상태에서 WordPress를 로컬로 빌드한 다음, 배포하려는 호스팅 슬롯과 빌드 결과물을 비교하여 일치하지 않는 부분을 푸시 전에 알려줍니다. npm install -g zinnector로 설치하세요. 무료 오픈소스(MIT 라이선스)이며, 여기 있는 다른 모든 도구와 동일한 공개 API를 기반으로 구축되었습니다.

무료 시작하기 개발자 플랫폼

다섯 개의 명령어가 있으며, 그중 가운데 있는 것이 핵심입니다

대부분의 호스팅 CLI는 배포부터 시작합니다. Zinnector®는 그보다 먼저 시작하여 여러분과 함께 사이트를 구축한 다음, 보낼 대상 서버와 대조하여 작업을 검증합니다. "내 노트북에서는 실행됐다"와 "서버에서 실행된다" 사이의 간극에서 오후 시간이 다 사라지며, 이 간극은 측정 가능합니다.

새 zinnector

즉시 실행되는 사이트, 플러그인 또는 블록 테마를 스캐폴딩하세요. 자리표시자 파일이나 TODO가 없습니다. 플러그인이 활성화되고 생성되는 즉시 테마를 선택할 수 있습니다.

zinnector 개발

Docker도, PATH에 PHP를 설정할 필요도 없이, 단 몇 초 만에 내 컴퓨터에서 실제 WordPress를 실행하여 나만의 플러그인과 테마를 구동해 보세요. 개발에 사용할 5.2부터 8.5까지의 모든 PHP 버전을 자유롭게 선택하세요.

진넥터 확인

사전 점검 기능입니다. 빌드한 결과물을 배포하려는 대상 슬롯과 비교하여 불일치하는 부분과 수행할 수 없었던 모든 검사 항목을 푸시 전에 명시합니다.

지넥터 푸시

배포 전 커밋을 푸시하고, 배포를 트리거한 후 완료될 때까지 모니터링하세요. 실패할 경우 명령어 한 번으로 빌드 로그를 확인할 수 있습니다.

지넥터 AI

프로젝트와 사이트를 컨텍스트로 삼아 터미널에서 어시스턴트에 질문하세요. 플랫폼 상에서 본인 계정을 기반으로 실행되므로, 어떠한 모델 키도 사용자의 컴퓨터에 저장되지 않습니다.

계정 필요 없이 2분 만에 작동하는지 테스트해 보세요

여섯 가지 명령어를 순서대로 실행하고, 각 단계에서 성공했을 때의 모습을 안내합니다. 여기에 있는 모든 작업은 본인의 컴퓨터에서 실행되며, API 키는 호스팅 슬롯에 도달했을 때만 필요합니다.

설치하기
Node 24 이상 버전에서 npm install -g zinnector를 실행하십시오. npm이 EBADENGINE 오류를 출력하는 경우, Node 버전이 24 미만인 것이므로 nodejs.org에서 현재 LTS 버전을 설치한 후 설치를 다시 실행하십시오.
버전 확인
zinnector --version은 0.1.2와 같은 버전 번호를 출력합니다. 24 버전보다 오래된 Node에서는 Node 24 이상이 필요하다는 메시지를 출력하고 종료합니다.
도움말 읽기
zinnector --help는 아래의 모든 명령어와 각각의 한 줄 용도를 나열합니다. 모든 명령어는 자체적으로 --help도 지원합니다.
사이트 구축하기
zinnector new my-site는 즉시 부팅되는 프로젝트(zinnector.json, wp-content 트리 및 README)를 생성하고 다음에 실행할 명령어를 출력합니다.
실행
cd my-site를 입력한 다음 zinnector dev를 실행하세요. 첫 실행 시 WordPress 런타임을 다운로드하기 위해 한 번 확인을 거칩니다(약 570MB, 프로젝트 폴더가 아니라 CLI 자체 캐시에 보관됨). 성공하면 "running at http://127.0.0.1:9400"과 같이 표시됩니다.
브라우저에서 열기
http://127.0.0.1:9400은 새로운 WordPress 사이트이며, /wp-admin은 이미 로그인된 상태로 대시보드를 엽니다. wp-content/plugins에 플러그인을 넣으면 다음 새로고침 시 바로 반영됩니다.
그런 다음 호스팅 슬롯과 함께
zinnector login, zinnector link, zinnector check, zinnector push — 구축한 항목을 슬롯에 대해 사전 점검한 후 배포하고 완료될 때까지 확인하십시오.

사전 점검 상세 내용

귀하는 PHP 8.3 기반으로 구축했습니다. 슬롯은 8.1로 실행됩니다. 사이트가 백화될 때까지 아무도 알려주지 않습니다. 이 명령어가 존재하는 이유가 바로 그 문제 때문이며, 이 플랫폼의 소유자가 직접 이름까지 언급하며 요청한 것입니다. Zinnector®는 두 환경을 모두 읽어 나란히 배치한 후, 그럴 만한 이유가 있을 수 있으므로 어쨌든 배포할 수 있도록 합니다.

정확하게 평가된 PHP

메이저 버전 차이는 사이트를 확실하게 중단시키기 때문에 높음으로 표시되며, 마이너 차이는 낮게 표시됩니다. 모든 것을 치명적으로 평가하면 경고를 무시하는 법만 배우게 될 뿐입니다.

디스크 및 파일 수(별도)

WordPress 디렉터리에는 수만 개의 작은 파일이 포함되어 있어, 디스크 용량이 여유가 있더라도 사이트의 inode 한도가 소모될 수 있습니다. 두 항목 모두 요금제가 아닌 슬롯에 실제로 남은 용량을 기준으로 확인됩니다.

“확인할 수 없음”은 그 자체로 답변입니다

그 대상을 볼 수 없는 검사는 확인되지 않음으로 보고되며, 한 번도 통과된 적이 없습니다. 거짓된 모든 정상이 두 번 다시 돌아보지 않는 유일한 대상이기 때문에, 깨끗한 실행은 검증할 수 없었던 항목의 개수를 나타냅니다.

경고만 하고 차단하지 않음

모든 발견 사항은 --force로 재정의할 수 있으며 요약에 그렇게 표시됩니다. CI에서는 그 대신 종료 코드가 관문 역할을 하므로, 사람이 통제력을 유지하는 동안 파이프라인이 엄격하게 유지될 수 있습니다.

두 개의 로컬 런타임, 둘 다 실제 작동함

WordPress Playground는 기본값입니다. WebAssembly로 컴파일되어 Node 내부에서 실행되는 PHP이므로, Node 외에는 아무것도 설치되지 않은 노트북에서도 이 문장을 읽는 데 걸리는 시간 정도면 아무것도 없는 상태에서 실행 중인 WordPress로 전환될 수 있습니다.

네이티브 PHP(imagick과 같은 확장 기능)나 실제 MySQL이 필요할 때 `--runtime docker`를 전달하면 php-fpm 및 MariaDB 컨테이너를 대신 얻을 수 있습니다. 둘 다 동일한 프로젝트에서 동일한 파일을 제공하므로, 둘 사이를 전환해도 엔진 외에는 아무것도 바뀌지 않습니다.

패널에서 이미 하고 계신 다른 모든 것들

Zinnector®은 대시보드와 동일한 공개 API를 기반으로 구축되어 있으므로 제어판이 할 수 있는 모든 작업을 수행할 수 있으며, 모든 명령어는 비공개 엔드포인트가 아닌 OpenAPI 사양에 문서화된 작업입니다.

사이트 및 배포

사이트 목록을 확인하고, 플랫폼이 해당 사이트에 대해 아는 모든 정보를 읽고, 재배포하고, 배포 이력과 빌드 로그를 읽습니다.

도메인, DNS 및 메일

도메인을 나열하고, DNS 레코드가 기록되기 전에 표시되는 레코드를 통해 이를 읽고 변경하며, 메일 서비스를 읽습니다.

PHP, 할당량, 데이터베이스 및 로그

PHP 버전을 전환하고, 플랜에서 제공하는 허용량과 비교하여 디스크 및 아이노드 사용량을 확인하고, phpMyAdmin에 대한 일회용 링크를 얻고, 액세스 및 오류 로그를 실시간으로 확인할 수 있습니다.

WP-CLI 및 대량 작업

사이트에 대해 허용 목록에 있는 WP-CLI 명령어를 실행하고, 개별 사이트마다 실행하는 대신 한 번의 호출로 전체 선택 영역의 캐시를 비우거나 멀웨어 검사를 시작합니다.

--help에 나오는 그대로의 모든 명령어

전체 목록은 한 줄에 하나씩 제공됩니다. 모든 플래그, 실행 가능한 예제, 각 명령이 출력하는 내용 등을 포함하는 완전한 참고서는 CLI 자체에서 생성되며 개발자 문서와 지식베이스에 수록되어 있으므로, 설치된 도구와 내용이 달라질 수 없습니다.

신규 zinnector

즉시 실행할 수 있는 WordPress 프로젝트를 구축하세요.

zinnector dev

Docker 없이 이 프로젝트를 로컬에서 실행하세요.

zinnector 로그인

Zinn Digital® API 키로 로그인하세요.

zinnector 로그아웃

저장된 API 키를 잊으세요.

zinnector whoami

이 CLI가 누구로 인증되어 있는지 표시합니다.

지넥터 사이트

이 키가 볼 수 있는 사이트를 나열하세요.

지넥터 상태

플랫폼이 단일 사이트에 대해 알고 있는 모든 정보입니다.

zinnector 공유

개발자, 디자이너, 클라이언트 등 단 한 명의 사용자에게 역할과 사유를 부여하여 단일 사이트에 대한 액세스 권한을 부여하세요.

zinnector 공동 작업자

사이트에 대한 액세스 권한을 부여받은 사람, 이들의 역할, 그리고 초대를 수락했는지 여부를 확인하세요.

zinnector 공유 해제

이메일 또는 부여 ID를 통해 사용자의 액세스 권한을 회수합니다.

zinnector 초대

대기 중인 초대를 확인하고 수락하세요.

zinnector 링크

이 프로젝트를 호스팅 슬롯에 지정하고(저장소 연결).

진넥터 풀

로컬 개발을 위해 호스팅된 사이트의 파일을 이 프로젝트로 가져오고, 다시 동기화하려면 다시 실행하세요. 사이트가 자체 저장소와 동기화되는 경우 빠른 경로를 사용하며, 그렇지 않은 경우 최신 백업에서 작동합니다.

zinnector 복제

원격 사이트에서 한 단계로 로컬 프로젝트를 생성하세요. 리포지토리를 복제하거나 파일을 풀(pull)하고, 프로젝트 파일을 작성한 뒤 zinnector dev를 실행할 준비를 완료합니다.

zinnector 확인

배포하려는 슬롯과 이 프로젝트를 비교하세요.

zinnector push

배포 전 커밋을 푸시하고 배포하세요.

zinnector 배포

푸시하지 않고도 플랫폼에 이미 있는 내용을 다시 배포하세요.

zinnector 배포 중

사이트의 배포 기록

zinnector php

사이트의 PHP 버전을 표시하거나 전환합니다.

지넥터 할당량

요금제에서 허용하는 디스크, 파일 및 데이터베이스 사용량입니다.

zinnector 데이터베이스

데이터베이스 크기 및 phpMyAdmin과 파일 관리자로의 일회성 링크.

지넥터 로그

사이트의 액세스 및 오류 로그를 실시간으로 확인합니다.

지넥터 WP

사이트에서 허용된 WP-CLI 명령어를 실행합니다.

지넥터 백업

사이트 백업 목록을 확인하고 생성합니다. 하위 명령어: list, now.

지넥터 도메인

이 키가 조회할 수 있는 도메인을 나열하십시오.

지넥터 DNS

DNS 레코드를 읽고 변경합니다. 하위 명령: list, add, rm.

지넥터 메일

메일 서비스 목록 표시

지넥터 일괄 작업

여러 사이트에 걸쳐 하나의 작업 실행 (cache_purge, malware_scan, sitemap, block_ip).

zinnector ai

이 프로젝트를 컨텍스트로 하여 Zinn Digital® 어시스턴트에게 문의하세요.

질문

Zinn Digital®을 사용하려면 고객이어야 합니까?

아니요. `zinnector new`와 `zinnector dev`는 계정이 전혀 필요 없습니다. 플러그인, 테마 또는 전체 사이트를 스캐폴딩하고 로컬에서 무료로 영구적으로 실행하세요. API 키는 호스팅과 통신하는 명령어에만 필요합니다.

Docker가 필요합니까?

기본 런타임용이 아닙니다. WordPress Playground는 PHP를 WebAssembly로 컴파일하고 Node 내부에서 실행되므로, `zinnector dev`를 사용하면 다른 것을 설치할 필요 없이 몇 초 만에 실제 WordPress를 부팅할 수 있습니다. imagick이나 ionCube 같은 확장을 테스트하기 위해 네이티브 PHP가 필요한 경우 `--runtime docker`를 사용하면 대신 php-fpm 및 MariaDB 컨테이너가 제공됩니다. 둘 다 지원되며 어느 쪽도 대체용이 아닙니다.

사전 비행 점검(pre-flight check)은 실제로 무엇을 비교하나요?

귀하의 로컬 PHP 버전과 슬롯의 PHP 버전 비교, 슬롯이 빌드한 버전으로 전환 가능 여부, 슬롯의 PHP가 지원 종료(EOL)되었는지 및 서버에 실제로 적용되었는지 여부, 프로젝트의 크기 및 파일 수와 남은 디스크 및 아이노드(inode) 여유 공간 비교, 양쪽의 WordPress 버전, 슬롯 프로비저닝 완료 여부, 그리고 배포를 위해 연결된 git 저장소 존재 여부. 확인할 수 없는 항목은 통과로 처리되지 않고 미확인으로 보고됩니다.

배포를 차단할 수 있나요?

아니오, 그것은 의도된 것입니다. 사전 비행 점검은 경고를 표시하고 통과시키며, `--force`는 모든 발견 사항을 무시하고 배포합니다. 검사기가 알 수 없는 귀하의 사이트에 대한 정보가 귀하에게 있으며, 배포를 거부하는 도구는 사용자가 삭제하는 도구이기 때문입니다.

내 API 키는 안전한가요?

이 키는 명령줄에서 읽히지 않고 프롬프트나 파이프된 표준 입력(stdin)에서만 읽히므로, 쉘 히스토리나 프로세스 목록에 남지 않습니다. 이 키는 파일 권한이 600으로 설정된 사용자 본인의 설정 디렉토리에 저장되며, Zinnector®는 기록할 때마다 이러한 권한을 다시 적용합니다.

CI 환경에서 사용할 수 있나요?

예. `ZINNECTOR_TOKEN`을 설정하면 모든 명령어가 `--json`을 지원합니다. 사람이 읽는 출력은 stderr로, 데이터는 stdout으로 전송되므로 파이프가 깨끗하게 유지됩니다. `zinnector check`는 문제가 발견되면 0이 아닌 값으로 종료되므로 파이프라인 게이트로 작동하며, `--strict`는 비교를 수행할 수 없을 때도 실패 처리합니다.

지금 설치하고 1분 안에 사이트를 실행하세요

npm install -g zinnector를 실행하거나 npx zinnector new my-site로 한 번 시도해 보세요. 무료이며 MIT 라이선스가 적용되고 공개 API를 기반으로 구축되었습니다. 프로젝트를 템플릿화하고, Docker 없이 로컬에서 실행하며, 배포 전에 사전 점검을 수행하세요.

문서 읽기