zrok v1.0.0 正式发布：下一代内网穿透与边缘服务管理平台

zrok 是一个基于 OpenZiti 技术的开源内网穿透与边缘服务管理平台，它通过零信任网络架构为用户提供安全、高效的远程访问解决方案。近日，zrok 迎来了具有里程碑意义的 v1.0.0 版本发布，这标志着该项目已经成熟稳定，具备了企业级应用的能力。

全新 Web 管理界面（API Console）

v1.0.0 版本带来了完全重新设计的 Web 管理界面，采用现代化的前端技术栈构建：

• 基于 Vite、React 和 TypeScript 的全新实现
• 提供双模式视图：可视化网络导航器和传统表格视图
• 改进的用户体验和更直观的操作流程

这个全新的管理控制台不仅外观更加现代化，其底层架构也为未来的功能扩展奠定了坚实基础。开发团队特别注重了界面的响应式设计，确保在不同设备上都能获得良好的使用体验。

革命性的 zrok Agent 架构

本次版本引入了 zrok Agent 这一核心创新功能，彻底改变了服务管理方式：

• 后台管理进程：作为常驻后台的服务管理器，统一管理多个共享和访问会话
• 多环境支持：轻松管理多个 zrok 环境配置
• 自动检测机制：zrok share 和 zrok access 命令能自动识别 Agent 运行状态
• 灵活模式切换：通过 --subordinate、--force-agent 和 --force-local 参数控制运行模式

这种架构设计使得长期运行的共享服务更加稳定可靠，同时也为系统管理员提供了更强大的管理能力。Agent 进程会自动监控其管理的子进程状态，并在异常退出时尝试自动恢复。

增强的访问控制功能

v1.0.0 在访问控制方面做了多项改进：

• 自动端口绑定：zrok access private 新增 --auto 模式，自动寻找可用端口
• 端口范围配置：支持通过 --auto-start-port 和 --auto-end-port 指定端口范围
• 环境迁移工具：新增 zrok rebase 命令，支持环境配置迁移和账户令牌更新

这些改进特别适合自动化部署场景，使得 zrok 能够更好地集成到 CI/CD 流程中。自动端口绑定功能尤其受到开发者欢迎，它解决了端口冲突这一常见痛点问题。

测试工具与兼容性改进

新版本对测试工具进行了全面重构：

• 废弃旧的 zrok test loop 命令树
• 引入新的 zrok test canary 测试框架
• 新增 public-proxy 和 private-proxy 测试子命令

在兼容性方面，v1.0.0 改进了客户端版本检查协议：

• 从简单的 GET 请求升级为 POST 方式的版本检查
• 服务端获得更大的版本管理灵活性
• 提供更清晰的客户端升级提示

技术架构优化

底层架构也进行了多项重要改进：

• API 实现全面重构，清理冗余代码
• 废弃密码配置节，采用更安全的默认密码策略
• Node.js 和 Python SDK 现在通过 openapi-generator 自动生成
• 新增 /api/v1/versions 端点，提供完整的服务版本信息

这些改进使得 zrok 的代码库更加整洁、可维护性更高，同时也为开发者提供了更规范的 SDK 接口。

升级注意事项

对于从旧版本升级的用户需要注意：

• 默认 API 端点变更为 https://api-v1.zrok.io
• 如果遇到版本错误，可以执行 zrok rebase apiEndpoint https://api-v1.zrok.io 快速修复
• Python SDK 现在要求 urllib3 2.1.0 或更高版本

zrok v1.0.0 的发布标志着该项目已经进入成熟阶段，新引入的 Agent 架构和现代化管理界面为未来的功能扩展奠定了坚实基础。无论是个人开发者还是企业用户，都能从这个版本中获得更稳定、更易用的内网穿透和边缘服务管理体验。