nps

README|中文文档

nps是一款轻量级、高性能、功能强大的内网穿透代理服务器。目前支持tcp、udp流量转发，可支持任何tcp、udp上层协议（访问内网网站、本地支付接口调试、ssh访问、远程桌面，内网dns解析等等……），此外还支持内网http代理、内网socks5代理、p2p等，并带有功能强大的web管理端。

一、背景

1. 做微信公众号开发、小程序开发等----> 域名代理模式

2. 想在外网通过ssh连接内网的机器，做云服务器到内网服务器端口的映射，----> tcp代理模式

3. 在非内网环境下使用内网dns，或者需要通过udp访问内网机器等----> udp代理模式

4. 在外网使用HTTP代理访问内网站点----> http代理模式

5. 搭建一个内网穿透ss，在外网如同使用内网vpn一样访问内网资源或者设备----> socks5代理模式

二、特点

• 协议支持全面，兼容几乎所有常用协议，例如tcp、udp、http(s)、socks5、p2p、http代理...
• 全平台兼容(linux、windows、macos、群辉、OpenWrt等)，支持一键安装为系统服务
• 控制全面，同时支持服务端和客户端控制
• https集成，支持将后端代理和web服务转成https，同时支持多证书
• 操作简单，只需简单的配置即可在web ui上完成其余操作
• 展示信息全面，流量、系统信息、即时带宽、客户端版本等
• 扩展功能强大，该有的都有了（缓存、压缩、加密、流量限制、带宽限制、端口复用等等）
• 域名解析具备自定义header、404页面配置、host修改、站点保护、URL路由、泛解析等功能
• 服务端支持多用户和用户注册功能

没找到你想要的功能？不要紧，点击进入文档查找吧

三、快速开始

1.安装

actions通过奶牛快传和坚果云下载

下载对应的系统版本即可，服务端和客户端是单独的

2.服务端启动

下载完服务器压缩包后，解压，然后进入解压后的文件夹

• 执行安装命令

  • 对于linux|darwin sudo ./nps install
  • 对于windows，管理员身份运行cmd，进入安装目录 nps.exe install

• 默认端口

  • nps默认配置文件使用了80，443，9000，9001端口
  • 80与443端口为域名解析模式默认端口,默认关闭
  • 9000为web管理访问端口
  • 9001为网桥端口，用于客户端与服务器通信

• 启动

  • 对于linux|darwin sudo nps start
  • 对于windows，管理员身份运行cmd，进入程序目录 nps.exe start

• 注意

  • 安装后windows配置文件位于当前目录，linux和darwin位于/etc/nps目录
  • nps支持以下命令参数：start,stop,restart,install,uninstall
  • 如果发现没有启动成功，查看日志(Windows日志文件位于当前运行目录下，linux和darwin位于/var/log/nps.log)

3.客户端连接

• 仅运行客户

  • 点击web管理中客户端前的+号，复制客户端运行命令的命令行
  • 执行命令，linux直接执行即可，windows将./npc换成npc.exe用cmd执行

• 注册到系统服务

  • 点击web管理中客户端前的+号，复制注册到系统服务的命令行
  • 执行命令，linux直接执行即可，windows将./npc换成npc.exe用cmd执行
  • 执行npc start即可
  • npc支持以下命令参数：start,stop,restart,install,uninstall

4.配置

• 客户端连接后，在web中配置对应穿透服务即可
• 更多高级用法见完整文档

四、贡献

• 如果遇到bug可以直接提交至dev分支
• 使用遇到问题可以通过issues反馈
• 项目处于开发阶段，还有很多待完善的地方，如果可以贡献代码，请提交 PR 至 dev 分支
• 如果有新的功能特性反馈，可以通过issues或者qq群反馈

五、更新日志(基于ehang-io/nps的v0.26.10版本修改)

• 1.调用新增修改客户端、隧道、域名的API，返回新增或修改后的记录json。
• 2.修改默认日志级别为0。关闭默认http及https默认端口。修改默认端口为9000。默认打开允许本地代理。
• 3.增加展开客户端时，显示安装或注册系统服务的命令。
• 4.增加上传到奶牛快传及坚果云，每天编译一次。
• 5.修改以服务方式安装nps和npc的服务名及显示名称（因特殊场景需要，改了服务名及名称，可Fork回去自行修改）。
• 6.windows环境下，安装及读取当前目录的配置文件及web目录（原默认安装及读取配置目录为C:\Program Files）。
• 7.管理域名和隧道时，客户端ID改成下拉列表选择。