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

更新日志

v1.1.47(2026-11-17)

  • 修复飞牛纯连接模式断线后不自动重连,auto_reconnection 开启时由管理进程按 5 秒重建;内嵌日志视图改为最新在前显示。

v1.1.46(2026-11-17)

  • 新增飞牛 fnOS 原生 NPC 客户端 FPK 包(NPC-Pro):设置页经飞牛统一网关挂载,后端仅监听本地 Unix Socket,支持连接列表、快捷指令/手动配置、直接编辑 npc.conf、日志查看与多 VKey 独立运行。
  • 服务端配置保存支持部分运行时参数即时生效;面板版本检查改为服务端缓存;删除最后一个客户端/隧道/Host 后回收持久化 ID。
  • 飞牛 FPK 与 Docker 客户端不接受服务端远程自更新;旧 NPC 和现有配置继续兼容,升级注意事项见 1.1.46 升级说明。

v1.1.45(2026-11-16)

  • 增加绑定邮箱登录及开放注册时的邮件找回密码;重置后撤销旧网页会话,修复 VKey 开关和客户端权限登录。
  • 修复审计首次加载;页面查询最近 2000 条,管理员可按天清理当前日志,API 历史查询范围不变。
  • 修复用户用量趋势并兼容旧历史,自动清理过期数据及已删除资源空记录;保留仍配置的离线资源累计量,P2P 不计入。
  • 使用说明窗口自适应可用区域,旧 NPC 和现有配置继续兼容。升级与清理注意事项见 1.1.45 升级说明。

v1.1.44(2026-11-10)

  • 补齐登录前置校验、TOTP、限频、免登签发/恢复及退出审计,追加来源、请求 ID、浏览器和认证失败阶段,严格按可信身份关联用户。
  • 审计与连接页使用完整可用区域,动作显示为“登录”等可读名称,新增诊断列、日志状态和完整 JSON 复制,适配明暗主题与手机。
  • 不改变 Bridge、旧 NPC、JSONL 或 API 动作代码。Docker 持久化、归档与升级方法见 1.1.44 升级说明。

v1.1.43(2026-11-10)

  • 优化手机登录、注册、IP 登记及账户管理布局,保留桌面磨砂样式和全部认证功能。
  • 客户端选择框统一备注、ID、所属用户及在线气泡,支持键盘和必填校验,编辑加载失败不会更换绑定。
  • 客户端双向累计流量合并为紧凑两行,实时带宽和表头方向说明统一;浏览器端增加 ip258 / GeoJS 降级查询与本地国家旗帜,支持 IPv4/IPv6,内网不外查。
  • 完善 NPC CLI、GUI 和系统服务更新后的重启恢复、权限处理、失败回滚及服务端上线确认;旧客户端连接协议和配置继续兼容。
  • 升级与旧更新器注意事项见 1.1.43 升级说明。

v1.1.42(2026-11-06)

  • 新增 3 天免登设备登记,账号可在「账户管理」查看设备、浏览器、系统、IP、活动时间和到期时间,并单独撤销或退出所有设备。
  • 管理员可在「账户管理」直接绑定、替换或关闭 TOTP;操作需要密码和动态验证码,保存后立即生效并使旧管理员会话失效。
  • 「全局参数」新增「安全」Tab,集中维护登录 PoW;登录页增加浏览器能力提示和低性能设备说明。
  • 「API 接入」统一更名为「账户管理」,集中提供 API 凭据、TOTP、登录设备和免登凭证。
  • 修复不限连接数的 TCP 隧道没有累加活动连接、列表和资源拓扑始终显示 0 的问题;配置上限后仍按上限拒绝超额连接。
  • 修复固定顶栏、页面标题与全局参数页签重叠或换行的问题;所有页面标题、状态与说明统一进入固定顶栏,操作按钮保留在内容区一次。
  • Bridge、旧 NPC、快捷命令、JSON 数据和既有 /api/v1 字段保持不变。

