liuweitao/shodan-proxy

Shodan Proxy Docker镜像

Shodan Proxy是基于Go语言开发的Shodan API请求代理服务器，提供IP过滤、路径拦截、管理面板等附加功能，适用于网络安全研究场景下的API请求管理。

核心功能

• 代理Shodan API请求，简化密钥管理
• IP白名单机制，限制合法访问来源
• 路径拦截，控制可访问的API接口
• 带认证的管理面板，便于配置与密钥管理
• 多Shodan API密钥轮询轮换，提升请求效率
• 支持自定义配置文件，灵活调整代理规则

使用场景

• 网络安全团队共享Shodan API密钥，统一管理请求权限
• 企业内部限制特定IP或接口的Shodan访问，降低安全风险
• 安全研究人员简化Shodan API调用流程，无需每次携带密钥

配置说明

容器通过config.yaml文件配置，需挂载包含该文件的卷到容器/app/config目录。配置文件需妥善保管，避免敏感密钥泄露。

部署示例

Docker Run快速启动

bash
docker run -p 8080:8080 liuweitao/shodan-proxy:latest

访问管理面板：http://localhost:8080/admin，默认凭据：用户名admin，密码shodanproxy。

挂载自定义配置

bash
docker run -p 8080:8080 -v /本地路径/config.yaml:/app/config/config.yaml liuweitao/shodan-proxy:latest

Docker Compose部署

1. 创建项目目录：

   bash
   mkdir shodan-proxy && cd shodan-proxy
   

2. 下载配置文件：

   bash
   curl -O https://raw.githubusercontent.com/liuweitao/shodan-proxy/main/compose.yaml
   

3. 启动服务：

   bash
   docker compose up -d
   

API调用示例

对比官方API与代理使用方式：

1. 搜索Apache主机
   官方：https://api.shodan.io/shodan/host/search?key=YOUR_KEY&query=apache
   代理：http://localhost:8080/shodan/host/search?query=apache
2. 获取IP信息
   官方：https://api.shodan.io/shodan/host/1.1.1.1?key=YOUR_KEY
   代理：http://localhost:8080/shodan/host/1.1.1.1

注意：代理默认使用自身配置的密钥，若请求携带key=shodanproxy或无key参数，将自动轮换密钥；若携带其他密钥，则直接使用该密钥。

Shodan CLI集成

修改Shodan客户端库的API地址：

bash
sed -i 's|https://api.shodan.io|http://你的代理地址:8080|g' ~/.local/lib/python3.9/site-packages/shodan/client.py

替换后，Shodan CLI将通过代理发送请求。

安全注意事项

• 管理面板需设置强密码，定期更换
• 避免将代理直接暴露于公网，建议在受控网络中使用
• 定期更新镜像，获取安全补丁
• 严格管理IP白名单与路径拦截规则

更多信息

• GitHub仓库：https://github.com/liuweitao/shodan-proxy
• 许可证：MIT License
• 贡献指南：参考仓库CONTRIBUTING.md
• 问题反馈：在GitHub仓库提交issue