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
    • 贡献
    • 交流
    • 捐助
    • 致谢

飞牛 fnOS 原生 NPC 包

NPC 提供仅客户端的 fnOS 原生 FPK 包。它不监听任何网络端口,也不提供公网 Web 入口;配置页面通过飞牛统一网关挂在 /app/NPC-Pro,后端只监听本地 Unix Socket,并复用飞牛登录态。

内嵌设置页

安装后在飞牛桌面打开 NPC-Pro,会进入内嵌设置页。页面提供:

  • 连接列表:查看每一条连接的备注、服务端地址、协议和启用状态。
  • 新增 / 编辑连接:选择「快捷指令」时只显示快捷码输入框;选择「手动填写」时才显示域名、端口、VKey、协议,并按协议联动显示 WS/WSS 路径、QUIC ALPN、TLS ServerName、证书指纹和 CA 文件。
  • 直接编辑 npc.conf:每条连接都能打开原始配置文本编辑器,改动会先校验再原子写入。
  • 运行日志:查看最近最多 500 条日志,并支持一键清空。

保存后运行中的 NPC 会热重载,不需要重启应用。飞牛网关会在转发前校验用户会话,页面不会回显 VKey 或快捷码。

配置文件

首次安装时,应用会在飞牛应用的 etc 配置目录释放完整的 npc.conf。文件来自项目的配置模板,包含所有常用字段、TLS、代理、限额、P2P、Secret、隧道、域名和健康检查示例;示例规则默认全部注释,不会自动开放端口。

同时会保留 npc.conf.example 作为参考。实际文件可以直接用文本编辑器修改,字段以当前版本 NPC 配置文件参考 为准。

重要规则:

  • npc.conf 是实际运行配置,原生应用设置和手动编辑使用同一份文件,不存在第二套隐藏 JSON 配置。
  • 修改保存后,运行中的 NPC 每秒检查配置;文件完成写入并连续两次读取有效后才应用,编辑器的临时空文件不会立即断开连接。
  • 配置无效时保留旧连接并记录错误,不会用模板覆盖或清空旧文件。
  • 配置文件含 VKey、密码和代理凭据,应用自动使用 0600 权限;不要把该文件上传或提交到公共仓库。
  • 升级 FPK 时保留 etc 目录中的 npc.conf、手写规则和注释,不会用新模板覆盖。

多个 VKey

一个 npc.conf 对应一个服务端入口和一个 VKey。需要在同一台飞牛连接多个不同 VKey 时,在原生设置中新增连接,应用会为其他连接创建独立目录和文件:

etc/npc.conf
etc/connections/<连接编号>/npc.conf

每个文件由独立 NPC 子进程运行,因此停用、修改或服务端删除其中一条连接,不会停止其他 VKey。连接文件中的隧道或域名规则仍使用原有 NPC 配置模式;此时服务端必须允许配置连接,否则只应保留 [common] 连接参数。

快捷启动码和手动填写是二选一。快捷码会转换为完整的 [common],手动设置只更新连接字段;其它字段、规则节和注释继续保留。

日志

运行日志位于应用 var 数据目录的 npc.log,按 5 MiB 轮转并保留 3 个备份,权限为 0600。日志条目带连接编号和协议,移除了终端颜色控制符,并遮盖 VKey、密码、Token、Secret 和代理凭据。

内嵌设置页可查看最近最多 500 条日志(不超过 128 KiB)。清空操作会清理当前日志和三个轮转文件,不能恢复;日志预览不是实时流,点击刷新即可更新。

更新与限制

飞牛 FPK 和 Docker 客户端不接受服务端远程自更新。请从应用中心安装新版 FPK;配置文件和 etc 数据会保留。普通 CLI、系统服务和 GUI 的既有更新行为不受影响。

FPK 构建成功不等于真机兼容性完成。首次发布前必须在实际 fnOS 设备上验证:安装向导、内嵌设置页的网关访问与登录态、表单联动、直接编辑 npc.conf、多 VKey 启停、升级保留配置和日志清理。

在 GitHub 上编辑此页
最后更新: 2026/11/16 22:04
Prev
NPC Docker 部署
Next
NPC GUI 客户端