Skip to content

首次启动检查

这一篇覆盖什么

刚部署完要做什么检查、AsterDrive 第一次启动会自动干哪些事、默认策略和默认目录长什么样。 按 启动后马上检查这些项 的清单跑一遍,就能确认服务真的准备好了。

AsterDrive 第一次成功启动后,会自动完成一批基础准备工作。
如果你刚部署完,最实用的做法就是按下面这份清单确认服务真的已经准备好了。

首次成功启动后会自动完成什么

  • 如果当前工作目录没有 data/config.toml,自动生成一份默认配置
  • 连接数据库并自动更新数据库结构
  • 如果系统里还没有存储策略,自动创建默认本地策略 Local Default
  • 自动创建默认策略组 Default Policy Group
  • 初始化后台系统设置的内置默认项
  • 启动邮件派发、后台任务派发、周期清理和底层文件一致性检查任务

默认本地策略内容:

  • 名称:Local Default
  • 驱动:local
  • 路径:data/uploads
  • 默认分片大小:5 MiB

首次写入的内置系统设置,会覆盖这些类别:

  • 站点配置
  • 用户管理
  • 认证与 Cookie
  • 邮件投递
  • 网络访问
  • 运行与调度
  • 存储与保留
  • WebDAV
  • 审计日志

后台任务默认频率:

  • 邮件队列每 5 秒扫描一次
  • 后台任务队列每 5 秒扫描一次
  • 1 小时跑一次周期性清理
  • 6 小时做一次底层文件一致性检查
  • 5 分钟探测一次已启用且配置了 base_url 的远程节点

周期性清理默认会覆盖:

  • 过期上传会话
  • 已完成上传会话
  • 回收站条目
  • 已归档团队
  • 审计日志
  • 任务产物
  • WOPI 会话

新部署实例的默认状态

新部署实例通常还会有这些默认结果:

  • 默认监听地址是 127.0.0.1:3000
  • 默认 WebDAV 前缀是 /webdav
  • 第一个创建的用户会自动成为管理员
  • 公开注册默认开启
  • 公开注册用户默认需要邮箱激活
  • 新用户默认配额是不限量
  • 新用户会自动绑定当前默认策略组
  • 新创建团队如果没有单独指定策略组,也会使用当前默认策略组

如果你把 auth.bootstrap_insecure_cookies = true 用在第一次纯 HTTP 引导上,系统第一次写入的 Cookie 安全要求也会跟着走这个引导值。

默认目录通常会出现哪些内容

如果你使用默认相对路径,首次启动后通常会看到:

  • data/config.toml
  • data/asterdrive.db
  • data/uploads
  • data/.tmp
  • data/.uploads
  • data/managed-ingress(follower 使用本地接收落点时)

其中 data/.tmpdata/.uploads 是运行时临时目录,不是长期数据目录。
data/managed-ingress 是 follower 受主控托管的本地接收根目录,只有你把这台实例作为从节点使用时才会真的重要。

启动后马上检查这些项

  1. /health 是否返回 200
  2. /health/ready 是否返回 200
  3. data/config.toml 是否在预期目录生成
  4. 数据库是否在预期位置创建并完成更新
  5. 默认存储策略是否已经存在
  6. 默认策略组是否已经存在
  7. 管理后台是否能正常打开
  8. 管理 -> 系统设置 里是否已经能看到各分组默认值
  9. 如果打算用 WebDAV,挂载路径是否与配置一致
  10. 如果准备启用 WOPI,公开站点地址预览应用 是否已经能正确保存
  11. 如果准备接远程节点,follower 是否已经完成 enroll,并且有已应用的默认接收落点

如果检查结果不对,优先回头看这几处

  • 当前工作目录是不是你以为的那个目录
  • data/config.toml 是否真的被服务读到了
  • 数据库、上传目录和临时目录是否有写权限
  • 容器卷、systemd WorkingDirectory 或宿主机路径是不是挂错了

基于 MIT 许可证发布