文档/如何接入/自建面板/出了问题·4 / 9

出了问题

先用两条命令:sudo veli panel 显示面板的状态,节点服务器上的 sudo veli doctor 说明设备为什么连不上。

面板打不开

在面板服务器上运行 sudo veli panel,看它是否在运行。如果主机商有自己的防火墙,请开放 443 端口;有域名时还要开放 80。

没有签发证书

域名必须指向面板服务器,80 端口必须开放。最近一次错误由 sudo veli panel 显示。没有域名时,面板可以按 IP 安装:--host。

服务器下载不了命令

在某些国家(例如俄罗斯)可能打不开我们的网站。把 veli 文件下载到电脑,复制到服务器——scp veli root@<地址>:~——再运行去掉 curl 部分的那一行。通过 SSH 添加节点时——nodes add 加 --from 和 --node-from。

nodes add 中途停了

它会用文字说明原因,并让服务器恢复原样,所以重新运行是安全的。需要 root(--ssh root@地址)和一致的指纹:不一致说明地址不对。脚本里请预先给出指纹——--fingerprint。

节点“没有声音”或“尚未报告”

在节点服务器上运行 sudo veli panel,可看到最近一次报告的时间。节点必须能访问面板地址——检查 curl -I https://panel.example.com 和 443 端口。然后再运行同一条 nodes add。

客户看不到新节点

新节点会随订阅的下一次刷新到达——请在应用里刷新订阅。还要检查客户所在的分组:节点可能不在其中。

令牌丢了

令牌只显示一次。把它吊销——sudo veli token revoke site——再签发新的。

客户或节点不见了

从备份恢复面板——sudo veli panel restore。

API

API 和 Webhook 的常见错误及处理方法。

400 name
名称为空、超过 40 个字符、含控制字符,是 c_ 加 12 个字符的形式,或是 API 的词:bulk、find
400 taken
该名称已被占用
400 none
没有这个名称的客户、节点或分组
400 bad
值超出范围,或分组、节点不存在。field 指明字段,max——上限
400 main
迷你面板的主节点不能停用,也不能移除
401 token
没有令牌,或令牌已撤销、已过期。它是否还在,在面板服务器上用 veli token list 查看
403 rights
令牌没有相应权限:例如只有「全部」才能删除客户。用 GET me 查看权限
404 none
请求的内容不存在,或调用未知
409 idempotency
这个 Idempotency-Key 已经用于另一个请求。一个键只对应一个操作:续期和创建用不同的键
411 length
请求体没有 Content-Length(分块 chunked):请一次完整发送
413 big
请求体超过 1 MB,max 为上限。请把批量修改分成几次
429 wait
令牌每分钟超过 300 次请求,或该地址 15 分钟内用错令牌十次。等待 Retry-After 所写的秒数
500 db
面板无法保存更改——请用同一个键重试
任何请求都返回“未找到”

API 地址不对:请检查域名、秘密路径和 /api/——veli token add 会连同令牌一起打印 API 地址。

浏览器中出现 CORS 错误

这是有意为之:令牌供您的服务器使用,浏览器页面无法访问面板。让页面请求您的服务器,再由服务器请求面板。

签名对不上

几乎总是因为请求体已被解析又重新序列化。请取原始字节:Express 中用 express.raw,Flask 中用 request.get_data()。还要确认密钥属于这个 Webhook:重新添加的 Webhook 密钥不同。

完全没有事件

veli webhook list 中没有这个 Webhook,所需事件没有写进 --events——或者面板没有运行:在面板服务器上运行 sudo veli panel 可以看到。