:::info{title="看完本文会得到什么"}
1. 一台家里的 Linux 的服务器连接到公网的 Linux nps 服务端
2. 一台家用的 Windows 电脑连接到公网 Linux nps 服务端
:::



## 如何选择客户端？

一般来说，有内网穿透需求的小伙伴无非是如下几类需求：

1. 文件、照片上传到家里的电脑上实现一个常规的 nas 需求（什么是 nas？ ）
2. 家用 windows 可以通过外网直接远程连接进行操作
3. 运行一个小型网站或者博客，或者程序员把家里的空闲的机器当作开发环境，便于自己在外也能访问


针对以上第一类需求给出如下选择：

> 家用 nas 请出门左转搜索 *群晖*，这里是[群晖京东自营旗舰店](https://mall.jd.com/index-1000002032.html)，不要自建内网穿越，毫无意义。

针对第二类需求，显然你需要的是 windows 客户端

本文主要介绍的如何启动 Linux 客户端和 nps 服务端建立通讯连接的。

## 安装 Linux 客户端

首先推荐查看官方文档关于客户端这一章节，直达链接[nps 安装](https://ehang-io.github.io/nps/#/install)，抄作业的跟着我走也行。

:::note{title="Windows"}
强烈推荐 Windows 客户端查看官方文档，Windows 的安装超级简单，就下载一个 exe 文件就可以了，客户端的文件配置跟 Linux 一样本文后面会讲解。
:::


本文以 Ubuntu 为范例，其他 Linux 版本如果有操作不顺的，请联系我。

假设你拥有一台 Ubuntu 的机器（**不管是云服务器还是你自己的电脑装有 Ubuntu 都可以**）

第一步通过 ssh 登录进入

```
$ ssh shouyicheng@5.6.8.9
```

`shouyicheng` 是我 Ubuntu 机器的用户名，而 `5.6.8.9` 是我 Ubuntu 机器的 IP，注意这个 IP 可以是你云服务器的公网 IP 或者你家里的 Ubuntu 电脑的内网 IP，只要你当前使用的电脑能登录进去就可以，但是如果你就是直接在家真机实体操作你的 Ubuntu，可以省去 ssh 登录这一步


首先更新一下仓库

```
$ apt update #如果你不是 root 用户，请执行 sudo apt update
```

然后安装如下几个非常重要的工具

```
$ apt install -y curl wget telnet # 如果你不是 root 用户，请执行 sudo apt apt install -y curl wget telnet
``` 

然后随便进入一个文件夹，推荐进入当前用户的文件夹目录

```
$ cd /home/shouyicheng/ # shouyicheng 是我的 ssh 登录用户名，请你换成你的
```

紧接着下载 Linux 对应的客户端，我这里挑选的是 `linux_amd64_client.tar.gz`，因为我自己的 Ubuntu 实体机是 x86 架构的，如果你的 Linux 机器是运行在 arm 架构上的，请用如下方式下载对应的版本。

```
$ wget https://github.com/ehang-io/nps/releases/download/v0.26.10/linux_amd64_client.tar.gz
# 或者也可以用 curl 进行下载 curl https://github.com/ehang-io/nps/releases/download/v0.26.10/linux_amd64_client.tar.gz --output linux_amd64_client.tar.gz
```

下载之后，进行解压

```
$ tar zxvf linux_amd64_client.tar.gz
```


### 先别着急安装，需要先行配置客户端参数

安装好了之后，会在当前目录创建一个默认的 `conf` 文件夹，我们要去找到配置文件进行修改

```
$ cd ./conf
```

进入文件夹之后，查看当前文件夹包含的内容

```
$ ls
# 会显示 2 个文件
# multi_account.conf  npc.conf
```
非高端玩家不需要在乎 `multi_account.conf` ，我们查看 `npc.conf`

```
$ cat npc.conf
```

会显示如下内容

```
[common]
server_addr=127.0.0.1:8024
conn_type=tcp
vkey=123
auto_reconnection=true
max_conn=1000
flow_limit=1000
rate_limit=1000
basic_username=11
basic_password=3
web_username=user
web_password=1234
crypt=true
compress=true
#pprof_addr=0.0.0.0:9999
disconnect_timeout=60

[health_check_test1]
health_check_timeout=1
health_check_max_failed=3
health_check_interval=1
health_http_url=/
health_check_type=http
health_check_target=127.0.0.1:8083,127.0.0.1:8082

[health_check_test2]
health_check_timeout=1
health_check_max_failed=3
health_check_interval=1
health_check_type=tcp
health_check_target=127.0.0.1:8083,127.0.0.1:8082

[web]
host=c.o.com
target_addr=127.0.0.1:8083,127.0.0.1:8082

[tcp]
mode=tcp
target_addr=127.0.0.1:8080
server_port=10000

[socks5]
mode=socks5
server_port=19009
multi_account=multi_account.conf

[file]
mode=file
server_port=19008
local_path=/Users/liuhe/Downloads
strip_pre=/web/

[http]
mode=httpProxy
server_port=19004

[udp]
mode=udp
server_port=12253
target_addr=114.114.114.114:53

[ssh_secret]
mode=secret
password=ssh2
target_addr=123.206.77.88:22

[ssh_p2p]
mode=p2p
password=ssh3

[secret_ssh]
local_port=2001
password=ssh2

[p2p_ssh]
local_port=2002
password=ssh3
target_addr=123.206.77.88:22
```

至此，客户端的安装已经完成，现在要回到服务端去创建一个客户端。

打开你的服务端管理的界面:

```
http://1.2.3.4:8080
```

（请忽略我自己的配置，因为我已经创建好了一个客户端）

![image.png](https://blog.shouyicheng.com/static/img/742a5b07951eef60c1d8c5987a369430.742a5b07951eef60c1d8c5987a369430.image.png)

你需要做的是点击 -> `新建`


![image.png](https://blog.shouyicheng.com/static/img/b61a15e6317d3fa42aa02427c00985b3.b61a15e6317d3fa42aa02427c00985b3.image.png)

这里按照如下信息填写：

- 备注： 随便取个标记名字，只要你知道它是谁就可以
- 唯一验证密钥： 这个就是客户端需要匹配的 vkey，很重要，如果你不填写它会帮你随机生成一个

其余均可留空，它默认会帮你生成。

创建完成之后你会看到跟我界面类似的列表


![image.png](https://blog.shouyicheng.com/static/img/97061882843652107f57396011cd11da.97061882843652107f57396011cd11da.image.png)

然后回到你的客户端 Linux，去修改 `npc.conf`。

找到刚才那么一长串的配置文件，你只需要修改的只有如下几个参数

```
server_addr=127.0.0.1:8024
vkey=123
```

这个 server_addr 的值就是你在 [nps 从零启动 - 1. 服务端](https://blog.shouyicheng.com/post/2) 配置的服务器的地址，注意这里需要加上 nps 服务端的桥接转发端口号 `bridge_port`，假设你没有修改过这个参数的话，并且你的服务端 IP 地址是 1.2.3.4，在客户端你的 server_addr 就应该是 `1.2.3.4:8024`

而这个 vkey 就是你在服务端管理界面上刚才创建的客户端的 `唯一验证密钥`，假设你的唯一验证密钥是 `abcdefghihjklmn`，那么你只需要修改成如下内容即可，把除了以下几行之外的所有配置，全都删除，我们刚刚开始学会使用某一项工具的时候，先不要被过多的参数打扰，只要是暂时用不上的全都删除。

```
server_addr=1.2.3.4:8024
vkey=abcdefghihjklmn
conn_type=tcp
auto_reconnection=true
```

然后启动客户端向服务端发出建立连接请求，测试一下网络连通性和密钥是否匹配：

```
$ ./npc  
```
你会看到如下内容：
（忽略我的服务器地址就是我当前的域名，你在这里看见的就是你自己的服务端的 IP 地址，例如 `1.2.3.4：8024`


```
2022/09/25 07:57:11.986 [I] [npc.go:231]  the version of client is 0.26.10, the core version of client is 0.26.0
2022/09/25 07:57:11.987 [I] [control.go:97]  Loading configuration file conf/npc.conf successfully
2022/09/25 07:57:12.191 [N] [control.go:174]  web access login username:user password:abcdefghihjklmn
2022/09/25 07:57:12.337 [I] [client.go:72]  Successful connection with server 1.2.3.4:8024
```

恭喜你，已经实现了把你当前的客户端暴露在外网，可以让外网进行访问了。但是目前你本地机器上什么好玩的服务都没有……所以 -> 


:::note{title="桥豆麻袋"}
这里还需要额外的操作才能让你的机器开机就自动连接到服务端，这样省略你每次开机要手动执行 npc start 的步骤
:::

还是在当前文件夹下执行：

```
$ sudo ./npc install -config=/root/npc/conf/npc.conf 
# 这里必须是绝对路径并且是指定到具体的 npc.conf 文件，不是指定 conf 文件夹，一定要看清楚
```

然后启动并且设置它开机自动启动:

```
$ sudo npc start
```

为了确保正确运行，可以执行如下来查看状态

```
$ npc status
```

如果遇到意外情况即使输入

```shell
$ sudo npc stop
$ sudo npc restart
$ sudp npc uninstall
```

出现意外情况
```
2022/09/27 05:11:56.077 [E] [npc.go:139]  Valid actions: ["start" "stop" "restart" "install" "uninstall"]
Failed to stop nps内网穿透客户端: exit status 5
jun@jun-ubuntu-server:~$ sudo npc uninstall
2022/09/27 05:12:03.368 [E] [npc.go:160]  Valid actions: ["start" "stop" "restart" "install" "uninstall"]
Failed to uninstall nps内网穿透客户端: exit status 1
jun@jun-ubuntu-server:~$ sudo npc restart
2022/09/27 05:12:13.159 [E] [npc.go:139]  Valid actions: ["start" "stop" "restart" "install" "uninstall"]
Failed to restart nps内网穿透客户端: exit status 5
```

我们可以采取强制措施删除它的可执行文件即可，再重新执行安装和启动的步骤。

```
$ sudo rm -f /usr/bin/npc
$ sudo rm -f /usr/bin/npc-update
```


紧接着我们就该考虑，如何把自己电脑上可以共享的服务和资源让别人也享受一下，我能想到的最好的就是博客了，正如你现在所看见的博客一样，它就是我通过 nps 技术将我自己家里的服务器建立的博客分享出来的，接下来我就要来手把手还原我是如何建立当前这个博客小站点的。😋

nps 从零启动 - 2. 客户端 Linux 篇

:::info{title="看完本文会得到什么"}
1. 了解 nps 是什么，他能做什么，有什么好玩的？
2. 在自己公网服务器上安装 nps 服务端
:::



## nps 是什么？
它是某几位开源大神写的一个网络组件，它致力于实现一个需求

> 让你家里的电脑或者是硬盘，或者是打印机，能够让你不在家的时候，用你的手机或者是笔记本电脑，也可以安全的直接操作和传输文件，尤其是当你想把重要的，很私密的信息保存到自己家里的电脑上时，nps 就可以帮助你实现这些需求。

之所以会有这种需求是因为并不是所有用户都相信公共的文件存储服务（网盘）的底线，尤其是在恶劣的竞争中，很多厂商承诺无限存储空间，但是又卡住你下载速度的脖子，让你付费，恰烂钱，吃相特别难看。而且有时候，你如果能在外面直接通过 windows 的远程登录自己的电脑也是一种刚需，所以 nps 以及之前的很多相关的开源项目就渐渐出现，再次感谢这些极具开源精神的大神，再次拜谢。


## 服务端 - Linux 下载和安装

首先登录到远端的服务器上：

>$ ssh root@1.2.3.4（请填写你自己机器的公网 IP）


:::note{title="注"}
如果你不是 root 用户名，也无关紧要，但是你一定得知道 root 的密码，否则之后执行 sudo 高权限操作会失败，nps 是无法使用的。
:::

然后在你此刻正在使用的电脑浏览器上打开 nps 项目的 Github Release 页面，获取最新发布的版本，以当前最新的 2021 年 4 月 8 号发布的版本为例，通过 wget 的方式在**服务器**上下载这个安装包（不是在你本机电脑执行如下命令，注意！！！）

>$ wget https://github.com/ehang-io/nps/releases/download/v0.26.10/linux_amd64_server.tar.gz

然后解压这个 tar 包

>$ tar -zxvf linux_amd64_server.tar.gz

紧接着要安装这个包，

>$ sudo ./nps install

接下来你会看见如下小部分截图

```
2022/09/19 10:53:01 install ok!
2022/09/19 10:53:01 Static files and configuration files in the current directory will be useless
2022/09/19 10:53:01 The new configuration file is located in /etc/nps you can edit them
2022/09/19 10:53:01 You can start with:
nps start|stop|restart|uninstall|update or nps-update update
```

恭喜你，第一步安装已经结束了。

## 服务端的配置 - 安全第一

>$ sudo nps start

注意安装之后界面显示的那一段话

> 2022/09/19 10:53:01 The new configuration file is located in /etc/nps you can edit them

意思就是告诉你，配置文件在 /etc/nps 这个目录下，我们要去修改一下。

真正需要修改的文件是 `/etc/nps/conf/nps.conf`

它默认的配置如下

```
appname = nps
#Boot mode(dev|pro)
runmode = dev

#HTTP(S) proxy port, no startup if empty
http_proxy_ip=0.0.0.0
http_proxy_port=80
https_proxy_port=443
https_just_proxy=true
#default https certificate setting
https_default_cert_file=conf/server.pem
https_default_key_file=conf/server.key

##bridge
bridge_type=tcp
bridge_port=8024
bridge_ip=0.0.0.0

# Public password, which clients can use to connect to the server
# After the connection, the server will be able to open relevant ports and parse related domain names according to its own configuration file.
public_vkey=123

#Traffic data persistence interval(minute)
#Ignorance means no persistence
#flow_store_interval=1

# log level LevelEmergency->0  LevelAlert->1 LevelCritical->2 LevelError->3 LevelWarning->4 LevelNotice->5 LevelInformational->6 LevelDebug->7
log_level=7
#log_path=nps.log

#Whether to restrict IP access, true or false or ignore
#ip_limit=true

#p2p
#p2p_ip=127.0.0.1
#p2p_port=6000

#web
web_host=a.o.com
web_username=admin
web_password=123
web_port = 8080
web_ip=0.0.0.0
web_base_url=
web_open_ssl=false
web_cert_file=conf/server.pem
web_key_file=conf/server.key
# if web under proxy use sub path. like http://host/nps need this.
#web_base_url=/nps

#Web API unauthenticated IP address(the len of auth_crypt_key must be 16)
#Remove comments if needed
#auth_key=test
auth_crypt_key =1234567812345678

#allow_ports=9001-9009,10001,11000-12000

#Web management multi-user login
allow_user_login=false
allow_user_register=false
allow_user_change_username=false


#extension
allow_flow_limit=false
allow_rate_limit=false
allow_tunnel_num_limit=false
allow_local_proxy=false
allow_connection_num_limit=false
allow_multi_ip=false
system_info_display=false

#cache
http_cache=false
http_cache_length=100

#get origin ip
http_add_origin_header=false

#pprof debug options
#pprof_ip=0.0.0.0
#pprof_port=9999

#client disconnect timeout
disconnect_timeout=60
```


它里面参数很多，选取**确定一定以及肯定要**修改的强调一下，其实这里有一些参数是可以单独开一篇教程讲解，因为参数值的不同会衍生出很多用法和玩法。


:::danger{title="注意"}
如下参数**确定一定以及肯定要**修改，否则被不怀好意的扫描到你的服务器安装 nps，他靠猜测就进了你的服务器，你的服务器容易暴毙。
:::

参数名|含义|默认值
--|--|--
appname|当前 nps 系统的名称，你可以取一个响亮的名字|nps
runmode|系统运行模式，如果是用户生产环境记得改成 pro|dev
web_username|系统超级管理员的登录名|admin
web_password|系统超级管理员密码|123
web_port|管理员界面登录的接口|8080
public_vkey|开放的客户端连接密码，也就是说如果有了这个，所有的客户端（不管是不是你的）都可以通过当前服务器把客户端自身暴露在公网上，很危险，强烈建议删除|123
auth_crypt_key|加密登录的密钥，改成随意的 16 位字符串|1234567812345678


按照自己的需求，上面的几个默认值一定要改掉，否则日后一旦你被别人扫描出来你在这台机器上安装了 nps，很容易把你自己的客户端暴露出来，我相信你也不愿意自己家里的电脑所有文件被人拷贝走，成为下一个冠希哥，对吧[doge]

改完之后，重启 nps

>$ sudo nps restart

回到当前操作的电脑，打开浏览器输入如下地址

> http://1.2.3.4:8080 （请填写你自己机器的公网 IP）

你会看到如下的界面

![image.png](https://blog.shouyicheng.com/static/img/1b66ebfa7673cf94d86fdb35a853f26d.1b66ebfa7673cf94d86fdb35a853f26d.image.png)

这说明你已经成功的安装了服务端，然后输入刚才你修改的 `web_username` 和 `web_password` 就可以登录进去

登录进去之后可以看到如下的控制面板（请忽略我屏幕上显示的连接的客户端有一个，因为我截图的网站是我正在使用的内网穿越的服务站点，你第一次打开，上面的客户端和在线客户端应该都是 0）：


![image.png](https://blog.shouyicheng.com/static/img/41df01419be8ffc23af542aa12056b18.41df01419be8ffc23af542aa12056b18.image.png)

服务端的安装和启动就此结束，我们进入客户端环节 -> [nps 从零启动 - 2. 客户端 Linux 篇](https://blog.shouyicheng.com/post/1)。