dstours/fluffy-barnacle

GitHub: dstours/fluffy-barnacle

基于 GitHub Codespaces 的免费临时网络基础设施工具包,提供 SOCKS5 代理、HTTPS 文件托管和 WireGuard VPN 隧道能力。

Stars: 82 | Forks: 7

fluffy-barnacle

Fluffy-Barnacle

由 GitHub Codespaces 驱动的一次性、临时网络基础设施。
在几秒钟内部署 SOCKS5 代理、HTTPS 文件托管和 WireGuard 隧道,完全免费。

Python 3.8+ Apache 2.0 License Code style: black

## 文档 完整文档请访问 **[https://dstours.github.io/fluffy-barnacle/](https://dstours.github.io/fluffy-barnacle/)** ## 什么是 Fluffy-Barnacle? **Fluffy-Barnacle** 是一个面向安全操作员的工具包,可将 GitHub Codespaces 转化为免费、临时的网络基础设施。它提供了一套 CLI 工具,用于快速部署和销毁环境。 | 工具 | 描述 | |------|-------------| | **cs-proxy** | 通过 SSH 隧道的 SOCKS5 和 HTTP 代理,支持自动重连和 Burp Suite 集成 | | **cs-serve** | 即时公共 HTTPS 文件托管、重定向服务器、自定义 HTTP 响应,以及通过 `*.app.github.dev` 进行数据捕获 | | **cs-wg** | 完整的 WireGuard VPN 隧道,具备路由管理和流量监控功能 | | **cs-tools** | nmap, ffuf, httpx, nuclei, sqlmap 的即插即用包装器,自动附加 SOCKS5 代理参数 | Codespace IP 在每次创建时都会轮换,让您按需获取全新的出口 IP。每个工具既可通过 CLI 使用,也可作为 Python 库使用。 ## 快速开始 ``` pip install -e . gh auth login cs-proxy start cs-tools ipcheck # verify you're proxied ``` 有关详细的设置,请参阅 [快速开始指南](https://dstours.github.io/fluffy-barnacle/quickstart/)。 ## 功能亮点 ### 带自动重连的 SOCKS5 代理 ``` cs-proxy start # single proxy, auto-select codespace cs-proxy -n 2 start -l WestEurope -l EastUs # two proxies, different regions (ports 1080 + 1081) cs-proxy status # codespace state + per-tunnel exit IP cs-proxy ssh # interactive shell (menu if multiple codespaces tracked) cs-proxy env # export statements for tools that read env vars cs-proxy burp # upstream proxy config for Burp Suite ``` ### 公共文件托管 ``` cs-serve file payload.bin # serve a file cs-serve redirect http://169.254.169.254/metadata/ # SSRF redirect cs-serve custom 9999 '{"pwned":true}' application/json # custom response cs-serve capture # capture POST data cs-serve -d dev.example.com file payload.bin # custom domain via Cloudflare ``` ### WireGuard VPN ``` cs-wg up cs-wg route add 192.168.10.0/24 # route a specific subnet cs-wg route all # route everything cs-wg monitor http # tcpdump with labeled output cs-wg down ``` ### 代理工具包装器 ``` cs-tools ipcheck cs-tools pnmap -p 80,443,8080 target.com cs-tools pffuf -u https://target.com/FUZZ -w list.txt cs-tools phttpx -l domains.txt -title -status-code cs-tools pcs gobuster dir -u https://target.com -w list.txt ``` ## 安装 **系统要求:** Python 3.8+, [GitHub CLI](https://cli.github.com/) (`gh`), `ssh`, `curl` ``` git clone https://github.com/dstours/fluffy-barnacle.git cd fluffy-barnacle pip install -e . ``` 特定功能的可选依赖项: - `wg`, `wg-quick`, `socat`, `ip` — 用于 `cs-wg` - `proxychains4`, `tinyproxy` — 用于 `cs-proxy proxychains` / `cs-proxy http` - `tcpdump` — 用于 `cs-wg monitor` 有关特定平台的说明,请参阅 [安装指南](https://dstours.github.io/fluffy-barnacle/user-guide/installation/)。 ## Python API ``` from csproxy import SSHTunnel, Config, GitHubManager, CodespaceSelector config = Config() gh = GitHubManager() cs_name = CodespaceSelector(gh, config).select() tunnel = SSHTunnel(config, cs_name) tunnel.start() from csproxy import check_proxy, ipcheck, pnmap if check_proxy(): ipcheck() pnmap(['-p', '80,443', 'target.com']) ``` ## 配置 配置文件:`~/.config/cs-proxy/config.yaml` ``` socks_port: 1080 http_proxy_port: 8080 num_proxies: 1 # 1-2; starts a tunnel through each on consecutive ports codespace_name: "" locations: [] # e.g. [WestEurope, EastUs] — one region per codespace reconnect_delay: 5 max_reconnect_delay: 300 verbose: false ``` 有关所有选项和环境变量,请参阅 [配置参考](https://dstours.github.io/fluffy-barnacle/user-guide/configuration/)。 ## 许可证 [Apache-2.0](LICENSE)
标签:Burp Suite集成, DevSecOps, GitHub Codespaces, HTTPS文件托管, IP 地址批量处理, Nmap封装, Python, SOCKS5代理, SSH隧道, WireGuard VPN, 上游代理, 临时基础设施, 代理自动化, 内存分配, 匿名网络, 无后门, 流量重定向, 端口转发, 网络安全, 逆向工具, 隐私保护