v1.1.41(2026-11-06)

  • 同一 VKey 支持多个在线实例,客户端详情显示实例身份、协议、局域网地址和连接时间,并支持单独断开。
  • 新增历史用量采集、趋势图和 /api/v1/status/history;管理员可查全局和各资源范围,普通用户只能读取自身资源,P2P 不计入。
  • HTTP(S) 反代补齐六类来源/协议请求头、分阶段超时、流式响应豁免和可选安全后端连接池。
  • Bridge 证书支持自动热加载;修复大屏快捷地址和 NPC 更新后的系统服务启动路径。
  • 继续兼容旧 NPC、快捷命令、JSON 数据和既有 API 字段。

v1.1.40(2026-11-02)

  • 运行时 NPC 资源使用独立临时 ID,不再消耗持久化资源序列;同一客户端的多个运行时 Host/隧道可以安全并行。
  • 客户端、隧道、域名反代和用户列表支持按实时上行/下行带宽及连接指标排序,并统一使用稳定快照。
  • 所有列表分页统一为 20 / 50 / 100 / 200,Host 列表补齐服务端排序参数,旧协议和 JSON 数据格式保持兼容。

v1.1.39(2026-10-30)

  • 用户管理和客户端列表改为用户名主行、备注次行显示,客户端备注和出口地址采用单行省略并保留完整悬浮提示,客户端备注与所属用户内容统一居中;管理员用户/客户端筛选统一使用「备注(账号)」和「客户端备注(ID)」,隧道与域名规则列表支持用户到客户端的联动筛选,同时保留单独筛选。
  • 客户端列表默认显示入口、出口流量,表头拆分显示公网到内网、内网到公网方向;域名反代自定义域名增加独立来源标签,入口按钮改为保留外链图标的“HTTP / HTTPS”;客户端列按“客户端备注 · ID”“所属用户备注 · ID”两行展示,超长内容自动省略并可悬浮查看全文。
  • 隧道列表的目标地址按 IP/端口分行展示,只有端口时仅显示端口;访问地址不再整行跳转,提供复制和 TCP HTTP 尝试按钮;TCP 当前连接列默认收起,仍可通过列表列设置和展开详情查看。

v1.1.38

  • 客户端连接日志补充 Bridge 主连接、子通道、握手与认证失败、隧道和域名代理会话的服务端地址、公网来源、客户端公网/内网地址及来源、客户端版本、Bridge 通道、握手阶段和账号到期信息。
  • 管理操作审计和连接日志的展开详情统一为紧凑的终端式原始 JSON 视图;普通用户仍只能查看所属客户端记录,日志不保存凭据或业务正文。
  • 所有列表页工具栏统一为左侧业务操作、右侧「搜索、筛选、列、刷新」,登录封禁和 IP 登记迁移到公共表格组件,域名反代补齐列菜单。
  • 登录封禁支持搜索、筛选和分页;服务端配置分类保存只校验当前页面字段,修复专项配置误拦通用页保存,并优化响应式配置卡片布局。
  • 不改变 Bridge 协议、快捷命令、JSON 持久化或 /api/v1 既有字段,NPS 与 NPC 无需同步升级。

