timothyclarke/go-csp-collector

go-csp-collector 镜像说明

镜像概述

go-csp-collector是一款基于Go语言开发的内容安全策略（CSP）违规收集工具，主要用于监听指定端口接收网站发送的CSP违规报告，并将报告记录到标准输出或文件中。工具内置无效报告过滤功能，可自动忽略无法处理的违规数据，同时支持自定义配置和多种输出格式。

核心功能

1. 违规报告收集：监听端口接收POST请求中的CSP违规报告
2. 自动过滤：忽略无法采取行动的无效报告（基于默认或自定义过滤列表）
3. 元数据附加：通过URL参数添加元数据到报告中
4. 多输出格式：支持文本（key/value）和JSON两种输出格式
5. 灵活配置：通过命令行参数设置端口、调试模式、过滤文件等
6. 部署支持：提供Kubernetes/Helm部署方案

使用场景

• 网站管理员收集CSP违规数据，分析网站内容安全策略的有效性
• 安全团队监控网站的CSP执行情况，及时发现潜在的安全风险
• 开发人员调试网站的CSP配置，优化策略以减少误报

配置说明

命令行参数

元数据使用

在报告请求URL中添加metadata参数，可将自定义元数据附加到报告中。例如：
https://collector.example.com/?metadata=webapp-v1

输出到文件

将工具输出重定向到文件：

sh
./csp_collector 2>> /path/to/violations.log

Docker部署示例

构建镜像

dockerfile
# 构建阶段
FROM docker.xuanyuan.run/golang:alpine AS builder
WORKDIR /app
COPY . .
RUN CGO_ENABLED=0 go build -o csp_collector csp_collector.go

# 运行阶段
FROM docker.xuanyuan.run/alpine:latest
WORKDIR /app
COPY --from=builder /app/csp_collector .
EXPOSE 8080
CMD ["./csp_collector"]

运行容器

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

带自定义配置运行

sh
docker run -d -p 8081:8081 --name csp-collector-custom \
  timothyclarke/go-csp-collector \
  ./csp_collector --port=8081 --output-format=json --debug