更新日志
v1.1.47 (2026-11-17)
- 修复飞牛纯连接模式(仅
[common]、无本地隧道规则)断线后不自动重连:子进程改为按auto_reconnection退出交由管理进程按 5 秒重建,或保持等待配置变更。 - 飞牛内嵌设置页日志视图改为最新在前显示。
v1.1.46 (2026-11-17)
- 新增飞牛 fnOS 原生 NPC 客户端 FPK 包(NPC-Pro):不监听网络端口、不暴露公网 Web,设置页通过飞牛统一网关挂载,后端仅监听本地 Unix Socket 并复用飞牛登录态。
- 内嵌设置页支持连接列表、快捷指令/手动配置二选一、直接编辑
npc.conf并校验后原子写入、查看并清空最近最多 500 条日志;保存后运行中 NPC 自动热重载。 - 支持同一台飞牛连接多个不同 VKey,每条连接独立
npc.conf并由独立子进程运行;首次安装释放完整配置模板,升级 FPK 保留设备etc中的配置与注释。 - 服务端配置保存支持部分运行时参数即时生效(允许端口、注册/登录/VKey 开关、验证码、限速/配额开关、连接历史保留数、流量落盘间隔、审计/连接日志路径等),其余监听端口、TLS、日志适配器等仍需重启。
- 面板版本检查改为服务端每 6 小时统一查询并缓存;删除最后一个客户端/隧道/Host 后回收持久化 ID;新增流量计数器重置并同步清理速率基线。
- 飞牛 FPK 与 Docker 客户端不接受服务端远程自更新;旧 NPC、Bridge 和业务 JSON 无需迁移,见 1.1.46 升级说明。
v1.1.45 (2026-11-16)
- 独立账号兼容用户名与绑定邮箱登录;修复 VKey 登录开关和“用户名 + VKey”登录,VKey 会话仍只管理对应客户端。
- 开放注册时提供邮件找回密码,复用 SMTP 并增加独立验证码、限频和异步发送;重置成功撤销旧网页会话及免登凭证,不影响 API Token 或 NPC。
- 修复审计首次加载卡住;页面只查询当前文件最近 2000 条,管理员可按保留天数手动清理,既有历史查询 API 范围不变。
- 修复用户用量趋势范围标识和旧历史兼容;启动及采样时自动清理过期历史,回收已删除资源的空记录,保留仍配置的离线资源累计量并串行写盘。
- 使用说明嵌入窗口铺满可用内容区;修复改密码时丢失邮箱、连接数和带宽设置。旧 NPC、Bridge 和业务 JSON 无需迁移,见 1.1.45 升级说明。
v1.1.44 (2026-11-10)
- 完善登录请求大小、PoW、图片验证码、请求过期、限频、密码及 TOTP 失败审计,记录免登签发/恢复和退出,注册前置验证失败也统一落盘。
- 新增请求 ID、无查询串路径、方法、浏览器、直连地址、来源 IP 识别依据、认证方式、校验阶段及错误代码;普通用户只能查看已验证身份归属的记录,匿名失败仅管理员可见。
- 审计与连接页铺满内容区,表头固定,动作/资源显示中英文名称,提供诊断列、日志状态及原始 JSON 复制;保留历史 JSONL 与 API 动作代码,旧 NPC 无需升级。
- Docker 日志挂载、文件权限及归档说明见 1.1.44 升级说明。
v1.1.43 (2026-11-10)
- 手机登录、注册和 IP 登记改为紧凑品牌条与单列表单,修复页脚挤压、验证码换行和 IPv6 省略;适配横屏、安全区、明暗主题和中英文,保留桌面磨砂参数及邮箱、TOTP、PoW、免登录功能。
- 隧道、域名规则的客户端选择框统一展示备注、ID、所属用户及在线气泡;支持键盘与必填校验,加载失败不丢失编辑页的原客户端绑定。
- 客户端累计入口/出口流量合为上下两行一列,实时带宽使用相同样式,表头补齐方向、单位和入口排序提示;客户端名称可编辑但数字 ID、VKey 和连接保持不变。
- 浏览器端优先 ip258 中文省市区,GeoJS 备用,支持 IPv4/IPv6、4 秒超时、最多四个并发查询、去重与缓存;内网不外查,国家旗帜随程序本地打包。
- 一并发布账户管理页面布局优化,以及 NPC CLI、GUI、系统服务跨平台升级替换、权限保持、重启恢复、失败回滚和服务端上线确认修复。
- 旧 NPC 与既有配置、业务 JSON、快捷命令和 API 兼容;客户端若需要使用新的升级恢复逻辑,应升级相应 NPC,旧更新器失败时需手动更新一次。详见 1.1.43 升级说明。
v1.1.42 (2026-11-06)
- 新增 3 天免登设备登记,服务端在
conf/web_sessions.json保存设备、浏览器、系统、IP、创建/最近活动/到期时间和会话代次。账号可在「账户管理」查看并单独撤销设备,或“退出所有设备”。 - 管理员可在「账户管理」直接绑定、替换或关闭 TOTP。操作需要登录密码和认证器动态验证码,保存后立即生效,并使旧管理员网页会话失效。
- 「全局参数」新增「安全」Tab,集中维护登录 PoW 开关和难度;登录页补充 Web Worker、Web Crypto、非 HTTPS 环境提示。
- 「API 接入」统一更名为「账户管理」,同页提供用户 Token、管理员密钥、TOTP、登录设备和免登凭证。
- 修复默认不限连接数的 TCP 隧道未累加运行时连接数、列表和资源拓扑始终显示“当前连接 0”的问题;现在始终统计活动连接,只有配置上限后才拒绝超额连接。
- 修复固定顶栏额外内边距、页面标题与顶栏重叠、全局参数五页签换行;所有页面标题、状态和说明统一进入固定顶栏,页面操作按钮保留在内容区一次。
- 修复登录、注册、验证码、PoW、请求大小、限频和邮件验证错误提示的中英文一致性;登录、注册和 IP 登记页面统一网络背景及明暗主题。
- Bridge 握手、NPC 版本、快捷命令、JSON 业务数据和既有
/api/v1字段保持不变,旧 NPC 无需同步升级。
v1.1.41 (2026-11-06)
- 同一 VKey 支持多个 NPC 在线实例,客户端详情展示实例 ID、主机名、系统、架构、局域网地址、Bridge 协议和连接时间,并可单独断开;新增
/api/v1/clients/{id}/instances接口。 - 新增分钟/五分钟历史用量采集、
conf/usage_history.json持久化、仪表盘 24 小时/7 天/30 天趋势图和GET /api/v1/status/history。管理员可查授权范围内的全局、用户、客户端、隧道和域名规则,普通用户只能查询自身资源;P2P 不计入。 - HTTP(S) 域名代理完整维护
X-Forwarded-Host、X-Real-IP、X-Forwarded-For、X-Forwarded-Proto、X-Real-Proto和X-Forwarded-Port,并支持覆盖、保留追加和可信代理策略。 - 增加客户端上传/响应总时长与停滞超时、后端连接/TLS/响应头/上传/读取超时,以及可选的安全隔离后端连接池;SSE、gRPC、WebSocket 和 multipart 流式响应豁免正文总时长。
- Bridge TLS 证书在文件替换或页面保存后自动热加载,无效的新文件继续使用最近有效证书;已有 TLS 连接不会被主动断开。
- 修复大屏快捷地址复用、打开按钮文字和 NPC 更新/系统服务路径;Windows 更新后服务不再继续启动旧桌面二进制。
- 旧版 NPC、历史快捷命令、JSON 数据和既有
/api/v1字段继续兼容;新增实例信息和局域网地址需要 NPC1.1.41及以上。
v1.1.40 (2026-11-02)
- NPC 配置创建的运行时客户端、隧道和域名反代改用独立临时 ID,不再消耗持久化 JSON 的自增序列;同一客户端的多个运行时 Host/隧道可并行存在。
- 客户端、隧道、域名反代和用户列表增加实时上行/下行带宽与连接指标排序,排序前使用统一快照,避免比较过程中重复读取实时状态。
- 所有列表分页统一为 20、50、100、200 条,并保留用户的分页选择;Host 列表现在完整传递服务端排序参数。
- 保持 Bridge 协议、快捷命令、JSON 持久化格式和
/api/v1既有字段不变,旧 NPC 与现有配置无需迁移。
v1.1.39 (2026-10-30)
- 用户管理和客户端列表改为用户名主行、备注次行显示,客户端备注和出口地址采用单行省略并保留完整悬浮提示,客户端备注与所属用户内容统一居中;管理员用户/客户端筛选统一使用「备注(账号)」和「客户端备注(ID)」,隧道与域名规则列表支持用户到客户端的联动筛选,同时保留单独筛选。
- 客户端列表默认显示入口、出口流量,表头拆分显示公网到内网、内网到公网方向;域名反代自定义域名增加独立来源标签,入口按钮改为保留外链图标的“HTTP / HTTPS”;客户端列按“客户端备注 · ID”“所属用户备注 · ID”两行展示,超长内容自动省略并可悬浮查看全文。
- 隧道列表的目标地址按 IP/端口分行展示,只有端口时仅显示端口;访问地址不再整行跳转,提供复制和 TCP HTTP 尝试按钮;TCP 当前连接列默认收起,仍可通过列表列设置和展开详情查看。
v1.1.38 (2026-10-29)
- 完善审计与连接页面:客户端连接日志记录 Bridge 主连接、子通道、早期握手/版本/连接类型失败、隧道和域名代理会话的详细来源与服务端地址,并尽可能展示客户端版本、公网/内网地址、内网地址来源、用户与客户端状态、到期时间和失败阶段;管理操作审计和连接日志的展开详情统一为紧凑的终端式原始 JSON 视图。认证失败不会伪造本次内网地址,只显示可确认的历史上报值及其来源。
- 统一所有列表页工具栏:资源操作保留在左侧,右侧固定按“搜索、筛选、列、刷新”从左到右排列;登录封禁和 IP 登记迁移到公共表格组件,域名反代补充列显示菜单,并修复窄桌面宽度下刷新按钮换行。
- 登录封禁列表新增关键词搜索、封禁类型和状态筛选及分页;服务端配置分类保存只校验当前页面负责的字段,修复证书、用户注册等专项配置阻塞通用页保存的问题。
- 服务端配置可视化页的字段卡片改为 3/4 列响应式网格,密码查看按钮保持单行。不改变 Bridge 协议、
nps.conf语义、JSON 持久化格式或/api/v1既有字段,NPS 与 NPC 无需同步升级。
v1.1.37 (2026-10-29)
- 新增 TCP、TCP + TLS、KCP、WS、WSS、QUIC 和 HTTP/3 共用入口的多 Bridge 命令展示,并引入兼容历史 v1 的 v2 快捷命令;NPC CLI、GUI 和系统服务完整支持协议、Path、ALPN、SNI 与证书指纹。
- 新增「证书设置」页面,集中维护 Bridge 证书、平台泛域名、HTTPS/ACME、管理面板 HTTPS 和 IP 登记 HTTPS,并显示配置证书与运行证书状态。
- 自定义域名的证书录入收敛为“上传”和“粘贴”;历史路径证书只读兼容并继续生效,平台泛域名与 Bridge 证书仍由管理员使用路径、上传或粘贴维护。
- 自定义证书必须先校验有效性、私钥匹配和域名覆盖才能保存,保存后持续显示证书来源、文件名、有效期、SAN、主题、颁发者和指纹等详情。
- 新增用户级最大并发连接数、共享上行带宽和共享下行带宽;同一用户全部客户端使用一组额度,
0表示不限,P2P 直连不计入。 - 「全局参数」新增「用户注册」Tab,集中维护注册入口、新账号默认权益、注册限频、邮箱验证和 SMTP;新注册默认值全部为不限制/永久有效。
- 管理员
POST /api/v1/users/register支持显式覆盖max_conn、upload_limit、download_limit,省略时读取对应注册默认值。 - 修复用户连接额度达到上限后仍继续放行的问题;并发额度按用户原子共享。
- 彻底移除旧版 IP 授权页面、代理链路、客户端模型字段和
/auth/ipwhiteauth、/api/v1/ipwhiteauth接口,只保留新版“仅允许已登记 IP”机制。 - 新增公开接口
POST /api/v1/ip-register;登记密钥只从 JSON 或表单请求体读取,访问 IP 由服务端按可信代理配置识别,客户端不能自行提交 IP。 - 修复域名反代新增和编辑页上传、粘贴证书时前端提交字段与后端读取字段不一致的问题;现可正常写入
conf/certs/host_<ID>.pem/.key。平台泛域名页面也会明确提示:未被主机引用时可更名或删除,已被引用时仅锁定名称,证书仍可更新。 /api/v1/hosts的新增、修改接口与 Web 表单统一证书规则:自定义域名只接受上传或粘贴,拒绝新服务器路径;历史路径仅可原样保留,查询不返回证书和私钥路径。- 修复同一 VKey 的不同协议会话互相覆盖、HTTP/3 错误复用浏览器证书、无效 HTTP/3 入口仍生成命令以及退出活动连接计数等问题。
v1.1.36 (2026-10-29)
- 自助注册改为创建独立用户并写入
users.json,支持后台配置默认客户端数、默认隧道数和默认有效天数;0继续表示不限制,有效期0表示永久。 - 注册支持图片验证码、独立提交限频、单 IP 成功注册上限,以及可选的 SMTP 邮箱一次性验证码。
- 新增管理员 API
POST /api/v1/users/register,可显式指定配额、expire_days或绝对expire_time;JSON 请求与查询参数中的管理员签名可同时使用。 - 用户邮箱不区分大小写且全局唯一;用户名、邮箱唯一性校验与写入已纳入同一互斥事务,避免并发注册产生重复账号。
- 注册页默认配额按实际配置值展示,仅在客户端或隧道配额为
0时标注“不限”,避免非零配额被误解。 - 重构服务端配置页,增加配置摘要、字段搜索、分组展开和完整源码视图;修复私钥路径被误隐藏及
auth_crypt_key、ZeroSSL API 密钥等敏感项未使用密码控件的问题。源码保存支持语法校验、关键配置关系校验和并发修订冲突检测。 - 普通用户可打开「IP 登记」菜单,并管理自己客户端下的登记;管理员继续管理全部客户端和公共登记桶,后端按实时归属执行隔离。
- 新增可配置的「使用说明」页面:支持远程 URL、
conf下的 HTML 文件或直接粘贴 HTML;粘贴内容自动写入conf/qa.html,文件缺失时页面仍可正常打开。 - 全局参数页按功能重新分组,服务端配置 Tab 补充图标;IP 登记、帮助文件读取和普通用户越权操作均增加回归测试。
- GeoIP/Geosite 路径留空时默认加载运行目录
conf下的数据文件,文件出现或更新后自动重新加载。 - 不改变 Bridge 协议、现有 Web 接口或
/api/v1调用;现有users.json无需迁移,NPS 与 NPC 无需同步升级。
v1.1.35 (2026-10-28)
- 修复普通用户访问
/user/api时页面白屏的问题。普通用户现在可以打开 API 接入页并管理个人 Token,包括再次查看和撤销;用户管理、全局参数和管理员 API 密钥接口仍仅限管理员访问。 - 新增普通用户页面访问与动作白名单回归测试,避免后续权限调整再次导致 API 接入页不可用或越权开放管理页面。
- README 中英文首页新增登录页、IP 登记页、客户端编辑页和域名反代编辑页截图。
- 不改变 JSON 持久化格式、
nps.conf、Bridge 协议或/api/v1;管理员行为保持不变,NPS 与 NPC 无需同步升级。
v1.1.34 (2026-10-26)
- 域名反代列表去掉「认证」列,改在访问入口前显示 Basic 认证锁图标(规则级或客户端级配置即点亮);列表接口只返回认证状态,不回传用户名密码。
- 域名反代与 TCP 隧道的展开详情统一为紧凑卡片布局,IP 名单以标签展示,长目标与 Header 使用代码块,Basic 密码只显示「已设置/未设置」。
- 全局参数「平台泛域名」输入区改为单列排版并限制输入宽度,证书路径、证书状态与到期信息不再拥挤。
- 修复域名反代新增/编辑页健康检查目标为空时保存被浏览器表单校验拦截的问题;未启用健康检查时相关字段自动禁用并填充默认值。
v1.1.33 (2026-10-26)
- 管理面板删除客户端时,NPS 会在断开前向在线的 NPC 下发「注册已删除」指令;新版 NPC 收到后关闭该客户端的控制连接与数据通道并停止重连,不再每 5 秒空转重试。旧版 NPC 忽略该指令,保持原有重连行为,兼容不变。
- 停用、到期和用户禁用仍使用普通断开方式,NPC 在状态恢复后可继续自动重连。
- NPC 以系统服务运行时收到删除指令,只停止被删除的那条连接;当该服务进程内的最后一条连接也因删除而结束时,才会自动停止本机 NPC 服务,但保留服务注册(Windows、Linux systemd/sysv/upstart、macOS launchd 等均处理),之后仍可用 npc 命令手动启动或停止。同一进程同时连接多个服务端时,删除其一不会影响其他连接。停止是尽力而为的后台动作,失败也不会阻塞 Web 端删除。
- 修复 NPC 数据通道(MUX)关闭时因查询 socket 缓冲大小把连接切到阻塞模式,导致连接迟迟无法真正断开、文件描述符泄漏的问题;现在删除客户端后数据通道会立即完整释放。
- NPS/NPC Docker 镜像补齐 CA 证书,修复 Geo 数据在线更新与版本检测报
x509: certificate signed by unknown authority的问题。 - 「API 接入」页面的文档链接改为官方文档站
https://zidunet.github.io/nps/api.html,并修复管理员生成密钥按钮请求错误路径的问题。 - 登录页、管理面板主布局和错误页统一显示浏览器标签页图标(favicon)。
v1.1.32 (2026-10-26)
- 新增统一对外 API
/api/v1:覆盖客户端、隧道、域名反代、用户、全局参数、Geo、登录保护、IP 登记、审计、状态与拓扑,全部返回status/code/msg/error_code/request_id信封。 /api/v1只接受 API 凭据(管理员auth_key+timestamp或普通用户Bearer npsu_...),不依赖浏览器 Session;普通用户资源继续按授权客户端过滤。- 新增公开的
/api/v1/time、/api/v1/authkey、/api/v1/ipwhiteauth与发现接口/api/v1;旧/api/v1/ipwhiteauth已在后续版本删除,现使用/api/v1/ip-register。 - 认证辅助接口统一收口到
/api/v1;未进入正式发布的/v1/auth/*已移除,旧/auth/*保持不变。 - 对外 API 支持
application/json请求体,默认分页limit=20、最大500,支持page/page_size。 - 旧
/client/*、/index/*、/user/*、/global/*、/auth/*路径和返回格式保持不变,现有 NPC 与页面无需调整。
v1.1.31 (2026-10-26)
- 移除管理面板的全局同源/Origin 校验:反代、混合 HTTP/HTTPS 和多端口部署不再出现「invalid request origin」误拦,POST 仅校验请求方法与登录/API 凭据。
GetClient、GetOneTunnel、GetHost单个查询接口同时返回旧code/data与标准status/msg字段;新增/复制隧道成功响应直接携带AccessHost、AccessAddr、AccessURL等访问地址,无需再回查列表。addhost失败提示补齐标点,错误信息直接说明域名前缀冲突原因。- Secret/P2P 的
target_type(tcp、udp、all)升级为真实转发能力;UDP 使用数据报帧协议保留报文边界,旧记录与旧客户端继续按 TCP 兼容。 - NPC 访客新增
-fallback_secret(默认开启),P2P 直连失败后自动回退 Secret 中继。 - 普通隧道新增隧道级最大连接数和总流量配额,0 表示不限,支持 Web 表单与 API。
- 域名反代证书统一支持路径、上传、粘贴三种录入方式并提供有效性校验,平台泛域名与自定义域名行为一致。
- 新增「系统 → API 接入」页面:Token 可再次查看和撤销;管理员拥有
nps.conf密钥与网页密钥两套等价凭据,查看原文需验证登录密码。 - 全局参数支持查看 Geo 数据状态并在线更新,默认使用
conf/geoip.dat和conf/geosite.dat。 - 仪表盘补齐 Bridge 各入口端口、P2P 地址、IPv4/IPv6 出口地址、已登记 IP 数和最小安全握手版本等配置信息,并按卡片分组。
- 普通用户可设置自己名下客户端的独立到期时间,仍受所属用户有效期约束。
- 客户端版本号改为可点击入口,弹窗检测最新版本并下发远程升级。
- 管理面板移除 ZUI 并全面迁移 Bootstrap 5.3.3;表单按业务分组、高级项收起、字段联动,列表详情紧凑多列展示,工具栏与操作交互统一,减少整页刷新。
- 公共 vkey 注册生成 16 字符验证密钥,修复配置文件模式注册卡死;
quic-go升级至 v0.64.1,修复 Go 1.26 下 P2P 直连 QUIC 握手 panic。
v1.1.30 (2026-10-25)
- NPS/NPC 配置文件和命令行支持自定义 DNS;多个 DNS 服务器会轮询并在失败时切换,未配置时保持系统解析器。
- NPC 出站 Bridge 代理支持 HTTP/HTTPS CONNECT、SOCKS4/4a、SOCKS5/SOCKS5H,以及
ALL_PROXY/NO_PROXY环境变量。 local_ip与local_ip_forward现在实际作用于 TCP、UDP、SOCKS5 UDP、KCP、QUIC 和 P2P 相关出站连接;私网目标仍保持默认路由。- 补齐 NPC Docker/配置文件说明,并继续兼容旧客户端与旧配置。
- NPC 命令行支持同时连接多个 NPS 服务端,配置文件模式支持多份配置并行运行;管理员可查看、解封和清理登录保护记录。
- 直接启动的 NPC 可用
-disable_remote_update=true忽略服务端升级指令,并新增npc update-force重新安装同版本正式包。 - SOCKS5 UDP ASSOCIATE 使用共享 UDP 端口和会话注册,支持多来源绑定、队列保护、空闲/断线回收、目标 ACL 与大报文转发。
- 隧道列表把配置、监听、客户端状态合并为一组紧凑状态标记,表头支持悬浮显示完整名称,窄屏使用卡片布局避免横向滚动。
v1.1.29 (2026-10-24)
- HTTP 正向代理与 SOCKS5 在 Web 面板统一为混合代理;旧 HTTP/SOCKS 规则继续兼容,编辑时可迁移为混合代理。
- 新增按功能分组的服务端配置页,可维护
nps.conf、脱敏敏感字段、关闭可选键并在保存后提示重启。 - 补齐 WebSocket/WSS、QUIC、IP 登记和日志轮转配置;升级不会重新添加已关闭的可选配置。
- 新增 Web 隧道与域名规则的后端健康检查配置,支持 HTTP 200/TCP、超时、失败次数、检查间隔和 HTTP 路径。
- 服务端按客户端下发健康检查配置;仅兼容新控制消息的 NPC 会接收,旧版 NPC 保持原有协议和本地
[health_*]配置不变。 - 新增健康配置的原子校验、持久化、资源启停/迁移后的实时刷新,以及多资源重复目标去重。
- TCP/Host 接口继续返回访问地址和端口信息;编辑页面补齐健康检查字段,配置文件模式兼容旧字段。
- 普通隧道和 Host 规则支持独立的
upload_limit/download_limit,列表和 API 返回当前方向速率;旧数据缺少字段时按不限速处理。 - NPC 配置模板和迁移文档补充规则级限速字段,升级不会覆盖既有配置值。
v1.1.28 (2026-10-22)
- 客户端列表展开详情安全显示 Basic 认证用户名和旧版客户端用户名;密码只显示是否已设置,不返回明文。
- 域名解析新增“跨域与兼容”开关说明,明确自动 CORS、兼容模式、OPTIONS 预检和 WebSocket 的实际行为。
- 域名解析新增和编辑页面统一展示两个开关的独立说明。
v1.1.27 (2026-10-22)
- 修复 NPC 系统服务日志权限过严导致普通用户无法读取的问题;日志文件与轮转文件统一为
0644,并改进旧日志权限错误提示。 - 修复 GUI-NPC 收到服务端升级指令时没有升级处理器的问题,补齐下载校验、替换和自动重启流程。
- NPC 手动更新与远程更新增加互斥,复用 Release 元数据请求,减少 GitHub API 限流风险。
- 客户端列表升级按钮放入常驻操作列;同步补齐 NPC 日志、批量重启与更新文档。
v1.1.26 (2026-10-22)
- 恢复 v1.1.24 的产品功能基线,并保留客户端远程升级、连接日志分类和普通用户删除自有客户端等能力。
- 恢复 v1.1.23 发布流水线:master 推送触发 CI、文档和 Docker 测试构建;正式标签触发跨平台 Release 和版本号镜像构建。
v1.1.25 (2026-10-22)
- 日常推送不再自动触发流水线;正式版本标签统一触发 CI、文档部署和 Release。
- 正式 Release 的 Docker 多架构构建同时推送版本号标签和
latest,不再需要额外的镜像晋升任务。 - Release 页面正文自动提取当前版本记录,并保留 GitHub 自动生成的变更摘要。
v1.1.24 (2026-10-21)
- 普通用户可从客户端列表删除自己名下的客户端。
- 删除操作会同步清理该客户端的隧道、Host 域名规则和在线连接,并在归属变更竞态下再次校验所有权。
- 旧版按客户端登录的会话不能获得自助删除权限;管理员仍可删除任意客户端。
- master Docker 构建只发布
sha-<短提交号>测试标签;正式 Release 同时发布版本号标签和latest稳定标签。
v1.1.23 (2026-10-21)
- 管理员可从客户端列表向在线且支持升级的 NPC 下发远程升级指令。
- NPC 在后台下载并校验 GitHub Release 后替换自身并自动重启;Windows 服务使用临时更新器处理运行中可执行文件占用。
- 升级过程遵循 NPC 服务账户权限,不尝试提权;安装目录不可写或校验失败时保持当前客户端运行。
v1.1.22 (2026-10-15)
- 修复 Bridge 连接、代理认证和更新包校验等兼容性问题。
v1.1.21 (2026-10-12)
- 修复 Web 面板配置
web_base_url后验证码仍请求根路径的问题,适配反向代理子路径。 - 修复系统服务启动时 Web 面板相对证书路径按错误工作目录解析的问题。
- 修复 SOCKS5 UDP
BND.ADDR优先返回错误外网地址的问题,增加校验过的 HTTPS 外网 IP 备用探测。 - 服务端更新成功后,若已安装系统服务则自动重启使新版本生效。
v1.1.20 (2026-09-22)
- 资源拓扑大屏密钥改为服务端加密持久化,授权账号刷新后仍可查看密钥、复制快捷地址并打开大屏;重新生成和撤销仍会立即失效旧地址。
- 管理员用户列表把 API Token 的生成、重新生成和撤销按钮放入 Token 状态列,操作列只保留启用/停用、编辑和删除。
- 用户列表客户端数、隧道数列宽收窄到适合三位数字的宽度。
v1.1.19 (2026-09-22)
- 普通用户可在账号区域自助生成、重新生成和撤销 API Token,管理员用户列表增加 Token 状态和撤销操作。
- 新增管理员/普通用户隔离的只读资源拓扑大屏快捷地址,支持自定义密钥和随时撤销。
- 补齐 Web API 与大屏快捷地址文档。
v1.1.18 (2026-09-21)
- 资源拓扑大屏默认每 60 秒刷新,管理员和普通用户页面均可自定义 5–3600 秒刷新间隔;设置保存在当前浏览器,不影响服务端转发。
v1.1.17 (2026-09-21)
- 增加 Linux GUI 发布依赖下载和 Wails 构建重试,避免网络抖动导致 Release 被跳过。
- 统一 GUI 安装包元数据版本到
1.1.17。
v1.1.16 (2026-09-21)
- 新增管理员操作审计日志:记录登录、用户、客户端、隧道、Host 和全局配置变更,日志使用本地 JSONL 文件保存,不记录密码、API 令牌、证书私钥或代理请求体。
- 新增按用户授权范围生效的 API 令牌,支持
Authorization: Bearer,令牌仅在生成时显示一次,用户停用或到期后立即失效。 - Host 域名代理新增路径重写、响应头修改、重定向、自动 CORS 和兼容模式;原始 HTTP 路径保护响应分帧头,避免改写导致分块响应截断。
- 管理面板新增管理员操作审计页面,并补齐相关配置与 API 文档。
v1.1.15 (2026-09-20)
- 修复 MUX 收到对端关闭帧时立即释放接收队列的问题。HTTP/1.0 无
Content-Length响应、分块响应和 TCP 流在关闭前会完整排空已缓冲的尾部数据。 - 对未被本地调用方读取的已关闭流增加 30 秒兜底回收;正常读取完成后立即释放,不影响现有 NPC 兼容性。
v1.1.14 (2026-09-20)
- 资源拓扑大屏改为直接基于用户提供的原型布局:保留顶栏、账号摘要、客户端与规则节点、连线、图例和右侧详情抽屉。
- 移除原型中的用户切换器,仅展示当前登录账号的授权资源;仪表盘入口改为在新标签页打开,继续使用全局登录鉴权与 Logo。
v1.1.13 (2026-09-20)
- 新增独立的资源拓扑大屏:按当前登录账号的授权范围展示客户端、隧道和域名规则,支持筛选、展开和资源详情查看。
- 页面每 5 秒从服务端内存读取实时状态、连接数、流量和速率,不持久化监控快照,也不会干扰转发链路。
- 仪表盘增加资源拓扑入口;直接访问页面沿用全局登录鉴权,接口不返回密钥、证书路径或认证配置。
v1.1.12 (2026-09-19)
- 修正 TCP、UDP、Host HTTP/HTTPS 与 WebSocket 的入口/出口流量统计:入口统一为公网到内网,出口统一为内网到公网;流量配额按真实双向总量计算。
- 控制台隧道列表明确区分配置状态、监听状态和客户端状态,显示 TCP 当前连接数;监听启动失败时保留错误原因并在仪表盘汇总。
- 实时请求调试器向拥有该资源权限的管理用户展示完整请求/响应头,不再对敏感头脱敏;仍只在订阅期间保留有界内存事件,不写入磁盘且不会阻塞转发。
- 文档补充流量方向、客户端共享带宽限制、配额语义和隧道状态说明。
v1.1.11 (2026-09-19)
- 新增隧道和域名规则的实时请求调试器,支持来源、监听、实际后端目标、请求/响应头、状态、耗时和流量信息。
- 对 NPS 可见明文的 HTTP(S) 域名代理,实时展示文本请求体和响应体;文件、二进制和敏感头自动忽略或脱敏。
- 调试事件只保留在有界内存队列中,浏览器处理慢时丢弃调试事件,不阻塞隧道转发。
v1.1.10 (2026-09-10)
- 修复 Linux NPC 注册 systemd/SysV 系统服务时引用临时解压路径的问题。
- 防止从
/usr/bin/npc重复安装时自覆盖二进制。
v1.1.9 (2026-09-09)
Host 反向代理稳定性
- 修复客户端请求使用
Connection: close时,Host 反向代理未等待后端响应完成就关闭连接,导致分块或压缩响应被截断。 - 增加分块响应终止块和客户端半关闭连接的回归测试,保留有限响应与 SSE 的原有清理行为。
v1.1.8 (2026-09-04)
用户资源与有效期
- 管理员可设置用户最大客户端数量,普通用户可在配额内自助创建客户端,用户所有客户端共享用户隧道配额。
- 客户端到期时间不得晚于用户到期时间;客户端留空时跟随用户,用户未设置到期时可独立设置或永不过期。
- 客户端新增和编辑支持 Basic 认证、压缩、加密及访问控制,服务端统一执行配额和到期边界校验。
控制台与品牌
- 表单统一到期控件、配额提示和自动填充策略,透明 NPS Logo 已接入登录页、控制台和文档站。
- 后台顶栏显示当前服务端版本,并在检测到更高的正式 Release 时提示更新。
v1.1.7 (2026-09-03)
稳定性修复
- 控制台菜单导航采用最新请求生效策略,快速点击或浏览器前进后退不会再出现地址与内容不一致。
- 新增、编辑隧道在任何数据写入和服务重启前验证代理模式,未知模式会被拒绝。
- 通用新增隧道页面的返回列表链接会随所选模式同步更新。
v1.1.6 (2026-09-02)
发布整理
- 同步控制台 UI、平台泛域名与证书热更新改进,统一 NPS、NPC 和 GUI 发布元数据,准备 GitHub Release 与 Docker 版本标签发布。
- 控制台运行时移除 Bootstrap、Bootstrap Table、Popper 和 DataTables 静态资源,表格改用 ZUI 主题下的原生 NPS 表格适配器,保留原有服务端分页、排序与筛选接口。
v1.1.5 (2026-09-02)
仪表盘与流式代理
- 仪表盘按管理员/普通用户权限隔离客户端、隧道、Host、流量和配额,增加客户端/隧道运行状态、NPS 代理入/出站速率、配额与健康告警、最后更新时间和 15 秒局部刷新。
- 修正当前代理连接、内存百分比和资源状态图表,并修复菜单切换和全屏加载闪烁。
- Host SSE、长连接与 WebSocket 双向转发增加持续输出、客户端中断和资源释放回归保护。
控制台表单与平台域名
- 新增/编辑页统一为清新蓝色 ZUI 响应式表单,桌面端双列、移动端单列,长字段全宽并消除横向滚动。
- 平台泛域名证书和私钥允许同时留空,留空时仅支持 HTTP;编辑隧道和 Host 显示客户端名称与 ID 且客户端 ID 只读,后端不会接受篡改的归属。
v1.1.4 (2026-09-02)
域名代理与证书
- 全局参数新增平台泛域名池,可维护多个
*.example.com、证书与私钥路径;配置保存在conf/global.json,被引用的域名不能删除或改名。 - Host 新增自定义域名和平台域名两种模式。平台子域名默认生成可修改的 8 位前缀,后端强制校验唯一性并锁定平台证书。
- 证书续期脚本以临时文件原子替换后,新 TLS 连接自动加载有效的新证书;文件损坏、缺失或不匹配时继续使用最近有效证书,不重启服务也不打断已有连接。
管理与文档
- 域名列表按协议展示 HTTP/HTTPS 链接,新增规则诊断,可确认 Host、路径和协议的路由命中与目标选择。
- 新增平台泛域名、证书热更新与规则诊断,并更新域名代理、全局参数、配置持久化和功能索引说明。
- NPS/NPC/GUI 版本统一升级到
1.1.4。
v1.1.3 (2026-09-02)
发布与更新
- 正式 Release 改为在所有平台构建完成后统一上传,并附带 SHA-256 校验文件。
- CLI 与 GUI 更新器按规范语义版本下载并校验平台资产和 SHA-256,避免安装非正式构建。
- 补齐 Linux ARM 通用包和 Windows ARM64 CLI 包,macOS GUI 更新改为替换完整
.app包。
Bridge 协议与兼容性
- 增加 Bridge 握手超时保护、HTTP CONNECT 代理鉴权、SOCKS5 认证协商和更新包安全校验。
- 恢复服务端请求客户端局域网地址、客户端断线重连和心跳退出处理。
- 兼容客户端配置别名
server/server_addr、tp/conn_type。
Web 管理面板
- 默认语言为简体中文,登录页和管理页支持中英文切换。
- 修复 Bootstrap 下拉菜单缺少 Popper.js 导致语言菜单无法打开的问题。
- 管理面板升级为基于 ZUI 3 的运维控制台:统一导航、面板、表格、表单说明、状态与空数据反馈,支持浅色/深色主题、响应式布局和键盘可访问交互。
- 补齐加载、空数据、错误和表单反馈状态,动态详情内容统一转义。
运行时可靠性与安全
- 客户端连接数配额使用原子预留,流量统计提供一致快照;HTTP、UDP、WebSocket 代理加强并发关闭和资源回收。
- 发布模板不再携带固定弱凭据;首次启动会轮换已知占位值,配置和日志文件权限按最小权限创建。
- 随机凭据使用系统 CSPRNG,IP 白名单授权接口限制为同源访问,日志不再输出授权密码或客户端密钥。
- 当整个
users.json在升级时缺失,会从仍保留旧凭据的历史客户端恢复对应用户;已存在文件中的删除、停用或到期状态仍严格生效。
v1.1.2 (2026-06-23)
隧道表单
- 修复新增和编辑隧道时不同类型字段显示不稳定的问题。
- 隧道表单按 TCP/UDP、HTTP 代理/SOCKS5、私密代理/P2P 和文件访问类型展示相应目标、监听、密钥及目录字段。
- Web 模板启动时会从嵌入资源同步覆盖,避免部署后继续读取旧模板。
Docker 构建
- 新增
.dockerignore,显著减少构建上下文。 - Dockerfile 使用 Go module 缓存和 BuildKit cache mount。
- GitHub Actions Docker 镜像构建启用 GHA 缓存,并通过 Go 交叉编译减少 QEMU 模拟构建耗时。
v1.1.1 (2026-06-15)
用户体系
- 新增独立
User模型,用户数据保存到conf/users.json。 - 管理员可创建普通用户,并将多个客户端分配给同一个用户。
- 普通用户登录后可查看和管理自己名下多个客户端。
- 普通用户权限按客户端归属过滤,不能访问用户管理和全局设置。
配额和到期
- 新增用户级最大隧道数限制。
- 普通隧道和 Host 域名规则统一计入客户端级和用户级配额。
- 用户到期后自动停用,并断开/清理名下客户端运行资源。
兼容迁移
- 启动时自动将旧客户端
WebUserName/WebPassword迁移为普通用户。 - 同名同密码合并;同名不同密码自动生成
用户名_客户端ID。 - 保留旧客户端登录兼容,降低升级风险。
CI/CD
- 修复 GUI 前端
package.jsonBOM 导致的 Yarn 安装失败。 - GUI 构建统一使用 Yarn 1.22.22。
v1.1.0 (2026-06-10)
Web UI
- 重写 Web 管理面板视觉样式。
- 支持明暗主题切换。
- 优化仪表盘、列表、表单、按钮和图表展示。
修复
- 修复 HTTP/HTTPS/SOCKS5/P2P 等代理连接资源释放问题。
- 修复 mux 连接池 goroutine 和内存泄漏问题。
- 修复登录验证码绕过问题。
- 修复客户端列表网速和连接数显示问题。
- 修复限速零值导致永久阻塞的问题。
功能
- 支持客户端到期时间。
- NPC 菜单新增更新客户端。
- NPS/NPC 菜单显示当前版本号。
v1.0.0 (2026-05)
- 基于原版 nps 0.26.10 的二次开发基线。
- 修复流量统计。
- 重设计 Web UI。
- 新增 Docker Compose。
v0.26.10
- 基于原版 NPS 原始基线,当前项目仓库:ZiDuNet/nps。
