dstours/fluffy-barnacle
GitHub: dstours/fluffy-barnacle
基于 GitHub Codespaces 的免费临时网络基础设施工具包,提供 SOCKS5 代理、HTTPS 文件托管和 WireGuard VPN 隧道能力。
Stars: 82 | Forks: 7
Fluffy-Barnacle
由 GitHub Codespaces 驱动的一次性、临时网络基础设施。
在几秒钟内部署 SOCKS5 代理、HTTPS 文件托管和 WireGuard 隧道,完全免费。
## 文档
完整文档请访问 **[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, 上游代理, 临时基础设施, 代理自动化, 内存分配, 匿名网络, 无后门, 流量重定向, 端口转发, 网络安全, 逆向工具, 隐私保护