[开源]ws隧道使用教程

dunce

接上贴 https://hostloc.com/thread-998487-1-1.html

这两天收了不少star，感谢各位。为了得到更多反馈，也方便大伙交流，我创了个TG群 https://t.me/+twL7xFkwifJiMTcx

鉴于上贴有不少MJJ要求我出个教程，那么本贴就作为教程贴，从安装到使用，一条龙服务。当然我还是建议去看一下文档(有中文)，尤其是关于Options的定义部分。

========== ========== ==========

Step1:

首先去Release页面下载编译好的二进制文件(目前最新版本是v0.3.1)。架构一般都是x86_64,  libc可以选用gnu或者musl. 两者的区别在于gnu是动态链接的，需要机器上有较高版本的glibc才能启动；而musl是静态链接的，只不过性能稍微比gnu弱一点(几乎可以忽略)

可以直接进网页下载，或者用命令行下载&解压

curl:

1. curl -sL https://github.com/zephyrchien/kaminari/releases/download/v0.3.1/kaminari-x86_64-unknown-linux-musl.tar.gz | tar -zxv

复制代码

或者用wget:

1. wget -qO- https://github.com/zephyrchien/kaminari/releases/download/v0.3.1/kaminari-x86_64-unknown-linux-musl.tar.gz|tar -zxv

复制代码

解压出来是两个二进制文件, kaminaric 和 kaminaris 分别是客户端和服务端。

Step2:

这两个文件安装到 /usr/bin (需要root权限)。 这一步可以省略，本身二进制文件下过来就可以直接运行了，放到 $PATH 下面只是为了省得输入路径。

1. cp kaminaric /usr/bin/
   
2. cp kaminaris /usr/bin/

复制代码

也可以继续配置systemd，方便以后作为守护进程运行。(虽然我觉得没必要啊= =)

Step3:

运行客户端或者服务端。启动时需要提供三个参数，按顺序分别是本地监听地址，远程连接地址，传输选项。传输选项格式都是 name 或者 name=value ，选项间要用分号隔开，这跟SS插件的格式是一样的。 ws和tls分别通过 ws; 和 tls; 启用。都不启用则为tcp，都启用则为wss

ws 客户端和服务端的必要参数为 path 和 host.  如果host或者path不匹配的话就没法建立连接

tls 客户端的必要参数为 sni, 可选参数为 0rtt 和 insecure

tls服务端的必要参数为 [cert 和 key] 或者 提供 servername 以使用自签证书

举个最简单的例子:

要用ws， 只要在选项里面填上 ws;host=hostloc.com;path=/chat

要用tls(自签证书)，只要在客户端填上 tls;sni=hostloc.com;insecure， 在服务端填上 tls;servername=hostloc

如果要在服务端启用自己的证书，则填写 tls;cert=/a/b/c;key=/a/b/d， 客户端就不必insecure了

要用wss则只要把以上两者都写上，客户端 ws;host=hostloc.com;path=/chat; tls;sni=hostloc.com;insecure，服务端ws;host=hostloc.com;path=/chat;tls;servername=hostloc

比起其他工具，这还不够简单直接么！

========== ========== ==========

以下为完整例子，例举了比较常见的使用场景。

Example 1:

iperf3测速(用ws转发。tls/wss同理，只要第三个参数写对了就行。)

本地监听本地10000端口供iperf3连接, 转发到服务器a.b.com:20000；服务端的iperf3监听本地10000端口，kaminaris监听20000端口，转发到本地iperf3.

1. 服务端
   
2. iperf3 -s -p 10000
   
3. kaminaris 0.0.0.0:20000 127.0.0.1:10000 'ws;host=a.b.com;path=/chat'
   
4. 
   
5. 客户端
   
6. kaminaric 127.0.0.1:10000 a.b.com:20000 'ws;host=a.b.com;path=/chat'
   
7. iperf3 -c 127.0.0.1 -p 10000

复制代码

Example 2:

服务端经过nginx反代，nginx完整配置我就懒得贴了，只要端口和路径对上就行。比如 location为/chat，里面写 proxy_pass http://127.0.0.1:10000的话

1. kaminaris 127.0.0.1:10000 127.0.0.1:20000 'ws;host=a.b.com;path=/chat'

复制代码

这样就可以把ws转换成tcp，转发到20000端口的其他服务

Example 3:

作为shadowsocks插件使用。可以跟v2ray-plugin混用(移动端上只能用它，没得选)，反正都是标准的ws实现，都可以互通。注意要给v2ray-plugin设置mux=0，这样它就不会多路复用，收发的都是标准ws.

1. 服务端
   
2. ssserver -s "0.0.0.0:8080" -m "aes-128-gcm" -k "123456" \
   
3.     --plugin "path/to/kaminaris" \
   
4.     --plugin-opts "ws;host=example.com;path=/chat"
   
5. 
   
6. 客户端
   
7. sslocal -b "127.0.0.1:1080" -s "example.com:8080" -m "aes-128-gcm" -k "123456" \
   
8.     --plugin "path/to/kaminaric" \
   
9.     --plugin-opts "ws;host=example.com;path=/chat"
   
10. 
    
11. 客户端用v2ray-plugin
    
12. 
    
13. sslocal -b "127.0.0.1:1080" -s "example.com:8080" -m "aes-128-gcm" -k "123456" \
    
14.     --plugin "path/to/v2ray-plugin" \
    
15.     --plugin-opts "mux=0;host=example.com;path=/chat"

复制代码

spotlight

看了下之前的帖子，就是rust实现的一个隧道，优点相比v2ray省资源，但少了其他一大堆功能。然后鄙视了一下go的库和开发者，c和cpp也顺带踩一脚。没有看出应用方面解决了什么痛点，也许代码质量高？虽然我还没看过，也没法评论

dunce

spotlight 发表于 2022-4-12 01:07
看了下之前的帖子，就是rust实现的一个隧道，优点相比v2ray省资源，但少了其他一大堆功能。然后鄙视了一下g ...

经典避重就轻，我干了这么多活到你那就变成"就是了": (

我本来就只提供ws/wss, 你拿来跟v2ray比花样多少就是你不对了= =

我承认我有点狂，但是我没有鄙视其他人的意思，能开源出来都是好事。我是说那些代码质量不咋地，看得我实在受不了了

aipage

绑定技术大佬。牛逼PLUS

cq214

技术大佬牛逼

Crying

支持技术人员，无私且无价，大佬

lsin

支持，建群不要当保姆，弄个FAQ靠自治就完事了

dunce

lsin 发表于 2022-4-12 00:02
支持，建群不要当保姆，弄个FAQ靠自治就完事了

好，晚点再出个FAQ!

dunce

秒沉，这是缀痛苦的

omo.moe

感谢分享，无价

option

dunce 发表于 2022-4-12 00:11
秒沉，这是缀痛苦的

又试了一下，ss搭配 v2ray-plugin 直接套cf加mux=0 可以连接（不知不用对应客户端是否有提速？服务端已换）

dunce

option 发表于 2022-4-12 00:33
又试了一下，ss搭配 v2ray-plugin 直接套cf加mux=0 可以连接（不知不用对应客户端是否有提速？服务端已换 ...

比v2省资源，不过客户端一般都不差这点性能，除非放在中转机上。  我个人没怎么写过手机app，只能看以后有没有人愿意把它移植到移动端上了