Label Studio离线部署方案：解决内网环境CDN依赖问题

在企业内网环境中部署Label Studio时，技术人员常会遇到页面加载失败的问题。经过分析发现，这是由于Label Studio默认会调用Sentry的错误监控服务和CDN资源，而这些外部依赖在内网环境中无法访问。

问题根源分析

Label Studio作为一款开源数据标注工具，默认集成了Sentry错误监控系统。系统会自动加载两个关键资源：

1. Sentry的JavaScript SDK（来自CDN）
2. 错误日志上报接口

这种设计在公网环境下能提供良好的错误监控能力，但在隔离网络环境中会导致页面加载停滞，严重影响使用体验。

解决方案

通过环境变量配置可以完全禁用这些外部依赖，使Label Studio成为完全自包含的应用。具体需要设置以下三个关键环境变量：

1. SENTRY_DSN - 置空以禁用后端Sentry集成
2. FRONTEND_SENTRY_DSN - 置空以禁用前端Sentry集成
3. COLLECT_ANALYTICS - 设为False禁用分析数据收集

实施方法

Docker部署方案

对于Docker部署方式，启动命令应修改为：

docker run -it \
  -e SENTRY_DSN='' \
  -e FRONTEND_SENTRY_DSN='' \
  -e COLLECT_ANALYTICS=False \
  -p 8080:8080 \
  heartexlabs/label-studio:latest

Kubernetes/Helm部署方案

在Helm chart配置中，需要在values.yaml中添加：

app:
  extraEnvironmentVars:
    SENTRY_DSN: ''
    FRONTEND_SENTRY_DSN: ''
    COLLECT_ANALYTICS: false

验证与效果

实施上述配置后：

1. 浏览器不再尝试加载CDN上的Sentry SDK
2. 应用不会向Sentry服务器发送任何请求
3. 所有功能转为完全本地化运行
4. 页面加载速度恢复正常

注意事项

1. 禁用监控后，系统将不再上报运行时错误，需加强本地日志收集
2. 此配置同时禁用了使用情况统计，可能影响产品改进
3. 建议在内网部署日志监控系统作为替代方案

这种配置方式特别适合政府、金融等对网络隔离有严格要求的行业场景，既能保证Label Studio的核心功能完整，又能满足网络安全合规要求。