Cơ sở tri thức

Tài liệu tham khảo lệnh Zinnector®

Mọi lệnh Zinnector® chính xác như những gì zinnector --help liệt kê — các đối số, cờ và giá trị mặc định, ví dụ có thể thực thi và kết quả in ra — được tạo trực tiếp từ chính CLI để không bị sai lệch so với phiên bản bạn đã cài đặt.

Mọi lệnh mà Zinnector® 0.1.6 nhận diện — tổng cộng 43 lệnh, chính xác như danh sách từ zinnector --help — cùng với các tùy chọn, một ví dụ có thể chạy được, và những gì quý vị sẽ thấy. Trang này được tạo tự động từ chính CLI, vì vậy nó luôn nhất quán với công cụ quý vị đã cài đặt; nếu thiếu bất kỳ lệnh nào trên máy của quý vị, hãy chạy npm install -g zinnector@latest.

Trước khi bắt đầu

Cài đặt công cụ bằng lệnh npm install -g zinnector trên Node 24 hoặc mới hơn, sau đó kiểm tra bản cài đặt bằng zinnector --version và zinnector --help. Hướng dẫn bắt đầu trình bày chi tiết năm phút đầu tiên; trang này là tài liệu tham khảo để quý vị xem lại.

Mọi lệnh đều nhận -h, --help. Các tùy chọn toàn cục này đứng trước tên lệnh:

tùy chọn	chức năng
`-V, --version`	in phiên bản
`--profile <name>`	sử dụng hồ sơ thông tin xác thực được đặt tên

Các lệnh

`zinnector new`

Tạo khung cho một dự án WordPress mà quý vị có thể chạy ngay lập tức.

zinnector new [options] [name]

đối số	bắt buộc	mô tả
`name`	không	thư mục để tạo dự án và tên của dự án — bắt buộc trừ khi dùng --here

tùy chọn	chức năng	mặc định
`-t, --template <kind>`	một trong các loại: site, plugin, theme	`"site"`
`--php <version>`	phiên bản PHP dùng để phát triển	`"8.3"`
`--wp <version>`	phiên bản WordPress cho môi trường runtime cục bộ	`"latest"`
`--runtime <name>`	playground hoặc docker	`"playground"`
`--here`	dựng khung vào thư mục hiện tại thay vì thư mục mới

Ví dụ

zinnector new my-site

Những gì bạn thấy — đã chụp — 0.1.2 trên Linux

Created my-site  ·  site
──────────────────────────

  + .gitignore
  + README.md
  + wp-content/mu-plugins/000-zinnector-dev.php
  + wp-content/plugins/.gitkeep
  + wp-content/themes/.gitkeep
  + zinnector.json

  php        8.3
  wordpress  latest
  runtime    playground

→ run it:
    cd my-site
    zinnector dev

→ then, when you have a hosting slot:
    zinnector link     # point it at a site
    zinnector check    # pre-flight before you push
    zinnector push

`zinnector dev`

Chạy dự án này trên máy cục bộ — không yêu cầu Docker.

zinnector dev [options]

| tùy chọn | chức năng | mặc định |\n|---|---|---|\n| --php <version> | phiên bản PHP để chạy (5.2–8.5 trên playground, 7.4–8.5 trên docker) | |\n| --wp <version> | phiên bản WordPress | |\n| -p, --port <port> | cổng để phân phát | |\n| --runtime <name> | playground (mặc định) hoặc docker | |\n| --login | tự động đăng nhập với tư cách quản trị viên | true |\n| --no-login | không tự động đăng nhập | |\n| --once | khởi động, báo cáo những gì đang chạy, sau đó dừng lại | |\n| --yes | cài đặt runtime cục bộ mà không cần hỏi | |\n| --reset-runtime | xóa runtime đã cài đặt và cài đặt lại | |\n| -v, --verbose | hiển thị đầu ra riêng của runtime | |\n\nVí dụ

cd my-site
zinnector dev

Những gì bạn thấy — đã ghi lại — 0.1.2. Lần chạy đầu tiên sẽ hỏi một lần để tải xuống môi trường chạy WordPress (~570 MB); truyền --yes để bỏ qua câu hỏi

my-site  ·  WordPress Playground (WASM, no Docker)
───────────────────────────────────────────────────

  serving    a WordPress project
  from       /home/you/my-site
  php        8.3
  wordpress  latest

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

  Ctrl-C to stop

`zinnector login`

Đăng nhập — bằng tài khoản của riêng bạn trong trình duyệt, hoặc bằng khóa API.

zinnector login [options]

tùy chọn	chức năng	mặc định
`--profile <name>`	lưu trữ dưới một hồ sơ được đặt tên (mặc định: default)
`--api <url>`	URL cơ sở của API	`"https://api.zinndigital.com"`
`--api-key`	dán khóa API theo tổ chức thay vì đăng nhập với tư cách cá nhân
`--issuer <url>`	dịch vụ đăng nhập	`"https://auth.zinndigital.com/realms/zinn"`
`--no-browser`	in liên kết đăng nhập mà không cố gắng mở trình duyệt

Ví dụ

zinnector login

Những gì bạn thấy — khóa được nhập tại dấu nhắc, không bao giờ trên dòng lệnh. Trong CI, hãy chuyển nó qua đường ống: echo "$ZINN_API_KEY" | zinnector login --profile ci

Sign in to Zinn Digital®  ·  https://api.zinndigital.com
────────────────────────────────────────────────────

  API key: ••••••••••••••••••••••••••••

✔ signed in as you@example.com (Acme Ltd) — profile “default”
→ next: zinnector sites

`zinnector logout`

Quên thông tin đăng nhập đã lưu.

zinnector logout [options]

tùy chọn	chức năng	mặc định
`--profile <name>`	hồ sơ nào cần quên (mặc định: default)

Ví dụ

zinnector logout

Nội dung bạn thấy

✔ signed out of profile “default”

`zinnector whoami`

Hiển thị CLI này đang đăng nhập dưới tư cách ai và có thể truy cập những gì.

zinnector whoami [options]

