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

增强功能

HTTPS 域名代理

NPS 根据域名规则是否绑定证书选择 TLS 处理方式:

证书配置行为NPS 可获取的信息
已配置证书与私钥NPS 终结 TLS,再以 HTTP 转发给内网目标请求头、来源地址和正文
未配置证书TLS 流量由内网目标自行终止只能转发加密连接,不能修改 HTTP 内容

自动 HTTPS

在「域名反代」的新增或编辑页勾选「自动 HTTPS」后,NPS 会把对应域名的 HTTP 请求以 301 重定向到 HTTPS。重定向会使用 https_proxy_port 中的端口; 例如 https_proxy_port=8443 时会跳转到 https://<host>:8443/...。

HTTPS 证书来源

「域名反代」中的自定义域名只提供上传和粘贴两种证书录入模式:

  • 上传模式:从本机选择证书和私钥文件,由 NPS 安全托管。
  • 粘贴模式:直接粘贴 PEM 内容,由 NPS 安全托管。

两种模式只需填写当前选中的一组,并且必须先通过有效性、私钥匹配和域名覆盖 校验才能保存。管理员仍可在「证书设置」中通过路径维护平台泛域名和 Bridge 证书。历史自定义域名中已经保存的路径证书继续生效并只读回显;外部脚本原子 替换有效证书后,后续 TLS 连接会自动加载,无需重启 NPS。完整说明见 域名代理与路由。

TLS 桥接加密

为保护客户端到服务端的 Bridge 流量,可启用 TLS:

# nps.conf
tls_enable=true
tls_bridge_port=8025      # 与 bridge_port 并存

客户端任选一种方式接入:

npc.exe -server=1.1.1.1:8024 -vkey=xxx                       # 明文桥接(bridge_port)
npc.exe -server=1.1.1.1:8025 -vkey=xxx -tls_enable=true      # TLS 桥接(tls_bridge_port)

客户端默认会校验证书。使用自签名证书时,请配置 -tls_fingerprint、-tls_ca_file 或 -tls_server_name;-tls_insecure_skip_verify=true 仅用于兼容旧部署,生产环境不要开启。

QUIC Bridge

服务端配置 bridge_quic_port(UDP,默认 0 关闭)后,NPC 可使用:

./npc -server=1.1.1.1:8026 -vkey=xxx -type=quic -tls_fingerprint=sha256:...

quic_alpn 两端必须一致,默认值为 nps。QUIC 使用 Bridge 证书完成 TLS 握手,需放行 UDP 端口;它承载 NPS Bridge 字节流,不是浏览器直接访问的 HTTP/3 反向代理。

全局参数

管理员进入「系统 → 全局参数」的「全局参数」Tab,可维护保存在 conf/global.json 中的业务设置:

字段含义
服务地址控制台生成客户端快捷命令、隧道访问地址和域名链接时优先使用的对外主机名;留空时回退到当前访问地址。它不改变实际监听地址
全局最大连接数所有客户端和代理入口共享的并发连接上限;0 表示不限
全局限速所有转发流量共享的总带宽上限,单位 KB/s,并叠加在客户端和资源限速之上;0 表示不限
全局 IP 黑名单 / 白名单支持 IPv4、IPv6、CIDR、IPv4 通配和 geoip: 规则,作用于客户端连接、代理入口和 Web 面板。同时配置两张名单时可选择“黑名单优先”或“白名单优先”
使用说明自动识别远程 URL、conf 下的 HTML 文件或粘贴的 HTML;远程 URL 和本地文件说明见使用说明页面配置
Geo 数据显示 geoip.dat、geosite.dat 的路径、大小、加载状态和版本,并支持在线更新

平台泛域名、Bridge/管理面板/默认 HTTPS 证书和 ACME 已集中到 「系统 → 全局参数」的「证书设置」Tab。访问控制规则和配额优先级见 访问控制与配额,字段默认值见 服务端配置文件参考。

代理到服务端本地

默认情况下,TCP、UDP 和域名规则的目标由所属 NPC 去连接。若要把请求转发到 运行 NPS 的服务器本机,先在 nps.conf 开启:

allow_local_proxy=true

重启 NPS 后,在 Web 面板新增或编辑隧道、域名规则时勾选「转发到本地」。两个条件都必须满足:

  1. 全局开关为 true,否则面板不会保存本地转发标记。
  2. 对应规则明确勾选「转发到本地」。

勾选后,目标地址由 NPS 进程连接。例如 NPS 机器上有服务监听 127.0.0.1:8081,可创建 Host 规则并将目标设为该地址;访问者请求 NPS 的 HTTP(S) 入口后,会由 NPS 直接转发给本机服务,不经过 NPC。

