一个独立开发者的审计日志平台-拓冰建站

一个独立开发者的审计日志平台

独立开发无羡，分享从零搭建统一审计日志平台的全过程：API Key 鉴权、React + shadcn/ui 前端、Nginx + Supervisor 部署上线。

为什么要做审计日志

我的在线考试系统、云深不知处博客、一纸云深小程序——三个服务跑在同一台 ECS 上，每次排查问题都要分别登录各服务器看日志。更难受的是，查「谁在什么时候做了什么操作」全靠翻文件，效率极低。

我需要一个统一的审计日志平台：

✅ 各服务统一写入，集中查询
✅ 多维筛选（用户、操作、时间、资源）
✅ 部署独立，不耦合任何一个业务系统

技术选型

模块	选型	理由
后端框架	Spring Boot 3.2	现有项目统一，复用经验
ORM	MyBatis-Plus	代码量最少
数据库	MySQL 8.0	RDS 已有，不加新中间件
前端	React + shadcn/ui + TailwindCSS	轻量、美观、组件丰富
数据库版本管理	Liquibase	自动建表，增量变更

数据库设计

两张表，非常简单：

t_operation_log 审计日志主表

字段	类型	说明
id	bigint (自增)	主键
user_name	varchar(50)	操作人
operation_name	varchar(64)	操作名称，如"删除试卷"
operation_result	tinyint	0-成功 1-失败 2-部分成功
log_type	tinyint	0-操作日志 1-系统日志 2-安全日志
log_level	tinyint	0-重要 1-一般 2-提示
server_name	varchar(64)	服务名称
resource_type	varchar(32)	资源类型，如 exam/paper/user
resource_id	varchar(64)	资源 ID
detail	text	操作详情
start_time	bigint	操作开始时间
end_time	bigint	操作结束时间
create_time	datetime	记录入库时间

索引只有 3 个：user_name、resource_type+resource_id（联合）、create_time。审计日志写多读少，索引越少写入越快。

t_server_name_info 服务字典表

记录有哪些服务接入，前端下拉框读取用，避免 DISTINCT 扫大表。

后端 API

方法	路径	说明
POST	/api/v1/logs	写入一条日志
GET	/api/v1/logs	分页列表 + 多维筛选
GET	/api/v1/logs/{id}	单条详情
GET	/api/v1/server-names	服务字典列表

写入示例

POST/api/v1/logs{"userName":"admin","operationName":"删除试卷","operationResult":0,"logType":0,"logLevel":1,"serverName":"考试系统","resourceType":"paper","resourceId":"55","detail":"管理员 admin 删除了试卷「期末模拟考」"}

鉴权：API Key

前端每次请求自动带X-Audit-Key请求头，后端 Filter 拦截校验。一开始没做，后来考虑到公网部署的风险加上的——虽然只是内部工具，但「知道地址就能用」终究不安全。

前端设计

用 React + shadcn/ui + TailwindCSS，暖色调 UI：

列表页：分页表格 + 按用户名/服务/类型/时间的多维筛选
详情页：概览卡片 + 操作详情展示
快捷筛选标签：操作日志 / 系统日志 / 安全日志

部署

老规矩：ECS + Nginx + Supervisor。

Maven 打成 jar 包上传到服务器，Supervisor 管理进程，Nginx 反代前端静态文件和 API，Certbot 扩域到已有 SSL 证书。

测试数据乌龙

上线后我发现测试数据还在页面上，排查半天发现是前端api.ts里把API_BASE硬编码成了localhost:8090。线上浏览器请求本地端口，读到了我本地数据库的数据。改成环境变量VITE_API_BASE后解决。

各服务接入

其他 Spring Boot 项目只需要一个RestTemplate就能接入：

restTemplate.postForObject("https://audit.wuxiannet.com/api/v1/logs",auditLogBody,Map.class);

总结

审计日志平台的核心价值不在于技术多复杂，而在于「统一」。以前查问题要登录三台机器翻文件，现在一个页面全搞定。对于独立开发者来说，这种基础设施类的东西，早做早省心。

关于作者：无羡，独立开发者，专注AI应用开发。

📌 分类：全栈开发

👉 关注我获取更多技术分享
👉 个人博客：云深不知处
👉 独立开发省钱攻略：查看详情
👉 个人门户：wuxiannet.com — 我的独立开发作品全集

如果这篇文章对你有帮助，欢迎点赞、收藏、关注，你的支持是我持续创作的动力！

点击「阅读原文」查看我的独立开发笔记

一个独立开发者的审计日志平台