rossumai/go-csp-collector

rossumai/go-csp-collector 镜像说明

镜像概述

rossumai/go-csp-collector是基于Golang开发的内容安全策略（CSP）违规收集工具，用于捕获网站的CSP违规报告并记录，帮助管理员分析和优化网站安全策略。工具支持自定义配置，适配不同场景需求。

核心功能

• 监听指定端口接收POST请求中的CSP违规报告
• 自动忽略无法处理的报告（可通过过滤文件自定义规则）
• 支持URL参数附加元数据到报告
• 提供文本、JSON两种输出格式
• 可配置健康检查路径及运行端口
• 调试模式输出详细日志

使用场景

• 网站管理员收集CSP违规数据，调整安全策略
• 开发团队验证测试环境中CSP规则的有效性
• 安全人员监控网站CSP执行情况，及时发现风险

配置说明

命令行选项

Docker部署示例

构建镜像

1. 编译兼容Alpine的可执行文件：

sh
CGO_ENABLED=0 go build csp_collector.go

2. 创建Dockerfile：

dockerfile
FROM docker.xuanyuan.run/alpine:latest
COPY csp_collector /app/
WORKDIR /app
EXPOSE 8080
CMD ["./csp_collector"]

3. 构建镜像：

sh
docker build -t rossumai/go-csp-collector .

运行容器

sh
docker run -d -p 8080:8080 --name csp-collector docker.xuanyuan.run/rossumai/go-csp-collector

若需保存日志到文件：

sh
docker run -d -p 8080:8080 -v /host/logs:/app/logs docker.xuanyuan.run/rossumai/go-csp-collector ./csp_collector 2>> /app/logs/violations.log

附加元数据

通过URL参数metadata添加报告上下文：

POST https://collector.example.com/?metadata=production

切换输出格式

使用JSON格式输出：

sh
docker run -d -p 8080:8080 docker.xuanyuan.run/rossumai/go-csp-collector ./csp_collector --output-format json