| tùy chọn | chức năng | mặc định |\n|---|---|---|\n| --profile <name> | sử dụng hồ sơ được đặt tên | |\n| --scopes | liệt kê các quyền mà khóa API nắm giữ | |\n| --json | đầu ra có thể đọc được bằng máy | |\n\nVí dụ

zinnector whoami --scopes

Những gì bạn thấy — được ghi lại từ một lần chạy thực tế của 0.1.5 trên môi trường production vào ngày 2026-09-14; các miền, id và liên kết dùng một lần đã được thay thế


Signed in  ·  https://api.zinndigital.com
──────────────────────────────────────────
account        you@example.com
as             a person, signed in through the browser
organisations  8 — listed below
mode           live
credential     profile “default”

  · Example Org  owner · 01a00000-0000-7000-8000-000000000000
  · Example Org· 01a00001-0000-7000-8000-000000000001
  · Example Org· 01a00002-0000-7000-8000-000000000002
  · Example Org· 01a00003-0000-7000-8000-000000000003
  · Example Org· 01a00004-0000-7000-8000-000000000004
  · Example Org· 01a00005-0000-7000-8000-000000000005
  · Example Org· 01a00006-0000-7000-8000-000000000006
  · Example Org· 01a00007-0000-7000-8000-000000000007

  scopes belong to API keys — a signed-in person acts with their ROLE in each organisation (shown above).

`zinnector sites`

Liệt kê các trang web mà khóa này có thể thấy.

zinnector sites [options]

tùy chọn	chức năng	mặc định
`--json`	đầu ra máy có thể đọc được
`--status <status>`	chỉ các trang web ở trạng thái này

Ví dụ

zinnector sites


Sites  ·  12
─────────────
domain          status  php      target  id
example-2.com   active  php —    fleet   01a00000-0000-7000-8000-000000000000
example-3.com   active  php —    fleet   01a00001-0000-7000-8000-000000000001
example-4.com   active  php —    fleet   01a00002-0000-7000-8000-000000000002
example-5.com   active  php 8.5  fleet   01a00003-0000-7000-8000-000000000003
example-6.com   active  php —    fleet   01a00004-0000-7000-8000-000000000004
example.com     active  php 8.4  fleet   01a00005-0000-7000-8000-000000000005
example-7.com   active  php —    fleet   01a00006-0000-7000-8000-000000000006
example-8.com   active  php 8.5  fleet   01a00007-0000-7000-8000-000000000007
example-9.com   active  php 8.5  fleet   01a00008-0000-7000-8000-000000000008
example-10.com  active  php 8.5  fleet   01a00009-0000-7000-8000-000000000009
example-11.com  active  php 8.5  fleet   01a00010-0000-7000-8000-000000000010
example-12.com  active  php 8.5  fleet   01a00011-0000-7000-8000-000000000011

`zinnector status`

Tất cả những gì nền tảng biết về một trang web.

zinnector status [options] [site]

đối số	bắt buộc	mô tả
`site`	không	id trang web, miền chính hoặc tên — mặc định là trang web được liên kết trong zinnector.json

tùy chọn	chức năng	mặc định
`--json`	đầu ra máy có thể đọc được

Ví dụ

zinnector status example.com


example.com  ·  01a00000-0000-7000-8000-000000000000
────────────────────────────────────────────────────────────────────────
status         active
product line   footprint_free
stack          wordpress
region         fsn1
deploy target  fleet
plan           PBN 10

● PHP
version        8.4
can switch to  8.5, 8.4, 8.3, 8.2, 8.1, 8.0, 7.4

● Quota
disk      188 MB used of 500.0 GB
files     6,313 of 2,000,000
database  1 MB

● Deploy
status         building
target         fleet
repository     —
commit         —
live url       —
last deployed  2026-09-14T01:29:26.991511Z

● WordPress
version     7.1
up to date  yes
multisite   no

`zinnector share`

Cấp quyền truy cập cho một người vào MỘT trang web duy nhất — nhà phát triển, nhà thiết kế, khách hàng.

zinnector share [options] <site> <email>

đối số	bắt buộc	mô tả
`site`	có	trang web cần chia sẻ — id, miền chính hoặc tên
`email`	có	người nhận quyền truy cập — họ sẽ nhận được thư mời qua email nếu chưa có tài khoản

tùy chọn	chức năng	mặc định
`--role <role>`	quyền họ có thể thực hiện: viewer, editor, manager
`--reason <text>`	lý do họ cần quyền — được lưu cùng với quyền đã cấp để phục vụ việc theo dõi kiểm toán
`--until <date>`	thời điểm quyền truy cập tự động kết thúc (YYYY-MM-DD); bỏ trống nếu muốn duy trì cho đến khi bị thu hồi
`--json`	dữ liệu xuất máy có thể đọc được

Ví dụ

zinnector share example.com dev@agency.test --role editor --reason "rebuild the checkout"

Những gì bạn thấy — dạng chính xác mà lệnh in ra, từ nguồn (W40-DEVTOOL đã thêm các mục này sau lần chụp tệp gần nhất); các miền, ID và ngày của bạn sẽ khác

Shared example.com  ·  01a03f39-730a-7dc4-84b0-5d4f7582dd04
────────────────────────────────────────────────────────────

✔ invited dev@agency.test as editor
  They have no account yet, so an invitation has been emailed. Until they
  sign in and accept it they can see nothing; the moment they do, the site is theirs.

→ what they do next, on their own machine:
    npm i -g zinnector && zinnector login   # sign in as themselves
    zinnector clone example.com   # pull the files down

`zinnector collaborators`

Những ai đã được cấp quyền truy cập vào một trang web và liệu họ đã chấp nhận hay chưa.

zinnector collaborators [options] [site]

đối số	bắt buộc	mô tả
`site`	không	id trang web, miền chính hoặc tên — mặc định là trang web được liên kết trong zinnector.json

tùy chọn	chức năng	mặc định
`--json`	đầu ra máy có thể đọc được

Ví dụ

zinnector collaborators example.com

