11 Star 89 Fork 20

lwch / natpass

加入 Gitee
与超过 1200万 开发者一起发现、参与优秀开源项目,私有仓库也完全免费 :)
免费加入
克隆/下载
startup.md 2.25 KB
一键复制 编辑 原始数据 按行查看 历史
lwch 提交于 2023-01-31 16:49 . 修改文档

开始使用

部署过程共分为三部分:服务器端、受控端和控制端,下面以debian系统进行举例。

服务器端部署

  1. 在服务器上下载并解压到任意目录

  2. 使用以下命令启动服务器端程序

     sudo ./np-svr --conf server.yaml
  3. (可选)开放外网防火墙,默认端口6154

受控端部署

  1. 在受控端机器上下载并解压到任意目录

  2. (可选)修改remote.yaml配置文件,修改server地址

  3. 使用以下命令启动客户端程序

     sudo ./np-cli --conf remote.yaml --user `whoami`

控制端部署

  1. 在本地控制机上下载并解压到任意目录

  2. (可选)修改local.yaml配置文件,修改server地址

  3. (可选)修改rule.d目录下的规则配置文件,rule配置方法

  4. 使用以下命令启动客户端程序

     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. 在命令行中使用-action install参数即可将程序注册为系统服务,使用参数-user可设置该服务的启动身份
  2. linux系统使用systemd管理系统服务,windows系统可用services.msc面板启动或停止服务
Go
1
https://gitee.com/lwch/natpass.git
git@gitee.com:lwch/natpass.git
lwch
natpass
natpass
master

搜索帮助