懒猫自定义入口控制器使用说明书

懒猫自定义入口控制使用文档

附件:
[懒猫自定义入口控制器使用文档(图片清晰)](https://dl.playground.lazycat.cloud/docs/%E6%87%92%E7%8C%AB%E8%87%AA%E5%AE%9A%E4%B9%89%E5%85%A5%E5%8F%A3%E6%8E%A7%E5%88%B6%E5%99%A8%E4%BD%BF%E7%94%A8%E6%96%87%E6%A1%A320251111093548.doc)


当客户端与微服无法直连的情况下，通过本工具将具有公网IP服务器作为客户端访问的入口，以优化传输效率。

目前支持两类方式：
1.路由器转发：家庭网络拥有公网IP，可直接设置路由器的端口转发到微服的地址 ( ip: 5500) 。
2.软件转发： Rathole、SSH、Frpc（TODO）

通过下面3种具体的方式添加自定义入口后，客户端会自动以此为通信的入口。

注意：
使用本工具时，请在设置中将应用设置自启动。以在下次重启微服时重新恢复网络转发服务。

![image.png](https://dl.playground.lazycat.cloud/guidelines/78/68e69ef8-0e54-4c5c-a18c-da1d4ac31946.png "image.png")


Rathole
参考下面文章搭建Rathole服务器：

https://github.com/rathole-org/rathole/blob/main/README-zh.md

https://www.bboy.app/2022/01/27/%E4%BD%BF%E7%94%A8rathole%E8%BF%9B%E8%A1%8C%E5%86%85%E7%BD%91%E7%A9%BF%E9%80%8F/


1.rathole服务器运行：

rathole -s server.toml

2.server.toml配置

[server]
bind_addr = "0.0.0.0:9994" # `9994` 配置了服务端监听客户端连接的端口

[server.services.s1]
token = "token_asdf" # 用于验证的 token
bind_addr = "0.0.0.0:7736" # `7736` 暴露给互联网的端口


3.本工具内部集成了rathole客户端，需按照以下方式添加的配置信息。


![image.png](https://dl.playground.lazycat.cloud/guidelines/78/f0a72073-a64b-4934-a932-57b33b6770c2.png "image.png")
4.点击测试

![image.png](https://dl.playground.lazycat.cloud/guidelines/78/c8ddd9dc-dcf0-480f-8e79-a5b0d333dce8.png "image.png")

5.点击创建，稍等1~2秒就会刷新到列表中

![image.png](https://dl.playground.lazycat.cloud/guidelines/78/3259d34f-b526-4334-b936-ed8543e1fe91.png "image.png")
6.添加成功
SSH
参考博客：

https://www.cnblogs.com/XiiX/p/15095135.html

https://www.entropy-tree.top/2024/04/18/ssh-tunneling-techniques/#%E5%9C%BA%E6%99%AF%E6%A1%88%E4%BE%8B



1.需要确保您正常配置好了sshd 服务，以支持ssh的隧道转发。 （很关键，需要修改 /etc/ssh/sshd_config，以及重启sshd服务）
2.根据推荐方式2的提供的命令，先ssh进入您的微服。
3.在您的服务器执行命令即可。
ssh -R *:6666:192.168.1.209:5500  root@192.168.1.145
注意：  @   需要修改成您的服务器真实的用户和IP。 （测试的例子是 root@192.168.1.145) 

![image.png](https://dl.playground.lazycat.cloud/guidelines/78/0caea16b-6709-4538-b5fc-87f5713ea27f.png "image.png")
4.在服务器执行命令，以及正常登录后，再执行下一步。

![image.png](https://dl.playground.lazycat.cloud/guidelines/78/ba441d04-fdff-418f-8a5f-ef02b4703aed.png "image.png")
5.再点击表单上的测试按钮，测试连通性。
6.点击创建。
7.创建成功后，在外部的列表点击测试。

![image.png](https://dl.playground.lazycat.cloud/guidelines/78/fbf0692e-3430-4c1a-8aed-aaa91c8872f9.png "image.png")

路由器
1.在您的家庭网络拥有公网IP前提下
2.进入路由器的控制面板中，配置端口转发到微服服务上。

![image.png](https://dl.playground.lazycat.cloud/guidelines/78/cfb8fa32-b43a-4c4b-bac4-03d88c4049b1.png "image.png")
3.创建完后，建议在表格的上，测试其连通性。

参考：

https://resource.tp-link.com.cn/pc/docCenter/showDoc?id=1655112481787390
    


https://appstore.lazycat.cloud/#/shop/detail/cloud.lazycat.app.customrelay