Este é o comando websockify que pode ser executado no provedor de hospedagem gratuita OnWorks usando uma de nossas várias estações de trabalho online gratuitas, como Ubuntu Online, Fedora Online, emulador online do Windows ou emulador online do MAC OS
PROGRAMA:
NOME
websockify - ponte de soquete WebSockets para TCP
SINOPSE
websockify [opções] [source_addr:] source_port target_addr: target_port
websockify [opções] [source_addr:] source_port - WRAP_COMMAND_LINE
OPÇÕES
-h, --help mostra esta mensagem de ajuda e sai
-v, --verbose mensagens verbosas e tráfego por frame
--record = FILE grava sessões em FILE. [número_da_sessão]
-D, --daemon torna-se um daemon (processo em segundo plano)
--run-once manipula uma única conexão WebSocket e sai
--timeout = TIMEOUT após TIMEOUT segundos saem quando não conectado
--cert = Arquivo de certificado SSL CERT
--key = arquivo de chave SSL KEY (se separado do certificado)
--ssl-only não permite conexões não criptografadas
--web = DIR executa o servidor web na mesma porta. Servir arquivos do DIR.
--wrap-mode = MODE ação a ser executada quando o programa empacotado sai ou
daemonizes: sair (padrão), ignorar, reaparecer
DESCRIÇÃO
No nível mais básico, websockify apenas traduz o tráfego de WebSockets para TCP normal
tráfego de soquete. O Websockify aceita o handshake WebSockets, analisa-o e começa
encaminhar o tráfego entre o cliente e o destino em ambas as direções.
websockify era anteriormente denominado wsproxy e fazia parte do projeto noVNC.
NOTAS
WebSockets binário dados,
Websockify oferece suporte a todas as versões do protocolo WebSockets (Hixie e HyBI). O mais velho
As versões Hixie do protocolo suportam apenas cargas úteis de texto UTF-8. Para transportar
dados binários em UTF-8, uma codificação deve ser usada para encapsular os dados em UTF-8.
Websockify usa base64 para codificar todo o tráfego de e para o cliente. Isso não afeta
os dados entre websockify e o servidor.
Criptografado WebSocket conexões (wss: //)
Para criptografar o tráfego usando o esquema de URI WebSocket 'wss: //', você precisa gerar um
certificado para o websockify carregar. Por padrão, websockify carrega um nome de arquivo de certificado
self.pem mas a opção --cert = CERT pode sobrescrever o nome do arquivo. Você pode gerar um self-
certificado assinado usando o openssl. Quando perguntado pelo nome comum, use o nome do host do
servidor onde o proxy será executado:
openssl req -new -x509 -days 365 -nodes -out self.pem -keyout self.pem
Websock Javascript biblioteca
Biblioteca da biblioteca Javascript websock.js (consulte https://github.com/kanaka/websockify)
fornece um objeto Websock que é semelhante ao objeto WebSocket padrão, mas Websock
permite a comunicação com soquetes TCP brutos (ou seja, o fluxo binário) via websockify. Esse
é realizado pela codificação base64 do fluxo de dados entre Websock e websockify.
Websock tem buffer de fila de recepção embutido; o evento de mensagem não contém
dados, mas é simplesmente uma notificação de que há novos dados disponíveis. Vários métodos rQ *
estão disponíveis para ler dados binários da fila de recebimento.
A API Websock está documentada na página wiki da API websock.js:
https://github.com/kanaka/websockify/wiki/websock.js
Consulte a seção "Wrap a Program" abaixo para obter um exemplo de uso do Websock e websockify como um
cliente telnet do navegador (wstelnet.html).
Adicional websockify características
Eles não são necessários para a operação básica.
* Daemonização: Quando a opção -D é especificada, websockify é executado em segundo plano como
um processo daemon.
* SSL (o wss: // URI WebSockets): Isso é detectado automaticamente pelo websockify por
farejar o primeiro byte enviado do cliente e, em seguida, encapsular o soquete se o
os dados começam com '\ x16' ou '\ x80' (indicando SSL).
* Política de segurança Flash: websockify detecta solicitações de política de segurança flash (novamente por
farejando o primeiro pacote) e responde com uma política de segurança flash apropriada
resposta (e então fecha a porta). Isso significa que não há política de segurança flash separada
é necessário servidor para suportar o emulador flash WebSockets fallback.
* Gravação de sessão: Este recurso que permite o registro do tráfego enviado e
recebido do cliente para um arquivo usando a opção --record.
* Mini-servidor da web: websockify pode detectar e responder às solicitações normais da web no
mesma porta do proxy WebSockets e política de segurança Flash. Esta funcionalidade é
ative com a opção --web DIR onde DIR é a raiz do diretório da web para
servir.
* Encerrar um programa: consulte a seção "Encerrar um programa" abaixo.
Embrulhe a Agenda
Além de fazer proxy de um endereço de origem para um endereço de destino (que pode estar em um
sistema diferente), o websockify tem a capacidade de lançar um programa no sistema local e
tráfego de WebSockets de proxy para uma porta TCP normal pertencente / vinculada pelo programa.
O é realizado com uma pequena biblioteca LD_PRELOAD (rebind.so) que intercepta bind ()
chamadas de sistema pelo programa. A porta especificada é movida para um novo localhost / loopback livre
porto alto. websockify, em seguida, faz proxy do tráfego de WebSockets direcionado à porta original para o
nova porta (movida) do programa.
O modo de agrupamento do programa é invocado substituindo o destino por - seguido pelo programa
linha de comando para quebrar.
`./websockify 2023 - ARGS DO PROGRAMA`
A opção --wrap-mode pode ser usada para indicar qual ação tomar quando o empacotado
o programa sai ou daemoniza.
Aqui está um exemplo de como usar websockify para envolver o comando vncserver (que fundos
em si) para uso com noVNC:
`./websockify 5901 --wrap-mode = ignore - vncserver -geometry 1024x768: 1`
Aqui está um exemplo de empacotamento de telnetd (de krb5-telnetd) .telnetd sai após o
a conexão fecha para que o modo de agrupamento seja definido para reiniciar o comando:
`sudo ./websockify 2023 --wrap-mode = respawn - telnetd -debug 2023`
A página wstelnet.html demonstra um cliente telnet simples baseado em WebSockets.
Use websockify online usando serviços onworks.net
