ImageFlow 一款更适合你的图床

一直以来我都是用的chevereto来作为图床管理，但是这个作者太脑瘫了。项目越改越辣鸡，经常增加一些虚头八脑的社交之类的功能，导致整个项目越来越臃肿卡顿，至于市面上其他的项目，我也不想再过多尝试，大部分都是基于多用户场景的，和我想要的相违背。本着既然没有，那就自己创造，还能加点我自己喜欢的功能，例如avif和webp格式自动压缩，API自适应横屏竖屏输出。于是 ImageFlow 就诞生了。

仓库地址：https://github.com/Yuri-NagaSaki/ImageFlow/ 欢迎点点star

✨ 主要特性 #

API 密钥认证：安全的 API 密钥验证机制，保护您的图片上传功能
自适应图像服务：根据设备类型（桌面端/移动端）自动提供横向或纵向图片
现代格式支持：自动检测浏览器兼容性并提供 WebP 或 AVIF 格式图片
简单的 API：通过简单的 API 调用获取随机图片
用户友好的上传界面：支持拖拽上传，具有暗黑模式和实时预览功能
图片管理功能：通过直观的管理界面查看、筛选和删除图片
自动图像处理：上传后自动检测图像方向并转换为多种格式
多存储支持：支持本地存储和 S3 兼容存储

🚀 技术优势#

安全性：API 密钥验证机制确保图片上传和管理功能的安全访问
格式转换：自动将上传的图片转换为 WebP 和 AVIF 格式，减少 30-50% 的文件大小
设备适配：为不同设备提供最合适的图片方向
热重载：上传的图片无需重启服务即可立即可用
并发处理：使用 Go 的并发特性高效处理图像转换
可扩展性：模块化设计便于扩展和定制
响应式设计：完美适配桌面端和移动端设备
暗黑模式支持：自动适应系统主题。
灵活存储：支持本地和 S3 兼容存储，通过 .env 文件轻松配置

📸 界面预览#

快速开始#

可以选择两种方式，都非常方便，一种是Docker，一种是二进制部署。

先说最简单的Docker吧

Docker部署#

拉取并进入仓库

1
git clone https://github.com/Yuri-NagaSaki/ImageFlow && cd ImageFlow

修改.env

1
cp .env.example .env
2
vim .env

根据所选择的部署模式调整参数，具体 S3 的下列参数如何获得这里就不再过多赘述了

1
# API Keys
2
API_KEY=your_api_key_here  # 这是你的API key 用于身份验证登录
3

4
# Storage Configuration
5
STORAGE_TYPE=local  # Options: local, s3  根据部署模式选择
6
LOCAL_STORAGE_PATH=static/images # Local
7

8
# S3 Configuration (required when STORAGE_TYPE=s3)
9
S3_ENDPOINT=
10
S3_REGION=
11
S3_ACCESS_KEY=
12
S3_SECRET_KEY=
13
S3_BUCKET=
14

15
# Custom Domain (optional)
16
CUSTOM_DOMAIN=   # 这里是S3 一般都会有的自定义域名。

拉取镜像准备部署

1
docker compose up -d
2
一般默认监听8686端口，如有必要，自行修改。

本地部署#

安装依赖#

安装 Go (1.22+)

安装 WebP 工具: sudo apt-get install webp (Ubuntu/Debian)

安装 AVIF 工具: sudo apt-get install libavif-bin (Ubuntu)

注意：这里的需要avif 1.0版本以上，Debian系统默认安装的是0.9 版本。需要自行编译安装。

Ubuntu 24.04 默认即可安装最新版本

下载二进制文件修改env

默认提供 X86 和ARM的，自行选择

1
git clone https://github.com/Yuri-NagaSaki/ImageFlow && cd ImageFlow
2
https://github.com/Yuri-NagaSaki/ImageFlow/releases/download/v1.0/imageflow-x86
3
chmod 777 imageflow-x86
4
cp .env.example .env
5
vim .env
6
./imageflow-x86

创建service

1
[Unit]
2
Description=ImageFlow Service
3
After=network.target
4

5
[Service]
6
ExecStart=/path/to/imageflow
7
WorkingDirectory=/path/to/imageflow/directory
8
Restart=always
9
User=youruser
10

11
[Install]
12
WantedBy=multi-user.target