1

api server

e1732a364fed edited this page 2022-12-28 13:25:25 +08:00

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

可参考 multi.server.toml

1. -ea命令行参数给出后，才会运行api服务器
2. -sa参数, 配置api server的监听地址，默认是 127.0.0.1:48345
3. -sap参数 配置admin的密码，默认没密码
4. -spp参数 配置api server 的 url前缀，默认是/api

默认allstate 的api的url 为 https://127.0.0.1:48345/api/allstate

用到basic auth，用户名为admin

配置文件的格式：

# [apiServer]            # v1.2.5开始, apiServer配置单独在一项中配置
# enable = true         # 默认为false
# plain = false         # 是否使用明文http, 默认false
# admin_pass = "i_love_verysimple"
# addr = "127.0.0.1:8080"
# key = "/home/vs/key"  # 若不用明文http, 可配置tls证书, 若不给出, vs会自动生成随机证书
# cert = "/home/vs/cert"
# prefix = "/myapi"

除了把参数放在query里，也可以放在http的form里提交。

api server热删除功能

举例：

/api/hotDelete?listen=1&dial=2 
删除第2个listen和第三个dial，具体第几个是啥用 /api/allstate 查

api server 热加载url功能

举例：

/api/hotLoadUrl?listen=vlesss://sdfdfadfss@0.0.0.0:443&dial=...

api getDetailUrl 查询当前某个 dial或listen 的配置url 举例：

/api/getDetailUrl?index=1&isDial=true

api dump功能 （导出当前总配置到文件, 如果用 get, 则打印当前总配置） 举例：

post /api/dump?name=filename.toml