Docker 与端口边界

  • Linux 上 NPS 使用 network_mode: host 时,NPS 容器中的 127.0.0.1 就是宿主机回环地址。
  • NPS 使用默认 bridge 网络时,容器内的 127.0.0.1 只指向容器自身。应改用宿主机可达地址,或将目标服务与 NPS 放入同一 Docker 网络。
  • 域名解析只负责把域名指向 NPS 公网 IP,不会替你开放端口。若 HTTP 入口设为 30111,访问地址必须写成 http://example.com:30111/,并在云安全组、宿主机防火墙和容器网络中放行该端口。
  • 在 NPS 主机本地先验证监听:curl -H 'Host: example.com' http://127.0.0.1:30111/;成功后再从外网验证。

本地转发让规则创建者可以访问 NPS 主机可达的内部服务。只应授予可信管理员,且应将管理面板限制在管理网络。

客户端与资源访问控制

客户端、隧道和 Host 都可以维护黑名单、白名单及冲突策略。规则支持 IPv4、 IPv6、CIDR、IPv4 通配和 geoip:;geosite: 只用于混合代理的目标 ACL。 需要来源固定、可提前录入时使用静态名单;需要允许访问者自助登记时使用 “仅允许已登记 IP”。

开启“仅允许已登记 IP”后,访问者先到 /ip/register 输入登记密钥,将 服务端识别到的公网来源地址登记一段有限时间,再访问目标资源。

登记密钥可使用客户端或资源自身的 register_key,也可由管理员配置 public_register_key。登记最长有效期由客户端/资源设置和 ip_register_max_hours 共同约束;记录只保存在内存中,到期或 NPS 重启后 失效。普通用户只能管理自己客户端下的登记,管理员可管理全部登记。

API 集成使用 POST /api/v1/ip-register。旧版“IP 授权密码”、跳转授权页、 持久化 IP 授权列表以及 /authIp、/auth/ipwhiteauth、 /api/v1/ipwhiteauth 均已删除。

后端 PROXY Protocol

TCP 隧道和域名反代的编辑页都提供「后端 PROXY Protocol」选项。选择 PROXY v1 或 PROXY v2 后,NPS 会在每个新后端 TCP 连接开始时发送对应的 PROXY 头,让明确支持该协议的后端获知访问者地址。普通 HTTP 服务不应开启 该选项;只有 Nginx、HAProxy 等后端显式启用 PROXY Protocol 时才应使用。

Web 登录验证码

nps.conf 中:

open_captcha=true

开启后 Web 登录页会要求图形验证码。结合登录失败限频、来源 IP 策略和 HTTPS 反向代理,可以降低暴力破解风险;具体窗口与失败次数见 Web 管理保护。

关闭代理

如需关闭 HTTP 域名代理,将 http_proxy_port 留空;如需关闭 HTTPS 域名代理, 将 https_proxy_port 留空。

流量数据持久化

服务端默认每 1 分钟持久化一次流量数据。将 flow_store_interval 设为空或 0 可关闭定时持久化;单位为分钟。

注意: NPS 不会持久化通过公共 VKey 连接的客户端。

系统信息显示

NPS 支持在 Web 仪表盘显示服务器 CPU、内存、连接和网卡信息。 system_info_display 默认开启;如需关闭,可在 nps.conf 中设置 system_info_display=false。

关闭 Web 管理

将 nps.conf 中的 web_port 设置为空或删除。

服务端多用户登录

allow_user_login 默认开启。当前优先使用「用户管理」中创建的普通用户账号登录, 账号与密码保存在 users.json;登录后可管理归属给该用户的多个客户端,并可在 MaxClientNum(0 表示不限制)内自行创建客户端。历史客户端仍兼容旧登录方式: allow_user_vkey_login=true 时,配置过 WebUserName/WebPassword 的客户端使用 该凭据;也可使用用户名 user、客户端旧版面板用户名或所属用户的用户名/邮箱,与该客户端 VerifyKey 登录,权限始终限于该客户端。关闭此开关不影响独立用户账号/邮箱与密码登录。新部署应 关闭旧 VKey 登录并使用独立用户体系,详见用户体系。

用户注册功能

将 allow_user_register=true 后登录页会出现注册入口。注册成功后创建独立用户并写入 users.json,不会再把面板用户名和密码写入客户端记录。 同一开关还控制登录页“注册”旁的“找回密码”入口及其接口:只有开放注册才允许通过绑定邮箱找回独立用户密码,复用 SMTP 配置;管理员账号和客户端 VKey 不参与此找回流程。详见找回密码。

