快速上手 on NPS Plus

Docker 部署（推荐）

Mon, 01 Jan 0001 00:00:00 +0000

先拉取镜像：

docker pull yisier1/nps

启动容器，请把 <本机conf目录> 替换为实际路径（例如 /root/nps/conf）：

docker run -d \
 --restart=always \
 --name nps \
 --net=host \
 -v <本机conf目录>:/conf \
 -v /etc/localtime:/etc/localtime:ro \
 yisier1/nps

先拉取镜像：

docker pull yisier1/npc

启动容器，请把 <> 内的值替换为实际配置：

docker run -d \
 --restart=always \
 --name <自定义名称> \
 --net=host \
 yisier1/npc \
 -server=<服务端IP:端口> \
 -vkey=<客户端验证密钥>

Mon, 01 Jan 0001 00:00:00 +0000

从项目发布页下载对应系统版本。服务端 (nps) 和客户端 (npc) 使用单独的压缩包。

首次启动时 nps 会在可执行文件同级目录自动生成 conf/nps.conf，并随机生成 web_password、auth_key、auth_crypt_key。Web 管理界面的登录密码请在 conf/nps.conf 或启动日志中查看。

Linux 或 macOS：

./nps -server

Windows：

nps.exe -server

运行目录中没有 conf/npc.conf 时，客户端无参数启动会进入交互菜单；存在该文件时会直接按配置文件运行。需要强制使用其他配置文件时传入 -config=/实际路径/npc.conf。

Linux 或 macOS：

./npc

Windows：

npc.exe

通过 Web 管理界面的【快捷连接码】，或手动填写 -server、-vkey 等参数配置客户端。

Mon, 01 Jan 0001 00:00:00 +0000

需要 Go 1.25.0 及以上，具体版本要求以仓库根目录的 go.mod 为准。

git clone https://github.com/yisier/nps.git
cd nps
go build -o nps cmd/nps/nps.go
go build -o npc cmd/npc/npc.go