firemail

标题: 轻快图床 [打印本页]

作者: Qter 时间: 2023-3-7 23:23
标题: 轻快图床
https://github.com/ischenliang/quickly-picture-bed
轻快图床：使用koa + vue3.x + typescript全家桶实现的在线图床系统，支持在线存储桶插件开发，目前支持腾讯云COS、又拍云Upyun、阿里云OSS、github图床、gitee图床、本地存储桶、七牛云 KODO等在线图床存储桶。市面上最火的图床系统是picgo，但由于picgo是桌面应用程序，换了新电脑需要重新下载安装配置，十分麻烦，为了解决该问题，故诞生了这款系统。

[color=var(--color-accent-fg)]

基于Koa2 + Vue3.x + Vite3.x + typescript开发的轻量级快捷图片管理系统、图床系统

[color=var(--color-accent-fg)]

[color=var(--color-accent-fg)]简介

程序员日常就是写博客，当然写博客时就会涉及到在博文中插入图片，所以往往会使用图床来进行图片资源管理，市面上较流行的图床系统是PicGo，是使用electron-vue开发的桌面应用程序，每次换电脑或者重装系统后都需要重新下载安装并配置图床，比较麻烦。所以开发了这款轻快图片管理系统，是基于vue3.x + typescript + vite + koa + mysql开发的前后端分离图床系统，使用该系统可以不需要每次都配置图床。前端使用 Vue3.x + Vite3.x + typescript + Element-plus, 后端使用 Koa2 + typescript + mysql 进行开发，使用 Jwt + koa-ts-controllers 做登录验证和权限校验。

[color=var(--color-accent-fg)]内置功能

图片上传
支持图片多图上传、拖拽上传、粘贴上传、一键复制多种格式的图片外链。

图片管理
多上传的图片进行管理，支持文件重命名、移入指定相册、删除图片、预览图片等。

存储桶管理
支持多桶储存，可同时添加多个对象存储桶管理，上不封顶，例如：七牛云对象存储、阿里云对象存储、腾讯云对象存储等等，系统会统计出每个存储桶下的图片数量以及已使用存储量。同时也支持控制存储桶是否显示在上传区。

相册管理
支持相册管理，可以对图片进行分组分类管理，便于用户将不同的图片进行分类挂办理，同时也支持直接将图片上传到相册中。

操作日志管理
完整的可视化日志功能，记录用户所有操作，方便事件溯源。普通用户只能查看自己的操作记录，管理员则能查看所有人员的操作记录，于此同时数据统计中的贡献图的数据来源也是从操作记录中提取。

个人信息维护
用户可以对自己的信息管理，如头像(系统内置4组不同维度的头像供选择)、昵称、职业、性别、个人简介以及个人登录密码进行维护管理。

数据统计
系统提供了数据统计功能，统计用户的图片数量、存储桶数量、总占用存储量、相册数量以及系统贡献度数据进行统计。

使用习惯配置
考虑到每个用户的使用习惯不同，系统提供了使用习惯配置中心，可以对默认复制的图片链接格式、自定义链接格式、常用快捷键配置以及是否开启上传成功提示、复制链接成功提示等配置。

用户管理
多用户管理，根据不同的角色可以管理不同的数据，同时用户可以通过自主注册或者管理员在管理页面直接创建。

存储桶插件管理
存储桶管理，是由管理员进行在线开发的插件，用于管理员对存储桶插件的相关配置，需要做什么前置处理或者后置处理等进行管理，例如七牛云对象存储，需要用户在界面上感知出需要填写哪些数据、哪些数据时必填项、有哪些数据的智能提示，需要前置操作则是获取上传认证，其实就是对存储桶拥有哪些元数据进行配置，于此同时还提供了是否启用或者禁用的功能，比如某一个对象存储已经从市面上out，则管理员可以进行禁用操作，这样用户就不能创建该类型的存储桶。

字典管理
对系统中经常使用的一些较为固定的数据进行维护，例如个人中心的职业、用户性别、存储桶页面不同的存储桶类别展示不同的图标等数据维护。

系统设置
对系统中一些常用的数据进行维护，包括系统名称、系统logo、备案信息、更新日志、系统上所使用的的图标的来源进行配置。

