对象存储
Novaix 支持将镜像和 ISO 文件归档到 S3 兼容的对象存储服务。对象存储作为远程备份,当本地文件因磁盘故障等原因丢失时,系统可以自动从对象存储恢复。
工作原理
- 本地存储为主:镜像和 ISO 文件默认存储在本地磁盘(
config.yaml中storage.image_dir配置的目录) - 对象存储为备:配置对象存储后,文件上传或下载到本地时会同步上传一份到对象存储
- 自动恢复:当系统需要使用某个镜像文件但本地文件不存在时,会自动从对象存储下载恢复
TIP
对象存储不是必须的。如果您只有一个节点或者对数据安全要求不高,不配置对象存储也完全可以正常使用。对象存储主要用于防范本地磁盘损坏导致镜像文件丢失的风险。
支持的服务
任何兼容 S3 API 的对象存储服务都可以使用,包括但不限于:
| 服务 | 说明 |
|---|---|
| AWS S3 | 亚马逊对象存储 |
| 阿里云 OSS | 阿里云对象存储(兼容 S3 API) |
| 腾讯云 COS | 腾讯云对象存储(兼容 S3 API) |
| MinIO | 自建对象存储 |
| Cloudflare R2 | Cloudflare 对象存储 |
配置
在管理面板的「系统设置」→「对象存储」中配置:
| 字段 | 说明 |
|---|---|
| Endpoint | 服务端点地址,如 s3.amazonaws.com、oss-cn-hangzhou.aliyuncs.com |
| Access Key | 访问密钥 ID |
| Secret Key | 访问密钥 Secret |
| Bucket | 存储桶名称 |
| Region | 存储区域(部分服务需要) |
| 路径前缀 | 文件在存储桶中的路径前缀(可选),如 novaix/images |
| 使用 HTTPS | 是否使用 HTTPS 连接(推荐开启) |
配置完成后,点击「测试连接」验证配置是否正确。
WARNING
- 请确保存储桶已创建且 Access Key 有读写权限
- 如果使用阿里云 OSS 或腾讯云 COS,Endpoint 需要填写对应区域的 S3 兼容域名,而非默认域名
- 对象存储配置更改不会影响已分发到节点的镜像,只影响后续的文件归档和恢复行为
