Skip to content
Novaix 目前处于早期开发阶段,功能尚未稳定,可能存在严重的 Bug。请勿用于生产环境。

对象存储

Novaix 支持将镜像和 ISO 文件归档到 S3 兼容的对象存储服务。对象存储作为远程备份,当本地文件因磁盘故障等原因丢失时,系统可以自动从对象存储恢复。

工作原理

  • 本地存储为主:镜像和 ISO 文件默认存储在本地磁盘(config.yamlstorage.image_dir 配置的目录)
  • 对象存储为备:配置对象存储后,文件上传或下载到本地时会同步上传一份到对象存储
  • 自动恢复:当系统需要使用某个镜像文件但本地文件不存在时,会自动从对象存储下载恢复

TIP

对象存储不是必须的。如果您只有一个节点或者对数据安全要求不高,不配置对象存储也完全可以正常使用。对象存储主要用于防范本地磁盘损坏导致镜像文件丢失的风险。

支持的服务

任何兼容 S3 API 的对象存储服务都可以使用,包括但不限于:

服务说明
AWS S3亚马逊对象存储
阿里云 OSS阿里云对象存储(兼容 S3 API)
腾讯云 COS腾讯云对象存储(兼容 S3 API)
MinIO自建对象存储
Cloudflare R2Cloudflare 对象存储

配置

在管理面板的「系统设置」→「对象存储」中配置:

字段说明
Endpoint服务端点地址,如 s3.amazonaws.comoss-cn-hangzhou.aliyuncs.com
Access Key访问密钥 ID
Secret Key访问密钥 Secret
Bucket存储桶名称
Region存储区域(部分服务需要)
路径前缀文件在存储桶中的路径前缀(可选),如 novaix/images
使用 HTTPS是否使用 HTTPS 连接(推荐开启)

配置完成后,点击「测试连接」验证配置是否正确。

WARNING

  • 请确保存储桶已创建且 Access Key 有读写权限
  • 如果使用阿里云 OSS 或腾讯云 COS,Endpoint 需要填写对应区域的 S3 兼容域名,而非默认域名
  • 对象存储配置更改不会影响已分发到节点的镜像,只影响后续的文件归档和恢复行为