mirror of
https://github.com/lwch/natpass.git
synced 2024-04-21 12:41:54 +00:00
86 lines
2.8 KiB
Markdown
86 lines
2.8 KiB
Markdown
---
|
|
title: "裸机部署"
|
|
linkTitle: "裸机部署"
|
|
type: docs
|
|
weight: 2
|
|
description: >
|
|
您可以在一台物理机或虚拟机上部署natpass服务。
|
|
---
|
|
|
|
部署过程共分为三部分：服务器端、受控端和控制端，下面以*debian*系统进行举例。
|
|
|
|
## 服务器端部署
|
|
|
|
1. 在服务器上[下载](https://github.com/lwch/natpass/releases)并解压到任意目录
|
|
2. 使用以下命令启动服务器端程序
|
|
|
|
```shell
|
|
sudo ./np-svr --conf server.yaml
|
|
```
|
|
|
|
3. （可选）开放外网防火墙，默认端口6154
|
|
|
|
## 受控端部署
|
|
|
|
1. 在受控端机器上[下载](https://github.com/lwch/natpass/releases)并解压到任意目录
|
|
2. （可选）修改remote.yaml配置文件，修改*server*地址
|
|
3. 使用以下命令启动客户端程序
|
|
|
|
```shell
|
|
sudo ./np-cli --conf remote.yaml --user `whoami`
|
|
```
|
|
|
|
## 控制端部署
|
|
|
|
1. 在本地控制机上[下载](https://github.com/lwch/natpass/releases)并解压到任意目录
|
|
2. （可选）修改local.yaml配置文件，修改*server*地址
|
|
3. （可选）修改rule.d目录下的规则配置文件，[rule配置方法](rules.md)
|
|
4. 使用以下命令启动客户端程序
|
|
|
|
```shell
|
|
sudo ./np-cli --conf local.yaml
|
|
```
|
|
|
|
5. 在以上操作成功后即可在浏览器中通过local.yaml中配置的端口号进行访问，默认地址：
|
|
|
|
http://127.0.0.1:8080
|
|
|
|
## 安全连接（可选）
|
|
|
|
1. 建议使用tls加密连接，使用方式如下
|
|
|
|
- 修改服务器端的server.yaml文件，配置tls相关文件路径，并重启服务
|
|
- 修改受控端的remote.yaml配置，配置ssl相关选项，并重启服务
|
|
- 修改控制端的local.yaml配置，配置ssl相关选项，并重启服务
|
|
|
|
2. 修改默认连接密钥，修改方式如下
|
|
|
|
- 使用以下命令生成一个16位随机串
|
|
tr -dc A-Za-z0-9 < /dev/urandom | dd bs=16 count=1 2>/dev/null && echo
|
|
- 修改服务器端的common.yaml文件，将secret设置为新的密钥，并重启服务
|
|
- 修改受控端的common.yaml文件，将secret设置为新的密钥，并重启服务
|
|
- 修改控制端的common.yaml文件，将secret设置为新的密钥，并重启服务
|
|
|
|
## 系统服务（可选）
|
|
|
|
1. 在命令行中使用`install`子命令可将程序注册为系统服务，使用参数`--user`可设置该服务的启动身份，如
|
|
|
|
```shell
|
|
sudo ./np-cli install --conf remote.yaml --user `whoami`
|
|
```
|
|
|
|
2. 通过以下命令可控制系统服务的启动与停止
|
|
|
|
```shell
|
|
sudo ./np-cli start
|
|
sudo ./np-cli stop
|
|
sudo ./np-cli restart
|
|
```
|
|
|
|
3. 通过以下命令可进行系统服务的移除
|
|
|
|
```shell
|
|
sudo ./np-cli uninstall
|
|
```
|
|
|
|
注: 以上命令同样支持服务器端程序，但`--user`参数仅支持客户端注册系统服务时使用 |