streamhut

strever

Diffusez et envoyez des données, terminal sur le Web et vice versa.

Synopsis

• Diffusez votre terminal vers quiconque sans rien installer.
• Noms de chemin MAP vers les canaux.
• Quiconque dans le même canal peut voir ce qui est diffusé.
• Auto-hébergez facilement votre propre serveur Streamhut.

StreamHut vous permet de diffuser (tuyau) des données en temps réel de votre terminal stdout / stderr vers une interface utilisateur web xterm ou même vers un autre terminal. Il vous permet également de partager rapidement les données et les fichiers entre les appareils.

Tant que vous avez netcat qui vient préinstallé dans la plupart des systèmes * Nix que vous pouvez utiliser StreamHut! Si vous ne pouvez pas installer NetCAT, vous pouvez également utiliser le client StreamHut CLI.

️ Avertissement: Ce logiciel est de qualité alpha et non prêt à la production. Utilisez à vos risques et périls!

Démo

https://streamhut.io

Début (sans rien installer)

Une doublure pour diffuser votre terminal:

$ exec & > >( nc stream.ht 1337 )

La commande ci-dessus tuyaux Stdout et Stderr de New Bash Shell à StreamHut.

Stream sur un nom de canal personnalisé:

$ exec & > >( nc stream.ht 1337 ) ; echo # mychannel

Exemple de streaming queue du fichier:

 # terminal 1
$ cat > data.txt

 # terminal 2
$ tail -F data.txt | nc stream.ht 1337

Diffuser la date actuelle chaque seconde:

$ while true ; do date ; sleep 1 ; done | nc stream.ht 1337

STUPPORT DE STREAT D'UN PROGRAMME (un retard est nécessaire pour voir l'URL de partage):

$ (sleep 5 ; htop) | nc stream.ht 1337
# waits 5 seconds, and then send contents of program.

Exemple de tuyauterie d'un programme à STDOUT et StreamHut:

$ (echo -n ; sleep 5 ; htop) | tee >( nc stream.ht 1337 )

Vous n'avez pas Netcat disponible? Tuyau vers un descripteur de fichier avec une connexion TCP ouverte:

$ exec 3<> /dev/tcp/stream.ht/1337 && head -1 < & 3 && exec & > >( tee >( cat >&3 ) ) 

Installer

$ go get github.com/streamhut/streamhut

CLI

Exemple d'utilisation de Streamhut CLI:

Stream vers le serveur

Commandes de tuyauterie:

$ htop | streamhut

Ajouter un retard pour voir l'URL de partage:

$ htop | streamhut -d 5

URL ouverte dans le navigateur:

$ htop | streamhut -o

Stream vers un serveur différent:

$ htop | streamhut -h example.com -p 1337

Canal de flux vers personnalisé:

$ htop | streamhut -c mychannel

Pour plus d'options, exécutez streamhut --help

Exécutez votre propre serveur:

$ streamhut server

Starting server...
HTTP/WebSocket port: 8080
TCP port: 1337

Exécutez le serveur avec SSL / TLS:

$ mkcert localhost

$ sudo streamhut server --tls --tls-cert=localhost.pem --tls-key=localhost-key.pem -p 443

Pour plus d'options, exécutez streamhut server --help

Connexion à un canal

 # terminal 1
$ streamhut connect -c mychannel

Pour plus d'options, exécutez streamhut connect --help

Docker

Vous pouvez exécuter StreamHut en tant que conteneur Docker:

$ docker pull streamhut/streamhut
$ docker run -e PORT=8080 -e TCP_PORT=1337 -p 8080:8080 -p 1337:1337 --restart unless-stopped streamhut/streamhut:latest

Auto-host (docker one-liner)

One-liner à l'auto-hébergement à l'aide de Docker:

docker run -p 8080:8080 -p 1337:1337 streamhut/streamhut

Test

make test 

Développement

SERVICE DE START:

make start

Exécuter des migrations:

make migrate

Application Web

Le code source de l'application Web se trouve sur https://github.com/streamhut/web.

FAQ

• Q: Comment les données de journal du flux sont-elles stockées?

  • R: Actuellement, il est stocké dans une base de données SQLite3 locale. Vous pouvez désactiver le stockage avec l'indicateur --no-storage , par exemple streamhut server --no-storage .

• Q: Qu'est-il arrivé au module StreamHut NPM?

  • R: L'implémentation Node.js de StreamHut est désormais obsolète en faveur de cette implémentation de Golang.

• Q: Le même canal peut-il être utilisé plus d'une fois?

  • R: Oui! Envoyer #{channel} (c'est-à-dire #mychannel ) comme premier texte de flux pour utiliser ce canal.

    Exemple:

     exec & > >( nc stream.ht 1337 ) ; echo # mychannel

• Q: Quelle est la différence entre Stream.ht et StreamHut.io ?

  • A: le domaine stream.ht est un alias pour streamhut.io , ce qui signifie que vous pouvez taper Stream.ht comme domaine pour la commodité. Les autres alias sont Streamhut.net et Streamhut.org .

• Q: Quelle est la différence entre exec > >(nc stream.ht 1337) 2>&1 et exec &> >(nc stream.ht 1337)

  • R: Ils sont les mêmes en ce qu'ils diffusent tous les deux Stdout et Stderr au serveur.

Licence

Libéré sous la licence Apache 2.0.

© Miguel Mota