NAS网络隧道 Docker客户端

☁️

方法一：Docker Hub 云仓拉取

⭐ 推荐

1

拉取镜像

从 Docker Hub 拉取最新版本的 NPC 客户端镜像

docker pull ad9999/jianke:npc

2

创建并启动容器

使用以下命令创建容器，数据将持久化保存

docker run -d \
    --name npc \
    -p 8080:8080 \
    -v /root/npc_data:/app/data \
    --restart=always \
    ad9999/jianke:npc

参数	说明
`-d`	后台运行容器
`--name npc`	容器名称，可自定义
`-p 8080:8080`	Web管理端口映射，可改为其他端口如 `-p 9090:8080`
`-v /root/npc_data:/app/data`	数据持久化目录，保存配置和日志
`--restart=always`	开机自动启动容器

3

访问Web管理界面

打开浏览器，访问 http://您的IP:8080 即可进入管理界面

🎉 完成！

输入您的账号密码登录，选择客户端后点击连接即可开始使用内网穿透服务。

🔧

方法二：手动构建安装

高级用户

1

下载源码包

从官方渠道下载 NPC Docker 客户端源码包

# 下载源码包
wget https://nas.8x6x.com/static/npc_docker_latest.tar

# 解压
tar -xzf npc_docker.tar.gz
cd npc_docker

2

构建Docker镜像

在源码目录下执行构建命令

docker build -t npc:latest .

💡 提示

构建过程需要下载依赖，请确保网络畅通，首次构建约需2-5分钟。

3

启动容器

使用构建好的镜像创建并启动容器

docker run -d \
    --name npc \
    -p 8080:8080 \
    -v /root/npc_data:/app/data \
    --restart=always \
    npc:latest

4

访问管理界面

浏览器访问 http://您的IP:8080

📖

使用说明

1

登录账号

在Web管理界面输入您在 NAS网络隧道注册的账号和密码，点击登录。

2

选择客户端

登录成功后，从下拉列表中选择要连接的客户端（隧道）。

3

连接服务器

点击"连接"按钮，系统会自动连接到分配的服务器节点。

✅ 连接成功

当状态显示"已连接"时，表示内网穿透已建立，您可以通过分配的域名访问内网服务了。

⚠️ 重要提示：内网目标地址设置

Docker 容器使用独立的网络环境，127.0.0.1 指向容器本身而非宿主机。

如需穿透宿主机上的服务，请将内网目标地址设置为：

172.17.0.1:端口号

例如：穿透宿主机的 Web 服务（端口5000），目标地址应填写 172.17.0.1:5000

❓

常见问题

如何查看容器运行状态？

                        # 查看容器状态
docker ps -a | grep npc

# 查看容器日志
docker logs npc

# 实时查看日志
docker logs -f npc
                    

如何更新到最新版本？

                        # 停止并删除旧容器
docker stop npc
docker rm npc

# 拉取最新镜像
docker pull ad9999/jianke:npc

# 重新创建容器（数据会保留）
docker run -d --name npc \
    -p 8080:8080 \
    -v /root/npc_data:/app/data \
    --restart=always \
    ad9999/jianke:npc
                    

如何修改Web管理端口？

在创建容器时修改端口映射参数，例如使用9090端口：

                        docker run -d --name npc \
    -p 9090:8080 \
    -v /root/npc_data:/app/data \
    --restart=always \
    ad9999/jianke:npc
                    

然后访问 http://您的IP:9090

连接失败怎么办？

请检查以下几点：

确认账号密码是否正确
确认客户端是否已在管理后台创建
检查服务器端口是否开放（默认8024）
查看容器日志排查具体错误

如何完全卸载？

                        # 停止并删除容器
docker stop npc
docker rm npc

# 删除镜像
docker rmi ad9999/jianke:npc

# 删除数据（可选）
rm -rf /root/npc_data
                    

⌨️

常用命令速查

操作	命令
启动容器	`docker start npc`
停止容器	`docker stop npc`
重启容器	`docker restart npc`
查看日志	`docker logs npc`
进入容器	`docker exec -it npc sh`
查看状态	`docker ps \| grep npc`

🚀 NAS网络隧道 Docker客户端