mirror of
https://github.com/openziti/zrok.git
synced 2025-07-25 01:45:37 +02:00
.github
agent
bin
build
cmd
controller
docker
docs
_attic
concepts
_backend_http.mdx
_category_.json
files.md
hosting.md
http.md
index.md
opensource.md
sharing-private.mdx
sharing-public.mdx
sharing-reserved.md
tunnels.md
guides
images
getting-started.mdx
drives
endpoints
environment
etc
google
nfpm
rest_client_zrok
rest_model_zrok
rest_server_zrok
sdk
specs
tui
ui
util
website
.flake8
.gitattributes
.gitignore
.goreleaser-darwin.yml
.goreleaser-linux-amd64.yml
.goreleaser-linux-arm64.yml
.goreleaser-linux-armel.yml
.goreleaser-linux-armhf.yml
.goreleaser-release.yml
.goreleaser-windows.yml
.markdownlint.yaml
ACKNOWLEDGEMENTS.md
BUILD.md
CHANGELOG.md
CODE_OF_CONDUCT.md
CONTRIBUTING.md
LICENSE
README.md
RELEASING.md
SECURITY.md
go.mod
go.sum
openapitools.json
52 lines
1.6 KiB
Markdown
52 lines
1.6 KiB
Markdown
---
|
|
title: Sharing Websites and Files
|
|
sidebar_position: 30
|
|
---
|
|
|
|
With `zrok` it is possible to share files quickly and easily as well. To share files using `zrok` use
|
|
the `--backend-mode web`, for example: `zrok share private . --backend-mode web`.
|
|
|
|
Running with this mode will make it trivially easy to share files from the directory which the command
|
|
was run from.
|
|
|
|
For example if you have a directory with a structure like this:
|
|
|
|
```shell
|
|
-rw-r--r--+ 1 Michael None 7090 Apr 17 12:53 CHANGELOG.md
|
|
-rw-r--r--+ 1 Michael None 11346 Apr 17 12:53 LICENSE
|
|
-rw-r--r--+ 1 Michael None 2885 Apr 17 12:53 README.md
|
|
-rwxr-xr-x+ 1 Michael None 44250624 Apr 17 13:00 zrok.exe*
|
|
```
|
|
|
|
The files can be shared using a command such as:
|
|
|
|
```shell
|
|
zrok share public --backend-mode web .
|
|
```
|
|
|
|
Then the files can be access with a `private` or `public` share, for example as shown:
|
|
|
|

|
|
|
|
`zrok` will automatically provide a stock website, which will allow the accessing user to browse and navigate the file tree. Clicking the files allows the user to download them.
|
|
|
|
`zrok` can also share a pre-rendered static HTML website. If you have a directory like this:
|
|
|
|
```shell
|
|
-rw-rw-r--+ 1 Michael None 56 Jun 26 13:23 index.html
|
|
```
|
|
|
|
If `index.html` contains valid HTML, like this:
|
|
|
|
```html
|
|
<html>
|
|
<body>
|
|
<h1>Hello <code>zrok</code></h1>
|
|
</html>
|
|
```
|
|
|
|
Sharing the directory will result in the following when you access the share in a web browser:
|
|
|
|

|
|
|
|
`zrok` contains a built-in web server, which you can use to serve static websites as a share. |