NodePass 面板搭建
加入NodePass生态圈
🌐 NodePass 官网：https://nodepass.eu 🚀 项目仓库：
https://github.com/yosebyte/nodepass
🧩 官方组织：
https://github.com/NodePassProject
📢 TG 频道： https://t.me/NodePassChannel
💬 TG 群组： https://t.me/NodePassGroup
安装指南
本指南提供了使用不同方法安装NodePass的详细说明。选择最适合您的环境和要求的选项。
系统需求
- Go 1.25或更高(用于从源构建)
- 服务器和客户端端点之间的网络连接
- 绑定到1024以下的端口可能需要管理员权限
安装选项
选项1:预构建的二进制文件
开始使用NodePass最简单的方法是下载一个为您的平台预先构建的二进制文件。
- 请访问发布页面在GitHub上
- 下载适用于您的操作系统(Windows、macOS、Linux)的二进制文件
- 如有必要，提取存档文件
- 制作二进制可执行文件(Linux/macOS):chmod +x nodepass
- 将二进制文件移动到路径中的某个位置:
- Linux/macOS:
sudo mv nodepass /usr/local/bin/ - Windows:将位置添加到PATH环境变量中
- Linux/macOS:
选项2:使用Go Install
如果您的系统上安装了Go，您可以使用go install命令:
go install github.com/NodePassProject/nodepass/cmd/nodepass@latest
这个命令下载源代码，编译它，并将二进制文件安装在Go bin目录中(通常是$GOPATH/bin).
选项3:从源代码构建
对于最新的开发版本或自定义版本:
# Clone the repository git clone https://github.com/NodePassProject/nodepass.git # Navigate to the project directory cd nodepass # Build the binary go build -o nodepass ./cmd/nodepass # Optional: Install to your GOPATH/bin go install ./cmd/nodepass
选项4:使用容器图像
NodePass在GitHub Container Registry上作为容器映像提供，非常适合于容器化的环境:
# Pull the container image docker pull ghcr.io/NodePassProject/nodepass:latest # Run in server mode docker run -d --name nodepass-server -p 10101:10101 -p 8080:8080 \ ghcr.io/NodePassProject/nodepass server://0.0.0.0:10101/0.0.0.0:8080 # Run in client mode docker run -d --name nodepass-client \ -e NP_MIN_POOL_INTERVAL=200ms \ -e NP_SEMAPHORE_LIMIT=512 \ -p 8080:8080 \ ghcr.io/NodePassProject/nodepass "client://nodepass-server:10101/127.0.0.1:8080?min=32&max=512"
选项5:使用管理脚本(仅限Linux)
对于Linux系统，我们提供了一个单击式脚本:
bash <(curl -sSL https://run.nodepass.eu/np.sh)
- 该脚本提供了易于使用的主模式(API模式)安装、配置和管理功能。
- 详情请参阅https://github.com/NodePassProject/npsh
验证安装
安装后，通过检查版本来验证NodePass是否已正确安装:
nodepass
后续步骤
现在您已经安装了NodePass，您可以:
安装问题疑难解答
如果您在安装过程中遇到任何问题:
- 确保您的系统满足最低要求
- 检查您是否有安装软件的正确权限
- 对于Go相关的问题，请使用以下方法验证您的Go安装
go version - 对于与容器相关的问题，请确保Docker已正确安装并正在运行
- 查看我们的故障排除指南寻求更多帮助