v1.1.37

  • 新增 TCP、TCP + TLS、KCP、WS、WSS、QUIC 和 HTTP/3 共用入口的多 Bridge 连接命令,以及兼容历史 v1 的 v2 快捷命令;NPC CLI、GUI 和系统服务支持完整协议参数。
  • 客户端列表显示实际连接协议,仪表盘展示所有实际启用的 Bridge 入口;同一 VKey 可使用不同协议并行连接且系统服务名互不覆盖。
  • 新增独立「证书设置」页面,集中维护 Bridge 证书、平台泛域名、HTTPS/ACME、管理面板 HTTPS 和 IP 登记 HTTPS。
  • 自定义域名只允许上传或粘贴证书,历史服务器路径只读兼容;Web 与 /api/v1/hosts 使用相同校验规则,查询不返回证书和私钥路径。
  • 用户管理新增同一用户全部客户端共享的最大并发连接数、上行带宽和下行带宽;0 表示不限,P2P 直连不计入。
  • 「系统 → 全局参数」新增「用户注册」Tab,集中维护注册入口、默认权益、限频、邮箱验证和 SMTP;新注册账号默认不限配额、带宽和连接数,并永久有效。
  • 管理员 /api/v1/users/register 支持 max_conn、upload_limit、download_limit 覆盖默认值。
  • 修复用户共享并发额度达到上限后仍可能放行新连接的问题。
  • 新增客户端连接日志和 GET/POST /api/v1/audit/connections;普通用户只能查看所属客户端记录,日志不保存凭据或业务正文。
  • 修复 audit_log_path 留空仍写入 audit.log 的问题,空值现在会关闭独立操作审计文件。
  • 删除旧版 IP 白名单授权页面、代理链路和 /auth/ipwhiteauth、/api/v1/ipwhiteauth 接口,只保留新版 IP 登记机制。

v1.1.36

  • 自助注册改为独立用户体系,支持后台设置默认客户端配额、隧道配额和有效天数;0 分别表示不限或永久。
  • 注册增加图片验证码、频率限制、单 IP 成功注册上限和可选邮箱验证码。
  • 新增管理员注册 API /api/v1/users/register,支持 expire_days、expire_time、max_client 和 max_tunnel。
  • 用户邮箱全局唯一,并修复并发注册可能绕过唯一性检查的问题。
  • 注册页仅在配额为 0 时标注“不限”,非零客户端或隧道配额只显示实际数量。
  • 服务端配置页新增配置摘要、字段搜索和完整源码视图;修复敏感项与私钥路径回显,源码保存增加语法、配置关系与并发冲突校验。
  • 普通用户可管理自己客户端下的 IP 登记,不能访问其他用户或公共登记桶;现有管理员能力保持不变。
  • 「系统 → 全局参数」的「全局参数」Tab 支持远程 URL、conf HTML 文件和直接粘贴 HTML,修改后无需重启或重新编译面板。
  • Geo 数据路径留空时自动使用 conf/geoip.dat 与 conf/geosite.dat,支持文件热更新。
  • 现有 nps.conf 自动补齐注册配置,SMTP 默认关闭;Bridge 协议、NPC 版本和既有接口保持兼容。

v1.1.35

  • 修复普通用户访问 /user/api 时页面白屏的问题;普通用户可打开 API 接入页并管理个人 Token,用户管理、全局参数和管理员密钥接口仍仅限管理员访问。
  • 新增非管理员页面与动作白名单回归测试,并在 README 首页补充登录、IP 登记、客户端编辑和域名反代编辑截图。

v1.1.34

  • 域名反代列表移除「认证」列,改用访问入口前的锁图标表示 Basic 认证状态;列表数据只返回状态、不回传凭据。
  • 域名反代与 TCP 隧道展开详情统一为紧凑卡片布局;IP 名单用标签展示,Basic 密码只显示「已设置/未设置」。
  • 全局参数「平台泛域名」输入区单列排版并限制输入宽度,证书信息布局更整齐。
  • 修复域名反代表单在健康检查未启用时保存被浏览器校验拦截的问题。

v1.1.33

  • 管理面板删除客户端时向在线 NPC 下发「注册已删除」指令;新版 NPC 关闭该连接并停止重连,旧版 NPC 保持原行为。
  • NPC 以系统服务运行时只停止被删除的连接,进程内最后一条连接结束时才自动停止本机 NPC 服务,保留服务注册,不卸载。
  • 修复 NPC 数据通道关闭时的阻塞与文件描述符泄漏,删除客户端后数据通道立即完整释放。
  • NPS/NPC Docker 镜像补齐 CA 证书,修复 Geo 在线更新与版本检测的证书校验失败。
  • 「API 接入」页文档链接改到官方文档站并修复管理员密钥生成按钮;登录页、主布局和错误页统一显示浏览器标签页图标。

