# 内网访问 内网访问是一项可选的付费扩展服务。组织需要先购买内网访问权益，购买后才能开启和使用内网访问。开启后，浏览器会优先通过当前网络直接连接执行环境来访问工作空间文件，适合浏览器与执行环境处于同一办公网络或局域网的场景。 内网访问不会改变工作空间原有的权限和安全规则。组织未购买该权益时不能使用内网访问。网络暂时不通时，系统会自动改用普通网络；但如果是权限不足或安全规则限制，不会通过切换网络绕过。 组织未购买内网访问权益时，成员不会在工作空间中看到内网模式相关配置和状态入口。 ## 适合哪些场景 - 在公司或团队内网中使用工作空间。 - 需要频繁浏览、预览、编辑工作空间文件。 - 执行环境就在当前电脑或同一局域网内。 - 希望减少大文件访问的等待时间。 ## 如何开启 ### 开启浏览器内网体验 1. 打开「个人设置 → 实验功能」。 2. 开启「内网模式」。 3. 返回工作空间，系统会自动检查当前空间是否支持内网访问。 这个设置只对当前浏览器生效，并按账号保存，不会同步到其他浏览器或设备。关闭后，当前浏览器会停止使用内网访问，但不会修改空间或执行环境的配置。 ### 配置执行环境 如果你是空间管理员或执行环境管理员，还需要确认： - 该组织已购买内网访问服务。 - 当前空间允许使用内网访问。 - 执行环境已开启内网访问，并处于正常运行状态。 - 浏览器所在网络可以访问该执行环境。 空间管理员可在「空间设置 → 执行环境」中查看网络访问方式并测试连接。尚未绑定执行机时请先绑定；本地执行机未开启内网访问时，执行机管理员可在执行机详情中开启，其他成员请联系执行机管理员；专属机等其他宿主机需确认内网访问已可用。 专属机等其他宿主机需先支持内网访问。支持后，还可以开启「内网文件监听」，让文件区更快地显示文件变化。关闭文件监听不影响正常使用，文件变化仍会按原方式刷新。 部分执行环境不支持内网访问。对于这类环境，页面不会显示内网配置或测试入口，仍可正常使用普通网络。 ## 支持哪些操作 开启并检测成功后，以下操作会优先通过内网完成： - **浏览和预览**：文件树、文件信息、文件和文件夹预览。 - **下载**：文件下载，仍需要你有下载权限，且空间允许下载。 - **上传**：通过上传窗口上传文件，显示上传进度，可随时停止。 - **编辑**：文本和 Markdown 文件的打开与保存，以及在编辑器中粘贴图片。 - **文件管理**：新建文件和文件夹、删除、重命名、移动、复制和拖拽。 - **Git**：查看变更、历史和分支；在平台开放后，还可以切换分支和删除本地分支。 开启了“自动 Git 提交”的空间，通过内网修改文件后，系统仍会按原有规则自动提交。 暂不支持内网访问的操作（例如部分共享文件、执行环境中的下载、整个空间的打包下载）会继续使用普通网络，使用方式不变。 ## 对话回复也会走内网 在内网访问可用时，你自己发起的对话，助手的实时回复也会优先通过内网送达，回复内容出现得更快、更连贯。无需额外操作，使用方式与平时完全相同。 - **只对本人发起的对话生效**：其他成员打开同一对话、机器人回复的对话、分享链接中的对话，仍通过普通网络显示，内容一致。 - **断网自动切换**：回复过程中内网中断，系统会自动改用普通网络继续接收，已显示的内容不会重复或丢失。 - **刷新不受影响**：回复进行中刷新页面，会从当前进度继续显示。 - **权限随时生效**：被移出空间或权限变更后，内网回复会立即停止，不会继续收到新内容。 ## 网络中断时会怎样 - 你能看到和操作的内容，仍由工作空间权限、共享设置和文件保护规则决定，内网访问不会额外开放任何文件。 - 操作还没开始时网络中断，系统会自动改用普通网络完成。 - 上传、保存、删除、重命名等修改类操作，如果已经开始而网络中断，系统**不会自动重做**，以免重复修改。页面会提示“结果待确认”，你可以查询结果，或在操作尚未真正执行时选择继续。 - 待确认的操作只保存在当前页面中。刷新或离开页面前，请先确认这些操作已完成。 - 保存时，如果文件在你打开后已被他人修改，系统不会直接覆盖，会提示你处理冲突。 - 创建、重命名、移动或复制时目标已存在，系统不会自动覆盖。 ## 查看当前状态 开启浏览器内网体验后，桌面端会在工作空间页面右上角显示当前网络状态；移动端暂不展示状态入口。状态包括： - **公网**：当前通过普通网络访问。 - **检测内网**：正在检查是否可以使用内网访问。 - **内网**：当前优先通过内网访问。 点击桌面端状态入口可以查看当前组织、空间和所选执行环境的可用情况，并在需要时重新检测。切换执行环境后，页面会自动刷新为新环境的文件；如果切换后显示“暂无文件”，请先确认该执行环境绑定的目录是否正确。 ![查看当前空间内网状态](/images/docs/extensions/browser-intranet-status.png) 状态弹层会分别显示全局内网体验、组织开通状态、空间设置和执行机开关。上图表示当前空间已具备内网访问条件，并正在优先使用内网模式。 如需确认文件操作实际使用的网络，也可以打开浏览器开发者工具的 Network 面板查看请求。内网模式的文件请求会访问执行机上报的内网地址，例如下图中的 `/browser/files/list` 请求。 ![通过浏览器网络请求确认内网访问](/images/docs/extensions/browser-intranet-network-request.png) 即使未开启浏览器内网体验，也可以通过状态入口查看开启条件。组织内网访问权益不可用后，新的内网连接会立即被拒绝，当前页面刷新后会更新状态。 ## 常见问题 ### 开启后仍显示“公网”怎么办？ 请确认组织已购买内网访问权益，浏览器、空间和所选执行环境都允许内网访问，并检查执行环境是否在线、绑定目录是否正确。你也可以打开网络状态入口重新检测。 ### 关闭内网模式会影响空间设置吗？ 不会。关闭的是当前浏览器的体验偏好，不会修改组织、空间或执行环境设置，也不会影响其他浏览器中的使用。 ### 为什么有时对话回复没有走内网？ 只有你本人发起的对话会优先走内网。机器人发起的回复、其他成员查看你的对话、内网暂时不可用或平台暂未开放该能力时，回复会通过普通网络送达，内容和体验一致。 ### 是否需要安装证书或修改浏览器设置？ 通常不需要。若浏览器或所在网络禁止访问局域网地址，内网访问可能无法建立，此时系统会继续使用普通网络访问。 ### 上传或保存提示“结果待确认”怎么办？ 这表示操作已经发出，但网络中断导致没有收到结果。请在提示中查询原操作的结果，确认是否已完成，不要重复上传或保存。确认完成前请不要刷新页面。