AsterDrive 的部署重点很简单:
- 把服务稳定跑起来
- 把数据放在可靠的位置
- 让浏览器上传、分享和 WebDAV 在你的网络环境里正常工作
网页、公开分享页、管理后台和 WebDAV 都由同一个 AsterDrive 服务提供,不需要另外部署一套前端站点。
| 方式 | 适合谁 |
|---|---|
| Docker | NAS、家用服务器、小团队、已经有容器环境 |
| systemd | 云主机、物理机、想长期稳定运行 |
| 直接运行二进制 | 本机试用、临时验证 |
第一次部署,优先选 Docker。
长期运行在 Linux 服务器上,优先选 systemd。
重启和升级后必须保留的内容至少包括:
config.toml- 数据库文件,或者外部数据库的连接信息
- 本地上传目录
服务运行时还会使用临时目录:
data/.tmpdata/.uploads
这两个目录通常不需要备份,但要保证本地磁盘有足够空间。
正式上线时,建议通过 HTTPS 提供服务,并保持:
[auth]
bootstrap_insecure_cookies = false如果你只是本机或内网 HTTP 首次引导,可以临时设成:
[auth]
bootstrap_insecure_cookies = true这只会影响第一次初始化时浏览器 Cookie 是否允许在纯 HTTP 下发送。
一旦数据库里已经有 auth_cookie_secure 这个运行时设置,再改静态引导项不会自动回写旧值。
当前版本默认允许用户在登录页自行注册,但管理员可以在后台关闭:
管理 -> 系统设置 -> 用户管理 -> 允许公开注册新用户
如果你打算直接把站点暴露到公网,先确认:
- 是不是要保留公开注册
- 邮件投递是否已经配好
公开站点地址是否已经填成真实域名
否则用户就可能能注册、能申请重置密码,却收不到正确的邮件链接。
如果你要让 Finder、Windows 资源管理器、rclone 或同步工具接入,部署时就要一起考虑:
- WebDAV 路径
- 反向代理
- 上传大小限制
如果文件继续放本地磁盘,部署最简单。
如果文件要放到 S3 / MinIO,请提前准备:
- Endpoint
- Bucket
- Access Key / Secret Key
- 如果要使用浏览器直传,再准备对象存储的 CORS 配置
Docker 最适合首次试跑和日常维护。
docker run -d \
--name asterdrive \
-p 3000:3000 \
-e ASTER__SERVER__HOST=0.0.0.0 \
-e ASTER__DATABASE__URL="sqlite:///data/asterdrive.db?mode=rwc" \
-v asterdrive-data:/data \
ghcr.io/apts-1547/asterdrive:latest如果当前还是纯 HTTP 测试环境,再额外加上:
-e ASTER__AUTH__BOOTSTRAP_INSECURE_COOKIES=true更完整的挂载方式、升级方式和卷规划见 Docker 部署。
systemd 适合长期运行的 Linux 服务器。
这类部署最重要的是两件事:
- 先定好
WorkingDirectory - 再决定配置文件、数据库、上传目录和临时目录放哪
完整示例见 systemd 部署。
如果你已经拿到 aster_drive 可执行文件,直接运行即可:
./aster_drive纯 HTTP 测试环境可以这样临时启动:
ASTER__AUTH__BOOTSTRAP_INSECURE_COOKIES=true ./aster_drive第一次成功启动后,AsterDrive 会自动完成:
- 生成默认
config.toml - 连接数据库并自动更新数据库结构
- 创建默认本地存储策略
Local Default - 创建默认策略组
Default Policy Group - 初始化系统设置
- 启动上传清理、回收站清理、团队归档清理、锁清理和审计日志清理任务
之后在浏览器打开:
http://服务器地址:3000
第一个创建出来的账号会自动成为管理员。
后续普通用户如果通过公开注册创建账号,需要完成邮箱激活后才能登录。
- 首页可以正常打开并登录
- 登录页能正确进入“登录 / 注册 / 创建管理员”流程
- 如果要开放注册、找回密码或邮箱改绑,测试邮件已经能收到
- 可以创建文件夹并上传文件
- 文件可以删除到回收站并恢复
- 管理后台可以打开
管理 -> 存储策略和管理 -> 策略组都能正常打开GET /health和GET /health/ready返回正常- 如果启用了 WebDAV,客户端可以成功连接