以下页面描述网关的预期行为。开源版本与企业版本正在拆分中,首个正式版本发布后细节会同步更新。
配置
启动配置 —— 就四项设置,没有别的。
配置文件的作用是把进程启动起来。它回答四个问题,仅此而已。 provider、凭据、路由、路由策略与告警都在控制台中管理。
完整的文件
[server]
listen = "0.0.0.0:8080"
public_url = "https://gateway.example.com"
[console]
listen = "127.0.0.1:8081"
[state]
path = "/var/lib/solidway"
[telemetry]
# 可选;见「指标」与「日志与追踪」
server
| 键 | 类型 | 说明 |
|---|---|---|
listen |
string | 网关接受流量的地址与端口 |
public_url |
string | 客户端使用的域名。绝对地址由它生成,Host 头也会与它比对。 |
public_url 不只是记账用:它定义了网关认为自己是哪个域名,因此带着意外 Host 到达的请求
可以在被路由之前就被拒绝。
console
| 键 | 类型 | 说明 |
|---|---|---|
listen |
string | 管理控制台的监听地址 |
请绑定到内网地址。控制台是管理面,不需要从公网可达。
state
| 键 | 类型 | 说明 |
|---|---|---|
path |
string | 存放控制台管理内容的目录 |
该目录是路由配置的真实来源:启动时读取,变更时写入。 请做好备份;在容器环境中要放在持久化存储上。
telemetry
可选的导出目标设置。这些属于基础设施端点,因此放在启动配置里而不是控制台。 见指标与日志与追踪。
这里没有什么
配置里刻意没有 providers、routes、alerts 这些段落。
如果你在找「在哪里添加 provider」,答案是控制台:
加载方式
文件在启动时读取一次,运行期间不可更改。修改监听地址或对外域名需要重启; 而修改任何与流量有关的内容都是控制台操作,立即生效。