跳转到内容
AsterDrive
安全更新：Docker 镜像从 v0.4.0-rc.1 起已修复 FFmpeg MagicYUV 解码器漏洞 CVE-2026-8461（高危），使用旧镜像的实例请立即升级。查看 CVE 公告
安全更新：v0.4.0-beta.3 已修复 WebDAV 请求可导致服务进程终止的问题，旧版本实例请尽快升级。查看安全公告

数据库配置

[database]
url = "sqlite://asterdrive.db?mode=rwc"
pool_size = 10
retry_count = 3

先选数据库类型

Section titled “先选数据库类型”
  • SQLite —— 单机、NAS、个人或小团队，最省心
  • PostgreSQL —— 你已经在跑 PG，或者想接入现有运维体系
  • MySQL —— 你已经在用 MySQL，想保持统一

选项一览

Section titled “选项一览”
选项默认值作用
url"sqlite://asterdrive.db?mode=rwc"数据库连接字符串
pool_size10连接池大小
retry_count3启动阶段连接失败时的重试次数

常见写法

Section titled “常见写法”

SQLite

Section titled “SQLite”
url = "sqlite://asterdrive.db?mode=rwc"

Docker 里更常见的写法：

url = "sqlite:///data/asterdrive.db?mode=rwc"

PostgreSQL

Section titled “PostgreSQL”
url = "postgres://user:password@localhost:5432/asterdrive"

MySQL

Section titled “MySQL”
url = "mysql://user:password@localhost:3306/asterdrive"

启动时会自动做什么

Section titled “启动时会自动做什么”

每次启动，AsterDrive 都会：

  1. 建立数据库连接
  2. 自动应用迁移（更新 schema）
  3. 继续启动服务

所以日常升级不需要你手动跑迁移命令。

换数据库后端，不要直接改 url

Section titled “换数据库后端，不要直接改 url”

SQLite 的路径语义

Section titled “SQLite 的路径语义”

默认 SQLite 用相对路径时，相对 data/config.toml 所在目录解析。

部署方式默认落点
本地直接运行./data/asterdrive.db
systemdWorkingDirectory/data/asterdrive.db
Docker（写成 sqlite:///data/asterdrive.db?mode=rwc）容器里的 /data

长期部署，把 SQLite 路径写成固定目录或挂到持久化卷里，避免受工作目录变化影响。

pool_size 和 retry_count 怎么调

Section titled “pool_size 和 retry_count 怎么调”
  • 单机、小团队：保持默认
  • 外部数据库启动较慢（容器编排里 DB 起得比 AsterDrive 慢）：把 retry_count 调高
  • 并发高、数据库本身也允许更多连接：再考虑提 pool_size

对应环境变量

Section titled “对应环境变量”
Terminal window
ASTER__DATABASE__URL="sqlite:///data/asterdrive.db?mode=rwc"
ASTER__DATABASE__POOL_SIZE=10
ASTER__DATABASE__RETRY_COUNT=3