Những gì bạn thấy — được ghi lại từ một lần chạy thực tế của 0.1.5 trên môi trường production vào ngày 2026-09-14; các miền, id và liên kết sử dụng một lần đã được thay thế. định dạng chính xác mà lệnh in ra, từ nguồn (W40-DEVTOOL đã thêm những thứ này sau khi tệp này được ghi lại lần cuối); các miền, id và ngày của bạn sẽ khác


Access to example.com  ·  3
───────────────────────────────────────────────────────────
who              role    status   ends  why                                          grant
dev@agency.test  viewer  revoked  —     Example Org— revoked immediately after       01a00000-0000-7000-8000-000000000000
dev@agency.test  viewer  revoked  —     Example Org— revoked at the end of the walk  01a00001-0000-7000-8000-000000000001
dev@agency.test  editor  revoked  —     Example Org— revoked at the end of the walk  01a00002-0000-7000-8000-000000000002

`zinnector unshare`

Thu hồi quyền truy cập trang web của một người — qua email hoặc grant id.

zinnector unshare [options] <site> <who>

đối số	bắt buộc	mô tả
`site`	có	trang web cần thu hồi quyền truy cập — ID, miền chính hoặc tên
`who`	có	người cần xóa — địa chỉ email của họ hoặc grant id từ zinnector collaborators

tùy chọn	tác dụng	mặc định
`--yes`	không hỏi

Ví dụ

zinnector unshare example.com dev@agency.test --yes

✔ withdrew the invitation to dev@agency.test

`zinnector invitations`

Các lời mời đang chờ bạn, và chấp nhận một lời mời.

zinnector invitations [options] [command]

Ví dụ

zinnector invitations

Những gì bạn thấy — được ghi lại từ một lần chạy thực tế của 0.1.5 trên môi trường production vào ngày 2026-09-14; các miền, id và liên kết dùng một lần đã được thay thế. định dạng chính xác mà lệnh in ra, từ nguồn (W40-DEVTOOL đã thêm những nội dung này sau khi tệp này được ghi lại lần cuối); các miền, id và ngày của bạn sẽ khác; nếu không có lệnh con, nó sẽ chạy list


Invitations  ·  0
──────────────────

● nothing waiting for you

`zinnector invitations list`

Lời mời được gửi đến tài khoản mà quý khách đang đăng nhập.

zinnector invitations list [options]

tùy chọn	chức năng	mặc định
`--json`	đầu ra có thể đọc được bằng máy

Ví dụ

zinnector invitations list


Invitations  ·  0
──────────────────

● nothing waiting for you

`zinnector invitations accept`

Chấp nhận lời mời — trang web sẽ thuộc về quý vị ngay khi lệnh này hoàn tất.

zinnector invitations accept [options] <id>

đối số	bắt buộc	mô tả
`id`	có	id lời mời từ zinnector invitations — chỉ cần tiền tố duy nhất của nó là đủ

Ví dụ

zinnector invitations accept 01a03f39-9c11-7b02-a7e0-2e4d0c5f1b77

✔ you now have access to example.com

`zinnector link`

Trỏ dự án này đến một vị trí lưu trữ (và kết nối kho lưu trữ của dự án).

zinnector link [options] [site]

đối số	bắt buộc	mô tả
`site`	không	id trang web, miền chính hoặc tên — mặc định là trang web được liên kết trong zinnector.json

tùy chọn	tác dụng	mặc định
`--repo <owner/name>`	kết nối kho lưu trữ này với trang web trên nền tảng
`--provider <name>`	tài khoản đã kết nối để triển khai: github_app, github hoặc gitlab (mặc định: tài khoản mà tổ chức của bạn đã kết nối)
`--branch <name>`	nhánh mà lệnh push sẽ triển khai từ đó
`--no-repo`	chỉ ghi zinnector.json; không tác động đến nền tảng

Ví dụ

zinnector link example.com --repo acme/example-site --branch main

Nội dung bạn thấy

✔ this project deploys to example.com (01a03f39-730a-7dc4-84b0-5d4f7582dd04)
  written to zinnector.json — commit it so everyone deploys to the same slot
✔ the platform will deploy acme/example-site (main)
→ next: zinnector check

`zinnector pull`

Kéo các tệp của một trang web được lưu trữ vào dự án này để phát triển cục bộ — và chạy lại để đồng bộ hóa lại.

zinnector pull [options] [site]

đối số	bắt buộc	giải thích
`site`	không	id trang web, miền chính hoặc tên — mặc định là trang web được liên kết trong zinnector.json

tùy chọn	chức năng	mặc định
`--via <seam>`	auto (mặc định), git, hoặc backup	`"auto"`
`--fresh`	tạo bản sao lưu mới thay vì sử dụng bản sao lưu mới nhất (tiêu tốn một lượt theo yêu cầu)
`--max-age <hours>`	chấp nhận bản sao lưu mới nhất nếu nó mới hơn khoảng thời gian này	`"24"`
`--full`	toàn bộ thư mục gốc tài liệu, bao gồm cả lõi WordPress (mặc định: chỉ wp-content)
`--no-uploads`	bỏ qua wp-content/uploads (phương tiện)
`--no-database`	bỏ qua cơ sở dữ liệu của trang web — chỉ lấy các tệp tin
`--live-config`	ghi cả wp-config.php — tệp chứa thông tin xác thực cơ sở dữ liệu HOẠT ĐỘNG
`--clean`	làm trống wp-content trước khi giải nén, để các mục đã xóa trên trang web được phản ánh đồng bộ
`--dry-run`	thông báo những gì sẽ xảy ra và dừng lại
`--yes`	không hỏi

Ví dụ

zinnector pull

Nội dung bạn thấy

Pull example.com  ·  01a03f39-730a-7dc4-84b0-5d4f7582dd04
─────────────────────────────────────────────────────────────

● via git — the site syncs to its own repository and this is a clone of it
✔ fast-forwarded 3 commits 4f1c2a9b → 9d2e7c14

● not synced, and why
  ✖ database                     the local playground has its own; the site's is not copied
  ✖ offloaded media              objects in storage are not in the site's files
  ✖ anything outside the repository  only wp-content syncs

→ next: zinnector dev

`zinnector clone`

Tạo một dự án cục bộ từ một trang web được lưu trữ: nhân bản kho lưu trữ của nó hoặc kéo các tệp của nó về.

