OpenZiti/zrok 入门指南：构建安全的互联网共享边界

OpenZiti/zrok 入门指南：构建安全的互联网共享边界

zrok Geo-scale, next-generation peer-to-peer sharing platform built on top of OpenZiti. 项目地址: https://gitcode.com/gh_mirrors/zr/zrok

什么是zrok？

zrok是一个创新的安全共享平台，它基于OpenZiti技术构建，允许用户轻松地共享网络服务或文件，同时确保高度的安全性和隐私保护。这个开源项目提供了两种使用方式：可以直接使用托管服务，也可以自行部署私有实例。

核心功能与应用场景

zrok主要解决以下几个关键场景：

1. 服务共享：将本地运行的Web服务或网络套接字安全地暴露给外部
2. 文件共享：安全地共享静态文件目录
3. 临时访问：创建临时访问通道，访问结束后自动关闭
4. 长期共享：建立保留的共享端点，支持长期访问

快速入门指南

第一步：获取账户凭证

使用zrok前，您需要获取账户令牌。有两种主要方式：

1. 使用托管服务：注册托管服务账户，这是最简单快捷的方式
2. 自建实例：在Linux、Docker或Kubernetes环境部署自己的zrok实例

第二步：安装zrok命令行工具

zrok提供了跨平台的命令行工具，支持以下系统：

• Windows (x86_64)
• macOS (Intel和Apple Silicon)
• Linux (多种架构)
• Docker容器

安装过程简单，只需下载对应平台的二进制文件，解压后即可使用。

第三步：启用zrok环境

获取账户令牌后，在终端执行以下命令启用环境：

zrok enable <您的账户令牌>

这个命令会：

1. 与zrok服务建立安全连接
2. 为当前设备创建安全身份
3. 配置必要的安全策略

第四步：开始共享

启用环境后，您可以立即开始共享资源。例如，要共享本地8080端口的Web服务：

zrok share public 8080

命令执行后，zrok会生成一个临时URL，任何人都可以通过这个URL访问您的本地服务。

深入理解zrok架构

环境概念

在zrok中，"环境"是指一个已启用的设备上下文，它包含：

• 账户令牌：用于身份验证
• Ziti身份：底层安全凭证
• 配置信息：API端点等设置

一个账户可以关联多个环境，实现跨设备共享。

共享模式

zrok提供两种主要的共享模式：

1. 公共共享(Public Share)

   • 通过HTTPS公开访问
   • 支持自定义子域名
   • 可配置认证选项
   • 适合临时演示或公开服务

2. 私有共享(Private Share)

   • 仅限特定用户访问
   • 支持TCP/UDP服务
   • 需要共享令牌
   • 适合内部协作场景

后端模式

共享时可以指定不同的后端模式：

• 代理模式(Proxy)：将流量转发到本地HTTP/HTTPS服务
• Web模式(Web)：直接共享本地文件系统目录

高级功能：保留共享

默认情况下，zrok共享是临时的。但您也可以创建"保留共享"：

1. 首先预留共享令牌：

   zrok reserve public --backend-mode web my_share
   

2. 然后启动共享：

   zrok share reserved my_share_token
   

保留共享的优势：

• 可以重复使用同一令牌
• 共享中断后可恢复
• 适合长期共享需求

安全最佳实践

使用zrok时应注意以下安全事项：

1. 妥善保管账户令牌，如同保护密码
2. 私有共享令牌也应谨慎分发
3. 定期检查活跃共享
4. 不再需要的保留共享应及时释放

自托管选项

对于有更高控制需求的用户，zrok支持完全自托管部署，可以在以下环境运行：

• 裸机Linux服务器
• Docker容器
• Kubernetes集群
• 云平台虚拟机

自托管提供了完全的自主控制权，适合企业级应用场景。

总结

zrok通过创新的安全共享模型，解决了传统网络共享中的安全与便利性矛盾。无论是临时演示、团队协作还是长期服务暴露，zrok都提供了简单而强大的解决方案。其基于OpenZiti的底层架构确保了通信的安全性，而直观的命令行界面则大大降低了使用门槛。

通过本指南，您应该已经掌握了zrok的核心概念和基本使用方法。接下来可以探索更高级的功能，如自定义认证、访问控制等，以满足更复杂的使用场景。

zrok Geo-scale, next-generation peer-to-peer sharing platform built on top of OpenZiti. 项目地址: https://gitcode.com/gh_mirrors/zr/zrok