# Picuang

**Repository Path**: tez/Picuang

## Basic Information

- **Project Name**: Picuang
- **Description**: 📌 本地存储图床，使用SpringBoot开发，RESTful前后端分离，面向用户的网络图床服务。📦 免费用于自用、商用图床，自由修改 | 📄 中文文档，配置简单，不依赖数据库 | 📝 URL图片转存功能 | 📈 历史记录功能 | 🍱 支持选择、拖拽、粘贴上传 | ⚗️ 自动生成img标签、Markdown标签 | 🔒 上传频率限制
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: https://pic.stackoverflow.wiki/
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2024-01-01
- **Last Updated**: 2024-01-01

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Picuang ![](https://img.shields.io/badge/license-Apache2.0-orange.svg?style=flat-square) ![](https://img.shields.io/github/downloads/adlered/Picuang/total?style=flat-square) ![](https://img.shields.io/github/v/release/adlered/Picuang?style=flat-square)

![](/Picuang_logo.png)

:pushpin: 轻量本地图床，使用SpringBoot开发，面向用户的网络图床服务。https://pic.stackoverflow.wiki  
:wrench: 如果你遇到任何问题，都可以通过我个人签名中的联系方式与我沟通！  
:bookmark: Picuang使用Apache 2.0协议，您可以自由进行个人/商业使用，但因各种原因造成的后果~~雨我无瓜~~请自行承担。

## :art: 介绍

Picuang是一款`根图床`WEB程序。用户可以向Picuang中上传`jpg`/`jpeg`/`png`/`svg`/`gif`/`bmp`/`ico`/`tiff`图片，Picuang会自动将图片上传至Picuang的运行目录中。

Picuang会将用户上传的图片保存到`本地`，而非将图片上传到`其它公共容器`中(例如七牛、新浪等)，满足`搭建一个提供图床存储、读取服务`的需求。

## :sparkles: 功能

- [x] 选择、拖拽或粘贴图片，自动上传至Picuang服务器中
- [x] 自动生成图片对应的`URL格式链接`、`HTML标签格式链接`、`Markdown格式链接`
- [x] 图片链接克隆（转存）功能，可输入图片的URL，Picuang会自动下载并保存到Picuang服务器中
- [x] 单IP上传自动阻流器，上传过快会排队上传，减轻服务器压力，防止恶意上传/克隆攻击
- [x] 历史记录功能（按IP地址读取，所以更换IP地址后无法查询）
- [x] Picuang管理员后台设置界面（基于配置文件存储，不依赖数据库）
- [x] 仅管理员可上传功能（默认关闭，必须在后台登录后才能上传）

## :globe_with_meridians: 使用技术

开发：
`Intellij IDEA`

后端：
`Thymeleaf`
`Spring Boot`

前端：
`JQuery`
`Bootstrap`
`Axios`

## :mag: 体验

[可以来这里直接体验哦~](https://pic.stackoverflow.wiki/)

### 管理界面：

支持热重载，丰富的自定义功能

![屏幕快照 2019-11-24 下午10.58.27.png](https://pic.stackoverflow.wiki/uploadImages/221/222/10/75/2019/11/24/23/02/181d3c20-3b7e-4b28-ac0f-66dba0a6e823.png)

### 主界面：

![屏幕快照 2019-11-24 下午10.58.31.png](https://pic.stackoverflow.wiki/uploadImages/221/222/10/75/2019/11/24/23/02/1809da36-d1d6-4032-aac1-98509e9eabf3.png)

### 历史记录：

时间线式展示，清晰明了全面

![屏幕快照 2019-11-24 下午10.59.55.png](https://pic.stackoverflow.wiki/uploadImages/221/222/10/75/2019/11/24/23/02/16f08bf0-b296-4f47-ae57-4884b9115013.png)

## :page_facing_up: 使用事项

Picuang不需要配置数据库，如果你使用IDEA直接运行本项目或是用Maven打包为war包，它会自动将图片上传到网站根目录中的`uploadImages`目录中。你可以在UploadController.java中找到适配代码：

```
String path = ClassUtils.getDefaultClassLoader().getResource("").getPath() + "static/uploadImages/";
```

Picuang读取了当前网站的根目录。由于项目使用了Thymeleaf，所以`static`是存储静态资源的根目录。

### :white_check_mark: 安装 / 二次开发

* Picuang可在Tomcat上运行，[在这里下载已经打包好的war包，部署到Tomcat中](https://github.com/AdlerED/Picuang/releases)
* 如果你想自己修改Picuang的源码，Clone后在Intellij IDEA中运行，使用Maven - package打包新的war包，新的war包位置在一般在`target`目录中。如图所示：

![image.png](https://pic.stackoverflow.wiki/uploadImages/bce0a4b4-bd34-4e63-a3a5-74d898a9dd63.png)

### :arrow_up: 版本更新

* 在版本更新之前，请备份您的 `uploadImages` 文件夹（图床文件存储位置），并备份 `config.ini` 文件。
* 清空旧版本 Picuang 所在目录，并将新版本部署。
* 将备份的文件放回原位。

### :heavy_plus_sign: 调整上传文件大小限制

在使用前，你可以在`application.properties`文件中调整文件的限制：

```
#重要！Picuang图床设置
//单个文件传输文件大小限制
spring.servlet.multipart.max-file-size=20MB
//单次传输文件大小限制
spring.servlet.multipart.max-request-size=20MB
#Picuang图床设置结束
```

同时，你设置的限制大小会自动同步到前端的标题当中，用户可以直观地看到文件上传的大小限制。

### :rotating_light: 注意事项

如果你使用了Tomcat 或 Tomcat和Nginx搭载了Picuang，你可能会遇到上传失败的情况。请按照下方的几个解决办法尝试：

1. Tomcat：context.xml

修改`conf/context.xml`文件，在`</Context>`之前添加一行：

```
<Resources cachingAllowed="true" cacheMaxSize="100000" />
```

2. Tomcat：server.xml

修改`conf/server.xml`文件，在你使用端口的`Connector`配置中添加一条：

```
maxPostSize="209715200"
```

3. Nginx

在你的`location / {`下添加一行：

```
client_max_body_size 100m;
```

### :green_heart: 轻量说明

```
Picuang 是一款轻量图床，适用于个人或小规模使用。
Picuang 没有数据库，图片日期通过文件夹进行排列存储，配置通过本地配置文件进行存储。
如有问题，欢迎联系我们或直接提交PR。
```