zinnector clone [options] <site> [dir]

đối số	bắt buộc	giải thích
`site`	có	trang web được lưu trữ cần sao chép — một id, miền chính hoặc tên
`dir`	không	thư mục cần tạo — mặc định là miền chính của trang web

tùy chọn	chức năng	mặc định
`--via <seam>`	auto (mặc định), git, hoặc backup	`"auto"`
`--fresh`	tạo bản sao lưu mới thay vì sử dụng bản sao lưu gần nhất
`--full`	toàn bộ thư mục gốc của tài liệu, bao gồm cả lõi WordPress
`--no-uploads`	bỏ lại wp-content/uploads (phương tiện)
`--no-database`	bỏ lại cơ sở dữ liệu của trang web — chỉ lấy các tệp
`--live-config`	ghi cả wp-config.php — tệp này chứa thông tin đăng nhập cơ sở dữ liệu TRỰC TIẾP
`--yes`	không hỏi

Ví dụ

zinnector clone client.example.com

Nội dung bạn thấy

Clone client.example.com  ·  client.example.com
──────────────────────────────────────────────────────

✔ wrote client.example.com/zinnector.json (php 8.3, wordpress 6.7.1)
● via backup — the site does not sync to a repository
✔ downloaded 214 MB and extracted wp-content

● not synced, and why
  ✖ database                     the local playground has its own; the site's is not copied
  ✖ offloaded media              objects in storage are not in the site's files
  ✖ wp-config.php                holds the live database credentials (--live-config to write it)
  ✖ WordPress core               the runtime supplies the version the slot runs (--full to take it)

→ next: zinnector dev

→ run it:
    cd client.example.com
    zinnector dev

`zinnector sync`

Đồng bộ hóa hai chiều giữa các tệp đang hoạt động của trang web và kho lưu trữ của trang web đó.

zinnector sync [options] [command]

Ví dụ

zinnector sync --help

Nội dung bạn thấy — nếu không có lệnh phụ, zinnector sync <site> sẽ là sync status

Usage: zinnector sync [options] [command]

two-way sync between a site's live files and its repository

  site → repository   zinnector sync run   commits the live files and pushes the branch
  repository → site   zinnector push       builds the branch and publishes it

`zinnector sync status`

Trạng thái đồng bộ hai chiều và các lần chạy gần đây nhất.

zinnector sync status [options] [site]

đối số	bắt buộc	mô tả
`site`	không	id trang web, miền chính hoặc tên — mặc định là trang web được liên kết trong zinnector.json

tùy chọn	chức năng	mặc định
`--json`	đầu ra máy có thể đọc được

Ví dụ

zinnector sync status example.com

Những gì bạn thấy — được ghi lại từ một lần chạy thực tế của 0.1.4 trên trang web thử nghiệm vào ngày 2026-09-12; miền và id được thay thế bằng các giá trị mẫu

Two-way sync — example.com
──────────────────────────

repository   acme/example-site (main)
available    yes
sync         on
state        synced
last sync    2026-09-12T22:51:41.539832Z
note         Started from acme/example-site@main.

run        files       commit         when
synced     2 changed   da85d73cef5f   2026-09-12T22:52:10.117301Z

`zinnector sync on`

Bật đồng bộ hóa hai chiều (tự nó không đẩy bất kỳ dữ liệu nào).

zinnector sync on [options] [site]

đối số	bắt buộc	giải thích
`site`	không	id trang web, miền chính hoặc tên — mặc định là trang web được liên kết trong zinnector.json

tùy chọn	chức năng	mặc định
`--subdir <path>`	chỉ đồng bộ hóa thư mục con này của trang web
`--json`	đầu ra máy có thể đọc được

Ví dụ

zinnector sync on example.com

Những gì bạn thấy — yêu cầu một kho lưu trữ được kết nối trên chính tài khoản GitHub của bạn; bản thân nó không tự đẩy bất kỳ nội dung nào lên

✔ two-way sync is on

Two-way sync — example.com
…
→ next: zinnector sync run

`zinnector sync off`

Tắt đồng bộ hóa hai chiều.

zinnector sync off [options] [site]

đối số	bắt buộc	giải thích
`site`	không	id trang web, miền chính hoặc tên — mặc định là trang web được liên kết trong zinnector.json

tùy chọn	chức năng	mặc định
`--subdir <path>`	chỉ đồng bộ hóa thư mục con này của trang web
`--json`	đầu ra máy có thể đọc được

Ví dụ

zinnector sync off example.com

Nội dung bạn thấy

✔ two-way sync is off

`zinnector sync run`

Commit các tệp trực tiếp của trang web vào kho lưu trữ ngay bây giờ.

zinnector sync run [options] [site]

đối số	bắt buộc	mô tả
`site`	không	id trang web, miền chính hoặc tên — mặc định là trang web được liên kết trong zinnector.json

tùy chọn	chức năng	mặc định
`--json`	đầu ra máy có thể đọc được

Ví dụ

zinnector sync run example.com

Những gì bạn thấy — được ghi lại từ một lần chạy thực tế của phiên bản 0.1.4 trên trang web thử nghiệm vào ngày 2026-09-12; miền và các id được thay thế bằng các giá trị mẫu. Lượt chạy mà kho lưu trữ đã vượt qua sẽ được chuyển sang trạng thái HELD thay thế: không có gì được đẩy lên hoặc ghi đè, lệnh thoát với mã 1 và nêu tên bước tiếp theo

✔ committed 2 changed files da85d73cef5f

Two-way sync — example.com
…
→ next: git pull in your clone

`zinnector sync resolve`

Xóa một đồng bộ hóa bị giữ lại bằng cách chọn bên nào thắng.

zinnector sync resolve [options] [site]

| đối số | bắt buộc | là gì |\n|---|---|---|\n| site | không | ID trang web, miền chính hoặc tên — mặc định là trang web được liên kết trong zinnector.json |\n\n| tùy chọn | chức năng | mặc định |\n|---|---|---|\n| --keep <side> | site (commit trang web lên trên) hoặc repository (hủy các thay đổi chưa đồng bộ của trang web) | |\n| --yes | không hỏi | |\n| --json | đầu ra máy có thể đọc được | |\n\nVí dụ

