Picuang
🔧 如果你遇到任何问题,都可以通过我个人签名中的联系方式与我沟通!
雨我无瓜请自行承担。
🎨 介绍
Picuang是一款根图床
WEB程序。用户可以向Picuang中上传jpg
/jpeg
/png
/svg
/gif
/bmp
/ico
/tiff
图片,Picuang会自动将图片上传至Picuang的运行目录中。
Picuang会将用户上传的图片保存到本地
,而非将图片上传到其它公共容器
中(例如七牛、新浪等),满足搭建一个提供图床存储、读取服务
的需求。
✨ 功能
- 选择、拖拽或粘贴图片,自动上传至Picuang服务器中
- 自动生成图片对应的
URL格式链接
、HTML标签格式链接
、Markdown格式链接
- 图片链接克隆(转存)功能,可输入图片的URL,Picuang会自动下载并保存到Picuang服务器中
- 单IP上传自动阻流器,上传过快会排队上传,减轻服务器压力,防止恶意上传/克隆攻击
- 历史记录功能(按IP地址读取,所以更换IP地址后无法查询)
- Picuang管理员后台设置界面(基于配置文件存储,不依赖数据库)
- 仅管理员可上传功能(默认关闭,必须在后台登录后才能上传)
🌐 使用技术
开发:
Intellij IDEA
后端:
Thymeleaf
Spring Boot
前端:
JQuery
Bootstrap
Axios
🔍 体验
管理界面:
支持热重载,丰富的自定义功能
主界面:
历史记录:
时间线式展示,清晰明了全面
📄 使用事项
Picuang不需要配置数据库,如果你使用IDEA直接运行本项目或是用Maven打包为war包,它会自动将图片上传到网站根目录中的uploadImages
目录中。你可以在UploadController.java中找到适配代码:
String path = ClassUtils.getDefaultClassLoader().getResource("").getPath() + "static/uploadImages/";
Picuang读取了当前网站的根目录。由于项目使用了Thymeleaf,所以static
是存储静态资源的根目录。
✅ 安装 / 二次开发
- Picuang可在Tomcat上运行,在这里下载已经打包好的war包,部署到Tomcat中
- 如果你想自己修改Picuang的源码,Clone后在Intellij IDEA中运行,使用Maven - package打包新的war包,新的war包位置在一般在
target
目录中。如图所示:
⬆️ 版本更新
- 在版本更新之前,请备份您的
uploadImages
文件夹(图床文件存储位置),并备份config.ini
文件。 - 清空旧版本 Picuang 所在目录,并将新版本部署。
- 将备份的文件放回原位。
➕ 调整上传文件大小限制
在使用前,你可以在application.properties
文件中调整文件的限制:
#重要!Picuang图床设置
//单个文件传输文件大小限制
spring.servlet.multipart.max-file-size=20MB
//单次传输文件大小限制
spring.servlet.multipart.max-request-size=20MB
#Picuang图床设置结束
同时,你设置的限制大小会自动同步到前端的标题当中,用户可以直观地看到文件上传的大小限制。
🚨 注意事项
如果你使用了Tomcat 或 Tomcat和Nginx搭载了Picuang,你可能会遇到上传失败的情况。请按照下方的几个解决办法尝试:
- Tomcat:context.xml
修改conf/context.xml
文件,在</Context>
之前添加一行:
<Resources cachingAllowed="true" cacheMaxSize="100000" />
- Tomcat:server.xml
修改conf/server.xml
文件,在你使用端口的Connector
配置中添加一条:
maxPostSize="209715200"
- Nginx
在你的location / {
下添加一行:
client_max_body_size 100m;
💚 轻量说明
Picuang 是一款轻量图床,适用于个人或小规模使用。
Picuang 没有数据库,图片日期通过文件夹进行排列存储,配置通过本地配置文件进行存储。
如有问题,欢迎联系我们或直接提交PR。