nwtgck/piping-server
Infinitely transfer between every device over pure HTTP: designed for everyone including people using Unix pipe and even for browser users
repo name | nwtgck/piping-server |
repo link | https://github.com/nwtgck/piping-server |
homepage | |
language | TypeScript |
size (curr.) | 23379 kB |
stars (curr.) | 1488 |
created | 2018-09-17 |
license | MIT License |
Piping Server
Infinitely transfer between every device over HTTP/HTTPS
Transfer
Piping Server is simple. You can transfer as follows.
# Send
echo 'hello, world' | curl -T - https://ppng.io/hello
# Get
curl https://ppng.io/hello > hello.txt
Piping Server transfers data to POST /hello
or PUT /hello
into GET /hello
. The path /hello
can be anything such as /mypath
or /mypath/123/
. A sender and receivers who specify the same path can transfer. Both the sender and the recipient can start the transfer first. The first one waits for the other.
You can also use Web UI like https://ppng.io on your browser. A more modern UI is found in https://piping-ui.org, which supports E2E encryption.
Stream
The most important thing is that the data are streamed. This means that you can transfer any data infinitely. The demo below transfers an infinite text stream with seq inf
.
Ideas
Piping Server is designed based on the ideas as follows.
- Infinite transfer: You can transfer any kind of data infinitely on a stream. Streams are very efficient in terms of both time and space.
- Zero installation: All you need is to have either a Web browser or
curl
, which are widely pre-installed. You do not need to install any extra software. - Simpleness: Making simple makes it more secure.
- Storageless: The server makes transfer more secure since the server never stores your data.
- Purity: The server streams over pure HTTP, which makes integration easier with other softwares.
- Engineer friendly: Also designed for Unix/Linux users, who use pipes, not only for Web browser users.
Applications
Any data such as text streams, video streams and protocols can be streamed over Piping Server. Here are applications that fully use the power of pure HTTP.
See: “The Power of Pure HTTP – screen share, real-time messaging, SSH and VNC”
The most important thing is that Piping Server stays simple. The applications use Piping Server as a core of data communication. It transfers data to POST /thepath
into GET /thepath
streamingly. The stream makes real-time communications over every device possible.
See “Ecosystem around Piping Server · nwtgck/piping-server Wiki” to find more about softwares using Piping Server.
Power of HTTP
In my experiment, Piping Server transferred 1,110TB (≈ 1PB) in a single HTTP request for 64 days and 2 hours at least. This means that it can transfer huge data and keep a request for about 2 months.
Engineer-friendly help
Get help and version only with curl
.
curl https://ppng.io/help
curl https://ppng.io/version
Transfer to multiple receivers
You can transfer to multiple receivers. In the demo below, query parameter ?n=3
is specified to allow three receivers.
Server on Docker
Run a Piping Server on http://localhost:8080 as follows.
docker run -p 8080:8080 nwtgck/piping-server
Run a server in background and it automatically always restarts.
docker run -p 8080:8080 -d --restart=always nwtgck/piping-server
Command-line options
Here is available CLI options by piping-server --help
.
Options:
--help Show help [boolean]
--version Show version number [boolean]
--http-port Port of HTTP server [default: 8080]
--enable-https Enable HTTPS [default: false]
--https-port Port of HTTPS server [number]
--key-path Private key path [string]
--crt-path Certification path [string]
Heroku deployment
Click the button above to deploy a Piping Server to Heroku.
Piping Server written in Rust
Piping Server is also developed in Rust.
https://github.com/nwtgck/piping-server-rust