zinnector sync resolve example.com --keep repository --yes

Những gì bạn thấy — được ghi lại từ một lần chạy thực tế của 0.1.4 trên trang web thử nghiệm vào ngày 2026-09-12; tên miền và id được thay thế bằng các giá trị mẫu. Không có --yes, nó sẽ hỏi trước và từ chối thẳng thừng khi không có terminal nào để hỏi

✔ kept the repository

Two-way sync — example.com
…
state        synced

`zinnector check`

So sánh dự án này với vị trí bạn chuẩn bị triển khai.

zinnector check [options] [site]

đối số	bắt buộc	mô tả
`site`	không	ID trang web, miền chính hoặc tên — mặc định là trang web được liên kết trong zinnector.json

tùy chọn	chức năng	mặc định
`--probe`	khởi động môi trường thực thi cục bộ và ĐO LƯỜNG php của nó, thay vì tin cậy zinnector.json
`--all`	hiển thị cả các bước kiểm tra thành công
`--strict`	cũng báo lỗi khi một mục không thể kiểm tra được
`--json`	đầu ra máy có thể đọc được

Ví dụ

zinnector check

Những gì bạn thấy — được ghi lại từ một lần chạy thực tế của 0.1.5 trên môi trường production vào ngày 2026-09-14; các miền, ID và liên kết dùng một lần đã được thay thế — lần chạy này đã phát hiện sự không khớp thực sự (PHP 8.3 trong dự án so với 8.4 trên slot), đây chính là toàn bộ mục đích của lệnh này

→ reading the slot
  size excludes: .git

Pre-flight — example.com  ·  01a00000-0000-7000-8000-000000000000
────────────────────────────────────────────────────────────────────────

  local  php 8.4  3 files, 0.0 MB
  slot   php 8.4  target fleet
  local php is the version DECLARED in zinnector.json — run with --probe to measure it

  ? unknown   local php extensions could not be enumerated
      try zinnector dev --once

  ? unknown   wordpress versions could not be compared
      No WordPress version found in the working copy.
      try zinnector status

  7 passed  ·  2 could not be checked

`zinnector push`

Kiểm tra sơ bộ, đẩy các commit của bạn và triển khai.

zinnector push [options] [site]

đối số	bắt buộc	mô tả
`site`	không	id trang web, tên miền chính hoặc tên — mặc định là trang web được liên kết trong zinnector.json

tùy chọn	chức năng	mặc định
`-f, --force`	triển khai ngay cả khi quá trình kiểm tra trước phát hiện vấn đề
`--skip-checks`	hoàn toàn không chạy kiểm tra trước
`--probe`	đo lường môi trường thực thi cục bộ trong quá trình kiểm tra trước thay vì tin cậy zinnector.json
`--no-wait`	kích hoạt quá trình triển khai và thoát mà không theo dõi
`--no-git`	không chạy git push; triển khai bất kỳ nội dung nào nền tảng đã có
`--dry-run`	thực hiện mọi thứ ngoại trừ việc triển khai

Ví dụ

zinnector push

Nội dung bạn thấy

Deploy to example.com  ·  01a03f39-730a-7dc4-84b0-5d4f7582dd04
───────────────────────────────────────────────────────────────

✔ pre-flight: 8 passed  ·  0 to look at  ·  2 could not be checked
→ pushing main (4f1c2a9b add the contact form)
✔ pushed
● deploy 7c0e… started — watching
✔ deployed 4f1c2a9b in 48s

  status    success
  commit    4f1c2a9b
  url       https://example.com

`zinnector deploy`

Triển khai lại những gì nền tảng đã có mà không cần push.

zinnector deploy [options] [site]

đối số	bắt buộc	mô tả
`site`	không	ID trang web, miền chính hoặc tên — mặc định là trang web được liên kết trong zinnector.json

tùy chọn	chức năng	mặc định
`--no-wait`	kích hoạt và thoát

Ví dụ

zinnector deploy example.com


Redeploy example.com  ·  01a00000-0000-7000-8000-000000000000
────────────────────────────────────────────────────────────────────────
→ starting the deploy
✔ deploy started

`zinnector deploys`

Lịch sử triển khai của một trang web.

zinnector deploys [options] [site]

argument	required	what it is
`site`	không	ID trang web, miền chính hoặc tên — mặc định là trang web được liên kết trong zinnector.json

option	what it does	default
`--json`	đầu ra có thể đọc bằng máy
`-n, --limit <n>`	số lượng cần hiển thị	`"10"`

Ví dụ

zinnector deploys example.com


Deploys — example.com  ·  2
───────────────────────────────────────────────────────────
status  commit  branch  trigger  started                      message
live    —       —       manual   2026-09-14T09:06:39.685554Z  —
live    —       —       manual   2026-09-14T01:29:20.196957Z  —

`zinnector php`

Hiển thị hoặc chuyển đổi phiên bản PHP của trang web.

zinnector php [options] [version]

đối số	bắt buộc	mô tả
`version`	không	phiên bản PHP để chuyển đổi trang web sang, ví dụ: 8.4 — bỏ qua để hiển thị phiên bản hiện tại

tùy chọn	chức năng	mặc định
`-s, --site <site>`	id hoặc miền của trang web
`--list`	liệt kê các phiên bản mà nền tảng cung cấp
`--json`	đầu ra có thể đọc bằng máy

Ví dụ

zinnector php 8.3 --site example.com

Những gì bạn thấy — được ghi lại từ một lần chạy thực tế của 0.1.5 trên môi trường production vào 2026-09-14; các miền, ID và liên kết dùng một lần đã được thay thế. nếu không có phiên bản thì nó sẽ hiển thị phiên bản hiện tại; --list hiển thị những gì nền tảng cung cấp cho dòng sản phẩm của trang web này


PHP — example.com
──────────────────────────────────────────────────────
version        8.4
can switch to  8.5, 8.4, 8.3, 8.2, 8.1, 8.0, 7.4

`zinnector quota`

