extern/zrok
1
1
Fork 0
mirror of https://github.com/openziti/zrok.git synced 2025-01-08 23:20:04 +01:00
Code Issues Packages Projects Releases Wiki Activity

better screenies

Browse Source
This commit is contained in:
Michael Quigley 2023-06-26 13:11:29 -04:00
parent 4abc4321d4
commit c02b1016b8
No known key found for this signature in database
GPG Key ID: 9B60314A9DD20A62
1 changed files with 37 additions and 65 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

102
docs/concepts/tunnels.md
View File

@ -17,23 +17,15 @@ $ zrok share private --backend-mode tcpTunnel 192.168.9.1:22
This will result in a share client starting, which looks like this: This will result in a share client starting, which looks like this:
``` ```
╭───────────────────────────────────────────────────────────╮╭──────────────────────────╮ ╭───────────────────────────────────────────────────────────╮╭────────────────────╮
│ access your share with: zrok access private 5adagwfl888k ││ [PRIVATE] [TCPTUNNEL] │ │ access your share with: zrok access private 5adagwfl888k ││[PRIVATE][TCPTUNNEL]│
╰───────────────────────────────────────────────────────────╯╰──────────────────────────╯ ╰───────────────────────────────────────────────────────────╯╰────────────────────╯
╭───────────────────────────────────────────────────────────────────────────────────────╮ ╭─────────────────────────────────────────────────────────────────────────────────╮
│ │ │ │
│ │ │ │
│ │ │ │
│ │ │ │
│ │ ╰─────────────────────────────────────────────────────────────────────────────────╯
│ │
│ │
│ │
│ │
│ │
│ │
╰───────────────────────────────────────────────────────────────────────────────────────╯
``` ```
Then on the system where you want to access your shared resource (an SSH endpoint in this case), you'll need an `enable`-d `zrok` environment. Run the following command (shown in the banner at the top of the `zrok share` client above): Then on the system where you want to access your shared resource (an SSH endpoint in this case), you'll need an `enable`-d `zrok` environment. Run the following command (shown in the banner at the top of the `zrok share` client above):
@ -44,22 +36,15 @@ $ zrok access private 5adagwfl888k
This will start an `access` client on this system: This will start an `access` client on this system:
``` ```
╭───────────────────────────────────────────────────────────────────────────────────────╮ ╭─────────────────────────────────────────────────────────────────────────────────╮
│ tcp://127.0.0.1:9191 -> 5adagwfl888k │ │ tcp://127.0.0.1:9191 -> 5adagwfl888k │
╰───────────────────────────────────────────────────────────────────────────────────────╯ ╰─────────────────────────────────────────────────────────────────────────────────╯
╭───────────────────────────────────────────────────────────────────────────────────────╮ ╭─────────────────────────────────────────────────────────────────────────────────╮
│ │ │ │
│ │ │ │
│ │ │ │
│ │ │ │
│ │ ╰─────────────────────────────────────────────────────────────────────────────────╯
│ │
│ │
│ │
│ │
│ │
│ │
╰───────────────────────────────────────────────────────────────────────────────────────╯
``` ```
The `access` client shows the endpoint at the top where the service can be accessed. In this case, you'll want to connect your SSH client to `127.0.0.1:9191`. We'll just use `nc` (netcat) to access the shared TCP port: The `access` client shows the endpoint at the top where the service can be accessed. In this case, you'll want to connect your SSH client to `127.0.0.1:9191`. We'll just use `nc` (netcat) to access the shared TCP port:
@ -71,41 +56,28 @@ SSH-2.0-OpenSSH_9.2 FreeBSD-openssh-portable-9.2.p1,1
And both the `share` client and the `access` client show the traffic: And both the `share` client and the `access` client show the traffic:
``` ```
╭───────────────────────────────────────────────────────────╮╭──────────────────────────╮ ╭──────────────────────────────────────────────────────────╮╭─────────────────────╮
│ access your share with: zrok access private 5adagwfl888k ││ [PRIVATE] [TCPTUNNEL] │ │ access your share with: zrok access private 5adagwfl888k ││[PRIVATE] [TCPTUNNEL]│
╰───────────────────────────────────────────────────────────╯╰──────────────────────────╯ ╰──────────────────────────────────────────────────────────╯╰─────────────────────╯
╭───────────────────────────────────────────────────────────────────────────────────────╮ ╭─────────────────────────────────────────────────────────────────────────────────╮
│Friday, 23-Jun-23 15:33:10 EDT ziti-edge-router │ │Friday, 23-Jun-23 15:33:10 EDT ziti-edge-router │
│connId=2147483648, logical=ziti- │ │connId=2147483648, logical=ziti- │
│sdk[router=tls:ziti-lx:3022] -> ACCEPT 192.168.9.1:22 │ │sdk[router=tls:ziti-lx:3022] -> ACCEPT 192.168.9.1:22 │
│ │ │ │
│ │ │ │
│ │ ╰─────────────────────────────────────────────────────────────────────────────────╯
│ │
│ │
│ │
│ │
│ │
╰───────────────────────────────────────────────────────────────────────────────────────╯
``` ```
``` ```
╭───────────────────────────────────────────────────────────────────────────────────────╮ ╭─────────────────────────────────────────────────────────────────────────────────╮
│ tcp://127.0.0.1:9191 -> 5adagwfl888k │ │ tcp://127.0.0.1:9191 -> 5adagwfl888k │
╰───────────────────────────────────────────────────────────────────────────────────────╯ ╰─────────────────────────────────────────────────────────────────────────────────╯
╭───────────────────────────────────────────────────────────────────────────────────────╮ ╭─────────────────────────────────────────────────────────────────────────────────╮
│Friday, 23-Jun-23 15:33:10 EDT 127.0.0.1:42312 -> ACCEPT 5adagwfl888k │ │Friday, 23-Jun-23 15:33:10 EDT 127.0.0.1:42312 -> ACCEPT 5adagwfl888k │
│ │ │ │
│ │ │ │
│ │ │ │
│ │ ╰─────────────────────────────────────────────────────────────────────────────────╯
│ │
│ │
│ │
│ │
│ │
│ │
╰───────────────────────────────────────────────────────────────────────────────────────╯
``` ```
Exit the `access` client to remove the local access to the shared TCP port. Exit the `share` client to disable further accesses to the shared resource. Exit the `access` client to remove the local access to the shared TCP port. Exit the `share` client to disable further accesses to the shared resource.