一款现代化、高性能、易部署的企业级图床管理系统
💡 正式站点: img.ltd ｜ 演示站点: demo.img.ltd（数据每 3 小时自动重置）
- 🚀 高性能 - 基于 Spring Boot 3.2 + Vue 3.5，支持大文件上传与高并发访问
- 🔐 安全可靠 - Sa-Token 权限认证，支持多种加密方式
- 📦 多存储支持 - 本地存储、阿里云 OSS、腾讯云 COS、MinIO 等
- 🐳 一键部署 - 完善的 Docker Compose 支持，5 分钟快速上线
- 📱 多端适配 - 响应式设计，支持 PC、平板、手机
- 🔌 插件化架构 - 模块化设计，按需加载功能插件
- 📊 可视化监控 - 内置 Druid 监控、API 文档
| 层级 | 技术 |
|---|---|
| 后端 | Spring Boot 3.2、MyBatis-Plus、Sa-Token、Knife4j |
| 前端 | Vue 3.5、Vite 6、Ant Design Vue 4、Pinia、TailwindCSS |
| 数据库 | MySQL 8.0、Redis 7 |
| 部署 | Docker、Docker Compose、Nginx |
z-img/
├── z-img-common/ # 公共模块（工具类、通用配置）
├── z-img-plugin/ # 业务插件模块
│ ├── z-img-plugin-auth/ # 认证授权
│ ├── z-img-plugin-biz/ # 核心业务
│ ├── z-img-plugin-client/ # 客户端接口
│ ├── z-img-plugin-dev/ # 开发工具
│ ├── z-img-plugin-mobile/ # 移动端支持
│ └── z-img-plugin-sys/ # 系统管理
├── z-img-plugin-api/ # 插件 API 接口定义
├── z-img-web-app/ # 后端启动模块
└── zimg-admin-web/ # 前端项目 (Vue 3)
# 克隆项目（选择任一仓库）
git clone https://github.com/IMG-LTD/Z-IMG.git
# 或
git clone https://gitee.com/IMG-LTD/Z-IMG.git
# 或
git clone https://gitcode.com/IMG-LTD/Z-IMG.git
# 或
git clone https://cnb.cool/IMG-LTD/Z-IMG
cd Z-IMG
# 一键部署
./deploy.sh部署脚本提供交互式菜单，支持：
- 全新部署（前端 + 后端 + MySQL + Redis）
- 仅后端部署（含数据库）
- 仅前端部署
- 使用外部数据库部署
- JDK 21+
- Node.js 18+
- MySQL 8.0+
- Redis 7+
- Maven 3.9+
# 1. 导入数据库
mysql -u root -p < z-img-web-app/src/main/resources/_sql/zimg.sql
# 2. 修改配置文件
vim z-img-web-app/src/main/resources/application-local.properties
# 3. 编译打包
mvn clean package -DskipTests
# 4. 启动服务
java -jar z-img-web-app/target/z-img-web-app-3.0.0.jarcd zimg-admin-web
# 安装依赖
npm install
# 开发模式
npm run dev
# 生产构建
npm run build| 配置项 | 说明 | 默认值 |
|---|---|---|
server.port |
后端服务端口 | 82 |
spring.datasource.* |
数据库配置 | localhost:3306 |
spring.data.redis.* |
Redis 配置 | localhost:6379 |
sa-token.timeout |
Token 有效期（秒） | 2592000 (30天) |
Docker 部署时支持通过环境变量覆盖配置，详见 .env.docker
| 服务 | 地址 | 说明 |
|---|---|---|
| 前端 | http://localhost:81 | 管理后台 |
| 后端 API | http://localhost:82 | 接口服务 |
| API 文档 | http://localhost:82/doc.html | Knife4j 文档 |
| Druid 监控 | http://localhost:82/druid | 数据库监控 |
# 启动所有服务
docker compose up -d
# 查看服务状态
docker compose ps
# 查看日志
docker compose logs -f backend
# 停止服务
docker compose down
# 重新构建
docker compose up -d --build- ✅ MySQL 8.0（默认）
- ✅ PostgreSQL
- ✅ Oracle
- ✅ SQL Server
- ✅ 达梦数据库
- ✅ 人大金仓
本项目基于 Apache License 2.0 开源协议。
欢迎提交 Issue 和 Pull Request！
| 平台 | 地址 |
|---|---|
| GitHub | https://github.com/IMG-LTD/Z-IMG |
| Gitee | https://gitee.com/IMG-LTD/Z-IMG |
| GitCode | https://gitcode.com/IMG-LTD/Z-IMG |
| CNB | https://cnb.cool/IMG-LTD/Z-IMG |
如果这个项目对你有帮助，请给一个 ⭐ Star 支持一下！