权限控制
完整的权限控制功能，不同的角色可分配不同的操作权限，控制对应的删除及查看。

[color=var(--color-accent-fg)]在线体验

在线演示
地址：[color=var(--color-accent-fg)]http://picture.itchenliang.club/#/
账号：[color=var(--color-accent-fg)]guest@163.com
密码：000000

[color=var(--color-accent-fg)]待办功能 TODO

后期待开发的功能列表/优化部分展示

数据迁移/数据备份
考虑到有的用户原先使用的是其他图床系统，需要将数据迁移到本系统中；或者需要将本系统中的图片迁移到其他图床系统中。
- 存储桶支持一键导出所有图片(即将该存储桶中的图片一键批量导出到zip包中)
- 存储桶支持一键导入所有图片(即将zip包中的图片一键批量导入到该存储桶中)
  考虑到有的用户需要将相册中的图片导入或者导出做备份工作
- 相册支持一键导出所有图片(即将该相册中的图片一键批量导出到zip包中)
- 相册支持一键导入所有图片(即将zip包中的图片一键批量导入到该相册中)
新增存储桶插件
考虑到很多用户在使用“哔哩哔哩图床”和“csdn图床”，为了方便用户的使用，管理员需新增如下两个存储桶插件：
- bilibili存储桶
- csdn存储桶
首页上传区
目前首页上传区存在的问题，如果用户上传的图片多且超清，会导致上传时间比较长，如果此时用户切换菜单到其他页面，会导致图片上传不成功问题，为了解决该问题需要配置一个“全局任务中心”，用户图片上传进度检测，由于是全局的，所以用户切换页面不会造成上传失败问题。
快捷键绑定实际事件
目前只完成了快捷键绑定设置功能，还需完善到实际的事件绑定，例如：快捷上传快捷键Ctrl + Shift + P，需要自动进入到个人中心页面。
提示功能
根据用户的习惯配置是否开启上传成功等相关的消息提示。
鉴黄能力
有的用户在本系统上上传【颜色图片】，属于不合法行为，故需接入鉴黄能力，若用户上传的图片是【有颜色图片】则上传失败。
新增其他图片处理的插件
例如：图片是否添加水印(文字水印|图片水印)插件、图片裁剪旋转缩放插件、图片压缩插件、图片滤镜、图片标注等图片处理相关插件。
整合markdown工具
大对数人使用markdown工具都是使用typora，然后直接在typora整合picgo实现图片上传功能，所以其实大多数都不会单独上传图片，故本系统需增加一项文档管理功能，可以对文章进行管理。大致界面设计如下: [color=var(--color-accent-fg)] [color=var(--color-accent-fg)] 主要包括的功能项：
- 文档目录管理
- 文档文章管理
- 导出markdown文件、导出html文件

[color=var(--color-accent-fg)]环境

Node版本 >= 14.17.6
Mysql版本 >= 5.7
typescript版本 >= 4.8.4

[color=var(--color-accent-fg)]安装[color=var(--color-accent-fg)]安装步骤

1. 安装node
前往[color=var(--color-accent-fg)]node官网下载node.exe并安装或者使用nrm进行安装。

2. 安装git
前往[color=var(--color-accent-fg)]Git官网下载git并安装，此步可忽略。

3. 安装typescript、nodemon、ts-node
使用下面的命令全局安装typescript

npm install typescript -gnpm install nodemon -gnpm install ts-node -g

4. 克隆代码
使用git clone命令将代码克隆到本地，或者直接下载压缩包到本地并解压

5. 执行sql文件
系统提供默认初始化数据库sql文件，打开并复制sql/picture-bed-backup.sql，在navicat或者其他工具中执行该sql文件。该sql文件中默认提供了一个管理员账号，方便用户初次使用时登录

管理员账号: admin@[color=var(--color-prettylights-syntax-constant)]163.com管理员密码: [color=var(--color-prettylights-syntax-constant)]000000

6. 修改数据库连接
打开server/src/global.config.ts文件，将数据库连接服务修改成自己的数据库ip、用户名、密码等