Mức sử dụng dung lượng ổ đĩa, tệp và cơ sở dữ liệu so với tài nguyên gói dịch vụ cung cấp.

zinnector quota [options] [site]

đối số	bắt buộc	mô tả
`site`	không	id trang web, miền chính hoặc tên — mặc định là trang web được liên kết trong zinnector.json

tùy chọn	chức năng	mặc định
`--json`	đầu ra máy có thể đọc được

Ví dụ

zinnector quota example.com


Quota — example.com
────────────────────────────────────────────────────────
disk used      188 MB
disk limit     500.0 GB
disk granted   500 GB  (per_site)
files used     6,313
file limit     2,000,000
database       1 MB

  “limit” is what is enforced today; “granted” is what the plan says.

`zinnector db`

Dung lượng cơ sở dữ liệu, cùng các liên kết sử dụng một lần vào phpMyAdmin và trình quản lý tệp tin.

zinnector db [options] [site]

đối số	bắt buộc	mô tả
`site`	không	id trang web, miền chính hoặc tên — mặc định là trang web được liên kết trong zinnector.json

tùy chọn	chức năng	mặc định
`--json`	đầu ra máy có thể đọc được

Ví dụ

zinnector db example.com

Những gì bạn thấy — được ghi lại từ một lần chạy thực tế của phiên bản 0.1.5 trên môi trường production vào ngày 2026-09-14; các miền, id và liên kết dùng một lần đã được thay thế. các liên kết phpMyAdmin và trình quản lý tệp là loại dùng một lần và sẽ hết hạn; không dán chúng ở bất kỳ đâu


Database — example.com
───────────────────────────────────────────────────────────
size    1 MB
tables  14

  single-use links, valid for one visit:
  phpMyAdmin    https://pma.example.com/signon.php?t=<single-use>
  file manager  https://files.example.com/signon.php?t=<single-use>

`zinnector logs`

Theo dõi nhật ký truy cập và lỗi của một trang web theo thời gian thực.

zinnector logs [options] [site]

đối số	bắt buộc	mô tả
`site`	không	id trang web, miền chính hoặc tên — mặc định là trang web được liên kết trong zinnector.json

tùy chọn	chức năng	mặc định
`--access`	chỉ nhật ký truy cập
`--error`	chỉ nhật ký lỗi
`--build`	thay vào đó là nhật ký bản dựng của lần triển khai gần đây nhất
`--json`	đầu ra máy có thể đọc được

Ví dụ

zinnector logs example.com --error

Nội dung quý vị thấy — được ghi lại từ một lần chạy thực tế của 0.1.5 trên môi trường production vào ngày 2026-09-14; các tên miền, mã định danh và liên kết dùng một lần đã được thay thế. --access dành cho nhật ký truy cập, --build dành cho nhật ký bản dựng của lần triển khai gần nhất (trang web không được dựng bởi nhà cung cấp bản dựng sẽ hiển thị các bước riêng của lần triển khai); khi không có cờ nào, cả hai nhật ký trang web đều được hiển thị, và nhật ký không thể đọc được sẽ thông báo như vậy thay vì để trống


Error log — example.com
────────────────────────────────────────────────────────────

2026-09-14 11:06:07.153643 [NOTICE] [1929978] [T0] [config:vhost:zcaffb6eec5abbdab03fb9b2d62a15:epsr:lsphp-zcaffb6eec5abbdab03fb9b2d62a15]'Process Limit' probably is too low, adjust the limit to: 640.
2026-09-14 11:06:37.873060 [INFO] [1929982] [T0] [lsphp-zcaffb6eec5abbdab03fb9b2d62a15] add child process pid: 1933036, procinfo: 0x5555561cfe30

`zinnector wp`

Chạy lệnh WP-CLI được phép trên một trang web.

zinnector wp [options] [command...]

đối số	bắt buộc	giải thích
`command...`	không	lệnh WP-CLI và các đối số của nó, ví dụ: plugin list — bỏ qua bằng --commands

tùy chọn	tác dụng	mặc định
`-s, --site <site>`	ID trang web hoặc miền
`--commands`	liệt kê những gì nền tảng sẽ chạy
`--json`	đầu ra máy có thể đọc được

Ví dụ

zinnector wp plugin list --site example.com

Những gì bạn thấy — được ghi lại từ một lần chạy thực tế của phiên bản 0.1.5 trên môi trường sản xuất vào ngày 2026-09-14; các miền, mã định danh và liên kết sử dụng một lần đã được thay thế. danh sách cho phép do nền tảng cung cấp — zinnector wp --commands sẽ in danh sách đó

name	status	update	version	update_version	auto_update
akismet	inactive	none	5.7.2		off
hello	inactive	none	1.7.2		off
imunify-security	active	none	4.1.0		off
litespeed-cache	active	none	7.9.1		off
redis-cache	active	none	2.8.0		off
zinn-cache	active	none	1.2.2		off
object-cache.php	dropin				off

`zinnector backup`

Liệt kê và sao lưu trang web.

zinnector backup [options] [command]

Ví dụ

zinnector backup list example.com

Những gì bạn thấy — được ghi lại từ một lần chạy thực tế của 0.1.5 trên môi trường sản xuất vào ngày 2026-09-14; các miền, id và liên kết dùng một lần đã được thay thế. Riêng lệnh backup sẽ in ra các lệnh con của nó; xem backup list và backup now bên dưới


Backups — example.com  ·  3
───────────────────────────────────────────────────────────
status  taken                        size    id
stored  2026-09-14T09:06:39.918280Z  4.7 MB  01a00000-0000-7000-8000-000000000000
stored  2026-09-14T01:29:20.403161Z  36 MB   01a00001-0000-7000-8000-000000000001
stored  2026-09-14T01:29:15.898099Z  36 MB   01a00002-0000-7000-8000-000000000002

daily backups   on
retention       30 days
off-site copy   yes
on-demand left  2 of 3

`zinnector backup list`

Liệt kê các bản sao lưu của trang web và những gì gói của trang web đó cung cấp.

zinnector backup list [options] [site]

đối số	bắt buộc	mô tả
`site`	không	id trang web, miền chính hoặc tên — mặc định là trang web được liên kết trong zinnector.json

