zrok/docs/concepts/sharing-public.md

16 lines
994 B
Markdown
Raw Permalink Normal View History

2023-02-02 03:38:42 +01:00
---
sidebar_position: 10
---
2023-06-26 18:06:33 +02:00
# Public Shares
2023-02-02 03:38:42 +01:00
2023-06-26 17:52:51 +02:00
`zrok` supports `public` sharing for web-based (HTTP and HTTPS) resources. These resources are easily shared with the general internet through public access points.
2023-02-02 03:38:42 +01:00
2023-06-26 17:52:51 +02:00
## Peer to Public
2023-02-02 03:38:42 +01:00
![zrok_public_share](../images/zrok_public_share.png)
2023-06-26 17:52:51 +02:00
`public` sharing is most useful when the person or service accessing your resources does not have `zrok` running locally and cannot make use of the `private` sharing mode built into `zrok`. Many users share development web servers, webhooks, and other HTTP/HTTPS resources.
2023-02-02 03:38:42 +01:00
2023-06-26 17:52:51 +02:00
As with `private` sharing, `public` sharing does not require you to open any firewall ports or otherwise compromise the security of your local environments. A `public` share goes away as soon as you terminate the `zrok share` command.
2023-02-02 03:38:42 +01:00
2023-06-26 17:52:51 +02:00
Using `public` shares is easy and is accomplished using the `zrok share public` command. Run `zrok share public` to see the command-line help and to learn how to use `public` shares.