1. Project Overview

natpass

The Ultimate Tool for Working from Home and Remote Development

A next-generation host management tool that supports shell management and remote desktop management.

2. Open Source License

Licensed under MIT

3. Screenshots

Effect picture

Dashboard Page

Command Line

platform	386	amd64	arm	arm64
windows	✅	✅	✅	✅
macos		✅		✅
linux	✅	✅	✅	✅

Remote Desktop

platform	386	amd64	arm	arm64
windows	✅	✅	❌	❌
macos		✅		✅
linux	✅	✅	❌	❌

Windows Clipboard Content

Code-Server Support

4. Feature Overview

Features and Capabilities:

1. Supports Self-Hosted Deployment

2. Low Memory Usage (Approximately 20 MB)

3. Supports Secure TLS Connections

4. Supports Multiplexed Asynchronous I/O

5. Supports Virtual Link Layer

6. Supports Link and Terminal Session Monitoring

7. Protobuf Data Encoding

8. Supports Web Shell

   Linux and macOS support PTY device creation and colored output.

   Windows supports PowerShell.

9. Supports Web VNC

   Supports Basic Keyboard and Mouse Operations

   Supports Full-Screen Display

   Supports Scrolling

   Supports Remote Clipboard Configuration and Reading

10. Supports code-server

11. Supports Multiple Operating Systems

    linux

    windows

    macos

5. Tech Stack

Performance

A 4C2G test environment was created in VMware (AMD Ryzen 7 4800U with Radeon Graphics). An all-in-one deployment of the server, remote, and local components was performed, and stress testing was conducted using benchmark rules. The results are as follows:

1. The stress test results cover only the entire process from the local component initiating a connection to the remote component receiving the connection and returning a successful response.

2. Experimental results show that the system can achieve over 10,000 QPS in a 4C2G environment, with both p99 and p100 response times below 60 ms.

TODO

1. Supports YAML configuration files with include directives

2. Generic connect, connect_response, and disconnect messages

3. Dashboard Page

4. File Transfer

5. Web Remote Desktop

6. Traffic Monitoring and Statistics Page: Server or Client?

7. Web-Based Management Rules

8. Supports Screen Recording

Compile

1. Since symbolic links are used to reference third-party libraries in directories such as html/dashboard, these linked directories must be manually replaced when compiling in a Windows environment. The third-party library source code can be found in the parent directories.