tùy chọn	chức năng	mặc định
`--json`	đầu ra máy có thể đọc được

Ví dụ

zinnector backup list example.com


Backups — example.com  ·  3
───────────────────────────────────────────────────────────
status  taken                        size    id
stored  2026-09-14T09:06:39.918280Z  4.7 MB  01a00000-0000-7000-8000-000000000000
stored  2026-09-14T01:29:20.403161Z  36 MB   01a00001-0000-7000-8000-000000000001
stored  2026-09-14T01:29:15.898099Z  36 MB   01a00002-0000-7000-8000-000000000002

daily backups   on
retention       30 days
off-site copy   yes
on-demand left  2 of 3

`zinnector backup now`

Tạo một bản sao lưu theo yêu cầu.

zinnector backup now [options] [site]

đối số	bắt buộc	mô tả
`site`	không	ID trang web, miền chính hoặc tên — mặc định là trang web được liên kết trong zinnector.json

Ví dụ

zinnector backup now example.com

Nội dung bạn thấy

✔ backup started — zinnector backup list example.com shows it when it completes

`zinnector domains`

Liệt kê các miền mà khóa này có thể thấy.

zinnector domains [options]

tùy chọn	chức năng	mặc định
`--json`	đầu ra có thể đọc được bằng máy

Ví dụ

zinnector domains


Domains  ·  1
──────────────
domain       status     ownership  renewal        expires
example.com  connected  connected  no auto-renew  —

`zinnector dns`

Đọc và thay đổi các bản ghi DNS.

zinnector dns [options] [command]

Ví dụ

zinnector dns list example.com

Những gì bạn thấy — được ghi lại từ một lần chạy thực tế của 0.1.5 trên môi trường production vào ngày 2026-09-14; các miền, id và liên kết dùng một lần đã được thay thế. Riêng lệnh dns sẽ in ra các lệnh con của nó; xem dns list, dns add và dns rm bên dưới


DNS — example.com  ·  1 records
────────────────────────────────────────
type  name          value               ttl
TXT   w4357-verify  zinn-w4357-updated  ttl 3600

`zinnector dns list`

Liệt kê các bản ghi DNS của một tên miền.

zinnector dns list [options] <domain>

đối số	bắt buộc	mô tả
`domain`	có	miền, theo tên hoặc id

tùy chọn	tác dụng	mặc định
`--type <type>`	chỉ các bản ghi thuộc loại này
`--json`	đầu ra có thể đọc bằng máy

Ví dụ

zinnector dns list example.com


DNS — example.com  ·  1 records
────────────────────────────────────────
type  name          value               ttl
TXT   w4357-verify  zinn-w4357-updated  ttl 3600

`zinnector dns add`

Tạo một bản ghi DNS.

zinnector dns add [options] <domain> <type> <name> <value>

| đối số | bắt buộc | là gì |\n|---|---|---|\n| domain | có | tên miền, theo tên hoặc id |\n| type | có | loại bản ghi: A, AAAA, CNAME, MX, TXT, SRV, … |\n| name | có | tên bản ghi — @ cho chính tên miền, hoặc nhãn tên miền phụ |\n| value | có | giá trị bản ghi trỏ đến — một địa chỉ, tên máy chủ hoặc văn bản |\n\n| tùy chọn | tác dụng | mặc định |\n|---|---|---|\n| --ttl <seconds> | thời gian tồn tại (time to live) | "3600" |\n| --priority <n> | mức độ ưu tiên, dành cho MX và SRV | |\n| --proxied | định tuyến qua CDN | |\n| -y, --yes | không hỏi | |\n\nVí dụ

zinnector dns add example.com TXT _acme "token" --ttl 300

Những gì bạn thấy — bản ghi được hiển thị và xác nhận trước khi được ghi; truyền --yes để bỏ qua câu hỏi

Add a DNS record to example.com
───────────────────────────────

  type   TXT
  name   _acme
  value  "token"
  ttl    300

  create it? [y/N] y
✔ created TXT _acme

`zinnector dns rm`

Xóa một bản ghi DNS.

zinnector dns rm [options] <domain> <recordId>

đối số	bắt buộc	ý nghĩa
`domain`	có	miền, theo tên hoặc id
`recordId`	có	id bản ghi, theo định dạng được zinnector dns list in ra

tùy chọn	chức năng	mặc định
`-y, --yes`	không hỏi

Ví dụ

zinnector dns rm example.com rec_7f3a

Nội dung bạn thấy

⚠ deleting A @ 203.0.113.10 from example.com
  delete it? [y/N] y
✔ deleted

`zinnector mail`

Liệt kê các dịch vụ thư.

zinnector mail [options]

tùy chọn	chức năng	mặc định
`--json`	đầu ra có thể đọc được bằng máy

Ví dụ

zinnector mail


Mail services  ·  0
────────────────────

● no mail services

`zinnector bulk`

Chạy một thao tác trên nhiều trang web (cache_purge, malware_scan, sitemap, block_ip).

zinnector bulk [options] <operation>

đối số	bắt buộc	là gì
`operation`	có	nội dung cần chạy trên mọi trang web đã chọn: cache_purge, malware_scan, sitemap hoặc block_ip

tùy chọn	tác dụng	mặc định
`--all`	mọi trang web mà khóa này có thể thấy
`--site <site...>`	các trang web cụ thể, theo id hoặc miền
`--status <status>`	mọi trang web ở trạng thái này
`-y, --yes`	không hỏi
`--json`	đầu ra máy có thể đọc được

Ví dụ

zinnector bulk cache_purge --all

Những gì bạn thấy — được ghi lại từ một lần chạy thực tế của phiên bản 0.1.5 trên môi trường production vào ngày 2026-09-14; các miền, id và liên kết dùng một lần đã được thay thế. chỉ một lệnh gọi đến nền tảng cho toàn bộ lựa chọn, không phải mỗi trang web một lệnh; lựa chọn được hiển thị và xác nhận trước


Bulk cache_purge  ·  1 sites
─────────────────────────────

·   example.com

→ running cache_purge
✔ cache_purge accepted for 1 sites

  The platform runs this asynchronously; results appear per site in the dashboard.

