cactus4docker/go-camo

go-camo 镜像文档

镜像概述

go-camo是基于Go语言开发的camo服务器实现，本质为图像代理服务。其核心功能是通过SSL/TLS协议转发非安全（HTTP）图像资源，解决在HTTPS安全页面中加载HTTP图像时浏览器出现的“混合内容警告”问题，保障页面安全状态。该服务需与后端业务代码协同工作，由后端完成图像URL重写及HMAC签名，确保代理请求的合法性。

核心功能与特性

• Go语言实现：采用Go语言开发，具备轻量、高效、并发性能优异的特点，适合作为代理服务稳定运行。
• 图像代理能力：专注于非安全图像资源的转发，将HTTP图像请求通过SSL/TLS加密通道代理，转换为HTTPS请求返回给前端。
• 混合内容防护：有效避免浏览器在HTTPS页面中加载HTTP图像时触发的混合内容警告，提升Web页面安全性和用户体验。
• HMAC签名验证：需配合后端代码对图像URL进行重写，并使用HMAC算法生成签名，确保代理请求经过授权，防止***使用。

使用场景与适用范围

适用于所有部署在HTTPS环境下的Web应用、网站或服务，具体场景包括：

• 网站需加载第三方非HTTPS图像资源（如用户上传的HTTP图片、外部API返回的HTTP图像链接等）。
• Web应用在HTTPS模式下，因加载HTTP图像导致浏览器控制台出现混合内容警告，影响页面功能或用户信任度。
• 需要对图像请求进行安全校验，防止未授权的代理请求消耗服务器资源。

使用方法与配置说明

基本运行方式

go-camo服务可通过Docker容器快速部署，基本命令示例（具体镜像名称及参数需根据实际情况调整）：

bash
docker run -d --name go-camo -p 8080:8080 cactus/go-camo

（注：实际部署时需根据需求配置端口映射、环境变量及挂载卷等）

关键配置要点

1. 后端协同：需在业务后端实现URL重写逻辑，将原始HTTP图像URL转换为go-camo可识别的代理URL，并附加HMAC签名参数。
2. HMAC密钥设置：通过环境变量或配置文件指定HMAC签名密钥，确保后端签名与代理服务验证使用相同密钥，避免签名验证失败。
3. SSL/TLS配置：若需服务本身提供HTTPS终结（即代理服务对外暴露HTTPS端口），需挂载SSL证书文件并配置相关参数（如证书路径、密钥路径等）。

更多配置信息

详细的配置参数、环境变量说明、HMAC签名生成方法及高级功能（如缓存策略、请求限制等），请参考官方文档：https://github.com/cactus/go-camo%E3%80%82