---
title: 配置腾讯云 COS 存储服务
description: 详细步骤配置腾讯云 COS 存储服务，确保文件存储顺利进行。
tags:
  - 腾讯云 COS
  - S3 存储
  - 文件存储
  - 环境变量
---

# 配置腾讯云 COS 存储服务

在服务端数据库中我们需要配置 S3 存储服务来存储文件。

## 配置步骤

<Steps>

### 配置并获取 S3 存储桶

你需要首先前往 [腾讯云 COS](https://console.cloud.tencent.com/cos/bucket) 并创建一个新的存储桶（Bucket）：

<Image
  alt={'腾讯云 COS 存储界面'}
  src={'https://github.com/user-attachments/assets/d3626294-74ba-4944-9a63-052e6cf719ab'}
/>

创建存储桶时将指定其名称，下文以 `lobe` 为例。选择 `公有读私有写`，地域随意，其余配置一概默认即可，然后点击创建。

<Image
  alt={'COS 创建存储桶'}
  src={'https://github.com/user-attachments/assets/7257eb0e-4e2c-4db2-981d-354598e2c60f'}
/>

### 获取存储桶相关环境变量

在 COS 存储桶的概览设置中，可以看到桶配置的信息：

<Image
  alt={'查看存储桶的相关信息'}
  src={'https://github.com/user-attachments/assets/d7d65e32-679d-4e50-a933-28cf5dde1330'}
/>

其对应的环境变量为：

```shell
# 存储桶的名称
S3_BUCKET=lobe-130xxxxxx2
# 存储桶的请求端点，注意没有前面的桶名
S3_ENDPOINT=https://cos.ap-chengdu.myqcloud.com
# 桶的区域
S3_REGION=ap-chengdu
# 存储桶对外的访问域名
S3_PUBLIC_DOMAIN=https://lobe-1251234567.cos.ap-chengdu.myqcloud.com
```

<Callout type={'warning'}>
请注意，`S3_ENDPOINT` 的值为 `https://cos.ap-chengdu.myqcloud.com`，而不是 `https://lobe-130xxxxxx2.cos.ap-chengdu.myqcloud.com`

且此处 URL 的 `https://` 不可缺失，须保持 URL 的完整性

</Callout>

### 配置跨域

在左侧 `安全管理 - 跨域访问 CORS 设置` 中，添加以下配置并保存：

<Image
  alt={'配置跨域'}
  src={'https://github.com/user-attachments/assets/35164b25-c964-42ce-9cb0-32f6ebe1d07c'}
/>

### 获取 S3 秘钥

前往 [腾讯云 API 密钥管理](https://console.cloud.tencent.com/cam/capi) 创建一个新的 SecretId 和 SecretKey，填写为 `S3_ACCESS_KEY_ID` 和 `S3_SECRET_ACCESS_KEY` 即可。

</Steps>

### 附加说明

- 对于对象存储，你可以选择设置 CDN 加速，以提高不同区域的访问速度，提高并发的同时减少下行费用。
- 创建 API 密钥时，推荐使用角色管理，以提高安全性。
