np.sh: One-click deployment of the NodePass main program, providing high-performance TCP/UDP tunneling with multi-system support and flexible configuration. dash.sh: One-click deployment of the NodePassDash control panel, simplifying tunnel management and monitoring with containerization and HTTPS support.

• Stable: v1.15.0
• Development: v2.0.0-b1

• Introduction
• System Requirements
• 1. np.sh Script (Main Program Installation)
  • Features
  • Deployment Methods
    • Interactive Deployment
    • Non-interactive Deployment
  • Quick Commands
  • Directory Structure
• 2. dash.sh Script (Control Panel Installation)
  • Features
  • Usage Instructions
  • Uninstallation Instructions
  • Update Version
  • Reset Password
• Feedback
• Deployment Screenshots

NodePass is a universal TCP/UDP tunneling solution with a control-data separation architecture, supporting zero-latency connection pools and multi-mode communication for high-performance, secure access across network restrictions.

• Operating System: Compatible with Debian, Ubuntu, CentOS, Fedora, Alpine, Arch, OpenWRT, and more
• Architecture: Supports x86_64 (amd64), aarch64 (arm64), armv7l (arm)
• Permissions: Requires root privileges to run

• Multi-system support
• Automatic detection of architecture and dependencies
• Flexible configuration of ports, API prefixes, and TLS modes
• Supports no encryption, self-signed certificates, or custom certificates
• One-click service start, stop, restart, and uninstall
• Automatic updates to the latest version
• Automatic recognition of container environments
• Supports installation of stable and development versions

bash <(wget -qO- https://run.nodepass.eu/np.sh)

or

bash <(curl -sSL https://run.nodepass.eu/np.sh)

Follow the prompts to provide the following information:

• Language selection (default: Chinese)
• Server IP (If it is 127.0.0.1, you can choose to create an instance with an intranet penetration API.)
• Port (leave blank for auto-assigned port in the 1024–8192 range)
• API prefix (default: api)
• TLS mode (0: no encryption, 1: self-signed certificate, 2: custom certificate)

bash <(curl -sSL https://run.nodepass.eu/np.sh) \
 -i \
 --language zh \
 --server_ip 127.0.0.1 \
 --user_port 18080 \
 --version stable \
 --prefix api \
 --tls_mode 0

bash <(curl -sSL https://run.nodepass.eu/np.sh) \
 -i \
 --language en \
 --server_ip localhost \
 --user_port 18080 \
 --version dev \
 --prefix api \
 --tls_mode 1

bash <(curl -sSL https://run.nodepass.eu/np.sh) \
 -i \
 --language zh \
 --server_ip 1.2.3.4 \
 --user_port 18080 \
 --version stable \
 --prefix api \
 --tls_mode 2 \
 --cert_file </path/to/cert.pem> \
 --key_file </path/to/key.pem>

After installation, the np shortcut command is created:

/etc/nodepass/
├── data # Configuration data
├── nodepass # Main program symlink pointing to the currently used kernel file
├── np-dev # Development version kernel file
├── np-stb # Stable version kernel file
├── nodepass.gob # Data storage file
└── np.sh # Deployment script

• One-click deployment of NodePassDash control panel
• Supports Debian, Ubuntu, CentOS
• Automatic detection of system and dependencies
• Host network mode is used, enabling seamless integration with host APIs
• Supports Docker and Podman for container deployment
• Automatic reverse proxy configuration (with HTTPS support)
• Automatic CA SSL certificate issuance (for domain-based deployment)
• Automatic mounting of logs and public resource directories

1. Run the script:

bash <(wget -qO- https://run.nodepass.eu/dash.sh)

or

bash <(curl -sSL https://run.nodepass.eu/dash.sh)

2. Provide information:

• Domain or IP: Entering a domain enables HTTPS reverse proxy and SSL certificate issuance; entering an IP skips reverse proxy and Caddy installation.
• Port: Default is 3000, customizable.

3. Container deployment:

• Automatically uses Docker or Podman to run the control panel container
• Checks for port conflicts

4. Mounted directories:

5. Completion prompt: The script will output the access address and admin account details upon completion.

To uninstall the NodePassDash control panel:

bash <(wget -qO- https://run.nodepass.eu/dash.sh) uninstall

or

bash <(curl -sSL https://run.nodepass.eu/dash.sh) uninstall

This will clean up the container, configuration files, and mounted directories.

Update the NodePassDash container:

bash <(wget -qO- https://run.nodepass.eu/dash.sh) update

or

bash <(curl -sSL https://run.nodepass.eu/dash.sh) update

This will update based on the local and remote versions.

bash <(wget -qO- https://run.nodepass.eu/dash.sh) resetpwd

or

bash <(curl -sSL https://run.nodepass.eu/dash.sh) resetpwd

For installation or usage issues, please submit feedback at GitHub Issues.