vsock-mux ssh proxy
allow the ssh-proxy to connect to cloud-hypervisor/Firecracker guests, via their unix-domain socket to AF_VSOCK multiplexer: https://github.com/cloud-hypervisor/cloud-hypervisor/blob/main/docs/vsock.md https://github.com/firecracker-microvm/firecracker/blob/main/docs/vsock.md
This commit is contained in:
committed by
Yu Watanabe
parent
12c9ebbbe4
commit
d357f129b2
@@ -24,7 +24,7 @@
|
||||
|
||||
<refsynopsisdiv>
|
||||
<programlisting>
|
||||
Host unix/* vsock/*
|
||||
Host unix/* vsock/* vsock-mux/*
|
||||
ProxyCommand /usr/lib/systemd/systemd-ssh-proxy %h %p
|
||||
ProxyUseFdpass yes
|
||||
</programlisting>
|
||||
@@ -46,7 +46,7 @@ Host unix/* vsock/*
|
||||
configuration fragment like the following:</para>
|
||||
|
||||
<programlisting>
|
||||
Host unix/* vsock/*
|
||||
Host unix/* vsock/* vsock-mux/*
|
||||
ProxyCommand /usr/lib/systemd/systemd-ssh-proxy %h %p
|
||||
ProxyUseFdpass yes
|
||||
CheckHostIP no
|
||||
@@ -64,7 +64,14 @@ Host .host
|
||||
<constant>AF_UNIX</constant> file system path to a socket will be directed to the specified socket, which
|
||||
must be of type <constant>SOCK_STREAM</constant>. Similar, SSH connections to <literal>vsock/</literal>
|
||||
followed by an <constant>AF_VSOCK</constant> CID will result in an SSH connection made to that
|
||||
CID. Moreover connecting to <literal>.host</literal> will connect to the local host via SSH, without
|
||||
CID. <literal>vsock-mux/</literal> followed by an absolute <constant>AF_UNIX</constant> file system
|
||||
path to a socket is similar but for cloud-hypervisor/firecracker which don't allow
|
||||
direct <constant>AF_VSOCK</constant> communication between the host and guests, and provide their own
|
||||
multiplexer over <constant>AF_UNIX</constant> sockets. See
|
||||
<ulink url="https://github.com/cloud-hypervisor/cloud-hypervisor/blob/main/docs/vsock.md">cloud-hypervisor VSOCK support</ulink>
|
||||
and <ulink url="https://github.com/firecracker-microvm/firecracker/blob/main/docs/vsock.md">Using the Firecracker Virtio-vsock Device</ulink>.</para>
|
||||
|
||||
<para>Moreover connecting to <literal>.host</literal> will connect to the local host via SSH, without
|
||||
involving networking.</para>
|
||||
|
||||
<para>This tool is supposed to be used together with
|
||||
@@ -89,6 +96,12 @@ Host .host
|
||||
<title>Talk to a local VM with CID 4711</title>
|
||||
|
||||
<programlisting>ssh vsock/4711</programlisting>
|
||||
</example>
|
||||
|
||||
<example>
|
||||
<title>Talk to a VM guest hosted with cloud-hypervisor/firecracker</title>
|
||||
|
||||
<programlisting>ssh vsock-mux/run/vm-1234.sock</programlisting>
|
||||
</example>
|
||||
|
||||
<example>
|
||||
|
||||
Reference in New Issue
Block a user