为了更好地保护商家,我们正在将网络访问声明作为要求添加。必须在shopify.app.toml的[network_access]部分中为在在线商店上运行代码的应用程序声明allowed_sources。
时间线
对于未按要求添加必要声明的应用,Shopify 将拒绝其部署并将其下架。
公开应用:
- 2026年12月1日:Shopify将拒绝部署和Shopify应用商店提交。商家将在Shopify管理后台看到警告。现有应用版本将继续正常工作。
- 2027年1月1日:Shopify将从Shopify应用商店下架应用程序并阻止新安装。现有安装将继续正常工作。
安装在您组织外部商店的自定义应用:
- 2026年12月1日:Shopify将拒绝部署。
- 2027年1月1日:在您范围内的每个应用程序都声明了其网络访问之前,Shopify将阻止您组织外部对您应用程序的安装。
受哪些应用影响
如果您在组织外部商店安装以下功能之一的公开应用和自定义应用,则它们会受到影响:
- 主题应用扩展区块或应用嵌入。
- 在线商店上的脚本标签。
- 应用代理。
- write_themes访问范围。
- 具有write_open_pixels访问范围的Web像素。
不受哪些应用影响
- 仅写入内容(如元字段、菜单或产品)的应用。
- 具有结账 UI 扩展但不具备上述任何功能的应用。
- 仅安装在您组织内部商店的自定义应用。
- 商家在 Dev Dashboard 或 Shopify 管理后台创建的应用。
- 在默认严格沙箱中运行的 Web 像素。
我们为何进行此项更改
注入的脚本可以从任何服务器向商店加载代码。声明您应用所属的服务器有助于 Shopify 识别可疑请求,从而保护您的应用以及使用该应用的商家。
操作指南
- 将您的应用程序代码加载或发送请求到的服务器(例如您的API或CDN)添加到allowed_sources。如果您的应用程序不联系任何外部服务器,则设置allowed_sources = []。空列表也算作声明。
- 可选:将您的应用程序链接到客户的网站(例如您自己的应用程序网站)添加到allowed_navigation_hosts。这有助于Shopify识别到您信任的网站链接,从而降低客户看到退出警告的可能性。
- 使用网络访问测试预览在开发商店上测试您的配置。该预览仅涵盖在线商店。
- 运行shopify app deploy,然后发布新版本。
以下是一个配置示例:
[network_access] allowed_sources = ["https://api.app.example.com"] allowed_navigation_hosts = ["app.example.com"]有关示例和故障排除,请参阅声明您应用程序的网络访问。对于即将到来的每个日期,请参阅即将进行的安全截止日期。

