安全更新：Docker 镜像从 v0.4.0-rc.1 起已修复 FFmpeg MagicYUV 解码器漏洞 CVE-2026-8461（高危），使用旧镜像的实例请立即升级。查看 CVE 公告

安全更新：v0.4.0-beta.3 已修复 WebDAV 请求可导致服务进程终止的问题，旧版本实例请尽快升级。查看安全公告

预览与编辑

哪些文件能直接在网页里打开

很多常见文件都可以直接在网页里打开，例如：

图片打开时，AsterDrive 会在两类来源之间选择：

管理员可以在 文件处理 -> 媒体处理 -> 图片预览策略 里调整默认策略：优先原图 适合希望尽量看到原始文件的站点；优先中等预览 适合大照片较多、带宽较敏感的站点。无论选哪一种，浏览器不支持当前原图格式时都会回退到后端预览图。

图片查看器支持全屏、缩放、拖动、旋转，以及在当前列表、文件夹或分享范围内切换上一张 / 下一张。后端预览图第一次缺失时会创建后台任务；任务完成前，页面可能会先显示加载或回退状态，后续再打开会复用缓存。

登录后的音频、视频预览会按当前存储策略读取文件，并支持浏览器 Range 请求。公开分享页里的音频和视频会先创建一个短时效流播放 session（默认约 3 小时），再把播放器指向这个临时地址。这个 session 不是分享链接本身的过期时间；分享链接的密码、过期时间和下载次数限制仍然照常生效。

压缩包预览是只读清单预览：

第一次打开某个压缩包时，如果清单还没有缓存，后端会创建 archive_preview_generate 后台任务。前端会显示生成中，稍后自动重试；任务完成后，后续打开会直接使用缓存。

ZIP 里的文件名如果显示为乱码，可以在预览工具栏里切换 文件名编码。优先试 自动，不行再按压缩包来源选择 GB18030、CP437、Shift_JIS、Big5 等编码。这个选择只影响清单显示，不会改动压缩包本身，也不会影响在线解压结果。

压缩包预览默认不开启，能不能用取决于管理员是否打开了总开关和对应入口（用户侧 / 分享侧）。

网页内编辑主要面向文本类文件，例如 Markdown、CSV / TSV、JSON、XML、TOML / YAML / INI 配置、日志、脚本和常见代码文件。

保存时，AsterDrive 会自动：

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

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

WOPI 最常见的用途，就是把 docx、xlsx、pptx 这类文件交给 OnlyOffice、Collabora 一类兼容服务打开。从用户角度看，WOPI 只需要记住这几件事：

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

如果某个 Office 文件没有出现额外入口，通常只有两种原因：管理员还没有给这种文件配置对应的预览应用，或者当前部署没有接入可用的 WOPI 服务。

如果你更习惯桌面应用，也可以通过 WebDAV 编辑文件——Finder 挂载网络位置、Windows 映射网络驱动器、rclone 同步或支持 WebDAV 的编辑器。通过 WebDAV 覆盖保存时，同样会生成历史版本。

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

常见处理方法：

过期锁会被后台自动清理，不需要手动处理。