首次初始化

部署 Zboard 后，首次安装向导负责建立站点基础信息、系统级时间/历史策略和第一个管理员账户。首次初始化分为四步，并在最后一次安装事务中一起提交需要持久化的设置。

初始化流程

1. 环境检查：确认后端、数据库和前端运行环境可以完成安装；
2. 站点设置：填写站点名称、公开访问地址和注册策略；
3. 系统策略：确认系统时区以及审计/运营历史的保留期限；
4. 首个管理员：创建第一个管理员账户并完成安装。

节点、SSH 和 Zero 接入不再属于首次安装向导本身。站点初始化完成后，再进入节点与协议服务管理接入 VPS。

系统时区

系统策略中的时区使用 IANA 名称，例如：

Asia/Shanghai
UTC
America/Los_Angeles

浏览器能够提供 IANA 时区时，向导会用浏览器时区作为预填值；无法识别时回退到 UTC。UTC+8 这类固定偏移写法不是有效配置，应改用对应的 IANA 区域名称。

Zboard 数据库和 API 继续保存绝对时间，不会因为修改系统时区而重写历史记录。系统时区影响管理界面的时间展示，并作为业务日历型读取的边界：例如 Dashboard 的“今天”、7 天/30 天区间、流量趋势的日期过滤和每日 bucket 都按系统当地日历计算，再转换成 UTC 查询。

夏令时地区会按真实日历处理 23/25 小时日；这不会改变底层 UTC 时间事实。

历史保留策略

首次安装可以确认以下默认值：

设置	默认值	作用
审计日志保留天数	180	清理超过期限的审计日志
运行历史保留天数	90	清理已结束的节点、协议发布、证书和供应商等运营历史
运营任务保留天数	90	清理已完成的任务及任务项

保留天数允许 0–3650：

• 0 表示永久保留；
• 只有已经结束的任务/操作会进入自动清理；
• 流量计费记录、额度事件、订单、订阅和支付历史等业务/账务事实不受这组运营历史清理策略影响。

清理工作会随后端生命周期运行。安装完成后，这些值仍可在系统设置中修改。

安装事务

站点设置、系统策略和首个管理员在同一次安装事务中提交。任一部分校验或写入失败时，不应留下“站点已安装但管理员/策略缺失”的半初始化状态。

为兼容旧安装客户端，新增的系统策略字段在 API 层保持可选；未提供时由服务端采用默认值。

安全建议

• 管理员密码使用高强度随机密码；
• 站点公开地址使用 HTTPS，并在安装后确认反向代理和 Cookie/认证行为正常；
• IANA 时区选择应以实际业务日历语义为准，不要为了“看起来是本地时间”随意修改；
• 历史保留策略需要同时考虑排障周期、审计要求和数据库规模；
• SSH、云厂商和 DNS 凭证在后续节点/基础设施接入时使用最小权限，并避免写入日志。

下一步

完成初始化后，继续阅读节点与协议服务管理。

熟悉新后台入口请阅读后台导航与日常运营。开放注册、邮箱验证及欢迎通知见公告、注册验证与邮件。