利用水墨映客图床作为COS服务器

2024-04-28 14:40 由愚生浅末发表于 #后端开发

利用水墨映客作为COS服务器
- 利用picGo配合typora上传图片
  - 安装PicGo(以Windows为例)
  - 安装lankong插件
- 在SpringBoot中开发图片上传工具类

利用水墨映客作为COS服务器

文章类网站项目的图片存储都是一个很重要的问题，一般都是使用云服务厂商的COS对象存储服务（参考前文：使用腾讯云对象存储搭建图床），虽然小网站的需求不大，购买也不贵，但是还是想能不能找个免费的，毕竟能省就省嘛。

平常有些博客或者笔记的都是用markdown编辑，图片一般都是上传图床，但是很多图床都没有开放接口。最近用路过图床的时候网站没打开，咨询管理说有DNS污染，便又搜索有没有好用一些的图床，就发现了水墨映客图床，虽然容量有限，但是他每天签到都可以扩充容量，并且最最重要的我发现水墨映客开放上传接口，于是就开始鼓捣想着利用水墨映客作为COS服务器。

水墨图床地址：图片映客--水墨图床，免费专业的高速外链图床

分为两种，一种还是利用picGo配合typora，另一种是在SpringBoot中开发为工具类专门用作图片上传。

利用picGo配合typora上传图片

安装PicGo(以Windows为例)

先下载PicGo的客户端安装包，找到对应的平台安装包然后下载。

下载链接：

GitHub：https://github.com/Molunerfinn/PicGo/releases (访问较慢)
山东大学镜像网站：https://mirrors.sdu.edu.cn/github-release/Molunerfinn_PicGo/ (速度较快)

(我的电脑：Windows11,64位，故下载PicGo-Setup-2.3.1-x64.exe)

下载之后正常安装就可以了。

安装lankong插件

这是一个为兰空图床适配开发的 PicGo 图片上传插件。同样适用于水墨映客图床

在picGo的插件设置中搜索lankong，然后安装。

安装后配置

Lsky Pro Version 在下拉菜单中选择 Lsky Pro 版本，V1 还是 V2，默认 V1
填写图床的 server url，注意不要以 / 结束
- https://image.example.com ✅️
- https://image.example.com/ ❌️
填写 Auth Token 使用 Bearer 拼接，token在水墨映客的设置中获取，注意在配置时候需要前面拼接Bearer
Strategy ID，存储策略 ID，如果是 V1 或 V2 使用默认存储策略的用户，请留空；除非你知道具体 ID，否则请留空
Album ID，相册 ID，只针对 V2 有效
Permission，图片权限，公开还是私有，默认是私有
Sync Delete 同步删除选项，只支持 V2，开启后在 PicGo 相册中删除图片可同步删除图床上的文件，默认关闭
Ignore certificate error 开关，默认关闭，请保持关闭，除非你遇到 certificate has expired 等证书报错才需要考虑将其开启。由于有些站点使用 Let's Encrypt 颁发的免费证书，有效期只有 90 天，在测试上传中遇到了 certificate has expired 错误，打开开关 Ignore certificate error 即可成功上传

配置完毕保存即可，然后再typora里配置图片上传服务即可。

在SpringBoot中开发图片上传工具类

该工具类的方法有两个参数一个是文件名（fileName），另一个是文件的输入流。

在Spring Boot中一般使用MultipartFile类来处理文件相关，在此处可以通过getInputStream()方法获取文件的输入流

主要的步骤分为：

设置图片上传请求的参数
设置图片的参数
读取图片内容并写入请求
获取响应

水墨映客图床的上传接口为https://img.ink/api/upload，如果上传成功状态码返回200，失败返回500

上传成功的返回格式：

{
    "code":200,
    "msg":"success",
    "data":		  
        {
            "id":"281381",
            "name":".jpg",
            "url":"https:\/\/pic2.ziyuan.wang\/user\/userNickName\/2024\/04\/fileName_d75b474147589.jpg",               "size":101168,
            "mime":"image\/jpeg",
            "sha1":"9adb76331eb1254567547afea3e516ac1901eac1",
            "md5":"aef7bc728fd44e77d5688529c8122882",
            "quota":"6485442560.00",
            "use_quota":"6666141.00"
        },
    "time":1714282312
}

设置图片上传请求的参数

 // 设置上传地址
URL url = new URL("https://img.ink/api/upload");
HttpURLConnection connection = (HttpURLConnection) url.openConnection();
 // 设置请求方法为POST
connection.setRequestMethod("POST");
connection.setDoOutput(true);
// 设置请求头
connection.setRequestProperty("token", "你的请求头"); // 替换为你的token，在设置中获取
// 构建请求参数
String boundary = Long.toHexString(System.currentTimeMillis());//用来标识multipart/form-data内容类型的边界字符串，使用时间戳，确保每次请求的边界字符串都是唯一的，以避免冲突
connection.setRequestProperty("Content-Type", "multipart/form-data; boundary=" + boundary);//设置上传文件的格式
OutputStream output = connection.getOutputStream();//获取与HTTP连接关联的输出流
PrintWriter writer = new PrintWriter(new OutputStreamWriter(output, "UTF-8"), true);//向输出流写入文本形式的数据

