{"id":15297116,"url":"https://github.com/nwtgck/tcphttp-server","last_synced_at":"2025-04-13T23:01:40.542Z","repository":{"id":48319520,"uuid":"158089929","full_name":"nwtgck/tcphttp-server","owner":"nwtgck","description":"TCP-over-HTTP server: Clients can use it with curl and perhaps browser","archived":false,"fork":false,"pushed_at":"2022-01-16T04:37:04.000Z","size":166,"stargazers_count":5,"open_issues_count":10,"forks_count":2,"subscribers_count":2,"default_branch":"develop","last_synced_at":"2025-03-27T13:12:46.568Z","etag":null,"topics":["http","http-server","nodejs","tcp","tcp-over-http"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","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/nwtgck.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","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":"2018-11-18T14:04:10.000Z","updated_at":"2022-12-15T06:12:21.000Z","dependencies_parsed_at":"2022-08-19T18:51:05.027Z","dependency_job_id":null,"html_url":"https://github.com/nwtgck/tcphttp-server","commit_stats":null,"previous_names":[],"tags_count":10,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nwtgck%2Ftcphttp-server","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nwtgck%2Ftcphttp-server/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nwtgck%2Ftcphttp-server/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nwtgck%2Ftcphttp-server/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/nwtgck","download_url":"https://codeload.github.com/nwtgck/tcphttp-server/tar.gz/refs/heads/develop","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248794565,"owners_count":21162614,"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":["http","http-server","nodejs","tcp","tcp-over-http"],"created_at":"2024-09-30T19:15:12.354Z","updated_at":"2025-04-13T23:01:40.509Z","avatar_url":"https://github.com/nwtgck.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# tcphttp-server\n[![npm](https://img.shields.io/npm/v/tcphttp-server.svg)](https://www.npmjs.com/package/tcphttp-server) [![Build Status](https://travis-ci.com/nwtgck/tcphttp-server.svg?token=TuxNpqznwwyy7hyJwBVm\u0026branch=develop)](https://travis-ci.com/nwtgck/tcphttp-server) \n[![Docker Automated build](https://img.shields.io/docker/automated/nwtgck/tcphttp-server.svg)](https://hub.docker.com/r/nwtgck/tcphttp-server/) [![](https://images.microbadger.com/badges/image/nwtgck/tcphttp-server.svg)](https://microbadger.com/images/nwtgck/tcphttp-server \"Get your own image badge on microbadger.com\")\n\n[![Deploy](https://www.herokucdn.com/deploy/button.svg)](https://heroku.com/deploy)\n\nTCP over HTTP server\n\n## Quick Start\n\nHere is examples to show how to use TCP over HTTP. Actually, the following examples show \"HTTP over HTTPS\" and \"HTTPS over HTTPS\".  \n\nHere is an example to request to example.com.\n\n```bash\ncurl --data-binary @- 'https://tcphttp.glitch.me?host=example.com\u0026port=80' \u003c\u003cEOS\nGET / HTTP/1.1\nHost: example.com\nConnection: close\n\n\nEOS\n```\n\n\nHere is an example to use HTTPS.\n\n```bash\ncurl --data-binary @- 'https://tcphttp.glitch.me?host=example.com\u0026port=443\u0026tls' \u003c\u003cEOS\nGET / HTTP/1.1\nHost: example.com\nConnection: close\n\n\nEOS\n```\n\n## Connection Flow\n\n![TCPHTTP Server Connection Flow](doc-assets/connection-flow.svg)\n\n## Run Server \n\n### Way 1: Run server on Heroku\n\nClick the button below and run a server.\n\n[![Deploy](https://www.herokucdn.com/deploy/button.svg)](https://heroku.com/deploy)\n\n### Way 2: Run server on Docker\n\nRun a tcphttp-server on \u003chttp://localhost:8181\u003e by the following command.\n\n```bash\ndocker run -p 8181:8080 nwtgck/tcphttp-server\n```\n\nYou can also specify options as follows. \n\n```bash\ndocker run -p 8181:80 nwtgck/tcphttp-server --http-port=80\n```\n\n### Way 3: Run server with npm\n\nInstall `tcphttp-server` as command as follows. \n\n```bash\nnpm install -g tcphttp-server\n```\n\nThen, run a server as follows.\n\n```bash\ntcphttp-server --http-port=8181\n```\n\n### Way 4: Run server from source \n\nRun a server from the latest source.\n\n```bash\n# Clone this repository\ngit clone https://github.com/nwtgck/tcphttp-server.git\n# Go to the directory\ncd tcphttp-server\n# Install dependencies\nnpm install\n# Run a server\nnpm start\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnwtgck%2Ftcphttp-server","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnwtgck%2Ftcphttp-server","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnwtgck%2Ftcphttp-server/lists"}