本文介绍如何在石墨安装器中关闭内置 MinIO，并将客户自有的 S3 对象存储配置为第三方 S3 对象存储。配置完成后，安装器会检查 S3 对象存储网络连通性、认证信息、存储桶读写等权限，检查通过后即可继续部署。

一、配置前准备

开始前，请确认：

S3 对象存储已安装并正常运行。

K8s集群节点可以访问S3 对象存储的主机和端口。

已准备连接S3 对象存储认证AK/SK。

S3 存储必须支持客户端浏览器访问。

建议使用独立的S3实例

需提供标准的S3协议的内外网访问地址

提前创建石墨业务标准的S3存储桶

S3 存储必须使用 SSD 磁盘。

石墨业务标准S3存储桶清单

bucket名称	访问权限	允许来源	允许方法	访问方式	Expose_headers
auto-mention	私有读写	-	-	内网
compose-payloads	私有读写	-	-	内网
fc-task	私有读写	-	-	内网
file-changesets	私有读写	-	-	内网
file-calced	私有读写	*	GET/HEAD	内网+外网
file-contents	私有读写	*	GET/HEAD	内网+外网	x-amz-meta-head x-amz-meta-length x-amz-meta-bytes x-amz-meta-delta-version x-amz-meta-eek x-amz-meta-formula-cache x-amz-meta-compressor
file-templates	私有读写	-	-	内网+外网
sheet-histories	私有读写	-	GET/HEAD	内网+外网	Access-Control-Allow-Origin x-amz-meta-compressor
svc-doc-history	私有读写	*	GET/HEAD	内网	Access-Control-Allow-Origin x-amz-meta-compressor
shimo-assets	公开读私有写	*	GET/HEAD	内网+外网
shimo-attachments	私有读写	*	GET/POST/PUT/HEAD	内网+外网
shimo-images	私有读写	*	GET/POST/PUT/HEAD	内网+外网
shimo-users	私有读写	-	-	内网+外网
shimo-avatar	公开读私有写	*	GET	内网+外网
preview	私有读写	*	GET/HEAD	内网+外网	Accept-Ranges x-amz-meta-head x-amz-meta-length x-amz-meta-bytes x-amz-meta-delta-version x-amz-meta-eek x-amz-meta-formula-cache x-amz-meta-compressor
svc-drive	私有读写	*	GET/POST/PUT	内网+外网	Accept-Ranges
svc-table	私有读写	*	GET/HEAD	内网+外网
file-snapshots	私有读写	-	-	内网+外网

bucket配置说明

Expose_Headers 建议设置指定的Header名称，不要使用 * 号，因为有些厂商会不支持 *号，例如华为云OBS、阿里OSS

bucket名字可根据公司需要配置前缀，避免重复

二、进入高级配置

在安装器的「配置」步骤中，完成网络、目标环境和节点信息配置后，展开页面下方的「高级配置」。

三、取消安装内置 MinIO

在「中间件服务」区域，取消勾选 MinIO

取消勾选后，安装器不会再安装内置 MinIO，后续将使用已准备的外置的S3 对象存储。其他中间件是否使用内置服务，请按实际部署方案选择。

四、打开第三方中间件配置

在「第三方中间件」区域，单击「配置」。

五、配置 S3 对象存储

在左侧选择「S3 对象存储」。

开启「MinIO 对象存储」。

主服务/编辑器交互分别输入：AK/SK、内部端点、公网端点、主机、端口、SSL等信息

验证并保存

主服务：除开协同编辑以外的服务使用的对象存储实例
编辑器交互：协同编辑服务使用的对象存储实例

说明：主服务和编辑器交互可以使用同一个对象存储实例，但为编辑器交互提供额外的单独实例，可以体验更好的协同编辑性能

Bucket覆盖

💡

当多业务应用共享同一个S3实例时，客户可以根据石墨的存储桶命名规则添加前缀，便于区分业务和管理存储桶

六、确认验证结果

安装器会检查以下内容：

connectivity：部署环境可以访问S3 对象存储

permission：账号具备连接、认证、存储桶读写等权限。

所有检查项显示「成功」后，关闭配置窗口，返回安装器的「配置」页面。

如果存在失败项，请根据页面提示检查：

主机和端口是否填写正确。

部署节点与S3 对象存储之间的网络是否连通。

用户名和密码是否正确。

账号是否具备所需权限（连接与认证、存储桶读写权限等）。

七、继续初始化部署

返回「配置」页面后，确认 S3 对象存储保持未勾选状态，然后单击「初始化部署」，继续完成部署概览、检查和执行步骤。

初始化部署前，请再次确认设置S3 对象存储的配置已保存，且所有验证项均已通过。

接入对象存储完成初始化部署

一、配置前准备#

石墨业务标准S3存储桶清单#

bucket配置说明#

二、进入高级配置#

三、取消安装内置 MinIO#

四、打开第三方中间件配置#

五、配置 S3 对象存储#

Bucket覆盖#

六、确认验证结果#

七、继续初始化部署#

一、配置前准备

石墨业务标准S3存储桶清单

bucket配置说明

二、进入高级配置

三、取消安装内置 MinIO

四、打开第三方中间件配置

五、配置 S3 对象存储

Bucket覆盖

六、确认验证结果

七、继续初始化部署