{"id":42584458,"url":"https://github.com/stlswm/transponder","last_synced_at":"2026-01-28T22:39:29.421Z","repository":{"id":57550503,"uuid":"229863866","full_name":"stlswm/transponder","owner":"stlswm","description":"golang内网穿透工具（支持windows与linux）","archived":false,"fork":false,"pushed_at":"2020-05-28T07:43:08.000Z","size":24607,"stargazers_count":6,"open_issues_count":0,"forks_count":3,"subscribers_count":2,"default_branch":"master","last_synced_at":"2024-06-20T06:25:17.580Z","etag":null,"topics":["net-tools"],"latest_commit_sha":null,"homepage":"","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/stlswm.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":"2019-12-24T03:33:43.000Z","updated_at":"2024-05-10T06:54:00.000Z","dependencies_parsed_at":"2022-09-26T18:41:45.910Z","dependency_job_id":null,"html_url":"https://github.com/stlswm/transponder","commit_stats":null,"previous_names":[],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/stlswm/transponder","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stlswm%2Ftransponder","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stlswm%2Ftransponder/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stlswm%2Ftransponder/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stlswm%2Ftransponder/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/stlswm","download_url":"https://codeload.github.com/stlswm/transponder/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stlswm%2Ftransponder/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28853759,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-28T15:15:36.453Z","status":"ssl_error","status_checked_at":"2026-01-28T15:15:13.020Z","response_time":57,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":["net-tools"],"created_at":"2026-01-28T22:39:29.347Z","updated_at":"2026-01-28T22:39:29.411Z","avatar_url":"https://github.com/stlswm.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# golang内网穿透工具V2.0（支持windows与linux）\n\n#### 项目介绍\nV2版本重写了内核代码可大幅提高转发速率。\n\ntransponder内网穿透工具分为两端：外网服务器端与内网服务器端。\n\n通过该程序内网服务器可以在没有公网IP的情况下借助外网服务器对广域网提供服务（适用于有回调接口的第方应用的开发调试，如：微信公众号、支付宝接口调试）。\n\n该工具支持windows与linux等不同的操作系统。\n\n该项目使用的为P2P中继模式非UDP打洞模式（适用于http协议的内网穿透）\n\n参考链接：https://blog.csdn.net/yunlianglinfeng/article/details/54018113\n\n#### 软件架构\ngolang\n\n\n#### 工作原理\n\n1、外网服务器监听端口9090（默认，防火墙要添加入站规则）为内网服务器提供服务，用于内网服务器与外网服务器的通讯并暂存内网服务器反向连接进入连接池\n\n2、外网服务器使用使用unix套接字提供外网服务（或监听端口8080，防火墙要添加入站规则），用于接收nginx转发过来的请求（也可以直接监听端口）\n\n3、连接通路：外网nginx-\u003e外网unix套接字-\u003e外网9090-\u003e内网连接-\u003e内部80。这样就借助外网服务器的9090端口成功的连接了外网80到内网80的连接通路。\n\n内网服务器会每秒检测当前连接到外网服务器的待命连接数，少于10个后会再主动发送一批连接并通过ping包维护与外网服务器的连接。\n\n### 工作流程\n\n![工作流程](https://www.stlswm.com/uploads/20190119115122.jpg)\n\n1、内网服务器批量建立到外网服务器的9090端口的连接并授权\n\n2、外网服务unix套接字（或8080端口）接收外网网络请求并从内网到9090的连接池中取出连接，发送转发指令\n\n3、内网服务器收到转发指令并回复转发待命指令\n\n4、外网服务器收到转发待命请求开发送数据，开启数据转发\n\n5、转发完成，内网服务器释放资源关闭连接，外网服务器释放资源关闭连接\n\n#### 安装教程\n\n会golang的大朋友走这里，不会的小朋友可跳过这里\n\n1、 先下载配置解析器（安装到GOPATH的src目录）\n\ngit clone https://gitee.com/stlswm/ConfigAdapter.git\n\n2、 下载本项目（安装到GOPATH的src目录）\n\ngit clone https://gitee.com/stlswm/transponder.git\n\n3、 o啦\n\n\n#### 配置说明\n\n1. git clone 本项目或下载可执行文件（文件在bin目录下）\n\n2. 外网服务端\n\n    配置文件：\n    \n    注：开发环境新建 outer.config.json 与 与outer_server.go处于同一目录即可，生产环境保证 outer.config.json 与outer_server(与outer_server.exe)可执行文件在同一目录，修改配置文件后要重启服务\n\n        \n        { \n            \"InnerServerAddress\": \"tcp://0.0.0.0:9090\",//内网服务监听地址，内网服务器收到外网服务器通知后，会发起到该端口的连接用于处理客户端的请求\n            \"OuterServerAddress\": \"tcp://0.0.0.0:8080\",//外部服务监听地址，用于对客户端提供服务\n            \"OuterServerAddress\": \"unix:///var/run/transponderouter.sock\",//linux unix套接字的网络模式（linux建议使用该模式）\n            \"AuthKey\":\"123456\"//连接授权码（内外网必须保持一致，长度不能超过32个字符）\n        }\n\n3. 内网服务端\n\n    配置文件：\n    \n    注：开发环境新建 inner.config.json 与 inner_server.go处于同一目录即可，生产环境保证 inner.config.json 与inner_server(与inner_server.exe)可执行文件在同一目录，修改配置文件后要重启服务\n    \n        \n        {\n            \"RegisterAddress\": \"tcp://外网服务器ip:9090\",//外网服务器对内网服务器的地址（这里填写外网服务器的InnerServerAddress）\n            \"ProxyAddress\": \"tcp://127.0.0.1:80\",//本地目标服务\n            \"AuthKey\":\"123456\",//连接授权码（内外网必须保持一致，长度不能超过32个字符）\n            \"MaxFreeConn\": 50//最大空闲连接数，并发数高时可适当增大该参数\n        }\n    \n4. 启动\n\n   4.1 先启动外网服务 \n   \n   保证配置文件outer.config.json与可执行文件在同一目录\n   \n    \n    linux : ./outer_server (后台执行:nohup ./outer_server \u003e\u003e /tmp/transponder_outer.log 2\u003e\u00261 \u0026)\n    \n    windows: 通过cmd命令行运行 ./outer_server.exe\n        \n   4.2 再启动内网服务\n   \n   保证配置文件inner.config.json与可执行文件在同一目录\n   \n    linux : ./inner_server (后台执行:nohup ./inner_server \u003e\u003e /tmp/transponder_inner.log 2\u003e\u00261 \u0026)\n    \n    windows: 通过cmd命令行运行 ./inner_server.exe\n\t\t\n#### nginx配置\n\n可以使用nginx配置转发，同时也可以实现多主机配置。\n\nlinux服务器推荐使用unix套接字网络模式加快转发效率，并且可以少占用一个端口。\n\nwindows只能使用端口转发。\n\n    server {\n\t\tlisten 80;\n\t\tserver_name  www.abc.com;\n\t \n\t\taccess_log  /var/log/www.abc.com.access.log;\n\t\terror_log  /var/log/www.abc.com.error.log;\n\t\t#root   html;\n\t\t#index  index.html index.htm index.php;\n\t \n\t\t#send request to transponderouter.socket\n\t\tlocation / {\n\t\t\tproxy_pass http://unix:/var/run/transponderouter.sock:/;\n\t\t\t\n\t\t\t#proxy settings\n\t\t\tproxy_redirect     off;\n\t\t\tproxy_set_header   Host             $host;\n\t\t\tproxy_set_header   X-Real-IP        $remote_addr;\n\t\t\tproxy_set_header   X-Forwarded-For  $proxy_add_x_forwarded_for;\n\t\t\tproxy_next_upstream error timeout invalid_header http_500 http_502 http_503 http_504;\n\t\t\tproxy_max_temp_file_size 0;\n\t\t\tproxy_connect_timeout      90;\n\t\t\tproxy_send_timeout         90;\n\t\t\tproxy_read_timeout         90;\n\t\t\tproxy_buffer_size          4k;\n\t\t\tproxy_buffers              4 32k;\n\t\t\tproxy_busy_buffers_size    64k;\n\t\t\tproxy_temp_file_write_size 64k;\n\t   }\n\t}\n\n#### 参与贡献\n\n1. Fork 本项目\n2. 新建 Feat_xxx 分支\n3. 提交代码\n4. 新建 Pull Request","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fstlswm%2Ftransponder","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fstlswm%2Ftransponder","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fstlswm%2Ftransponder/lists"}