首次启动检查
这一篇覆盖什么
刚部署完要做什么检查、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.tomldata/asterdrive.dbdata/uploadsdata/.tmpdata/.uploadsdata/managed-ingress(follower 使用本地接收落点时)
其中 data/.tmp 和 data/.uploads 是运行时临时目录,不是长期数据目录。data/managed-ingress 是 follower 受主控托管的本地接收根目录,只有你把这台实例作为从节点使用时才会真的重要。
启动后马上检查这些项
/health是否返回 200/health/ready是否返回 200data/config.toml是否在预期目录生成- 数据库是否在预期位置创建并完成更新
- 默认存储策略是否已经存在
- 默认策略组是否已经存在
- 管理后台是否能正常打开
管理 -> 系统设置里是否已经能看到各分组默认值- 如果打算用 WebDAV,挂载路径是否与配置一致
- 如果准备启用 WOPI,
公开站点地址和预览应用是否已经能正确保存 - 如果准备接远程节点,follower 是否已经完成 enroll,并且有已应用的默认接收落点
如果检查结果不对,优先回头看这几处
- 当前工作目录是不是你以为的那个目录
data/config.toml是否真的被服务读到了- 数据库、上传目录和临时目录是否有写权限
- 容器卷、systemd
WorkingDirectory或宿主机路径是不是挂错了