NPSNPS
首页
  • 安装与部署
  • 快速开始
  • 运行命令速查
  • 隧道模式
  • 使用示例
  • 使用说明
  • 配置文件
  • 增强功能
  • Docker 部署
  • 参数与安全速查
  • 使用说明
  • 增强功能
  • 配置与启动
  • 配置文件参考
  • 更新与远程升级
  • SDK
  • 功能概览
  • 域名代理与路由
  • 平台域名与证书诊断
  • 访问控制与配额
  • 运行说明
  • 配置示例
  • 对外 API v1
  • API 鉴权与兼容
  • 历史 Web API
  • 用户体系
  • FAQ
  • 升级迁移
  • 功能与兼容矩阵
  • 本项目更新日志
  • 上游更新日志
GitHub
首页
  • 安装与部署
  • 快速开始
  • 运行命令速查
  • 隧道模式
  • 使用示例
  • 使用说明
  • 配置文件
  • 增强功能
  • Docker 部署
  • 参数与安全速查
  • 使用说明
  • 增强功能
  • 配置与启动
  • 配置文件参考
  • 更新与远程升级
  • SDK
  • 功能概览
  • 域名代理与路由
  • 平台域名与证书诊断
  • 访问控制与配额
  • 运行说明
  • 配置示例
  • 对外 API v1
  • API 鉴权与兼容
  • 历史 Web API
  • 用户体系
  • FAQ
  • 升级迁移
  • 功能与兼容矩阵
  • 本项目更新日志
  • 上游更新日志
GitHub
  • 文档首页
  • 快速上手

    • 安装与部署
    • 快速开始
    • 运行命令速查
    • 完整部署参考
    • 隧道模式
    • 使用示例
  • 服务端

    • 服务端使用
    • 使用说明页面配置
    • 配置文件参考
    • 服务端增强功能
    • 服务端介绍
    • 部署安全与参数速查
    • Docker 部署
    • 宝塔面板部署
  • 客户端

    • 客户端使用
    • 客户端增强功能
    • NPC SDK
    • 客户端配置与启动
    • 配置文件参考
    • NPC Docker 部署
    • 飞牛 fnOS 原生包
    • NPC GUI 客户端
    • 客户端更新与远程升级
  • 扩展功能

    • 功能概览
    • 域名代理与路由
    • 平台域名与证书诊断
    • 访问控制与配额
    • 运行说明
    • 对外 API v1
    • API 鉴权与兼容
    • 历史 Web API
    • 使用示例
  • 项目与社区

    • 用户体系
    • 系统架构
    • 升级迁移
    • 功能与兼容矩阵
    • 构建发布
    • 本项目更新日志
    • 上游更新日志
    • FAQ
    • 贡献
    • 交流
    • 捐助
    • 致谢

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
在 GitHub 上编辑此页
最后更新: 2026/10/29 10:28
Prev
上游更新日志
Next
贡献