mirror of
https://github.com/openziti/zrok.git
synced 2025-06-19 17:27:54 +02:00
updated screenies (#877)
This commit is contained in:
parent
c9449c81d2
commit
cdeba322fa
@ -211,50 +211,17 @@ Resources that are shared _publicly_ are exposed to any users on the internet wh
|
||||
|
||||
A frontend is an HTTPS listener exposed to the internet, that lets any user with your ephemeral share token access your publicly shared resources.
|
||||
|
||||
For example, I might create a public share using the `zrok share public` command, which results in my `zrok` instance exposing a URL like `https://2ptgbr8tlfvk.share.zrok.io` to access my resources.
|
||||
For example, I might create a public share using the `zrok share public` command, which results in my `zrok` instance exposing a URL like `https://xxr2b7tzfx64.share.zrok.io` to access my resources.
|
||||
|
||||
In this case, my share was given the "share token" of `2ptgbr8tlfvk`. That URL can be given to any user, allowing them to immediately access the shared resources directly from my local environment, all without exposing any access to my private, secure environment. The physical network location of my environment is not exposed to anonymous consumers of my resources.
|
||||
|
||||
:::note
|
||||
Here is the `--help` output from `zrok share public`:
|
||||
|
||||
```text
|
||||
zrok share public
|
||||
```
|
||||
$ zrok share public --backend-mode web .
|
||||
```
|
||||
|
||||
```buttonless title="Output"
|
||||
Error: accepts 1 arg(s), received 0
|
||||
Usage:
|
||||
zrok share public <target> [flags]
|
||||
|
||||
Flags:
|
||||
--backend-mode string The backend mode {proxy, web, caddy, drive} (default "proxy")
|
||||
--basic-auth stringArray Basic authentication users (<username:password>,...)
|
||||
--frontends stringArray Selected frontends to use for the share (default [public])
|
||||
--headless Disable TUI and run headless
|
||||
-h, --help help for public
|
||||
--insecure Enable insecure TLS certificate validation for <target>
|
||||
|
||||
Global Flags:
|
||||
-p, --panic Panic instead of showing pretty errors
|
||||
-v, --verbose Enable verbose logging
|
||||
|
||||
[ERROR]: an error occurred (accepts 1 arg(s), received 0)
|
||||
```
|
||||
|
||||
`<target>` defines the path to the local resource that you intend to share. The form of `<target>` depends on the `--backend-mode` that you're using.
|
||||
|
||||
In the case of `--backend-mode proxy`, `<target>` should be a URL to an HTTP endpoint.
|
||||
|
||||
In the case of `--backend-mode web`, `<target>` is the path to a file on disk that serves as the "root" of the file tree to be shared.
|
||||
:::
|
||||
In this case, my share was given the "share token" of `xxr2b7tzfx64`. That URL can be given to any user, allowing them to immediately access the shared resources directly from my local environment, all without exposing any access to my private, secure environment. The physical network location of my environment is not exposed to anonymous consumers of my resources.
|
||||
|
||||
If we return to the web console, we see our share in the explorer:
|
||||
|
||||

|
||||
|
||||
If we click on our new share in the explorer, we can see the share details:
|
||||

|
||||

|
||||
|
||||
If we click on the _frontend endpoint_ a new browser tab opens and we see the content of our share:
|
||||

|
||||
|
0
docs/images/zrok-visualizer-environment.png
Executable file → Normal file
0
docs/images/zrok-visualizer-environment.png
Executable file → Normal file
Before Width: | Height: | Size: 232 KiB After Width: | Height: | Size: 232 KiB |
BIN
docs/images/zrok-visualizer-public-share.png
Normal file
BIN
docs/images/zrok-visualizer-public-share.png
Normal file
Binary file not shown.
After Width: | Height: | Size: 307 KiB |
BIN
docs/images/zrok-visualizer-sparklines.png
Normal file
BIN
docs/images/zrok-visualizer-sparklines.png
Normal file
Binary file not shown.
After Width: | Height: | Size: 308 KiB |
0
docs/images/zrok-zoom-to-fit.png
Executable file → Normal file
0
docs/images/zrok-zoom-to-fit.png
Executable file → Normal file
Before Width: | Height: | Size: 3.6 KiB After Width: | Height: | Size: 3.6 KiB |
Loading…
x
Reference in New Issue
Block a user