nwtgck/piping-server

Piping Server

概述和主要用途

Piping Server是一个基于HTTP/HTTPS的无限数据传输服务器，支持在任意设备间流式传输数据。其核心设计理念是通过纯HTTP协议实现高效、安全的数据流传输，无需安装额外软件，服务器不存储任何数据，确保传输过程的简洁与安全。无论是通过命令行工具（如curl）还是Web浏览器，用户都能轻松实现数据传输，适用于文本流、视频流、协议流等多种场景，包括屏幕共享、实时消息传递、SSH和VNC等应用。

核心功能和特性

无限传输

支持任意类型数据的无限流式传输，流在时间和空间上均具有高效性，可传输无限大小的数据。

零安装

仅需浏览器或curl（广泛预装工具）即可使用，无需安装额外软件。

简单性

设计简洁，减少安全风险，降低使用和维护复杂度。

无存储

服务器不存储传输数据，提升数据安全性，避免数据泄露风险。

纯HTTP协议

基于纯HTTP协议流式传输，易于与其他软件集成，支持多种应用场景扩展。

工程师友好

兼顾Unix/Linux管道用户（支持命令行管道操作）和Web浏览器用户，提供灵活的使用方式。

使用场景和适用范围

• 文本流传输：如日志流、实时文本消息等无限文本数据传输。
• 视频流传输：支持视频数据的实时流式传输。
• 协议流传输：可传输SSH、VNC等协议数据，实现远程控制。
• 屏幕共享：通过HTTP流实现跨设备屏幕共享。
• 实时消息传递：构建基于HTTP的实时通信应用。
• 无限数据传输：适用于持续生成的监控数据、传感器数据流等场景。

使用方法和配置说明

基本传输方法

通过curl命令传输

发送数据：

bash
# 示例：发送文本数据
echo 'hello, world' | curl -T - http://localhost:8080/hello

接收数据：

bash
# 示例：接收数据并保存到文件
curl http://localhost:8080/hello > hello.txt

发送方通过POST /路径或PUT /路径发送数据，接收方通过GET /路径接收数据。路径可自定义（如/mypath、/mypath/123/），相同路径的发送方和接收方可建立传输，双方均可先启动，先启动方会等待另一方。

通过Web UI传输

• 基础Web UI：访问服务器地址（如http://localhost:8080）。
• 现代UI（支持端到端加密）：访问piping-ui.org并连接自建服务器。

流式传输

数据以流形式传输，支持无限数据传输。例如，使用seq inf生成无限文本流进行传输：

bash
# 发送无限文本流
seq inf | curl -T - http://localhost:8080/infstream

bash
# 接收无限文本流
curl http://localhost:8080/infstream

多接收者传输

通过查询参数?n=接收者数量支持多个接收者。例如，允许3个接收者：

bash
# 发送方：允许3个接收者
echo 'data for 3 receivers' | curl -T - http://localhost:8080/multipath?n=3

bash
# 接收方1
curl http://localhost:8080/multipath?n=3 > data1.txt

bash
# 接收方2
curl http://localhost:8080/multipath?n=3 > data2.txt

bash
# 接收方3
curl http://localhost:8080/multipath?n=3 > data3.txt

Docker自托管部署

基本运行

在本地http://localhost:8080启动Piping Server：

bash
docker run -p 8080:8080 docker.xuanyuan.run/nwtgck/piping-server

后台运行并自动重启

在后台运行服务器，并配置自动重启：

bash
docker run -p 8080:8080 -d --restart=always docker.xuanyuan.run/nwtgck/piping-server

命令行选项

通过Docker运行时可添加命令行参数自定义配置，格式为docker run ... nwtgck/piping-server [选项]。主要选项如下：

• --http-port：HTTP服务器端口（默认：8080）
• --enable-https：启用HTTPS（默认：false）
• --https-port：HTTPS服务器端口（需与--enable-https同时使用）
• --key-path：HTTPS私钥文件路径（需与--enable-https同时使用）
• --crt-path：HTTPS证书文件路径（需与--enable-https同时使用）

示例：启用HTTPS（需提前准备证书文件）：

bash
docker run -p 443:443 -v /path/to/certs:/certs docker.xuanyuan.run/nwtgck/piping-server --enable-https --https-port=443 --key-path=/certs/private.key --crt-path=/certs/cert.crt

公共服务器

若无需自建，可使用公共Piping Server：

• https://ppng.io（别名：https://piping.ml）
• https://piping.glitch.me
• https://piping-47q675ro2guv.runkit.sh
• https://piping.nwtgck.repl.co
• https://ppng.herokuapp.com