图片存储

配置平台图片的存储方式。系统支持两种存储方案，可以根据你的流量和预算选择。

存储方案对比

方案	优点	缺点	适合场景
本地存储	配置简单，无额外费用	占用服务器磁盘带宽，无 CDN 加速	初期、流量较小
腾讯云 COS	CDN 加速、高可用、不占服务器资源	需要 Tencent Cloud 账号、产生存储和流量费用	生产环境、大流量

配置步骤

1. 进入系统设置，找到「图片存储」卡片
2. 在存储方式下拉菜单中选择 本地存储 或 腾讯云对象存储 (COS)
3. 保存设置

切换存储方式后，新上传的图片会使用新的存储方案。已有图片不受影响，可以通过迁移工具迁移。

---

腾讯云 COS 配置

如果选择了「腾讯云对象存储 (COS)」，需要额外配置以下信息：

第一步：创建存储桶

1. 登录 腾讯云 COS 控制台
2. 创建存储桶
3. 记录以下信息：
   • Bucket 名称（如 my-bucket-125xxxxxx）
   • 所属地域（如 ap-guangzhou）

第二步：获取密钥

1. 进入腾讯云 访问管理 → API 密钥管理
2. 获取 SecretId 和 SecretKey

第三步：配置自定义域名（可选）

1. 在 COS 控制台为存储桶绑定自定义域名
2. 配置 CDN 加速（推荐）
3. 记录自定义域名（如 img.your-domain.com）

第四步：填入系统设置

找到「腾讯云对象存储 (COS)」卡片，填写以下信息：

配置项	说明	示例
Bucket	存储桶名称	my-bucket-125xxxxxx
地域	存储桶所属区域	ap-guangzhou
自定义域名	CDN 加速域名（可选）	img.your-domain.com
Secret ID	腾讯云 API 密钥 ID	—
Secret Key	腾讯云 API 密钥	—

保存设置。

第五步：验证配置

配置完成后，上传一张测试图片，确认图片可以通过 COS 域名正常访问。

---

图片迁移工具

系统提供了存储方案之间的迁移工具，在「腾讯云对象存储 (COS)」卡片底部：

工具	功能	说明
迁移到 COS	本地存储 → 腾讯云 COS	将所有本地图片上传到 COS
迁移回本地	腾讯云 COS → 本地存储	将所有 COS 图片下载到本地

迁移注意事项

重要

• 迁移操作不可逆，执行前请确认你的选择
• 迁移过程中请勿关闭页面，等待操作完成
• 大量图片迁移可能需要较长时间
• 建议在低流量时段执行迁移操作

迁移到 COS 的内容范围

迁移工具会将以下所有类型的本地文件上传到 COS：

• 用户上传的话题图片
• 讲师头像
• 用户头像

一键替换历史链接

在迁移到 COS 后，可以使用「一键替换」按钮，将话题和评论中已有的本地图片链接替换为新的存储链接。

提示

建议先配置好 COS 并上传少量测试图片验证无误后，再执行全量迁移。