应用首次安装配置

POST

/api/v1/setup/apply

完成代理、AI、限流与 SSH 配置，并在成功后返回可直接使用的管理员 JWT。

请求参数

Authorization

JWT Bearer

在 Header 添加参数

Authorization

示例：

Authorization: ********************

Body 参数application/json必填

示例

{
    "password": "pa$$word_qwe",
    "backend_addr": "http://127.0.0.1:3000",
    "listen_port": 8080,
    "ai_enabled": false,
    "api_key": "pa$$word",
    "ai_model": "gpt-4o-mini",
    "ai_base_url": "http://example.com",
    "rpm": 1,
    "burst_size": 1,
    "ssh_enabled": true,
    "ssh_max_fails": 1,
    "ssh_ban_minutes": 1
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/api/v1/setup/apply' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "password": "pa$$word_qwe",
    "backend_addr": "http://127.0.0.1:3000",
    "listen_port": 8080,
    "ai_enabled": false,
    "api_key": "pa$$word",
    "ai_model": "gpt-4o-mini",
    "ai_base_url": "http://example.com",
    "rpm": 1,
    "burst_size": 1,
    "ssh_enabled": true,
    "ssh_max_fails": 1,
    "ssh_ban_minutes": 1
}'

返回响应

🟢200

application/json

配置已应用

Bodyapplication/json

示例

{
    "status": "ok",
    "message": "string",
    "id": "string",
    "token": "string"
}

🟠400BadRequest

🟠403Forbidden

修改于 2026-08-18 04:50:02

设置首次初始化管理员密码

获取 V2 安全概览