1 Star 2 Fork 1

linkai / acs

加入 Gitee
与超过 1200万 开发者一起发现、参与优秀开源项目,私有仓库也完全免费 :)
免费加入
克隆/下载
README.md 4.40 KB
一键复制 编辑 原始数据 按行查看 历史
func 提交于 2024-01-02 17:07 . readme

ACS ApiCallerStats

简介

ACS是一款使用go和vue3开发的用于记录API访问记录、网页浏览记录等的开源项目。它提供了一个简单易用的后台管理页面,可以查看调用折线图、饼图等,帮助您更好地了解API的使用情况以及发现一些异常。

主要功能

  1. 记录 API 访问记录、网页浏览记录等
  2. 提供后台管理页面,查看调用折线图、饼图等
  3. 支持Restful风格API和GRPC两种通信模式,快速接入您的系统。
  4. 支持多种数据库记录方式。(目前仅支持mysql,其他数据库引擎开发中...)

使用场景

  • 场景1: 小明在自己的项目中大量调用一些第三方的API服务,为了方便查看调用记录和调用频率等问题。
  • 场景2: 小李有一个自己的博客网站,想观察一下自己的博客实际的访问状态,访问趋势等。
  • 场景3: 小红的项目给别人提供了接口服务,为了统计别人调用自己接口的调用量和调用趋势

技术选型

  1. 前端:用基于vue3的Element-Plus构建基础页面。
  2. 后端:采用高效的go语言开发,使用Gin快速搭建基础restful风格API。
  3. 鉴权:采用JWT鉴权。
  4. 数据库:采用MySql>5.7版本,数据库引擎 innoDBimportant,使用gorm实现对数据库的基本操作。Clickhouse和Monge待实现。
  5. 配置文件:使用viper实现.env格式的配置文件。
  6. 日志:使用logrous和lfshook实现日志记录和分隔。
  7. 数据通信:支持GRPC和HTTP两种通信方式。

原生安装

# 克隆项目
git clone https://github.com/linkaias/acs.git
# 或者
git clone https://gitee.com/tolinkai/acs.git

# 进入项目目录
cd acs

# 复制.env_bak示例配置文件重命名为.env并根据文档修改配置文件
cp .env_bak .env
vim .env

# 安装依赖
go mod tidy

# 启动后端服务
go run main.go

# 启动前端服务
cd web/acs_admin
# 安装依赖
npm install
# 启动服务
npm run dev

# 浏览器访问 
http://localhost:9528

Docker安装

# 克隆项目
git clone https://github.com/linkaias/acs.git
# 或者
git clone https://gitee.com/tolinkai/acs.git

cd acs

# 复制.env_bak示例配置文件重命名为.env并根据文档修改配置文件
cp .env_bak .env

# 构建镜像
docker build -t acs:1.1 .

# 启动容器 说明:.env为项目配置文件, var 为日志目录。 8080为后台管理界面端口,9528为http接口服务端口,9529为grpc服务端口。
# 注意:--network 建议和你的mysql容器网络一致。如果mysql没有使用docker安装,可以删除--network参数
docker run -d -it --network=[yourNetworkName] -v ./.env:/run/.env -v ./var:/run/var  -p 8080:80 -p 9528:9528 -p 9529:9529 --name acs acs:1.1 /bin/sh


# 打开浏览器,打开http://127.0.0.1:8080,即可访问后台登陆界面。

详情参考安装文档:https://funcs.gitbook.io/acs_docs/kai-shi-kai-shi/install

Online Demo

在线体验 http://acsdemo.uiucode.com

用户名:admin 密码:123456

❤️ 创作不易,点个Star便是我更新的动力!您也可以分享好友圈子以支持此项目。

License

MIT

Copyright (c) 2024-present LinKai

Go
1
https://gitee.com/tolinkai/acs.git
git@gitee.com:tolinkai/acs.git
tolinkai
acs
acs
master

搜索帮助