安全更新：Docker 镜像从 v0.4.0-rc.1 起已修复 FFmpeg MagicYUV 解码器漏洞 CVE-2026-8461（高危），使用旧镜像的实例请立即升级。查看 CVE 公告
安全更新：v0.4.0-beta.3 已修复 WebDAV 请求可导致服务进程终止的问题，旧版本实例请尽快升级。查看安全公告
部署方式选择
如果只是本机、内网或临时试用，不用选，直接 快速开始。
| 你的规模 | 推荐路径 | 场景页 |
|---|---|---|
| 本机试用、临时验证 | 直接跑官方镜像，纯 HTTP 即可 | 快速开始 |
| 个人、家庭、小团队单实例 | Docker Compose 或 systemd 二选一 | 单实例 Docker、单实例 systemd |
| 多用户、需要多 Primary 承载流量 | cluster profile + 负载均衡 | 多实例与负载均衡 |
| 已有 Kubernetes 平台 | 复用仓库内置 manifest | Kubernetes 部署 |
| 想把另一台 AsterDrive 接成远程存储 | 主控不动，新机器跑 follower | Follower 存储节点 |
第一次部署，优先选 Docker。长期跑在 Linux 服务器上，优先选 systemd。多 Primary 不是”单实例跑两份”，先看 多实例与负载均衡 的契约再动手。
| 环境 | 额外要看 |
|---|---|
| 任何正式公网入口 | 反向代理：HTTPS、上传大小、WebDAV 方法透传 |
| follower 在另一个网络 | 从节点网络部署方式：公网、VPN、Docker 网络、反向通道怎么选 |
| 对象存储（S3 / MinIO / R2 / COS / Azure / OneDrive / SFTP） | 存储后端 对应教程，部署后再接 |
上线前需要确认
Section titled “上线前需要确认”正式部署不只是启动容器，还需要提前确认以下事项：
- 数据目录：
config.toml、数据库、本地上传目录要能跟着升级和重启保留下来 - 访问方式：公网入口应该通过反向代理提供 HTTPS
- 公开站点地址：分享、邮件、WOPI 和跨源访问都依赖它
- WebDAV：如果要给 Finder、Windows、rclone 或同步工具用，代理层要放行对应方法和上传大小
- 存储位置：不同存储策略后端有不同维护成本
- 备份恢复：上线前先确认备份和恢复流程，避免故障发生后才临时补做准备