雪床 - 使用IMHO搭建的图床站

IMHO 提供稳定可靠的图片存储与分享平台

基于 IMHO 项目搭建

功能特点

快速部署

几分钟内完成部署,无需复杂配置,下载后简单设置即可使用

多用户支持

支持多用户管理,每个用户拥有独立API Key,权限分明

开放API

提供完整API接口,支持各种工具和应用集成,轻松上传管理图片

安全可靠

采用PHP原生Session和严格Cookie参数,防止常见安全漏洞

工具集成

支持PicGO等上传工具,轻松实现截图粘贴自动上传

灵活扩展

支持挂载CDN,轻松扩展存储和访问速度,满足不同规模需求

使用文档

接入PicGO

1. 下载并安装PicGO客户端

PicGO下载地址

2. 在PicGO中安装"自定义web图床"插件

下载插件

3. 配置插件参数:

  • API地址:https://up.imho.top/api.php
  • 请求方法:POST
  • 请求头:添加X-Auth-Key,值为你的API Key
  • 图片参数名:file
  • URL路径:$.data.url
配置参数

4. 保存配置,测试上传

配置完成后,即可使用PicGO快速上传图片到雪床。

API 文档

基本信息

Base URL: https://up.imho.top/api.php

所有API请求均需要通过API Key认证,你可以在登录Web面板后,从右上角"查看我的API Key"获取。

上传图片

重要说明

当前系统仅支持 https://cdn.imho.top 域名作为外链域名,请将 url 参数设置为 1 来使用该域名。

请求示例 (curl)

curl -X POST \
  -H "X-Auth-Key: your_api_key"\
  -F "file=@/path/to/pic.jpg"\
  -F "url=1"\
  https://up.imho.top/api.php

参数说明

参数 说明 默认值
file 二进制文件(必填)
url 回源编号(目前仅支持编号1对应 https://cdn.imho.top) 1
base_url 自定义外链域名(当前版本暂不支持此参数)

返回示例

{
  "success": true,
  "message": "上传成功",
  "data": {
    "url": "https://cdn.imho.top/admin_20250920_img_a3f9e7b8.jpg",
    "original_url": "https://up.imho.top/i/admin_20250920_img_a3f9e7b8.jpg",
    "filename": "admin_20250920_img_a3f9e7b8.jpg",
    "size": 238784
  }
}

错误码说明

HTTP状态码 含义
401 API Key 无效 / 被禁用
400 文件超限 / 类型不合
405 非 POST 请求
500 服务器内部错误