{"id":26847746,"url":"https://github.com/sh3d0ww01f/waterdragon","last_synced_at":"2025-04-30T22:22:01.982Z","repository":{"id":37233099,"uuid":"505500664","full_name":"sh3d0ww01f/WaterDragon","owner":"sh3d0ww01f","description":"WaterDragon:用GithubAction实现代理功能。红队,cve,代理池,隐匿,攻防,对抗，hackone,src,proxy,CVE-2020,CVE-2021,CVE-2022","archived":false,"fork":false,"pushed_at":"2023-02-14T14:02:27.000Z","size":2444,"stargazers_count":142,"open_issues_count":1,"forks_count":27,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-03-30T20:31:48.749Z","etag":null,"topics":["gfw","gfw-breaker","github-actions","proxy","python","redteam"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/sh3d0ww01f.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2022-06-20T15:38:53.000Z","updated_at":"2025-03-24T01:36:34.000Z","dependencies_parsed_at":"2025-03-30T20:41:23.340Z","dependency_job_id":null,"html_url":"https://github.com/sh3d0ww01f/WaterDragon","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sh3d0ww01f%2FWaterDragon","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sh3d0ww01f%2FWaterDragon/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sh3d0ww01f%2FWaterDragon/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sh3d0ww01f%2FWaterDragon/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/sh3d0ww01f","download_url":"https://codeload.github.com/sh3d0ww01f/WaterDragon/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":251790211,"owners_count":21644181,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["gfw","gfw-breaker","github-actions","proxy","python","redteam"],"created_at":"2025-03-30T20:30:20.695Z","updated_at":"2025-04-30T22:22:01.950Z","avatar_url":"https://github.com/sh3d0ww01f.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# WaterDragon 水龙 v1.0\n和水一样 灵活多变,\n\n\n# 建议用小号跑 大号容易封号\n# 如果手头有多余邮箱的 可以多注册几个github号来跑这个\n\n像龙一样 来去自如\n## 用Github Action实现IP代理功能 也可翻墙\n### 核心\n这个项目的**核心是NPS[https://github.com/ehang-io/nps] + Github Action**\nGithub Action和SCF实现代理池的方式不一样：**SCF可以用网关触发，但是Action不是**，Action是给你提供了一台可出不可入的如同私人电脑一般的一个虚拟环境，所以我们如果要想用代理到Action然后去访问 就要我们的**vps 帮忙，先做个穿透，然后转发**\n## Tips:代理出去的IP是微软云的 而且IP众多 也不容易被ban\n# 使用方法\n\n#### 1.在vps上装nps并配置\n下载地址 [https://github.com/ehang-io/nps/releases/tag/v0.26.10](https://github.com/ehang-io/nps/releases/tag/v0.26.10)\n下载合适的版本 这里下载的是linux_amd64_server.tar.gz\n执行`tar -axvf linux_amd64_server.tar.gz`进行解压\n![](https://raw.githubusercontent.com/sh3d0ww01f/WaterDragon/main/img/222.png)\n#### 2.然后去修改配置\n`cd conf`\n`vim nps.conf`\n我们修改一共2个东西\n###### ①.首先是 web_password\n**这个改的越复杂越好** 是nps的管理面板 不过这里不用gui的 用的是webapi，用不到gui的密码，如果是默认的123，会被有心人搞破坏\n###### ②.然后是这里\n![](https://raw.githubusercontent.com/sh3d0ww01f/WaterDragon/main/img/333.png)\n把`auth_key`前面的注释去掉，然后修改auth_key的值\n然后把`auth_crypt_key`修改为别的16位长度的一个字符串 （默认也可以\n**然后把auth_key 记住备用**\n##### ③.http_proxy_port\n可改可不改 **改了是防止http监听端口与apache，nginx这些服务冲突**\n##### ④.web_port\n**api的地址**，监听的是8080端口 如果8080与本地软件有冲突则更改（按需更改）,如果改过就是    vps的ip:web_port\n然后回到上级目录`cd .. `\n随后让nps运行` ./nps`\n如果正常未出现问题 就可以把nps挂后台然后进行 下一步了\n`nohup ./nps \u0026`\n#### 3.获取github_token\n##### 前往[https://github.com/settings/tokens](https://github.com/settings/tokens)\n\n###                  里面勾勾要全勾上哦\n\n![](https://raw.githubusercontent.com/sh3d0ww01f/WaterDragon/main/img/444.png)\n![](https://raw.githubusercontent.com/sh3d0ww01f/WaterDragon/main/img/555.png)\n![](https://raw.githubusercontent.com/sh3d0ww01f/WaterDragon/main/img/666.png)\n**记住备用**\n#### 配置脚本\n首先下载脚本\n`git clone https://github.com/sh3d0ww01f/WaterDragon.git`\n然后修改`main.py`文件\n![](https://raw.githubusercontent.com/sh3d0ww01f/WaterDragon/main/img/777.png)\n   ①**api的位置填上自己的api地址(http://vps_ip:web_port，如果没改过前面的web_port 则就是http://vps_ip:8080)**\n ②**auth_key 写上更改过的auth_key**\n ③**token写github获取的token**\n# 运行脚本\n`python3 main.py`\n![](https://raw.githubusercontent.com/sh3d0ww01f/WaterDragon/main/img/888.png)\n**①.输入socks5 进入隧道管理 我们需要先加一个**\n![](https://raw.githubusercontent.com/sh3d0ww01f/WaterDragon/main/img/999.png)\n出现成功连接WebApi则说明api配置正确\n**②.输入add 增加socks5隧道**\n![](https://raw.githubusercontent.com/sh3d0ww01f/WaterDragon/main/img/1111.png)\n**密钥随意写，端口只要外网能通就可以，加密的话1代表要加密，0代表不加密**\n**③.配置好了新隧道，我们回到菜单使用**\n输入\t`back` 回到菜单,然后**键入`manager`进入Github Action管理**\n![](https://raw.githubusercontent.com/sh3d0ww01f/WaterDragon/main/img/2222.png)\n输入`select`选择要连接的socks5隧道\n这里选择新增的 客户端ID为21的\n![](https://raw.githubusercontent.com/sh3d0ww01f/WaterDragon/main/img/3333.png)\n\n出现`start success`即为启动成功\n\n![](https://raw.githubusercontent.com/sh3d0ww01f/WaterDragon/main/img/4444.png)\n配置一下 配置好 就可以用这个代理了\n\n# 效果\n![](https://raw.githubusercontent.com/sh3d0ww01f/WaterDragon/main/img/2.png)\n![](https://raw.githubusercontent.com/sh3d0ww01f/WaterDragon/main/img/3.png)\n![](https://raw.githubusercontent.com/sh3d0ww01f/WaterDragon/main/img/4.png)\n![](https://raw.githubusercontent.com/sh3d0ww01f/WaterDragon/main/img/5.png)\n# 停止Action\n![](https://raw.githubusercontent.com/sh3d0ww01f/WaterDragon/main/img/5555.png)\n然后键入0 即可暂停现在运行中的GithubAction机子\n出现“取消运行成功” 则代表成功暂停运行\n# 后序\nAction和SCF不一样 没有多出口 但是可以多开Action，然后实现多ip访问的目的\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsh3d0ww01f%2Fwaterdragon","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsh3d0ww01f%2Fwaterdragon","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsh3d0ww01f%2Fwaterdragon/lists"}