kapaweb deploy

kapaweb 部署

在与 Claude 的对话中，将网站、PHP 应用和 WordPress 部署到 kapaweb 托管服务（DirectAdmin；Plesk 支持仍处于预览阶段），无需让托管密码进入聊天。该插件捆绑了 kapaweb 连接器、本地 MCP 服务（在你的电脑上运行），以及一项指导 Claude 安全使用它的技能。

要求

• 在 DirectAdmin 服务上拥有 kapaweb 托管账户（https://kapaweb.gr），或在 Plesk 服务上拥有账户（Plesk 支持仍处于预览阶段）。
• 运行 Claude 的电脑上安装了 Node.js 18.17 或更高版本。连接器没有依赖项，也无需构建。
• 使用能够启动本地 MCP 服务的 Claude 端：Claude Code，或在你的电脑上运行的 Cowork 会话。网页版 Claude 聊天不会启动本地服务，因此请在该环境中使用 https://kapaweb.gr/deploy-with-ai/ 上的 Claude Desktop 扩展。

使用方法

让 Claude 将项目部署到 kapaweb。该技能会让 Claude 阅读公开的操作指南（https://kapaweb.gr/deploy-with-ai/playbook.md），检查连接器是否为最新版本，并调用 connect。connect 会在你自己的电脑上打开一个登录页面（http://127.0.0.1，使用随机端口和令牌）：你在页面中输入 DirectAdmin 地址、用户名和密码，而不会在聊天中输入。连接器会将密码换成权限受限的 DirectAdmin 登录密钥，随后忘记该密码，并且只将密钥保存在电脑的受保护存储中（Windows DPAPI、macOS Keychain、Linux secret-tool）。Plesk（预览）： Plesk 不允许客户创建受限密钥，因此对于 Plesk 账户，连接器会将你的 Plesk 密码本身保存在相同的受保护存储中，并在每次向你自己的 Plesk 控制面板发送请求时使用该密码；登录页面会在你登录前告知此情况，disconnect 会移除密码，而且 Claude 永远无法看到它。

工具：deploy（始终先创建备份）、rollback、list_files、read_file、write_file、db_create、db_import、db_export（流式传输，支持任意大小，并保存在你的电脑上）、files_archive、files_extract、files_upload、files_download（支持压缩、解压缩，以及任意大小文件的上传和下载；list_files 支持分页浏览任意大小的文件夹）、node_* 和 files_*（Plesk 预览：Plesk 订阅的 Node.js 扩展和文件管理器）、php_versions、set_php_version、php_settings、ssl_status、cron_*、subdomain_*、check_url、logs、usage、account_info、playbook、connect、disconnect。只读工具标注为 readOnlyHint，具有破坏性的工具标注为 destructiveHint。

它运行、存储和发送的内容

• 运行 此插件中的 node server/index.js，在你的计算机上通过 stdio 运行。在 macOS 上，它会调用 security（Keychain）；在 Linux 上调用 secret-tool；在 Windows 上调用 PowerShell DPAPI，以存储和读取自己的登录密钥；它会在本地登录页面打开你的浏览器。
• 仅向以下地址发送请求：你自己的 kapaweb DirectAdmin 或 Plesk 控制面板（你输入的地址；每次连接前都会与 kapaweb 自己的服务器列表进行核对）；https://firewall.kapaweb.gr/servers.txt（kapaweb 服务器地址列表）；https://kapaweb.gr/deploy-with-ai/playbook.md（操作手册）；https://kapaweb.gr/downloads/kapaweb-connector.version.json（每天最多检查一次版本；除 User-Agent kapaweb-connector/<version> 外不会发送任何内容；设置 KAPAWEB_CONNECTOR_NO_UPDATE_CHECK=1 可关闭此功能）；以及仅当你使用 check_url 要求检查时，你自己的主机账户所托管的域名（以及 kapaweb 自己维护的一小组固定网站）。
• 在你的计算机上存储：已保存的连接信息（控制面板地址、用户名、密钥 ID；不含密码）、登录密钥（对于 Plesk 账户：Plesk 密码，见上文）和受保护存储中的数据库密码，以及你要求导出的数据库文件（保存在连接器的设置文件夹中）。不会向 kapaweb 发送任何分析数据，此插件也不会收集任何关于你的信息。
• 绝不会向 Claude 显示你的密码（包括 Plesk 密码）、登录密钥或生成的数据库密码。

