Shopify CLI 与 Headless

Shopify CLI 走公司代理一直连接超时怎么配

现象#

shopify theme dev 卡在 Connecting to Shopify 超过一分钟,随后报 request to https://admin.shopify.com failed, reason: connect ETIMEDOUT;浏览器打开后台却完全正常。

原因#

  • CLI 只认 SHOPIFY_HTTP_PROXY 与 SHOPIFY_HTTPS_PROXY,不读取系统全局代理设置
  • 代理要求认证但地址里没带账号密码,CONNECT 阶段直接返回 407
  • HTTPS 走 CONNECT 隧道,防火墙只放行白名单域名,未包含 admin.shopify.com
  • 企业代理替换了证书链,Node 不信任自签根证书,报 self signed certificate 错误

处理步骤#

  1. 先验证代理本身:curl -x http://proxy:8080 https://admin.shopify.com
  2. 设置 SHOPIFY_HTTP_PROXY 为完整地址,HTTPS 另设 SHOPIFY_HTTPS_PROXY
  3. 企业根证书用 NODE_EXTRA_CA_CERTS=/path/ca.pem 注入,不要关闭 TLS 校验
  4. 让网络组把 admin.shopify.com、api.shopify.com、*.myshopify.com 加进白名单
  5. 查看代理访问日志,确认 CONNECT admin.shopify.com:443 返回 200 而不是 407

验收标准#

shopify theme list 在代理环境能返回主题;shopify theme dev 十秒内打印预览地址。

本文由 风格技术 技术团队整理,适用于 Shopify 标准版与 Plus 店铺。Shopify 平台能力迭代较快,具体操作路径与字段以官方文档和店铺后台实际版本为准。