图床服务
Moraya 支持将图片上传到外部图床服务,用永久 URL 替换本地路径。在 设置(Cmd+,)> 图片 中配置你偏好的图床。
支持的服务商
| 服务商 | API | 认证方式 |
|---|---|---|
| SM.MS | https://sm.ms/api/v2/upload | Bearer Token |
| Imgur | https://api.imgur.com/3/image | Client-ID Header |
| GitHub | GitHub Contents API | Bearer Token (PAT) |
| 七牛 Kodo | 七牛上传 API | Access Key + Secret Key |
| 阿里云 OSS | OSS REST API | AccessKey ID + AccessKey Secret |
| 腾讯云 COS | COS XML API | SecretId + SecretKey |
| AWS S3 | S3 REST API | Access Key + Secret Key |
| Google Cloud Storage | JSON API | Service Account Key |
| Custom | 用户自定义端点 | Bearer Token + 自定义 Headers |
添加供应商
在设置 > 图片中点击**“添加图床”**,查看按类别分组的供应商选择菜单:
- 图床 — SM.MS、Imgur
- Git 仓库 — GitHub
- 对象存储 — 七牛 Kodo、阿里云 OSS、腾讯云 COS、AWS S3、Google Cloud Storage
- 自定义 — 任意 REST API 端点
配置方法
SM.MS
- 在 sm.ms 注册并获取 API token
- 在设置 > 图片中选择 SM.MS 作为服务商
- 粘贴你的 API token
Imgur
- 在 Imgur API 注册应用
- 选择 Imgur 作为服务商
- 输入你的 Client-ID
GitHub
- 创建一个具有
repo权限的 Personal Access Token - 选择 GitHub 作为服务商
- 输入你的仓库 URL、分支、上传目录和 token
- 选择 CDN:raw.githubusercontent.com(直连)或 jsDelivr(CDN 加速)
七牛 Kodo
- 在 七牛云 注册并创建存储空间
- 选择 七牛 Kodo 作为服务商
- 输入你的 Access Key、Secret Key、Bucket 名称和区域
- 可选设置自定义域名以使用 CDN 加速
阿里云 OSS
- 在 阿里云 注册并创建 OSS Bucket
- 选择 阿里云 OSS 作为服务商
- 输入你的 AccessKey ID、AccessKey Secret、Bucket 和区域(例如
oss-cn-hangzhou) - 可选设置自定义域名
腾讯云 COS
- 在 腾讯云 注册并创建 COS Bucket
- 选择 腾讯云 COS 作为服务商
- 输入你的 SecretId、SecretKey、Bucket 和区域(例如
ap-guangzhou)
AWS S3
- 在 AWS 控制台 中创建 S3 Bucket
- 选择 AWS S3 作为服务商
- 输入你的 Access Key、Secret Key、Bucket 和区域(例如
us-east-1)
Google Cloud Storage
- 在 Google Cloud 控制台 中创建 Bucket
- 选择 Google Cloud Storage 作为服务商
- 输入你的 Service Account Key、Bucket 名称和 Project ID
Custom
- 选择 Custom 作为服务商
- 输入你的上传端点 URL
- 以 JSON 对象格式配置所需的 headers
上传方式
手动上传
在编辑器中右键点击图片,选择 “上传到图床”。本地路径将被替换为返回的 URL。
自动上传
在设置 > 图片中启用 自动上传。当你粘贴或拖拽图片到编辑器时,图片将自动上传到你配置的服务。
测试上传
点击设置中的 “测试上传” 来验证你的配置。Moraya 会发送一个 1x1 红色像素 PNG 来测试连接。
从发布目标导入
如果你已配置了 GitHub 发布目标(参见发布目标),可以一键将其仓库设置直接导入到 GitHub 图床配置中。