[color=var(--color-prettylights-syntax-comment)]/**[color=var(--color-prettylights-syntax-comment)] * mysql数据库配置[color=var(--color-prettylights-syntax-comment)] */[color=var(--color-prettylights-syntax-keyword)]export [color=var(--color-prettylights-syntax-keyword)]const databaseConfig [color=var(--color-prettylights-syntax-constant)]= { [color=var(--color-prettylights-syntax-constant)]host: [color=var(--color-prettylights-syntax-string)]'localhost', [color=var(--color-prettylights-syntax-comment)]// 数据库ip，默认是localhost [color=var(--color-prettylights-syntax-constant)]port: [color=var(--color-prettylights-syntax-constant)]3306, [color=var(--color-prettylights-syntax-comment)]// 数据库端口，默认3306 [color=var(--color-prettylights-syntax-constant)]database: [color=var(--color-prettylights-syntax-string)]'picture-bed-backup', [color=var(--color-prettylights-syntax-comment)]// 数据库 [color=var(--color-prettylights-syntax-constant)]username: [color=var(--color-prettylights-syntax-string)]'root', [color=var(--color-prettylights-syntax-comment)]// mysql用户名，默认是root [color=var(--color-prettylights-syntax-constant)]password: [color=var(--color-prettylights-syntax-string)]'xxxx' [color=var(--color-prettylights-syntax-comment)]// mysql密码}

7. 依赖安装

[color=var(--color-prettylights-syntax-comment)]# 前端依赖安装[color=var(--color-prettylights-syntax-constant)]cd clientnpm install[color=var(--color-prettylights-syntax-comment)]# 服务端依赖安装[color=var(--color-prettylights-syntax-constant)]cd servernpm install

8. 项目启动
首先将后端服务启动

[color=var(--color-prettylights-syntax-comment)]# 服务端启动[color=var(--color-prettylights-syntax-constant)]cd servernpm run start

在运行前端代码前还需要做一步操作，打开client/public/global.config.js文件，修改window.uploader_ip，将下面的locahost:3002改成你本地启动的server的ip和端口(如果是部署上线时需进行此步，本地调试可跳过)。

[color=var(--color-prettylights-syntax-storage-modifier-import)]window.[color=var(--color-prettylights-syntax-constant)]uploader_ip [color=var(--color-prettylights-syntax-constant)]= [color=var(--color-prettylights-syntax-string)]'localhost:3002'

然后执行下面命令运行前端代码

[color=var(--color-prettylights-syntax-comment)]# 前端项目启动[color=var(--color-prettylights-syntax-constant)]cd clientnpm run dev

控制台出现如下如所示即代表启动成功 [color=var(--color-accent-fg)]

[color=var(--color-accent-fg)]

9. 配置邮箱服务和ip定位服务使用系统提供的默认管理员账号admin@163.com登录系统，点击左侧菜单栏上的系统配置菜单，进入系统配置页面，然后点击顶部的系统配置tab栏，找到ip定位服务配置以及邮件服务配置填写相关数据即可。 [color=var(--color-accent-fg)]

注意：

本系统预设了两种ip定位服务
- 百度地图：获取开发者秘钥的前提需要登录[color=var(--color-accent-fg)]百度地图开放平台注册账号，并入驻成为开发者，创建服务端类型的应用，复制应用的AK填写到上面截图中的开发者秘钥中，然后点击保存按钮，此时就开启了ip定位服务。 [color=var(--color-accent-fg)]
- 高德地图：获取开发者秘钥的前提需要登录[color=var(--color-accent-fg)]高德地图开放平台注册账号，并入驻成为开发者，创建web服务类型的应用，复制应用的AK填写到上面截图中的开发者秘钥中，然后点击保存按钮，此时就开启了ip定位服务。 [color=var(--color-accent-fg)]
本系统为了方便用户使用，提供了使用邮箱注册账号、邮箱找回密码等功能，默认使用的是qq邮件服务，故需要配置qq邮件服务的相关数据
- 首先登录QQ邮箱，点击设置 -> 账号，找到POP3/IMAP/SMTP/Exchange/CardDAV/CalDAV服务 [color=var(--color-accent-fg)] 在POP3/SMTP服务一栏，必须是上图所示的，已开启状态，开启后会拿到对应的授权码，将授权码填写到邮件服务配置一栏中的邮件授权码输入框中，并且填写发件人邮箱地址(即您启用授权码的qq邮箱) [color=var(--color-accent-fg)]