mirror of https://github.com/ehang-io/nps
77 lines
3.9 KiB
Markdown
77 lines
3.9 KiB
Markdown
|
|
# NPS
|
|
 
|
|
[](https://gitter.im/cnlh-nps/community?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge)
|
|
[](https://travis-ci.org/ehang-io/nps)
|
|
|
|
|
|
[README](https://github.com/ehang-io/nps/blob/master/README.md)|[中文文档](https://github.com/ehang-io/nps/blob/master/README_zh.md)
|
|
|
|
NPS is a lightweight, high-performance, powerful **intranet penetration** proxy server, with a powerful web management terminal.
|
|
|
|
|
|
|
|
|
|
## Feature
|
|
|
|
- Comprehensive protocol support, compatible with almost all commonly used protocols, such as tcp, udp, http(s), socks5, p2p, http proxy ...
|
|
- Full platform compatibility (linux, windows, macos, Qunhui, etc.), support installation as a system service simply.
|
|
- Comprehensive control, both client and server control are allowed.
|
|
- Https integration, support to convert backend proxy and web services to https, and support multiple certificates.
|
|
- Just simple configuration on web ui can complete most requirements.
|
|
- Complete information display, such as traffic, system information, real-time bandwidth, client version, etc.
|
|
- Powerful extension functions, everything is available (cache, compression, encryption, traffic limit, bandwidth limit, port reuse, etc.)
|
|
- Domain name resolution has functions such as custom headers, 404 page configuration, host modification, site protection, URL routing, and pan-resolution.
|
|
- Multi-user and user registration support on server.
|
|
|
|
**Didn't find the feature you want? It doesn't matter, click [Enter the document](https://ehang-io.github.io/nps/) to find it!**
|
|
|
|
## Quick start
|
|
|
|
### Installation
|
|
|
|
> [releases](https://github.com/ehang-io/nps/releases)
|
|
|
|
Download the corresponding system version, the server and client are separate.
|
|
|
|
### Server start
|
|
|
|
After downloading the server compressed package, unzip it, and then enter the unzipped folder.
|
|
|
|
- execute installation command
|
|
|
|
For linux、darwin ```sudo ./nps install```
|
|
|
|
For windows, run cmd as administrator and enter the installation directory ```nps.exe install```
|
|
|
|
- start up
|
|
|
|
For linux、darwin ```sudo nps start```
|
|
|
|
For windows, run cmd as administrator and enter the program directory ```nps.exe start```
|
|
|
|
```After installation, the windows configuration file is located at C:\Program Files\nps, linux or darwin is located at /etc/nps```
|
|
|
|
**If you don't find it started successfully, you can check the log (Windows log files are located in the current running directory, linux and darwin are located in /var/log/nps.log).**
|
|
|
|
- Access server IP:web service port (default is 8080).
|
|
- Login with username and password (default is admin/123, must be modified when officially used).
|
|
- Create a client.
|
|
|
|
### Client connection
|
|
- Click the + sign in front of the client in web management and copy the startup command.
|
|
- Execute the startup command, Linux can be executed directly, Windows will replace ./npc with npc.exe and execute it with cmd.
|
|
|
|
|
|
If you need to register to the system service, you can check [Register to the system service](https://ehang-io.github.io/nps/#/use?id=注册到系统服务)
|
|
|
|
### Configuration
|
|
- After the client connects, configure the corresponding penetration service in the web.
|
|
- For more advanced usage, see [Complete Documentation](https://ehang-io.github.io/nps/)
|
|
|
|
## Contribution
|
|
- If you encounter a bug, you can submit it to the dev branch directly.
|
|
- If you encounter a problem, you can feedback through the issue.
|
|
- The project is under development, and there is still a lot of room for improvement. If you can contribute code, please submit PR to the dev branch.
|
|
- If there is feedback on new features, you can feedback via issues or qq group.
|