面板做什么,您做什么
面板是一套机制,而不是现成的客户后台。您服务的业务问题不由我们来定,我们也不迁就它们:店面、客户自己的页面、CRM——由您自己搭建,亲手做,或者交给 AI 一起做。
您能得到什么
- 命令行
- 面板服务器上的 veli 命令:安装面板、按 IP 添加节点、创建客户、签发令牌和 Webhook。无需在浏览器里打开任何东西。
- API
- 通过 HTTPS 完成同样的操作:客户、节点、分组、流量、事件。openapi.json 是接口说明,AI 或程序员据此用任何语言写出客户端。
- Webhook
- 面板会主动告知事件:客户已添加、期限将尽、流量将用完、节点没了动静。您的服务器收到一条带签名的请求,再做自己的事。
- 给 AI 用的 MCP
- 同一个 API 变成 Claude 等智能体的工具:“这周谁到期”“给所有带 vip 标签的人续期”。权限由令牌决定。
面板做什么
凡是与 VPN 访问有关的事,都稳妥完成,无需您插手。
- 保存客户:期限、设备、速度、流量上限、备注和您自己的标签。
- 给每位客户一条通往您所有服务器的链接,以及一个带应用按钮的简洁订阅页。
- 把客户名单分发给各节点:新客户半分钟内在所有节点上生效。
- 统计流量和设备,记录操作日志,已删除的客户在回收站保留 30 天。
- 通过 Webhook 和事件流告知事件,并通过 MCP 回应 AI 智能体。
您来做什么
所有取决于您业务的部分都留在您手里,面板不会干涉。
- 价格与支付 — 您的价目表、支付系统、退款、税务。面板只知道天数、设备和流量——价格和支付由您自己负责。
- 店面与客户页面 — 网站或应用:用户在这里付款、查看期限、领取自己的链接。
- 您自己的工作方式 — 团队里谁能改什么,给客户发哪些邮件和消息,需要哪些报表。
- 客服与记录 — CRM、工单、沟通记录。客户通过外部 ID 与您的系统关联:订单号或您系统中的用户 ID。
令牌
为网站、CRM 或 AI 智能体创建一个带所需权限和期限的令牌,并妥善保管,让泄露也造不成损失。
在控制台创建令牌
在面板服务器上以 root 运行:veli token add <名称> --rights read|clients|all。令牌和 Webhook 只能由控制台创建——不能由另一个令牌或 API 调用创建。
名称、权限、有效期
名称——谁在使用它,例如 cabinet。权限——read、clients 或 all(见下)。有效期可选:--days 90,范围 1 到 3650 天;不加 --days 则令牌永久有效。
复制令牌
控制台只打印一次令牌:请把它复制到您系统的设置中。丢了?撤销它,再创建一个新的。
有效期 90 天的令牌——在面板服务器上运行
veli token add cabinet --rights clients --days 90令牌列表,按名称撤销
veli token list
veli token revoke cabinet- 只读
- --rights read。可查看客户(不含链接)、节点、流量、事件流。不改动任何东西
- 客户
- --rights clients。可查看一切(包括客户链接)并管理客户:添加、续期、停用和启用、更换链接、解绑设备、批量修改。不能删除
- 全部
- --rights all。面板能做的一切:删除客户,管理节点和分组。令牌和 Webhook 除外——它们只能由控制台创建
- API 地址是面板地址、秘密路径和 /api/。veli token add 会在令牌下面打印它(安装面板时也会打印)。路径就像密码:把它和令牌放在一起,不要放进公开的代码仓库。
- 令牌放在请求头 Authorization: Bearer veli_… 中——从您的服务器发出。面板不会回应浏览器页面中的脚本。
- 令牌和 Webhook 不能通过 API 创建,即使是“全部”权限的令牌也不行:泄露的令牌无法自我繁殖。只能由控制台创建。
限制
- 每个令牌每分钟 300 次请求。每个响应都带有 RateLimit-Limit、RateLimit-Remaining——这一分钟还剩多少次——以及 RateLimit-Reset——多少秒后开始新的一分钟。
- 超出限制——返回 429 wait 和 Retry-After: 60。等待这么多秒后重发同一个请求;POST 请求要用同一个重试键。
第一个请求
检查令牌:GET me 返回它的名称、权限和有效期,响应头则显示这一分钟内还剩多少次请求。
在您的服务器上
VELI=https://panel.example.com/Zq7mT2xP4vLc9wRbE5nK/api
VELI_TOKEN=veli_…
curl -si "$VELI/me" \
-H "Authorization: Bearer $VELI_TOKEN"响应
HTTP/1.1 200 OK
content-type: application/json
ratelimit-limit: 300
ratelimit-remaining: 299
ratelimit-reset: 41
{"name": "cabinet", "token": true, "rights": "clients", "until": 0, "api": 1}