注册页和管理员 API 均支持以下默认规则:

  • register_max_clients:新用户默认客户端配额,0 表示不限;
  • register_max_tunnels:新用户默认隧道总配额,域名反代也计入,0 表示不限;
  • register_max_conn:新用户全部客户端共享的并发连接上限,0 表示不限;
  • register_upload_limit:新用户全部客户端共享的上行带宽,单位 KB/s,0 表示不限;
  • register_download_limit:新用户全部客户端共享的下行带宽,单位 KB/s,0 表示不限;
  • register_expire_days:新用户从注册成功时起默认有效天数,默认 0(永久有效);
  • register_captcha:是否要求图片验证码;
  • register_rate_window、register_rate_limit、register_ip_rate_limit:注册限频;
  • register_email_verify、SMTP 参数和邮箱验证码参数:可选邮箱验证。

公开注册受 allow_user_register 控制;管理员通过 POST /api/v1/users/register 创建账号时不受该公开注册开关限制。完整字段、SMTP 示例和迁移说明见 服务端配置。所有注册参数也可在 「系统 → 全局参数」的「用户注册」Tab 中维护。

监听指定 IP

NPS 支持每个隧道监听不同的服务端 IP。nps.conf 中设置 allow_multi_ip=true 后,可在 Web 面板控制,或在 NPC 配置文件中指定:

server_ip=xxx

客户端到期时间

在创建 / 修改客户端时可填写「到期时间」(可留空表示跟随所属用户;用户也未设置时表示永不过期)。客户端到期时间不能晚于所属用户到期时间;到期后该客户端会被自动暂停,所有隧道停止服务,直到管理员手工延长或清空到期时间并重新启用客户端。用户到期会同时暂停该用户的所有客户端和隧道。 支持格式:2006-01-02 15:04:05 / 2006-01-02 15:04 / 2006-01-02T15:04:05 / 2006-01-02T15:04 / 2006-01-02。

首次启动随机凭据

为避免默认密码被恶意扫描,首次启动时用户名默认为 admin,web_password、auth_key、auth_crypt_key 会随机生成,并直接打印到终端:

[INFO] Web login username: admin, password: <xxxxxxxx>
[INFO] auth_key: <xxxxxxxx>
[INFO] auth_crypt_key: <xxxxxxxxxxxxxxxx>

请在第一次启动时妥善记录。后续可在 nps.conf 中手工修改。

与 Nginx 配合

有时需要在云服务器上运行 Nginx,做静态缓存或多服务复用 80/443。 可把 http_proxy_port 设为非 80 端口(例如 8010),再由 Nginx 反代:

server {
    listen 80;
    server_name *.proxy.com;
    location / {
        proxy_set_header Host  $http_host;
        proxy_pass http://127.0.0.1:8010;
    }
}

如需 HTTPS 也由 Nginx 终结,将 https_proxy_port 留空关闭,由 Nginx 监听 443。下面使用当前推荐的 TLS 配置:

server {
    listen 443 ssl;
    http2 on;
    server_name *.proxy.com;

    ssl_certificate     /etc/letsencrypt/live/proxy.example.com/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/proxy.example.com/privkey.pem;
    ssl_session_timeout 5m;
    ssl_protocols TLSv1.2 TLSv1.3;
    ssl_ciphers HIGH:!aNULL:!MD5;
    ssl_prefer_server_ciphers on;

    location / {
        proxy_set_header Host $http_host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $remote_addr;
        proxy_set_header X-Forwarded-Proto $scheme;
        proxy_pass http://127.0.0.1:8010;
    }
}

如果 NPS 前面还有其他可信代理,应只在该链路按实际架构传递真实 IP,并确保 每一层都覆盖而不是追加客户端自带的 X-Forwarded-For。

Web 管理使用 HTTPS

可直接在 nps.conf 中设置 web_open_ssl=true 并配置 web_cert_file、 web_key_file;也可以在「系统 → 全局参数」的「证书设置」Tab 中打开 “管理面板 HTTPS”进行维护。证书替换后需重启 NPS。

Web 使用 Caddy 代理

以下示例把管理面板发布到 https://nps.example.com/nps,并保留 /nps 路径。nps.conf 中同时设置:

web_base_url=/nps

Caddy 2 配置:

nps.example.com {
    reverse_proxy /nps/* 127.0.0.1:8081
}

修改 web_base_url 或代理路径后重启 NPS,并清理浏览器缓存。不要再使用 Caddy v1 的 proxy / ... { transparent } 语法。

在 GitHub 上编辑此页
最后更新: 2026/11/15 16:17
Prev
配置文件参考
Next
服务端介绍