v1.1.32

  • 新增统一对外 API /api/v1,覆盖客户端、隧道、域名反代、用户、全局参数、Geo、IP 登记、审计、状态与拓扑。
  • 所有响应统一返回 status、code、msg、request_id,失败额外返回 error_code;列表支持有界分页。
  • 管理员使用 auth_key + timestamp 签名,普通用户使用按授权范围生效的 Bearer Token;/api/v1 不依赖浏览器 Session。
  • 旧 /auth/*、/client/*、/index/*、/user/*、/global/* 路径和返回格式保持不变。
  • 开发期间短暂新增但从未正式发布的 /v1/auth/* 已移除,统一收口到 /api/v1。

v1.1.31

  • Secret/P2P 的 target_type 真正支持 tcp、udp、all,UDP 数据报边界完整保留;P2P 访客默认支持 Secret 回退。
  • 隧道新增最大连接数与总流量配额;域名反代证书支持路径、上传、粘贴与校验。
  • 新增可复用 Token 的「API 接入」页、Geo 数据在线更新、更完整的仪表盘配置信息。
  • 普通用户可设置自己名下客户端的独立到期时间;客户端版本号点击后可直接检测并下发升级。
  • 管理面板移除 ZUI、全面迁移 Bootstrap 5.3.3,表单分组联动、列表详情紧凑化,工具栏与操作交互统一。
  • 修复公共 vkey 配置文件模式注册卡死,升级 quic-go 修复 P2P 直连 QUIC 握手 panic。

v1.1.30

  • NPC 自定义 DNS、HTTP/HTTPS 与 SOCKS4/4a/5 出站代理、ALL_PROXY/NO_PROXY 环境代理现在实际生效。
  • local_ip/local_ip_forward 覆盖 TCP、UDP、SOCKS5 UDP、KCP 和 QUIC 的出站绑定,并保持私网目标的默认路由。
  • NPC 支持多服务端并行连接和多配置文件启动;管理员可在“登录封禁”页面清理临时登录保护记录。
  • 直接启动的 NPC 可用 -disable_remote_update=true 禁止服务端升级指令,并支持 npc update-force 重新安装同版本正式包。
  • 配置文件和 Docker 文档补齐,旧客户端与旧配置继续兼容。
  • SOCKS5 UDP 使用共享 UDP 会话注册,补齐多来源绑定、队列保护、空闲/断线回收、目标 ACL 与大报文支持。
  • 隧道列表合并配置、监听、客户端状态并优化表头提示与窄屏布局。

v1.1.29

  • 新增 Web 隧道与域名规则的后端健康检查配置,并按 NPC 版本自动选择兼容的控制消息。
  • 新增规则级上行/下行限速、API 访问地址与速率字段,旧数据按不限速兼容。
  • HTTP 正向代理与 SOCKS5 统一为混合代理;旧规则兼容,编辑时可迁移。
  • 新增服务端 nps.conf 后台维护页,支持分组配置、敏感字段脱敏、可选键移除和重启提示。
  • 新增 TCP、KCP、WebSocket/WSS 和 QUIC Bridge 传输入口;QUIC 使用独立 UDP 端口,不是浏览器 HTTP/3 Host 反代。
  • 服务端启动时自动补齐缺失配置,保留既有值、注释、自定义字段和旧字段,支持原子写回。
  • 管理面板继续按管理员、普通用户和客户端主体隔离资源;实时调试、审计、IP 登记和客户端升级沿用同一权限边界。

完整的历史版本记录统一维护在项目更新日志,本页保留当前版本摘要和入口,避免文档站侧边目录出现空白页。

在 GitHub 上编辑此页
最后更新: 2026/11/16 23:39
Prev
本项目更新日志
Next
FAQ