创建沙箱并将更改部署到生产中

请注意：2026年4月30日，传统标准沙盒将停止服务。此日期之后，您将无法继续使用 传统标准沙盒。如需创建新沙盒环境，请了解如何 创建沙盒并向生产环境部署变更。为协助过渡，现有旧版沙盒用户的沙盒配额已临时提升。在临时配额有效期内，您可在保留旧版沙盒的同时创建新版标准沙盒，从而手动迁移关联应用并熟悉新版操作界面。更多变更详情请参阅 HubSpot社区。

开始前须知

了解要求

限制与注意事项

• 在2026年4月30日前，您的账户将额外获得一个标准沙盒。
• 默认情况下，生产环境中的所有超级管理员将在创建时自动复制到沙盒环境。
  • 创建后，若在生产环境账户新增超级管理员，需手动将其添加至沙盒账户。
  • 创建后，当生产环境账户移除超级管理员时，该用户将自动从沙盒账户中移除。
• 了解部署至生产环境功能支持的对象配置与资产详情。
• 联系人、公司、商机、工单及自定义对象的ID在沙盒与生产环境中将不相同。建议创建新自定义属性（如外部记录ID），并通过自动化将生产环境记录ID复制至该字段，以便在沙盒环境中进行测试时使用。
• 整个沙盒账户每日所有工作流的记录注册上限为100,000条。超出上限的注册请求将被丢弃。当达到上限时，系统会通知您当前账户状态及下次可同步的时间。
• 若某类资产在创建时无法复制到标准沙盒账户，依赖该资产类型的关联资产也将无法同步。例如：由于调查表不可复制到标准沙盒账户，所有使用调查表作为触发器或操作的工作流均不会被复制。 
• 生产账户中的集成不会自动连接至标准沙盒账户。若需将现有集成连接至沙盒账户，HubSpot 建议连接该集成的沙盒版本，以避免影响您的 CRM 数据。

创建标准沙盒

创建沙盒的步骤：

1. 在 HubSpot 帐户中，单击顶部导航栏中的 settings “设置”图标。
2. 在左侧边栏菜单中选择沙盒。
3. 点击创建沙盒。
   
   
   
4. 在右侧面板的沙盒名称栏输入沙盒名称。
   • 默认勾选"复制生产环境资产"复选框，因沙盒需模拟生产账户环境。点击下拉图标查看将复制至沙盒的资产列表。
   •  勾选"复制5,000个联系人及其关联记录"复选框，即可复制最近更新的5,000个联系人，以及每个联系人最多100条关联的交易、公司和工单记录。

请注意： 创建标准沙盒时可复制5,000条联系人及关联记录。若创建沙盒时未复制记录，您可在后续日期导出测试记录并导入至沙盒。 您可手动导入下列对象的记录，每种对象最多支持200,000条记录：联系人、公司、商机、工单、自定义对象、购物车、发票、营销活动及各类订单记录。其余记录类型请参阅CRM数据使用量追踪指南。

6. 点击创建标准沙盒。
7. 创建沙盒的过程可能需要数小时，具体取决于需要从生产账户复制的资产数量、生产计划功能及超级管理员数量。了解超级管理员在沙盒账户中的处理方式。
8. 创建状态将在“活动日志”选项卡的“状态”列中显示。
9. 创建完成后状态将更新，您将收到邮件通知。
   
   
   
10. 点击沙盒旁的状态查看创建详情。 
    • 点击"失败资产"选项卡可查看失败资产及错误详情。
    • 点击"已复制资产"选项卡查看创建的资产列表。
      
      
      

访问标准沙盒

所有在沙盒创建过程中被复制的超级管理员均可通过其主账户菜单访问沙盒。

1. 在您的HubSpot账户中，点击右上角的账户名称。 
2. 将鼠标悬停在 账户名称上，查看您最近使用的账户列表。 
3. 在下拉菜单中点击目标沙盒名称。
   
   
   
4. 窗口顶部将显示横幅提示，表明您当前处于标准沙盒账户中。

 超级管理员还可通过账户设置访问沙盒：

1. 在 HubSpot 帐户中，单击顶部导航栏中的 settings “设置”图标。
2. 在左侧边栏菜单中选择沙盒。
3. 点击要访问的沙盒名称。 
4. 退出沙盒账户时，请点击右上角的生产账户名称。

设置生产环境部署

在沙盒中完成修改后，可将支持的资产部署至生产账户。 设置生产部署时 ，请 导航至生产账户，然后：

1. 在 HubSpot 帐户中，单击顶部导航栏中的 settings “设置”图标。
2. 在左侧边栏菜单中选择沙盒。
3. 在右上角选择“设置部署”。
   • 在"支持的资产类型"列中，选择要部署的资产。若部署对象，请在资产旁点击"选择配置"。
   • 若需了解各类资产的部署条件，请点击顶部横幅中的查看[X]项部署行为。在右侧面板中查阅相关信息后，点击关闭。
     
     
     
4. 勾选每个可部署变更项旁的复选框。若部署对象，此操作需在右侧面板进行，并必须点击保存选择。

请注意：每次最多可部署300项变更。 

7. 点击下一步。 
8. 所有关联资产将在"关联资产"步骤中显示。关联资产指被选中资产所依赖的其他资产，且为本次部署所必需。
   
   • 在名称列中 点击查看对象配置，即可根据关联关系查看将要部署的内容。
   • 在“被使用”列中 点击x个选定资产以查看关联关系。

   • 若需将配置纳入部署范围，请勾选"添加x个连接至我的部署"复选框，然后点击"下一步"。

9.  系统将自动检测冲突。请检查错误并解决冲突后继续部署。若未检测到冲突，请点击下一步。
10. 在部署名称字段中输入部署名称，在描述字段中输入说明。点击下一步。
11. 审核生产环境部署内容。准备就绪后，点击部署到生产环境。
12. 点击“部署到生产环境”进行确认。

13. 部署启动后，生产环境的活动日志标签页将显示状态栏为 "进行中"。部署启动后无法取消。
14. 部署完成后，状态将更新为 [#]项变更已部署。

• 请注意：若部署失败，请查阅部署错误日志以排查故障原因。如需进一步协助，请联系技术支持。

15. 点击部署名称或 [#]项变更已部署查看部署详情。

查看沙盒活动

要查看用户在您账户中执行的沙盒操作历史记录：

1. 在 HubSpot 帐户中，单击顶部导航栏中的 settings “设置”图标。
2. 在左侧边栏菜单中导航至沙盒。
3. 点击活动日志选项卡。
4. 系统将显示完整的沙盒相关活动列表，包括：
   • 沙盒创建详情（如复制的资产及错误原因）
   • 历史生产环境部署记录
   • 沙盒删除记录
5. 点击日志类型下拉菜单可筛选不同活动类型。

沙盒最佳实践

沙盒允许用户在生产账户之外安全地进行创新。建议制定开发策略，并考虑以下方面以确保沙盒中可靠的测试：

• 沙盒用途是什么？（例如：积极开发、集成测试、培训）
• 哪些人员需要访问权限？（例如：考虑限制可能影响测试可靠性的冲突）
• 是否需要更多沙盒以支持不同用例？
• 如何创建和管理沙盒以最佳支持开发需求？

明确定义这些方面有助于保障测试可靠性，将支持资产部署至生产环境，同时兼顾其他使用场景。

以下是不同沙箱用途、应获访问权限的用户群体及确保可靠测试与开发的创建策略示例：