FAQ
服务端无法启动
服务端默认使用 8024、8025、8081、80、443 端口,如果端口冲突请修改 conf/nps.conf 中的配置。
客户端无法连接服务端
- 检查所有端口是否在安全组/防火墙中放行
- 检查 vkey 是否正确
- 检查客户端与服务端版本是否兼容
服务端日志反复出现「拒绝客户端连接 … not found」
这是某个 NPC 仍在用已不存在的 vkey 连接服务端。常见原因:
- 客户端在 Web 面板被删除、重新创建或换过 vkey,但旧 NPC 仍在运行;
- NPC 配置了错误的 vkey,或
-server指向了 Web/非 Bridge 端口; - NPC 挂载了错误的数据卷(Docker 场景)。
新版 NPC 在「被服务端删除」后会自动停止重连;旧版 NPC 会每 5 秒重试一次。找到并停止对应 NPC 服务,或修正其 vkey 后即可消除日志。
Geo 更新或版本检测报「certificate signed by unknown authority」
Docker 镜像中缺少系统 CA 证书时,访问 api.github.com 会校验失败。升级到补齐 CA 证书的新版镜像即可;裸机部署请确认系统已安装 ca-certificates 包,否则同样无法完成 HTTPS 校验。
服务端配置文件修改无效
使用 install 安装后:
- Linux 配置文件在
/etc/nps/conf/nps.conf - Windows 配置文件在
C:\Program Files\nps\conf\nps.conf
Web 面板访问不了
- 检查
web_port端口是否放行 - 如果是首次生成配置,查看终端输出的随机密码;已有
conf/nps.conf时以文件中的web_username和web_password为准 - 尝试
http://127.0.0.1:8081本地访问
如果页面能打开但语言菜单或下拉框没有反应,确认页面已加载 Bootstrap 5 脚本和 static/js/language.js,然后重启 NPS 让嵌入式静态资源同步,再清理浏览器缓存。
nps install 还能用吗?
能用。nps install、nps start、nps stop、nps restart、nps uninstall 是非交互命令,适合脚本化部署。
nps -server 是交互菜单入口,不是安装命令本身。菜单里也可以选择安装、删除/卸载、更新、查看状态、启动、停止和重启。NPS 服务端只有一个系统服务,所以用「查看状态」即可,不需要服务列表。
NPC 也一样。npc install -server=<服务器IP>:8024 -vkey=<VerifyKey> 仍然是可用的非交互安装命令;直接运行 npc 进入的是客户端交互菜单。客户端交互菜单支持注册服务、删除/卸载服务、启动服务、停止服务、更新客户端、查看已注册服务列表和查看指定服务状态。
SOCKS5 账号密码在哪里设置?
SOCKS5 和 HTTP 正向代理优先使用「HTTP / SOCKS 混合代理」规则里的独立 Basic 认证;没有配置独立认证时,才使用所属客户端的公共 Basic。
路径:
新增/编辑 HTTP / SOCKS 混合代理 -> 认证配置 -> 每行填写 用户名:密码
客户端 -> 新增/编辑客户端 -> 认证配置 -> Basic 认证用户名 / Basic 认证密码
规则级和客户端级账号都为空时,SOCKS5/HTTP 正向代理会允许无认证连接。公网开放时必须设置强密码,并配合来源限制。
P2P 穿透失败
双方 NAT 类型都是 Symmetric NAT 时无法成功。建议先检测 NAT 类型:
./npc nat -stun_addr=stun.stunprotocol.org:3478
Windows 客户端闪退
使用 CMD 运行而非直接双击,以便查看错误信息:
npc.exe -server=ip:8024 -vkey=your-key
