内网访问

内网访问是一项可选的扩展能力。开启后，浏览器会优先通过当前网络中的执行环境访问工作空间文件，适合浏览器与执行环境处于同一办公网络或局域网的场景。

内网访问不会改变工作空间原有的权限和安全规则。平台管理员须先为所在组织显式开通，组织默认关闭；浏览器无法使用内网时，只读网络故障会回退到同一环境的普通网络访问，授权或策略拒绝不会通过回退绕过限制。

适合哪些场景

• 在公司或团队内网中使用工作空间。
• 需要频繁浏览、预览工作空间文件，或在默认环境按既有策略下载文件。
• 执行环境就在当前电脑或同一局域网内。
• 希望减少大文件访问的等待时间。

如何开启

开启浏览器内网体验

1. 打开「个人设置 → 实验功能」。
2. 开启「内网模式」。
3. 返回工作空间，系统会自动检查当前空间是否支持内网访问。

这个设置只对当前浏览器生效，并按账号保存，不会同步到其他浏览器或设备。关闭后，当前浏览器会停止使用内网访问，但不会修改空间或执行环境的配置。

配置执行环境

如果你是空间管理员或执行环境管理员，还需要确认：

• 平台管理员已在「平台管理 → 组织管理 → 点击组织名称」为该组织开启「内网直连授权」。
• 当前空间允许使用内网访问。
• 执行环境已开启内网访问，并处于正常运行状态。
• 浏览器所在网络可以访问该执行环境。

空间管理员可在「空间设置 → 执行环境」中查看网络访问模式并测试连接。尚未绑定执行机时请先绑定；Local Agent 未授权时，有该执行机管理权限的成员可以打开执行机详情修改授权，无权成员请联系执行机管理员；其他宿主机或 HTTP 模式请联系宿主机管理员确认支持情况。

部分执行环境不提供内网访问能力。对于这类环境，页面不会显示内网配置或测试入口，仍可继续使用普通网络访问。

能力会持续扩展

当前内网访问首先提供文件查看类能力，包括文件树、文件信息、文件预览和符合规则的下载。后续我们会在保证权限、安全和稳定性的前提下，逐步开放更多文件能力及其他工作空间能力，具体以产品页面实际提供的功能为准。

使用文件

开启并检测成功后，默认环境和所选 Local Agent 执行环境的文件树、文件信息与已接入的只读预览优先使用各自绑定执行机的内网访问。执行环境不提供直连下载，相关下载继续受现有空间规则控制并通过 Backend 处理。

• 你能看到和操作的内容，仍由工作空间权限、共享设置和文件保护规则决定。
• 内网访问不会额外开放文件，也不会绕过只读、下载限制或其他安全策略。
• 网络暂时不可用时，系统会自动尝试普通网络访问。
• 如果是权限不足或策略限制，系统不会通过切换网络来绕过限制。

查看当前状态

开启浏览器内网体验后，工作空间文件区域会显示当前网络状态：

• 公网：当前通过普通网络访问。
• 检测内网：正在检查是否可以使用内网访问。
• 内网：当前优先通过内网访问。

点击状态入口可以查看当前组织、空间和所选执行环境的可用情况，并在需要时重新检测。状态随文件来源切换；切换目录、停用或解绑执行环境后，已打开的文件树会尽快重新读取当前绑定；若切换后提示“暂无文件”，先核对该执行环境绑定的目录及文件树请求是否确实为空，不要误认为默认环境的目录丢失。

即使未启用当前浏览器的内网体验，也可在工作空间文件区域查看条件指引；此时不进行直连探测。其他设备关闭组织授权后，当前页面可在刷新时更新状态；服务端会立即拒绝新的直连授权，旧直连会话则在通知重试或授权到期后失效。

常见问题

开启后仍显示“公网”怎么办？

请确认组织授权、浏览器、空间和所选执行环境都允许内网访问，并检查执行环境是否在线、绑定目录是否正确。你也可以打开网络状态入口重新检测。

关闭内网模式会影响空间设置吗？

不会。关闭的是当前浏览器的体验偏好，不会修改组织、空间或执行环境设置，也不会影响其他浏览器中的使用。

是否需要安装证书或修改浏览器设置？

通常不需要。若浏览器或所在网络禁止访问局域网地址，内网访问可能无法建立，此时系统会继续使用普通网络访问。