主题

文件编辑 ​

这一篇讲 AsterDrive 里怎么直接改文件——包括文本类文件的浏览器内编辑，和把 Office 文件交给外部编辑器（Collabora / OnlyOffice）的接入流程。

AsterDrive 现在有两条常见编辑路线：

  • 直接在浏览器里编辑文本文件
  • 通过管理员配置的 WOPI 打开方式，把 Office 类文件交给外部在线编辑器处理

你平时不需要先分辨底层实现——打开文件后能不能直接改、会不会出现额外的"打开方式"，都由文件类型和管理员当前配置决定。

浏览器里适合直接编辑什么 ​

网页内编辑主要面向文本类文件，例如：

  • Markdown
  • CSV / TSV
  • JSON
  • XML
  • TOML、YAML、INI 这类配置文件
  • 日志
  • 脚本
  • 常见代码文件

这条路线最适合改文档、配置、脚本和源码。
如果是 Word、Excel、PowerPoint 这类 Office 文件，通常要看管理员有没有给站点配置 WOPI 打开方式。

打开后你会看到什么 ​

文本文件 ​

文本类文件通常可以直接在网页里打开和保存。
保存时，AsterDrive 会自动：

  • 在编辑期间为文件加锁
  • 保存前检查文件是否已经被别人改过
  • 保存成功后生成新的历史版本
  • 关闭编辑器后释放锁

如果保存时收到冲突提示，通常说明这份文件在你编辑期间已经被别人改过。
先刷新内容，再决定是否继续。

Office 文件和其他外部打开方式 ​

如果管理员已经配置好预览应用，你在某些文件上会看到额外的“打开方式”。
这类入口可能包括：

  • 内置预览器
  • 外部 URL 模板预览器
  • WOPI 在线打开方式

WOPI 最常见的用途，就是把 docx、xlsx、pptx 这类文件交给 OnlyOffice 一类兼容服务打开。
具体是在当前弹窗里打开，还是跳到新标签页打开，取决于管理员怎么配置这条打开方式。

URL 模板预览器更像“把当前文件的预览链接交给外部网页”。
内置的 Microsoft / Google 预览器就属于这一类，它们通常要求文件预览链接能被外部服务访问，内网地址、localhost 或纯 HTTP 链接经常会直接失败。

如果某个 Office 文件没有出现额外入口，通常只有两种原因：

  • 管理员还没有给这种文件配置对应的预览应用
  • 当前部署没有接入可用的 WOPI 服务

WOPI 打开方式对用户意味着什么 ​

从用户角度看，WOPI 只需要记住这几件事：

  • 它不是单独的站点入口，而是文件预览窗口里的一个打开方式
  • 不是所有部署都会出现
  • AsterDrive 会在你打开文件时临时创建会话并签发访问令牌
  • 通过 WOPI 保存回来的内容，同样会写回原文件
  • WOPI 覆盖保存后，也会进入历史版本

如果管理员接的是外部 Office 服务，你看到的编辑界面样式和按钮，主要由那套服务决定，不完全由 AsterDrive 决定。

历史版本什么时候会产生 ​

只要发生覆盖写入，就会生成历史版本。常见来源包括：

  • 浏览器内文本编辑
  • WOPI 在线保存
  • WebDAV 覆盖保存
  • 其他直接覆盖原文件内容的写入方式

你可以在版本历史里：

  • 查看旧版本
  • 恢复某个版本
  • 删除某个版本

恢复旧版本后，那个版本之后的新版本会一起被截断，所以恢复前先确认。

通过 WebDAV 编辑也会保留版本 ​

如果你更习惯桌面应用，也可以通过 WebDAV 编辑文件。
通过 WebDAV 覆盖保存时，同样会生成历史版本。

常见场景包括：

  • Finder 挂载网络位置
  • Windows 映射网络驱动器
  • rclone 或其他同步工具
  • 支持 WebDAV 的编辑器或办公软件

管理员要先配好什么，WOPI 才会出现 ​

如果你是管理员，WOPI 相关入口主要在这里：

  • 管理 -> 系统设置 -> 站点配置 -> 公开站点地址
  • 管理 -> 系统设置 -> 站点配置 -> 预览应用

最常见的准备顺序是：

  1. 先把 公开站点地址 填成用户真实访问 AsterDrive 的 HTTP(S) 来源；多个公开入口逐项添加
  2. 在 预览应用 里导入或创建 WOPI 打开方式
  3. 确认外部 Office / WOPI 服务能访问到 公开站点地址 生成的 /api/v1/wopi/...
  4. 如果浏览器控制台明确报 AsterDrive API 的 CORS 错误，再去 管理 -> 系统设置 -> 网络访问 放行对应来源
  5. 用一个真实 Office 文件试开一次，再确认能正常保存回 AsterDrive

如果你在 预览应用 里使用 WOPI Discovery，系统会根据 discovery 地址生成对应应用。
后续如果发现入口能显示但打开失败，先检查 discovery 地址、公开站点地址和 WOPI 服务到 AsterDrive 的网络连通性。

遇到锁定问题怎么办 ​

文件正在被编辑时，其他用户不能随意覆盖、重命名、移动或删除它。

常见处理方法：

  • 先让持有锁的用户正常保存并退出
  • 如果是浏览器标签页、WebDAV 客户端或外部 WOPI 编辑器异常中断，再让管理员到 管理 -> 锁 里清理残留锁

使用边界 ​

  • 浏览器内编辑主要适合文本类文件
  • Office 类文件是否能在线打开，取决于管理员是否配置了对应预览应用
  • WOPI 是否支持多人协作，取决于你接入的外部服务；AsterDrive 负责文件访问、会话和锁
  • 不会自动帮你合并冲突
  • 历史版本保留数量由管理员控制

基于 MIT 许可证发布

Copyright © 2026 AptS:1547