核心功能
xCloud Docker Deploy 是一款面向 DevOps 与开发者的智能部署助手技能,专为 xCloud 托管平台设计。该技能通过自然语言交互,自动检测项目技术栈(WordPress、Laravel、Next.js、Node.js、Python、Go 等),智能决策采用 xCloud 原生部署或自定义 Docker 方案,并生成完整的部署配置。
显著优点
1. 智能项目检测:通过扫描关键文件(wp-config.php、artisan、next.config.*、requirements.txt 等)自动识别技术栈,无需手动指定。
2. 自动适配 xCloud 约束:深度理解 xCloud 平台的限制规则——禁止 docker build、保留端口 80/443、需预构建镜像到 GHCR 等,自动修复冲突配置。
3. 多场景覆盖:支持三种核心场景——
4. 安全设计:明确声明无网络调用、无可执行文件、沙箱化运行;API Token 需用户主动提供,禁止存储或打印。
5. 官方 API 集成:与 xCloud 官方技能(xcloud:servers、xcloud:sites 等)无缝协作,区分本地配置生成与线上资源操作。
- Scenario A:源码构建(移除
build:,生成 GitHub Actions 工作流推送至 GHCR) - Scenario B:代理冲突解决(移除 Caddy/Traefik,替换为内联 nginx-router)
- Scenario C:多服务构建(矩阵式并行构建多个镜像)
潜在局限
- 平台锁定:生成的配置高度针对 xCloud 约束优化,迁移至其他 Docker 托管平台需人工调整。
- 复杂编排限制:对于涉及多个独立构建服务、复杂网络拓扑或自定义 SSL 证书的场景,需人工介入验证。
- 依赖外部 CI:镜像构建完全依赖 GitHub Actions,用户需配置
GHCR权限与仓库 Secrets。
适合人群
- 希望快速将现有项目迁移至 xCloud 的开发者
- 不熟悉 Docker 或 xCloud 约束规则的技术团队
- 需要标准化 CI/CD 流水线的 DevOps 工程师
- 使用 WordPress、Laravel、Next.js、Python FastAPI 等主流栈的独立开发者
常规风险
- 端口冲突:若未遵循
3080:80等映射规则,部署将失败。 - 敏感信息泄露:
.env.example生成时需确保不包含真实密钥;API Token 需用户自行保管。 - 镜像拉取失败:GHCR 镜像需公开或配置正确 Token,否则 xCloud 无法拉取。