{"id":13367709,"url":"https://github.com/cw1997/NATBypass","last_synced_at":"2025-03-12T20:30:51.396Z","repository":{"id":41263093,"uuid":"107445680","full_name":"cw1997/NATBypass","owner":"cw1997","description":"一款lcx.exe在golang下的实现, 可用于内网穿透, 建立TCP反弹隧道用以绕过防火墙入站限制等, This tool is used to establish reverse tunnel in NAT network environment, it can bypass firewall inbound restriction, support all functions of lcx.exe","archived":false,"fork":false,"pushed_at":"2018-11-03T06:25:10.000Z","size":29,"stargazers_count":1113,"open_issues_count":10,"forks_count":279,"subscribers_count":34,"default_branch":"master","last_synced_at":"2025-03-12T13:06:05.248Z","etag":null,"topics":["computer-network","frp","lcx","network","socket","socket-programming","tcp","tcp-client","tcp-server"],"latest_commit_sha":null,"homepage":"https://github.com/cw1997/NATBypass","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/cw1997.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2017-10-18T18:13:16.000Z","updated_at":"2025-03-10T18:01:17.000Z","dependencies_parsed_at":"2022-08-02T19:46:00.353Z","dependency_job_id":null,"html_url":"https://github.com/cw1997/NATBypass","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cw1997%2FNATBypass","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cw1997%2FNATBypass/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cw1997%2FNATBypass/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cw1997%2FNATBypass/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/cw1997","download_url":"https://codeload.github.com/cw1997/NATBypass/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243290648,"owners_count":20267755,"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":["computer-network","frp","lcx","network","socket","socket-programming","tcp","tcp-client","tcp-server"],"created_at":"2024-07-30T00:02:03.270Z","updated_at":"2025-03-12T20:30:51.359Z","avatar_url":"https://github.com/cw1997.png","language":"Go","funding_links":[],"categories":["Go","Go (531)"],"sub_categories":[],"readme":"# NATBypass (内网穿透，端口转发工具)\n一款lcx（htran）在golang下的实现\n\n通过主动连接具有公网IP的电脑打通隧道可实现内网穿透，让内网主机提供的服务能够借助外网主机来访问。软件实现的端口转发，透明代理，在主机限制入站规则但未限制出站规则的特定情况下可绕过防火墙。\n\n# build\n`go build nb.go`\n\n如果未出现任何消息则表示编译成功。（Linux哲学：没有消息就是最好的消息）\n\n执行之后Linux或Mac OS在当前目录执行./nb，Windows在当前目录执行nb.exe，如果出现欢迎信息则表示一切正常。\n\n如果编译出现错误，请检查当前系统上的golang是否被破坏，建议重装后再尝试或者直接下载已经编译好的二进制文件，下载地址见后面。\n\n如果运行出现错误，请检查您所输入的参数是否有错，或者相应的端口被占用，请更换端口重试。如果未看见欢迎消息，请给编译好的可执行文件设置权限为777。如果无法写日志，请检查当前用户是否有权限在日志文件路径的读写权限。\n\n# release\nhttps://github.com/cw1997/NATBypass/releases\n\n-v1.0.0 发布时间：2017-10-20 16:11:02 平台：Windows-386，Windows-amd64 [下载地址](https://github.com/cw1997/NATBypass/releases/tag/v1.0.0) \n\n# platform\n- Windows 7 7601 + go1.7.5(windows/amd64) 编译与测试通过\n- Ubuntu 16.04.1 + go1.6.2(linux/amd64) 编译与测试通过\n- Windows 2003 SP2 3790 + go1.9.1(windows/386) 编译与测试通过\n\n# usage\n\n### 语法\n- -listen port1 port2 \n\n### 说明\n同时监听port1端口和port2端口，当两个客户端主动连接上这两个监听端口之后，nb负责这两个端口间的数据转发。\n\n### 示例\n`nb -listen 1997 2017`\n\n---\n\n### 语法\n- -tran port1 ip:port2 \n\n### 说明\n本地开始监听port1端口，当port1端口上接收到来自客户端的主动连接之后，nb将主动连接ip:port2，并且负责port1端口和ip:port2之间的数据转发。\n\n### 示例\n`nb -tran 1997 192.168.1.2:338`\n\n---\n\n### 语法\n- -slave ip1:port1 ip2:port2\n\n### 说明\n本地开始主动连接ip1:port1主机和ip2:port2主机，当连接成功之后，nb负责这两个主机之间的数据转发。\n\n### 示例\n`nb -slave 127.0.0.1:3389 8.8.8.8:1997`\n\n---\n\n### 语法\n- log filedirpath\n\n### 示例\n`nb -listen 1997 2017 -log D:/nb`\n\n`nb -tran 1997 192.168.1.2:338 -log D:/nb`\n\n`nb -slave 127.0.0.1:3389 8.8.8.8:1997 -log D:/nb`\n\n### 说明\n`-log`为一个可选开关，其参数为日志文件所在目录。如果在前面任意一个必选开关的末尾加上该开关，那么所有转发数据将会被记录到`D:/nb/Y_m_d_H_i_s-agrs1-args2-args3.log`文件中，其中`YmdHis`以及`args`均会被替换为实际执行时的时间和参数。如果有特殊需求，可根据时间顺序，以及相关参数进行合并，以得到连续的转发数据日志记录。（由于转发数据可能并非文本文件，建议使用UltraEdit等支持二进制查看的编辑器打开）\n\n警告：不要使用包含空格以及各种特殊字符的文件路径，比如说`C:\\Documents and Settings\\Administrator\\桌面\\go\\bin`这个文件路径就是无效文件路径，因为其包含空格。\n\n注意：由于日志流记录是即时的，建议将日志文件存储在机械硬盘分区中，而不要放在包括固态硬盘，U盘，SD卡等设备，防止大量小文件写入影响这些设备的寿命。\n\n技巧：可使用Linux下的`tail -f`命令将转发数据实时显示出来。\n\n# example\n假设有外网主机`123.123.123.123:1997`和`123.123.123.123:2017`端口开放。\n\n内网主机`192.168.1.2:3389`需要转发到外网。首先在外网主机执行\n\n`nb -listen 1997 2017`\n\n作用是开辟两个用于监听内网打隧道的连接端口和其他应用客户端连接的端口。\n\n接着内网主机执行\n\n`nb -slave 127.0.0.1:3389 123.123.123.123:1997`\n\n作用是内网主机主动连接外网主机打通隧道。\n\n然后其他客户端（例如本例子中的3389远程桌面客户端）连接`123.123.123.123:2017`，就等同于连接到了内网主机的`192.168.1.2:3389`上。\n\n# TODO\n- UDP协议的转发支持\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcw1997%2FNATBypass","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcw1997%2FNATBypass","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcw1997%2FNATBypass/lists"}