向后兼容性

ngrok承诺有关其接口的兼容性和稳定性，以便您可以自信地构建集成顶部，知道在升级到较新版本时期望的更改。

兼容性承诺

  • Point Release (2.0.0 -> 2.0.1) - ngrok承诺在点发布之间没有突破性的变化

  • Minor Version Change (2.0 -> 2.1) - ngrok可能会进行小的更改，打破兼容性的次要版本更改。 ngrok承诺，任何破坏性更改将由一个版本前面，该版本警告将要更改或弃用的行为。

  • Major Version Change (2.0 -> 3.0) - nngrok不承诺任何接口在主要版本更改中是稳定的。

什么接口是受约束的？

  • ngrok命令行界面：命令及其选项
  • ngrok配置文件
  • ngrok客户端API

任何其他界面，如日志格式或Web UI不受任何兼容性承诺，并可能会更改，而不会在版本之间的警告。

2.1中的更改

对配置文件中定义的http and tls隧道的行为更改，或通过没有subdomain or hostname属性的API启动。 

  1. tunnels:
  2.   webapp:
  3.     proto: http
  4.     addr: 80

给定此示例隧道配置，行为将以以下方式改变。

老行为

使用隧道的名称作为子域启动隧道，生成URL http://webapp.ngrok.io

新行为

启动具有随机子域的隧道，例如像http://d95211d2.ngrok.io这样的URL

如何保持旧的行为

添加与隧道名称相同的子域subdomain属性：

  1. tunnels:
  2.   webapp:
  3.     proto: http
  4.     addr: 80
  5.     subdomain: webapp

此行为已更改，以便可以启动随机域的隧道。这阻止了使用配置文件和客户端API释放层用户。.