安全更新：Docker 镜像从 v0.4.0-rc.1 起已修复 FFmpeg MagicYUV 解码器漏洞 CVE-2026-8461（高危），使用旧镜像的实例请立即升级。查看 CVE 公告
安全更新：v0.4.0-beta.3 已修复 WebDAV 请求可导致服务进程终止的问题，旧版本实例请尽快升级。查看安全公告
本地磁盘存储策略教程
适合什么时候用
Section titled “适合什么时候用”本地磁盘适合这些场景：
- 单机部署
- NAS 或挂载盘已经在应用服务器上
- 文件规模不大，想减少外部依赖
- 希望上传、下载路径最直接
- 想先用最简单的后端把实例跑起来
如果你希望把容量和带宽交给对象存储，看 S3 / MinIO / R2、Azure Blob Storage 或 腾讯云 COS。如果你希望主控节点和真实对象落点拆开，看 远程节点存储策略。
先分清你要配哪几层
Section titled “先分清你要配哪几层”只创建本地存储策略还不够。用户或团队上传时，会先命中策略组，再由策略组规则分配到某条存储策略。
1. 准备本地目录
Section titled “1. 准备本地目录”长期部署建议使用绝对路径，例如：
/srv/asterdrive/data如果使用 Docker，确认这个目录已经作为 volume 挂载到容器内。容器内路径和宿主机路径不是一回事，存储策略里填写的是 AsterDrive 进程看到的路径。
2. 确认权限和容量
Section titled “2. 确认权限和容量”运行 AsterDrive 的系统用户需要对该目录有：
- 创建目录权限
- 写入文件权限
- 读取文件权限
- 删除文件权限
还要确认目录所在文件系统有足够容量。本地策略支持容量观测，后台会读取策略基础目录所在文件系统的总量、可用量和已用量。
3. 在 AsterDrive 创建 local 存储策略
Section titled “3. 在 AsterDrive 创建 local 存储策略”进入：
管理 -> 存储策略 -> 新建策略选择驱动类型：
本地常见字段：
| 字段 | 示例 |
|---|---|
| 基础路径 | /srv/asterdrive/data |
| 单文件大小上限 | 0 表示不限 |
| 分片大小 | 默认值通常够用 |
| 内容去重 | 默认关闭 |
保存前或保存后，先用后台的连接测试确认目录可读写。
4. 内容去重怎么选
Section titled “4. 内容去重怎么选”本地策略的内容去重默认关闭。
开启后：
- 上传完成后会再读一遍临时文件
- 计算 SHA-256 内容指纹
- 相同内容复用同一份底层 blob
- 可以节省重复文件占用的磁盘空间
保持关闭：
- 上传路径更直接
- 不会多一次全文件读取
- 相同内容会分别创建 blob
家用、单机部署多半不需要去重；多人重复上传相同素材的小团队可以开启。
5. 创建测试策略组
Section titled “5. 创建测试策略组”不要一上来直接改默认策略组。建议先创建一个测试策略组。
进入：
管理 -> 策略组创建策略组，例如：
Local Test Group添加一条规则：
| 字段 | 建议 |
|---|---|
| 存储策略 | 刚创建的 local 策略 |
| 优先级 | 保持默认或设为最先命中 |
| 文件大小范围 | 先覆盖所有大小，方便测试 |
6. 绑定测试用户或测试团队
Section titled “6. 绑定测试用户或测试团队”进入：
管理 -> 用户 -> 用户详情把测试用户的策略组改成刚才创建的 Local Test Group。
进入：
管理 -> 团队 -> 团队详情把测试团队的策略组改成 Local Test Group。
团队空间上传时会按团队策略组走，不按个人用户策略组走。
7. 做一轮真实验收
Section titled “7. 做一轮真实验收”用测试账号完成这些操作：
- 上传小文件
- 上传大文件
- 下载文件
- 预览图片
- 删除文件
- 从回收站恢复
- 分享文件并下载
验收时同时观察：
- 后台容量观测是否正常
- 本地目录下是否出现对象文件
- AsterDrive 日志是否有权限错误
- 如果启用了内容去重，重复上传相同文件后 blob 引用是否复用
8. 切真实流量
Section titled “8. 切真实流量”确认测试策略组没有问题后，再把真实用户或团队迁到目标策略组。
如果要迁移已有文件，不要直接改旧策略的目录。正确做法是：
- 新建本地策略
- 测试连接和真实上传下载
- 用
管理 -> 存储策略 -> 迁移数据创建迁移任务 - 迁移完成后调整策略组规则
- 定期确认磁盘剩余空间
- 生产部署使用绝对路径或稳定挂载卷
- 不要手动移动、重命名或删除策略目录里的对象文件
- 备份时同时备份数据库、配置文件和本地对象目录
- 生产迁移前先看 备份与恢复