{"id":35734286,"url":"https://github.com/dimaskiddo/dns-to-tcp","last_synced_at":"2026-01-25T05:35:25.835Z","repository":{"id":332412288,"uuid":"1128865720","full_name":"dimaskiddo/dns-to-tcp","owner":"dimaskiddo","description":"DNS UDP-to-TCP Bridge","archived":false,"fork":false,"pushed_at":"2026-01-06T10:10:37.000Z","size":9,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2026-01-13T19:56:30.687Z","etag":null,"topics":["bridge","converter","dns","packet","tcp","to","udp"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/dimaskiddo.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,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-01-06T09:06:06.000Z","updated_at":"2026-01-13T10:33:36.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/dimaskiddo/dns-to-tcp","commit_stats":null,"previous_names":["dimaskiddo/dns-to-tcp"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/dimaskiddo/dns-to-tcp","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dimaskiddo%2Fdns-to-tcp","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dimaskiddo%2Fdns-to-tcp/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dimaskiddo%2Fdns-to-tcp/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dimaskiddo%2Fdns-to-tcp/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/dimaskiddo","download_url":"https://codeload.github.com/dimaskiddo/dns-to-tcp/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dimaskiddo%2Fdns-to-tcp/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28744429,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-25T05:12:38.112Z","status":"ssl_error","status_checked_at":"2026-01-25T05:04:50.338Z","response_time":113,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: 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":["bridge","converter","dns","packet","tcp","to","udp"],"created_at":"2026-01-06T12:10:55.223Z","updated_at":"2026-01-25T05:35:25.829Z","avatar_url":"https://github.com/dimaskiddo.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# DNS UDP-to-TCP Bridge\n\nA tool to help converting and acting as a bridge for DNS UDP packet to TCP packet format.\n\nThis case used if you just have a DNS on TCP listener like when using SSH Tunnel to forward the DNS TCP port to your main server but most DNS client request is using UDP packet format.\n\n## Getting Started\n\nThese instructions will get you a copy of the project up and running on your local machine for development and testing purposes.\nSee deployment section for notes on how to deploy the project on a live system.\n\n### Prerequisites\n\nPrequisites packages:\n* Go (Go Programming Language)\n* GoReleaser (Go Automated Binaries Build)\n* Make (Automated Execution using Makefile)\n\nOptional packages:\n* Docker (Application Containerization)\n\n### Deployment\n\n#### **Using Container**\n\n1) Install Docker CE based on the [manual documentation](https://docs.docker.com/desktop/)\n\n2) Run the following command on your Terminal or PowerShell\n```sh\ndocker run -d \\\n  -p \u003cUDP_PORT\u003e:\u003cUDP_PORT\u003e\n  --name dns-to-tcp \\\n  --rm dimaskiddo/dns-to-tcp:latest \\\n  dns-to-tcp -lh 0.0.0.0 -lp \u003cUDP_PORT\u003e -rh \u003cREMOTE_TCP_IP\u003e -rp \u003cREMOTE_TCP_PORT\u003e -p \u003cCONNECTION_POOL_SIZE\u003e\n\n# Example of Usage\n\ndocker run -d \\\n  -p 53:53\n  --name dns-to-tcp \\\n  --rm dimaskiddo/dns-to-tcp:latest \\\n  dns-to-tcp -lh 0.0.0.0 -lp 53 -rh 9.9.9.9 -rp 9953 -p 1024\n```\n\n#### **Using Pre-Build Binaries**\n\n1) Download Pre-Build Binaries from the [release page](https://github.com/dimaskiddo/dns-to-tcp/releases)\n\n2) Extract the zipped file\n\n3) Run the pre-build binary\n```sh\n# MacOS / Linux\nchmod 755 dns-to-tcp\n# -- Example of Usage\n# -- ./dns-to-tcp -lh 0.0.0.0 -lp \u003cUDP_PORT\u003e -rh \u003cREMOTE_TCP_IP\u003e -rp \u003cREMOTE_TCP_PORT\u003e -p \u003cCONNECTION_POOL_SIZE\u003e\n./dns-to-tcp -lh 0.0.0.0 -lp 53 -rh 9.9.9.9 -rp 9953 -p 1024\n\n# Windows\n# You can double click it or using PowerShell\n# -- Example of Usage\n# -- .\\dns-to-tcp.exe -lh 0.0.0.0 -lp \u003cUDP_PORT\u003e -rh \u003cREMOTE_TCP_IP\u003e -rp \u003cREMOTE_TCP_PORT\u003e -p \u003cCONNECTION_POOL_SIZE\u003e\n.\\dns-to-tcp.exe -lh 0.0.0.0 -lp 53 -rh 9.9.9.9 -rp 9953 -p 1024\n```\n\n#### **Build From Source**\n\nBelow is the instructions to make this source code running:\n\n1) Create a Go Workspace directory and export it as the extended GOPATH directory\n```sh\ncd \u003cyour_go_workspace_directory\u003e\nexport GOPATH=$GOPATH:\"`pwd`\"\n```\n\n2) Under the Go Workspace directory create a source directory\n```sh\nmkdir -p src/github.com/dimaskiddo/dns-to-tcp\n```\n\n3) Move to the created directory and pull codebase\n```sh\ncd src/github.com/dimaskiddo/dns-to-tcp\ngit clone -b master https://github.com/dimaskiddo/dns-to-tcp.git .\n```\n\n4) Run following command to pull vendor packages\n```sh\nmake vendor\n```\n\n5) Until this step you already can run this code by using this command\n```sh\nmake run\n```\n\n6) *(Optional)* Use following command to build this code into binary spesific platform\n```sh\nmake build\n```\n\n7) *(Optional)* To make mass binaries distribution you can use following command\n```sh\nmake release\n```\n\n### Running The Tests\n\nCurrently the test is not ready yet :)\n\n## Built With\n\n* [Go](https://golang.org/) - Go Programming Languange\n* [GoReleaser](https://github.com/goreleaser/goreleaser) - Go Automated Binaries Build\n* [Make](https://www.gnu.org/software/make/) - GNU Make Automated Execution\n* [Docker](https://www.docker.com/) - Application Containerization\n\n## Authors\n\n* **Dimas Restu Hidayanto** - *Initial Work* - [DimasKiddo](https://github.com/dimaskiddo)\n\nSee also the list of [contributors](https://github.com/dimaskiddo/dns-to-tcp/contributors) who participated in this project\n\n## Annotation\n\nYou can seek more information for the make command parameters in the [Makefile](https://github.com/dimaskiddo/dns-to-tcp/-/raw/master/Makefile)\n\n## License\n\nCopyright (C) 2026 Dimas Restu Hidayanto\n\nPermission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the \"Software\"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdimaskiddo%2Fdns-to-tcp","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdimaskiddo%2Fdns-to-tcp","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdimaskiddo%2Fdns-to-tcp/lists"}