内网访问

内网访问是一项可选的付费扩展服务。组织需要先购买内网访问权益，购买后才能开启和使用内网访问。开启后，浏览器会优先通过当前网络直接连接执行环境来访问工作空间文件，适合浏览器与执行环境处于同一办公网络或局域网的场景。

内网访问不会改变工作空间原有的权限和安全规则。组织未购买该权益时不能使用内网访问。网络暂时不通时，系统会自动改用普通网络；但如果是权限不足或安全规则限制，不会通过切换网络绕过。

组织未购买内网访问权益时，成员不会在工作空间中看到内网模式相关配置和状态入口。

适合哪些场景

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

如何开启

开启浏览器内网体验

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

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

配置执行环境

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

• 该组织已购买内网访问服务。
• 当前空间允许使用内网访问。
• 执行环境已开启内网访问，并处于正常运行状态。
• 浏览器所在网络可以访问该执行环境。

空间管理员可在「空间设置 → 执行环境」中查看网络访问方式并测试连接。尚未绑定执行机时请先绑定；本地执行机未开启内网访问时，执行机管理员可在执行机详情中开启，其他成员请联系执行机管理员；专属机等其他宿主机需确认内网访问已可用。

专属机等其他宿主机需先支持内网访问。支持后，还可以开启「内网文件监听」，让文件区更快地显示文件变化。关闭文件监听不影响正常使用，文件变化仍会按原方式刷新。

部分执行环境不支持内网访问。对于这类环境，页面不会显示内网配置或测试入口，仍可正常使用普通网络。

支持哪些操作

开启并检测成功后，以下操作会优先通过内网完成：

• 浏览和预览：文件树、文件信息、文件和文件夹预览。
• 下载：文件下载，仍需要你有下载权限，且空间允许下载。
• 上传：通过上传窗口上传文件，显示上传进度，可随时停止。
• 编辑：文本和 Markdown 文件的打开与保存，以及在编辑器中粘贴图片。
• 文件管理：新建文件和文件夹、删除、重命名、移动、复制和拖拽。
• Git：查看变更、历史和分支；在平台开放后，还可以切换分支和删除本地分支。

开启了“自动 Git 提交”的空间，通过内网修改文件后，系统仍会按原有规则自动提交。

暂不支持内网访问的操作（例如部分共享文件、执行环境中的下载、整个空间的打包下载）会继续使用普通网络，使用方式不变。

对话回复也会走内网

在内网访问可用时，你自己发起的对话，助手的实时回复也会优先通过内网送达，回复内容出现得更快、更连贯。无需额外操作，使用方式与平时完全相同。

• 只对本人发起的对话生效：其他成员打开同一对话、机器人回复的对话、分享链接中的对话，仍通过普通网络显示，内容一致。
• 断网自动切换：回复过程中内网中断，系统会自动改用普通网络继续接收，已显示的内容不会重复或丢失。
• 刷新不受影响：回复进行中刷新页面，会从当前进度继续显示。
• 权限随时生效：被移出空间或权限变更后，内网回复会立即停止，不会继续收到新内容。

网络中断时会怎样

• 你能看到和操作的内容，仍由工作空间权限、共享设置和文件保护规则决定，内网访问不会额外开放任何文件。
• 操作还没开始时网络中断，系统会自动改用普通网络完成。
• 上传、保存、删除、重命名等修改类操作，如果已经开始而网络中断，系统不会自动重做，以免重复修改。页面会提示“结果待确认”，你可以查询结果，或在操作尚未真正执行时选择继续。
• 待确认的操作只保存在当前页面中。刷新或离开页面前，请先确认这些操作已完成。
• 保存时，如果文件在你打开后已被他人修改，系统不会直接覆盖，会提示你处理冲突。
• 创建、重命名、移动或复制时目标已存在，系统不会自动覆盖。

查看当前状态

开启浏览器内网体验后，桌面端会在工作空间页面右上角显示当前网络状态；移动端暂不展示状态入口。状态包括：

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

点击桌面端状态入口可以查看当前组织、空间和所选执行环境的可用情况，并在需要时重新检测。切换执行环境后，页面会自动刷新为新环境的文件；如果切换后显示“暂无文件”，请先确认该执行环境绑定的目录是否正确。

状态弹层会分别显示全局内网体验、组织开通状态、空间设置和执行机开关。上图表示当前空间已具备内网访问条件，并正在优先使用内网模式。

如需确认文件操作实际使用的网络，也可以打开浏览器开发者工具的 Network 面板查看请求。内网模式的文件请求会访问执行机上报的内网地址，例如下图中的 /browser/files/list 请求。

即使未开启浏览器内网体验，也可以通过状态入口查看开启条件。组织内网访问权益不可用后，新的内网连接会立即被拒绝，当前页面刷新后会更新状态。

常见问题

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

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

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

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

为什么有时对话回复没有走内网？

只有你本人发起的对话会优先走内网。机器人发起的回复、其他成员查看你的对话、内网暂时不可用或平台暂未开放该能力时，回复会通过普通网络送达，内容和体验一致。

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

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

上传或保存提示“结果待确认”怎么办？

这表示操作已经发出，但网络中断导致没有收到结果。请在提示中查询原操作的结果，确认是否已完成，不要重复上传或保存。确认完成前请不要刷新页面。