隐私政策

Kapaweb（https://kapaweb.gr，[email protected]）提供此插件。

• **我们收集的内容：**无。此插件没有账户、分析功能，也不会在我们这边收集遥测数据。
• **保留在你计算机上的内容：**主机控制面板的地址、用户名和密钥 ID；受限的 DirectAdmin 登录密钥（对于 Plesk 账户则是你的 Plesk 密码，因为 Plesk 不向客户提供权限受限的密钥）；生成的数据库密码（存储在操作系统的受保护存储中）；以及你要求导出的数据库文件。在 DirectAdmin 上，你的主机密码仅用于创建密钥，随后即会被遗忘；在 Plesk 上，密码会保存在受保护存储中，直到你断开连接。所有这些内容都会一直保留，直到你将其删除：使用 disconnect，或在 DirectAdmin 的 Login Keys 下移除密钥（对于 Plesk：如果计算机由多人共用或丢失，还应更改 Plesk 密码）。密钥默认 30 天后过期（你可以选择 90 天、一年或永不过期），也可以随时撤销。
• **数据去向：**你的主机控制面板（你要求 Claude 操作的账户文件、数据库、设置和日志）。上文列出的发往 kapaweb.gr 和 firewall.kapaweb.gr 的请求不含个人数据，但会包含常规网络数据（你的 IP 地址、时间、请求的文件，以及 User-Agent kapaweb-connector/<version>）；kapaweb 的 Web 服务器会将这些数据记录在常规访问日志中。工具返回的内容（文件列表、日志、命令结果）会提供给 Claude，即你使用的 AI 应用，并受该应用自身的条款和隐私政策约束。
• **第三方：**我们不会与任何人分享任何内容。不投放广告，也不出售数据。
• **保留期限：**本地数据会一直保留，直到你将其删除（见上文）；kapaweb 的 Web 服务器日志遵循 kapaweb 的常规日志保留期限。
• **儿童：**这是一款商业工具，不适用于 18 岁以下人士。
• 联系方式：[email protected]。

供审核者参考的说明

目录扫描因其启发式规则检测到“一项凭据”与“远程主机”相邻，而将此插件标记为待审核。每项检测结果所指的内容如下（均已在源代码中核实）：

• server/da.js：ssd5.kdns.gr 只出现在代码注释中（面板地址的示例形式）。用户输入的面板地址会通过 kapaweb 自己的服务器列表进行检查（verifyPanelHost），并且在发送登录密钥之前，连接会固定到已验证的 IP 地址。
• server/setup.js：${h} 是本地登录页面（http://127.0.0.1:<random port>）Origin 检查中的 JavaScript 模板字面量；它不是主机，也不会向其发送任何机密。
• server/tools.js：kapaweb.gr 是注释和公开操作手册 URL。该请求只携带 User-Agent: kapaweb-connector 这个标头（不含密钥或密码）。
• server/plesk.js、server/plesk-web.js、server/provision-plesk.js（Plesk 预览版）：这些文件只与用户输入的 Plesk 面板通信；面板会通过 kapaweb 自己的服务器列表进行检查，并像 DirectAdmin 一样，先固定到已验证的 IP 地址。Plesk 密码只会发送到该面板（作为登录表单提交内容或 Basic auth 标头），绝不会发送给 Claude 或任何其他主机。
• server/clients.js：此文件会为用户生成帮助文本，并在其中提及路径 ~/.claude.json。它不会读取任何文件，也不会发送任何内容。

该插件处理的凭据属于用户自己的主机账户。DirectAdmin：受限登录密钥由用户在本地登录页面上输入一次密码后创建，之后该密码会被忘记。Plesk（预览版）：由于 Plesk 不允许客户创建受限密钥，因此使用 Plesk 密码本身；用户会在同一本地页面上输入该密码，且页面会在用户登录前明确说明这一点。两种情况下，机密都保存在操作系统的受保护存储中，并且只会发送到该用户自己经过验证的 kapaweb 面板。该插件不会读取用户电脑上的任何其他凭据、环境令牌或文件。

许可证

MIT。详见 LICENSE 文件。