xCloud Docker Deploy

🐳 一键生成 xCloud 部署配置

智能检测项目类型,自动生成 Docker 镜像与 Compose 配置,适配 xCloud 托管平台约束,支持 GitHub Actions CI/CD 流水线构建。

收藏
3.2k
安装
1.2k
版本
1.4.0
CLS 安全扫描中
预计需要 3 分钟...

使用说明

核心功能

xCloud Docker Deploy 是一款面向 DevOps 与开发者的智能部署助手技能,专为 xCloud 托管平台设计。该技能通过自然语言交互,自动检测项目技术栈(WordPress、Laravel、Next.js、Node.js、Python、Go 等),智能决策采用 xCloud 原生部署或自定义 Docker 方案,并生成完整的部署配置。

显著优点

1. 智能项目检测:通过扫描关键文件(wp-config.phpartisannext.config.*requirements.txt 等)自动识别技术栈,无需手动指定。
2. 自动适配 xCloud 约束:深度理解 xCloud 平台的限制规则——禁止 docker build、保留端口 80/443、需预构建镜像到 GHCR 等,自动修复冲突配置。

3. 多场景覆盖:支持三种核心场景——

4. 安全设计:明确声明无网络调用、无可执行文件、沙箱化运行;API Token 需用户主动提供,禁止存储或打印。
5. 官方 API 集成:与 xCloud 官方技能(xcloud:serversxcloud: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 无法拉取。

xCloud Docker Deploy 内容

assets文件夹
compose-templates文件夹
examples文件夹
references文件夹
手动下载zip · 35.7 kB
github-actions-build.ymltext/plain
请选择文件