处理别人与您共享的网站

站点所有者可以授予您访问其其中一个站点的权限（而非其账户、账单或其他站点），您可以使用您自己的 Zinn Digital® 登录信息和免费的 Zinnector® 命令行工具（CLI）来对其进行开发。本指南涵盖了这两个方面：所有者做什么，以及您做什么。

如果您以前未使用过 Zinnector®，可以通过Zinnector® 入门指南在两分钟左右完成安装。此处的所有操作均无需您购买托管服务。

对于站点所有者 — 共享单个站点

1. 在控制面板中打开该站点，然后转到安全。
2. 在谁还可以访问此站点下，选择共享此站点。
3. 输入开发者的电子邮箱地址。他们暂时尚不需要账户——如果他们从未登录过，将会收到一封邀请函，并且访问权限在他们接受邀请的瞬间即开始生效。
4. 选择一个角色：

• 查看者——只能查看，无法做任何更改。
• 编辑者——开发者通常需要的角色。他们可以更改站点的文件、使用 wp-admin，并下载站点归档文件以在本地进行开发。该归档文件包含数据库。
• 管理者——具备编辑者的一切权限，外加恢复备份。

1. 提供一个原因，并且如果工作有截止日期，请设置一个到期时间。权限将在该日期自动停止计算；您无需特意去记住取消它。
2. 保存。

无论您选择哪个角色，协作者都绝不能删除该站点、查看您的账单或访问您的任何其他站点。

“归档文件包含数据库”意味着什么

编辑者或管理者可以获取该站点的副本以进行开发，而站点副本包含其文件以及其数据库。WordPress 数据库保存了您的访客提供给该站点的一切信息——评论者的姓名和电子邮箱地址、客户账户、WooCommerce 订单和配送地址、表单提交内容。

这通常正是开发者所需要的：如果没有数据库，他们面对的只是一个没有内容的空站点，其主题也无法正常展示。了解这一点很有必要，因为这是真实的个人数据，这些数据属于您的客户，而不是我们。

由此引出两点，平台会为您处理好这两点：

• 每次导出都会记录在您的审计日志中。 打开审计日志并查找 site.backup.exported。每行记录都指明了谁进行了导出、导出的时间，以及该归档文件是否携带了数据库。您无需主动询问。
• 您可以随时终止权限。 撤销是即时生效的——见下文。

如果您更希望他们在没有数据库的情况下进行开发，请告知他们在拉取（pull）时添加 --no-database 参数；只需一个标记，其余操作保持不变。

对于开发者 — 将站点获取到您的本地机器上

1. 安装 Zinnector®

npm install -g zinnector
zinnector --version

您需要 Node 24 或更高版本。node --version 必须打印出 v24 或更高版本。

2. 以您自己的身份登录

zinnector login

这会打开您的浏览器，并使用您自己的 Zinn Digital® 账户（即接收到邀请函的那个账户）为您登录。您永远不需要所有者的密码，他们也无需向您提供密码。

检查您被授予了哪些内容：

zinnector sites

您将准确地看到与您共享的站点，除此之外别无其他。如果列表为空，说明邀请尚未被接受，或者授权已被撤销或已过期。

3. 将站点拉取到本地

zinnector clone client-domain.com
cd client-domain.com

clone 会从托管站点创建一个本地项目。它包含：

• wp-content——作为站点自身成果的主题、插件、mu-plugins、语言包和媒体文件；
• 数据库，写入项目中的 database.sql。

它会有选择地不包含 WordPress 核心文件（您的本地运行时会提供正确的版本）、wp-config.php（它保存了线上站点的数据库密码）以及任何已卸载至对象存储的媒体文件。

每次运行都会打印出获取了什么、遗漏了什么以及相应的数量。如果您只想获取文件，请添加 --no-database。

已经有了项目且只想获取最新内容？在项目内部运行 zinnector pull。

4. 在本地运行，并使用真实内容

zinnector dev --runtime docker

在 Docker 运行时上，这会导入 database.sql，将站点 URL 重定向到您的本地地址，并使用客户的真实内容打开站点。请使用站点自身的 WordPress 账户登录。

默认运行时——无需 Docker 的 WordPress Playground——启动更快且不导入数据库；它会明确告知您这一点，而不是默默地以空状态启动。当您在编写代码且不需要内容时，请使用它。

5. 妥善保管您获得的副本

database.sql 是线上站点的数据库。Zinnector® 在写入该文件的瞬间就会将其添加到您项目的 .gitignore 中，从而防止一时疏忽的 git add -A 将某个人的客户数据发布到代码仓库中。请保留该行配置，并在工作完成后删除该文件。

协作者可以做什么和不能做什么

| | 查看者 | 编辑者 | 管理者 | |---|---|---|---| | 查看站点及其设置 | ✔ | ✔ | ✔ | | 更改文件、使用 wp-admin、部署 | | ✔ | ✔ | | 拉取站点（包含数据库） | | ✔ | ✔ | | 在线上站点之上恢复备份 | | | ✔ | | 删除站点 | | | | | 查看账单或发票 | | | | | 访问所有者的其他站点 | | | |

最后三行对所有角色均为空白。它们并非设置项。

终止访问

所有者打开站点的安全部分，并点击该人员姓名旁边的撤销。它会立即生效：该开发者运行的下一个 Zinnector® 命令将无法看到该站点，他们掌握的其他任何途径也无法看到。

到期时间会在指定的日期自动执行相同的操作，无需任何人特意去记。如果您在共享站点时设置了到期时间，那么您现在已经完成了。

当某个功能无法正常工作时

• zinnector sites 未显示任何内容。 邀请尚未被接受，或者授权已被撤销或已过期。请让所有者查看站点的“安全”部分——待处理的邀请会列在其中。
• zinnector pull 提示该站点没有最近的备份。 如果套餐允许，拉取操作会获取一个新备份，并会先进行询问。如果套餐不包含按需备份，请调高 --max-age 以接受较旧的备份。
• zinnector dev 启动了一个空白的 WordPress。 您当前使用的是 Playground 运行时，它不导入数据库。请运行 zinnector dev --runtime docker。
• 本地站点不断重定向到线上域名。 导入操作会重写站点 URL；如果该步骤失败，命令会给出提示并打印出需要运行的 wp search-replace 命令。

更多错误及修复方法请参见：Zinnector® 故障排除。