设置图片的参数

writer.append("--" + boundary).append("\r\n");//添加了一个分隔边界标记
writer.append("Content-Disposition: form-data; name=\"image\"; filename=\"" + fileName + "\"").append("\r\n");//设置Content-Disposition头部信息,
writer.append("Content-Type: image/jpeg").append("\r\n");//声明上传文件的MIME类型为image/jpeg
writer.append("\r\n");//回车换行符作为分隔
writer.flush();

读取图片内容并写入请求

//接受传入的输入流
InputStream input = inputStream;
byte[] buffer = new byte[4096];//临时存储从输入流中读取的数据
int bytesRead;
//持续读取输入流中的数据直到没有数据
while ((bytesRead = input.read(buffer)) != -1) {
    output.write(buffer, 0, bytesRead);
}
output.flush();
input.close();
// 结束整个multipart/form-data请求体
writer.append("\r\n").append("--" + boundary + "--").append("\r\n");
writer.close();

获取响应

//获取服务器对上传请求的响应状态码,200代表上传成功
int responseCode = connection.getResponseCode();
if (responseCode == HttpURLConnection.HTTP_OK) {
    BufferedReader reader = new BufferedReader(new InputStreamReader(connection.getInputStream()));
    String line;
    StringBuffer response = new StringBuffer();
    //逐行读取服务器返回的文本数据
    while ((line = reader.readLine()) != null) {
        response.append(line);
    }
    reader.close();
    ObjectMapper mapper = new ObjectMapper();
    //使用Jackson库的ObjectMapper来解析response中的JSON字符串为JsonNode对象
    JsonNode rootNode = mapper.readTree(String.valueOf(response));
    //从解析出的JSON对象中，通过路径rootNode.path("data")定位到"data"节点，再从该节点下获取"url"字段的值，即图片上传后的URL
    JsonNode userNode = rootNode.path("data");
    String imgUrl = userNode.path("url").asText();
    return imgUrl;
} else {
    return "error";
}

调用该方法时的使用(file为MultipartFile对象)：

String originalFilename = file.getOriginalFilename();//获取完整文件名
String fileName = originalFilename.substring(originalFilename.lastIndexOf("."));//获取文件名后缀
String url = InkImageUtil.uploadImg(fileName,file.getInputStream());//调用方法上传图片

测试：

源码：

public class InkImageUtil {
    public static String uploadImg(String fileName,InputStream inputStream) throws IOException {
            // 设置上传地址
            URL url = new URL("https://img.ink/api/upload");
            HttpURLConnection connection = (HttpURLConnection) url.openConnection();
            // 设置请求方法为POST
            connection.setRequestMethod("POST");
            connection.setDoOutput(true);
            // 设置请求头
            connection.setRequestProperty("token", "f3ee57bcc8d796ea9b72bd776f243d98"); // 替换为你的token
            // 构建请求参数
            String boundary = Long.toHexString(System.currentTimeMillis());
            connection.setRequestProperty("Content-Type", "multipart/form-data; boundary=" + boundary);
            OutputStream output = connection.getOutputStream();
            PrintWriter writer = new PrintWriter(new OutputStreamWriter(output, "UTF-8"), true);
            // 添加图片参数
            writer.append("--" + boundary).append("\r\n");
            writer.append("Content-Disposition: form-data; name=\"image\"; filename=\"" + fileName + "\"").append("\r\n");
            writer.append("Content-Type: image/jpeg").append("\r\n");
            writer.append("\r\n");
            writer.flush();
            // 读取图片内容并写入请求
            InputStream input = inputStream;
            byte[] buffer = new byte[4096];
            int bytesRead;
            while ((bytesRead = input.read(buffer)) != -1) {
                output.write(buffer, 0, bytesRead);
            }
            output.flush();
            input.close();
            // 结束请求
            writer.append("\r\n").append("--" + boundary + "--").append("\r\n");
            writer.close();
            // 获取响应
            int responseCode = connection.getResponseCode();
            if (responseCode == HttpURLConnection.HTTP_OK) {
                BufferedReader reader = new BufferedReader(new InputStreamReader(connection.getInputStream()));
                String line;
                StringBuffer response = new StringBuffer();
                while ((line = reader.readLine()) != null) {
                    response.append(line);
                }
                reader.close();
                System.out.println(response.toString());
                ObjectMapper mapper = new ObjectMapper();
                JsonNode rootNode = mapper.readTree(String.valueOf(response));
                JsonNode userNode = rootNode.path("data");
                String imgUrl = userNode.path("url").asText();
                return imgUrl;
            } else {
                return "error";
            }
    }
}

@PostMapping("/upload")
    public Result<String> fileUpload(MultipartFile file) throws IOException {
        String originalFilename = file.getOriginalFilename();
        String fileName = originalFilename.substring(originalFilename.lastIndexOf("."));
        String url = InkImageUtil.uploadImg(fileName,file.getInputStream());
        return Result.success(url);
    }

欢迎关注公众号：愚生浅末