用户手册
欢迎使用 AsterDrive ✨
这一篇是给普通用户看的——拿到账号、登录进来、上传第一个文件、分享给别人、必要时找回回收站里的内容。整个手册按页面组织，不需要按顺序读完，登录后看到哪一块不清楚，直接翻对应章节就行。
如果你是管理员，建议先看一遍这一篇了解普通用户视角，再看 管理后台。
如果你打算挂载 WebDAV、给 Office 文件接外部编辑器，对应章节会专门讲。
我们对"好用"的定义
AsterDrive 不追求"功能最多的网盘"。我们想做的是这样一个东西：
- 常用的事不让你想 —— 上传、找文件、分享、误删恢复，都该是一次操作完成
- 不出意外的事不打扰你 —— 没必要的提示、没必要的对话框、没必要的"你确定吗"都尽量去掉
- 真出问题时给你清晰的信号 —— 错误码 + 中文提示 + 可操作的下一步建议
如果你用下来觉得哪里别扭，开个 issue 告诉我们——这是最直接的反馈方式。
登录和首次进入
登录页不需要你先决定"这是登录还是注册"。
输入用户名或邮箱后，页面会自动判断流程：
- 系统里还没有任何用户：创建管理员
- 输入的是已有账号：登录
- 输入的是新账号，而且管理员允许公开注册：注册普通账号
需要注意：
- 第一个创建成功的账号会自动成为管理员
- 后续新注册的普通账号，通常需要先点激活邮件才能登录
- 如果管理员关闭了公开注册，联系管理员给你创建账号
- 如果管理员已经配好邮件，可以在登录页直接申请密码重置邮件
- 如果你已经添加过 Passkey，可以在登录页直接用设备解锁或安全密钥登录
- 如果管理员配置了外部认证，登录页会显示对应的外部登录入口
- 如果你的账号启用了 MFA，密码或外部身份通过后，还需要输入认证器验证码或恢复码
先认识工作空间
登录后，左侧最上方会看到工作空间列表：
我的空间：你的个人文件、个人分享、个人回收站和 WebDAV 账号都在这里- 团队空间：只有你加入团队后才会出现；每个团队空间都有自己的文件、分享、回收站和任务列表
搜索、分享、任务和回收站都会跟着当前工作空间走。
要管理哪一组内容，先切到对应工作空间。
文件页面最常用的位置
- 左侧工作空间列表：切换个人空间或团队空间
- 左侧目录树：快速进入目标文件夹
- 顶部搜索框：搜索当前工作空间里的文件和文件夹
回收站：处理当前工作空间里的已删除内容我的分享：查看当前工作空间里已经发出去的链接任务中心：查看在线压缩、在线解压、打包下载等后台任务WebDAV：只在个人空间里出现，用来创建桌面客户端账号- 右上角用户菜单里的
设置：调整个人资料、界面、安全和团队相关设置
上传和整理文件
文件列表、右键菜单和顶部操作区可以完成大多数日常工作：
- 创建文件夹
- 创建空白文本文件
- 上传文件
- 上传文件夹
- 下载文件
- 重命名、复制、移动、删除文件和文件夹
- 查看详细信息
- 手动锁定或解锁文件
- 在线压缩、在线解压和文件夹打包下载
- 在列表视图和网格视图之间切换
- 按名称、大小、创建时间、更新时间或类型排序
你也可以直接拖拽：
- 把文件或文件夹拖到左侧目录树里的目标文件夹
- 把文件或文件夹拖到顶部面包屑里的上级目录
- 把文件或文件夹拖到左侧的回收站
搜索、多选和批量处理
顶部搜索框会在当前工作空间里按名称搜索文件和文件夹。
可以直接点搜索框，也可以用 Ctrl + K 打开搜索弹窗；弹窗里能切换“全部 / 仅文件 / 仅文件夹”，还能按图片、视频、音乐、文档、表格、演示、压缩包、代码和其他分类快速筛选。方向键选结果，Enter 打开。
左侧也有常用类型的快速入口，例如图片、视频、音乐和文档。点进去本质上还是在当前工作空间里按文件分类搜索。
文件页面里的搜索状态会跟着当前工作空间走。
你在团队空间里搜到的结果，不会混进个人空间的文件。
需要一次处理多个项目时，可以直接多选后批量执行：
- 批量移动
- 批量复制
- 批量删除
- 批量打包下载
在文件列表和回收站里都可以使用 Ctrl + A 或 Cmd + A 全选当前页。
文件或文件夹的“详细信息”会显示名称、大小、类型、创建时间、修改时间、锁定状态、分享状态和存储策略 ID 等信息。
排查“这个文件到底在哪条策略上”“是不是被锁住了”时，先看这里。
打开、预览和编辑
很多常见文件都可以直接在网页里打开，例如：
- 图片
- 音频和视频
- Markdown
- CSV / TSV
- JSON
- XML
- ZIP 压缩包清单
- 纯文本和常见代码文件
文本类文件通常可以直接编辑。保存时，系统会自动：
- 检查这份文件在你打开之后有没有被别人改过
- 生成新的历史版本
- 释放编辑锁
如果管理员给站点配置了额外的在线预览或在线编辑能力，你在某些文件上还会看到额外的“打开方式”。
最常见的场景，就是把 Office 文件交给外部预览器或 WOPI 在线编辑器打开。
这类入口会不会出现，取决于管理员有没有给当前文件类型配置对应的预览应用。
如果你手上的 docx、xlsx 或 pptx 没有显示额外打开方式，通常说明当前站点还没把这类文件接到可用的外部服务。
ZIP 压缩包预览是只读清单预览。它只显示压缩包里的目录、文件、大小和修改时间，不会把压缩包解压到当前文件夹，也不能单独下载压缩包里的某个文件。第一次打开某个 ZIP 时，可能会先显示生成中，等后台任务完成后再展示清单。
如果 ZIP 里的文件名显示乱码，在预览工具栏里切换 文件名编码。优先试 自动，不行再按压缩包来源选择 GB18030、CP437、Shift_JIS、Big5 等编码。这个选择只影响清单显示，不会改动压缩包本身。
版本历史怎么用
你可以在版本历史里：
- 查看旧版本
- 恢复某个旧版本
- 删除不需要的旧版本
恢复旧版本后，那个版本之后的新版本记录会被截断，所以恢复前先确认。
如果保存时出现冲突提示，通常说明这份文件在你打开后又被别人改过了。先刷新内容，再决定是否继续保存。
任务中心
当前界面里，最常见会进入 任务中心 的操作包括：
- 文件夹打包下载
- 选中一批文件或文件夹后在线压缩
- 对压缩包做在线解压
- 第一次打开 ZIP 压缩包预览时生成清单
如果站点后续接入了其他后台文件任务，它们也会在这里按同样方式显示。
在 任务中心 里，你可以：
- 查看任务当前是排队中、处理中、已完成、已取消还是失败
- 查看创建时间、开始时间和完成时间
- 查看每一步的当前进度和状态说明
- 在任务完成后直接打开结果所在文件夹
- 在失败时重新排队
任务中心同样跟着当前工作空间走。
你在团队空间里发起的任务，要到对应团队空间的 任务中心 去看。
回收站
普通删除不会立刻彻底清除文件或文件夹，而是先进入回收站。
你可以在回收站中：
- 恢复项目
- 永久删除单个项目
- 清空整个回收站
- 批量恢复
- 批量永久删除
如果原来的父目录已经不存在，恢复时项目会回到根目录。
分享链接
分享会跟着当前工作空间走。
要分享团队空间里的文件，先切到对应团队空间再创建分享。
AsterDrive 支持文件分享和文件夹分享。创建分享时可以设置：
- 密码
- 过期时间
- 最大下载次数
需要注意的规则：
- 同一个文件或文件夹同一时间只能保留一条活跃分享
- 如果要改密码、过期时间或下载次数，不需要重建链接，去
我的分享里直接编辑即可 - 如果链接设置了密码，访问者在当前浏览器验证成功后，通常约 1 小时内不需要重复输入密码
如果你分享的是单个文件，弹窗里还可以切到 直链 模式。直链不支持密码、过期时间和下载次数限制，但会额外给出一个“强制下载链接”。默认直链更适合直接打开，强制下载链接则明确要求浏览器下载；当文件位于开启了 presigned 下载策略的第三方存储上时，这条强制下载链接可能会先跳转到一个短时效下载地址。
分享页里播放音频或视频时，系统会创建一个短时效播放 session，默认大约 3 小时有效。这个 session 只是给浏览器播放器使用，分享链接本身的密码、过期时间和下载次数限制仍然照常生效。
如果管理员开启了分享侧 ZIP 预览，访问者也可以在分享页只读查看 ZIP 内部清单。设置了分享密码时，必须先通过密码验证才能看到清单。
我的分享
左侧 我的分享 页面会列出当前工作空间里已经发出去的链接。
你可以在那里：
- 复制分享链接
- 打开公开页面
- 编辑密码、过期时间和下载次数限制
- 删除不再需要的分享
- 查看打开次数和下载次数
- 多选后批量移除分享
分享列表有分页。分享很多时，先确认当前页再批量操作，避免误以为一次会选中所有历史分享。
WebDAV
如果你希望在 Finder、Windows 资源管理器、rclone 或其他桌面工具里直接使用 AsterDrive，可以创建 WebDAV 专用账号。
WebDAV 账号只在个人空间里管理，不跟团队空间共用。
常见做法是：
- 每台设备一个独立账号
- 某台设备丢失时单独停用
- 把某个账号限制到根目录下某个文件夹
创建 WebDAV 账号时可以：
- 自定义用户名
- 自定义密码，或让系统自动生成
- 指定访问范围
密码只会在创建成功时显示一次，建议立刻保存。
默认 WebDAV 地址通常是：
https://你的域名/webdav/如果管理员修改了 WebDAV 前缀，请改用新的地址。
设置
从右上角用户菜单进入后，设置页分成四个部分。
个人资料
你可以修改：
- 展示名称
- 头像
头像支持这些常见做法：
- 上传头像并裁剪
- 使用根据邮箱生成的 Gravatar 头像
- 清除当前头像
用户名会显示在这里。
邮箱状态也会显示，但改绑邮箱要到 设置 -> 安全 里操作。
界面
你可以调整：
- 浅色 / 深色 / 跟随系统
- 主题颜色
- 显示语言
- 文件浏览器默认视图
- 单击还是双击打开文件和文件夹
- 是否开启实时同步文件变更
- 展示时区
这里的“实时同步文件变更”指网页端通过实时推送刷新当前视图。它不是桌面本地文件夹同步客户端，需要和本地同步能力区分开。
安全
这里负责邮箱状态、邮箱改绑、密码、MFA、Passkey、外部身份和登录设备。
你可以看到：
- 当前邮箱是否已经验证
- 能不能添加 Passkey
- MFA 是否已经启用
- 已绑定哪些外部身份
- 是否有一个“待确认的新邮箱”
如果当前邮箱已经验证，你可以：
- 输入一个新邮箱
- 发送确认邮件到新邮箱
- 在需要时重新发送确认邮件
新邮箱只有在你点开确认链接之后才会真正生效。
你也可以在这里修改登录密码。修改密码时需要先输入当前密码。
当前版本里，密码修改成功后，当前浏览器会话会继续保持登录，其他设备上的登录会失效，需要重新登录。
多因素认证 标签页可以给账号添加第二因子。当前支持 TOTP 认证器应用，例如 1Password、Bitwarden、Google Authenticator、Microsoft Authenticator 等。
启用 MFA 时，系统会让你：
- 用认证器应用扫描二维码，或手动输入密钥
- 输入当前 6 位验证码完成绑定
- 下载或复制恢复码
恢复码只会在生成时明文显示一次，每个只能使用一次。请保存到密码管理器、加密笔记或其他安全位置。丢失认证器时，可以在登录页用恢复码完成二次验证；登录后建议重新生成恢复码。
启用 MFA 后，密码登录和外部身份登录都会要求第二因子。Passkey 登录本身依赖设备解锁或安全密钥完成用户验证，不会再进入这里的 TOTP 挑战。禁用 MFA 或重新生成恢复码时，也需要输入当前 TOTP 验证码或一个未使用的恢复码确认操作。
如果认证器和恢复码都丢了，联系管理员在用户详情里重置 MFA。
Passkey 标签页可以管理免密码登录方式：
- 添加新的 Passkey
- 给已有 Passkey 改名
- 查看创建时间和最近使用时间
- 删除不再使用的 Passkey
添加时浏览器会打开系统自己的验证窗口。添加成功后，登录页就可以直接用设备解锁、指纹、人脸或安全密钥登录当前账号，具体方式取决于你的浏览器和系统。
外部身份 标签页会列出当前账号绑定过的外部登录身份。解绑后，对应身份不能再直接登录这个账号；如果管理员开启了按已验证邮箱自动绑定，后续满足规则时仍可能重新绑定。
你还可以在 登录设备 里：
- 查看当前仍保持登录的设备
- 单独移除某台设备
- 一次退出其他设备
如果你移除的是当前设备，当前浏览器会立刻退出登录。
团队
设置 -> 团队 会列出你加入的团队。
你可以在这里：
- 查看团队名称、简介、成员数和空间占用
- 直接打开某个团队工作空间
- 进入团队管理页
- 查看已归档团队
如果你在团队里是管理员或所有者，还可以继续管理成员和查看团队审计。
如果你有对应权限，也可以恢复已归档团队。