https://github.com/llllllxy/tiny-mock
tiny-mock 是一个基于SpringBoot开发的一个简单易用的在线数据Mock平台系统，支持mockJs语法，可用于前端开发时的数据Mock。
https://github.com/llllllxy/tiny-mock
mock mockjs springboot
Last synced: 3 months ago
JSON representation
tiny-mock 是一个基于SpringBoot开发的一个简单易用的在线数据Mock平台系统，支持mockJs语法，可用于前端开发时的数据Mock。
- Host: GitHub
- URL: https://github.com/llllllxy/tiny-mock
- Owner: llllllxy
- License: apache-2.0
- Created: 2024-03-08T08:07:21.000Z (over 2 years ago)
- Default Branch: master
- Last Pushed: 2025-08-01T03:34:26.000Z (11 months ago)
- Last Synced: 2025-10-07T05:42:02.487Z (8 months ago)
- Topics: mock, mockjs, springboot
- Language: JavaScript
- Homepage:
- Size: 5.96 MB
- Stars: 6
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Tiny Mock
# 一个基于SpringBoot开发的轻量级在线数据Mock平台
## 功能特色
- 快速生成演示数据，将请求根地址指向到模拟地址即可轻松实现接口模拟
- 支持项目管理，根据项目给接口分组，不同项目拥有不同的接口根地址
- 支持MockJs模拟，根据MockJs的强大能力进行数据生成，文档可见 [mockjs示例](http://mockjs.com/examples.html)
- 支持自定义Http响应码
- 支持模拟接口返回延时
- 支持项目接口数据的导出和导入，方便数据恢复备份
- 支持成员协作功能，同一项目可以邀请多人进行协助
- 支持仪表盘功能，快速预览项目和接口运行调用情况
- 支持数据统计功能，查看每一个接口的调用分析数据
- 支持邀请码注册功能，方便团队内成员注册
- 全局基于国密算法的登录验证和数据保护体系，保证账户安全
## 主要技术选型
| 依赖 | 说明 |
|--------------------|---------------|
| SpringBoot 3.3.10 | 基础框架 |
| Hikari | 高性能数据库连接池 |
| MyBatis-Plus 3.5.8 | MyBatis的增强ORM |
| Redis | 业务缓存、会话共享 |
| MySQL 5.7 | 关系型数据库 |
| Layui 2.9.15 | 前端框架和模板 |
| Mock.js 1.0.0 | 数据mock引擎 |
## 运行环境
- Jdk21
- MySQL5.6+
- Redis3.0+
## 运行启动教程
1. 新建`MySQL`数据库并导入`resources\init`文件夹下的数据库脚本
2. 修改配置文件中`application.yml`中数据库连接信息和Redis连接信息
3. 运行启动类`TinyMockApplication`，即可正常启动项目
4. 管理后台登录地址：`http://localhost:9019` 账户密码 `zhangsan / Aa123456@`
## 项目结构
```
tiny-mock
│
├─resources 资源模块
│ │
│ ├─init 系统初始化脚本
│ │
│ ├─mapper mybatis的xml文件
│ │
│ └─static 静态资源
│ │
│ ├─css 样式表资源
│ │
│ ├─images 图片资源
│ │
│ ├─js js公共文件封装
│ │
│ ├─lib js公共库
│ │
│ ├─page 页面资源
│ │
│ └─index.html 系统入口页面
│
├─java 后台模块
│ │
│ ├─common 公共模块
│ │ │
│ │ ├─annotation 公共注解
│ │ │
│ │ ├─config 系统配置
│ │ │
│ │ ├─constants 系统常量
│ │ │
│ │ ├─enums 系统枚举
│ │ │
│ │ ├─exception 系统自定义异常
│ │ │
│ │ ├─model 公共数据模型
│ │ │
│ │ └─utils 工具类
│ │
│ └─modules 业务模块
│ │
│ ├─bean bean对象
│ │ │
│ │ ├─dto 参数对象
│ │ │
│ │ ├─vo 视图对象
│ │ │
│ │ ├─enums 业务枚举
│ │ │
│ │ └─entity 实体类
│ │
│ ├─helper 业务工具类
│ │
│ ├─web 控制层
│ │
│ ├─service 服务层
│ │
│ └─mapper 持久层
└─
```
## 平台功功能界面展示
登录
注册
首页
我的项目
我的项目-新建
接口管理
接口管理-新增
接口管理-版本
接口管理-访问日志
接口管理-成员协助
数据统计
操作日志
问题与建议
接口测试工具
使用文档
## 其他
Mock.js 文档地址 http://mockjs.com/examples.html
## 项目计划
- Mock核心功能 `已完成`
- 项目管理 `已完成`
- 接口管理 `已完成`
- 接口修改历史 `已完成`
- 接口访问日志 `已完成`
- 租户邀请码注册 `已完成`
- 租户密码找回 `未完成`
- 租户首页大屏 `已完成`
- 租户数据统计页面 `已完成`
- 项目成员协作功能 `已完成`
- 项目导出，项目导入（项目级别的，以便数据备份和恢复） `已完成`
- 自定义头像修改 `已完成`
- 接口分模块管理 `未完成`
- 租户操作日志记录功能 `已完成`
- 租户操作日志查询功能 `已完成`
## 项目部署
#### 1、安装`jdk21`，比如安装到`/opt/jdk-21.0.4`目录下
#### 2、安装`MySQL`数据库
#### 3、安装`Redis`数据库
#### 4、修改配置文件`application.yml`，自定义端口号、MySQL数据库连接信息、Redis连接信息、文件存放位置、各种密钥信息
#### 5、上传`tiny-mock-1.1.2.jar`和自定义配置文件`application.yml`到服务器指定目录下，比如上传到opt目录下，则执行命令`nohup /opt/jdk-21.0.4/bin/java -jar /opt/tiny-mock-1.1.2.jar >/dev/null 2>&1 &`即可
#### 6、如需开启注册功能，还需要配置数据库中的`t_mail_config`表，添加一条数据，填写自己的邮箱服务器配置
## 前后端分离部署示例（以linux环境举例，nginx版本1.24.0）
#### 1、安装 `nginx`
#### 2、将 `/resources/static/js/layuimini/miniAjax.js` 里的 `baseURL` 属性改为 `/back`
#### 3、安装 `nginx` 并更改配置 `default.conf` （位置一般在 /etc/nginx/conf.d 文件夹下）
```editorconfig
listen 80;
server_name localhost;
client_max_body_size 50M;
# 前端文件的实际路径部署，实际路径在D:\nginxplace\mock
location / {
root /usr/share/nginx/html;
index index.html index.htm;
}
# 后端服务反向代理，其中 /back 和 miniAjax.js 里的 baseURL 属性对应
location /back/ {
proxy_pass http://127.0.0.1:9019/;
proxy_redirect off;
# bForwarded-ForIP
proxy_set_header Host $host:$server_port;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_next_upstream error timeout invalid_header http_500 http_502 http_503 http_504;
}
# mock地址反向代理，其中 /mock 和 核心mock地址对应
location /mock/ {
proxy_pass http://127.0.0.1:9019/mock/;
proxy_redirect off;
# bForwarded-ForIP
proxy_set_header Host $host:$server_port;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_next_upstream error timeout invalid_header http_500 http_502 http_503 http_504;
}
```
#### 4、将 `/resources/static` 目录下的内容 全部复制到 `/usr/share/nginx/html` 目录下，此目录和 nginx 的 location.root 路径配置保持一致
#### 5、刷新nginx配置 `nginx -s reload`，然后即可访问 `http://ip地址`
#### 6、配置https(扩展)
1. 申请免费证书，得到一个key文件和pem文件（教程见阿里云免费SSL证书申请流程（一键申请20张）
）
2. 更改nginx配置（default.conf）
```editorconfig
server {
listen 443 ssl;
server_name lxyccc.top;
ssl_certificate lxyccc.top.pem;
ssl_certificate_key lxyccc.top.key;
# 优化SSL配置
ssl_protocols TLSv1.2 TLSv1.3;
ssl_ciphers ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256;
ssl_prefer_server_ciphers on;
ssl_session_cache shared:SSL:10m;
ssl_session_timeout 10m;
ssl_stapling on;
ssl_stapling_verify on;
#access_log /var/log/nginx/host.access.log main;
location / {
root /usr/share/nginx/html;
index index.html index.htm;
}
#error_page 404 /404.html;
# redirect server error pages to the static page /50x.html
#
error_page 500 502 503 504 /50x.html;
location = /50x.html {
root /usr/share/nginx/html;
}
# 后端反向代理，其中 /back 和 miniAjax.js 里的 baseURL 属性对应
location /back/ {
proxy_pass http://127.0.0.1:9019/;
proxy_redirect off;
# bForwarded-ForIP
proxy_set_header Host $host:$server_port;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_next_upstream error timeout invalid_header http_500 http_502 http_503 http_504;
}
# 后端反向代理，其中 /back 和 miniAjax.js 里的 baseURL 属性对应
location /mock/ {
proxy_pass http://127.0.0.1:9019/mock/;
proxy_redirect off;
# bForwarded-ForIP
proxy_set_header Host $host:$server_port;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_next_upstream error timeout invalid_header http_500 http_502 http_503 http_504;
}
# proxy the PHP scripts to Apache listening on 127.0.0.1:80
#
#location ~ \.php$ {
# proxy_pass http://127.0.0.1;
#}
# pass the PHP scripts to FastCGI server listening on 127.0.0.1:9000
#
#location ~ \.php$ {
# root html;
# fastcgi_pass 127.0.0.1:9000;
# fastcgi_index index.php;
# fastcgi_param SCRIPT_FILENAME /scripts$fastcgi_script_name;
# include fastcgi_params;
#}
# deny access to .htaccess files, if Apache's document root
# concurs with nginx's one
#
#location ~ /\.ht {
# deny all;
#}
}
```
3. 新增nginx配置（httpToHttps.conf）
```editorconfig
# HTTP强制跳转HTTPS
server {
listen 80;
server_name yourdomain.com;
return 301 https://$host$request_uri;
}
```
4. 也可使用Let's encrypt 申请免费证书
地址 https://letsencrypt.org/zh-cn/ 或者 https://letsencrypt.top/