`zinnector ai`

Hỏi trợ lý Zinn Digital®, với dự án này làm ngữ cảnh.

zinnector ai [options] <question...>

đối số	bắt buộc	ý nghĩa
`question...`	có	điều bạn muốn hỏi, bằng các từ ngữ đơn giản — việc đặt trong dấu ngoặc kép là tùy chọn

tùy chọn	chức năng	mặc định
`-s, --site <site>`	hỏi về một trang web cụ thể
`--org <id>`	tổ chức để đóng vai trò hỏi, khi tài khoản của bạn thuộc về nhiều hơn một tổ chức
`--no-context`	không gửi bất cứ thông tin nào về dự án cục bộ
`--json`	đầu ra máy có thể đọc được

Ví dụ

zinnector ai "why is my deploy failing?"

Những gì bạn thấy — được ghi lại từ một lần chạy thực tế của 0.1.5 trên môi trường thực tế vào 2026-09-14; tên miền, mã định danh và liên kết dùng một lần đã được thay thế. Trợ lý trả lời bằng ngôn ngữ của TÀI KHOẢN — cài đặt ngôn ngữ của tài khoản này là tiếng Ả Rập, vì vậy câu trả lời được ghi lại bằng tiếng Ả Rập cho một câu hỏi bằng tiếng Anh

→ thinking

Zinn Digital® assistant
────────────────────────────

  هذا مشروع WordPress تم إنشاؤه بواسطة Zinnector® (مُهيّأ على PHP 8.4، أحدث
  إصدار WordPress، وبيئة تشغيل playground)؛ لتشغيله محلياً، انتقل إلى مجلده
  وشغّل الأمر: cd <اسم-المشروع> ثم zinnector dev، وسيقوم بتشغيل موقع WordPress
  حقيقي على جهازك دون الحاجة إلى Docker.

  sources:
    · https://zinndigital.com/kb/zinnector-getting-started
    · https://zinndigital.com/kb/zinnector-local-development

`zinnector mcp`

Chạy một cầu nối stdio đến máy chủ MCP được lưu trữ — dành cho Claude Desktop và các máy khách chỉ cục bộ khác.

zinnector mcp [options]

Ví dụ

ZINN_MCP_TOKEN=zmcp_live_… zinnector mcp

Những gì bạn thấy — được khởi động BỞI một ứng dụng khách AI chẳng hạn như Claude Desktop, không bao giờ bằng tay — ứng dụng này giao tiếp MCP trên stdin và stdout. Đã được chứng minh từ Claude Code 2.1.270 trên máy chủ trực tiếp vào ngày 2026-09-12

zinnector 0.1.4: MCP bridge to https://api.zinndigital.com/v1/mcp

Biến môi trường

biến	tác dụng
`ZINNECTOR_TOKEN`	khóa API, được sử dụng thay cho hồ sơ đã lưu — đây là cách CI xác thực
`ZINNECTOR_API`	URL gốc của API (mặc định `https://api.zinndigital.com`)
`ZINNECTOR_DEBUG=1`	in dấu vết ngăn xếp và đầu ra của chính trình cài đặt runtime
`ZINNECTOR_CACHE_DIR`	nơi lưu giữ runtime WordPress và mọi Node được quản lý (mặc định `~/.cache/zinnector`)
`ZINNECTOR_CONFIG_DIR`	nơi chứa tệp hồ sơ khóa API (mặc định `~/.config/zinnector`)
`NO_COLOR`	tắt màu

Mã thoát

0 thành công · 1 kết quả tìm thấy hoặc bị từ chối · 70 lỗi nội bộ · 77 xác thực hoặc quyền truy cập · 78 Node không được hỗ trợ.

Tất cả tài liệu dành cho nhà phát triển →

Mới nhất từ blog

Những gì chúng tôi đã viết về lưu trữ web, SEO và vận hành trang web ở quy mô lớn.

SEO và xây dựng liên kết từ tầng lưu trữ: Góc nhìn của nhà vận hành năm 2026

Cách dịch vụ lưu trữ định hình việc lập chỉ mục và giá trị liên kết (link equity) vào năm 2026: giữ cho các trang luôn được lập chỉ mục, kiểm tra kỹ lưỡng các tên miền cũ trước khi xây dựng, xây dựng liên kết mà không để lại dấu vết (footprint), và một cái nhìn thẳng thắn về những gì cơ sở hạ tầng có thể và không thể làm cho SEO.

21 tháng 7, 2026

Đọc bài viết →

Giúp WordPress nhanh chóng và an toàn: Danh sách kiểm tra hiệu suất và plugin

Danh sách kiểm tra thực tế cho một trang WordPress nhanh và an toàn: lưu vào bộ nhớ đệm ở cấp độ máy chủ, bộ nhớ đệm đối tượng cho từng trang web, số ít plugin đáng sử dụng, duy trì ngăn xếp công nghệ luôn mới nhất và các trang WooCommerce mà quý vị tuyệt đối không bao giờ được lưu vào bộ nhớ đệm.

20 tháng 7, 2026

Đọc bài viết →

Cách chọn dịch vụ lưu trữ web được quản lý vào năm 2026: Hướng dẫn cho người mua

Điều thực sự tạo nên sự khác biệt giữa dịch vụ lưu trữ được quản lý tốt và một máy chủ giá rẻ có bảng điều khiển — di chuyển dữ liệu, sao lưu, cách ly, bộ nhớ đệm thực sự và khả năng mở rộng trung thực — và cách đánh giá dịch vụ đó trước khi bạn cam kết.

19 tháng 7, 2026

Đọc bài viết →

Đọc blog →

Vẫn gặp khó khăn?

Hỗ trợ được bao gồm trong mọi gói, bộ phận chăm sóc khách hàng hoạt động 24 giờ một ngày và quý khách có thể viết thư cho chúng tôi bằng bất kỳ ngôn ngữ nào trong số 58 ngôn ngữ của chúng tôi — chúng tôi sẽ trả lời quý khách bằng ngôn ngữ của quý khách.

Liên hệ hỗ trợ → Tất cả bài viết →