happynet是happyn.cc 提供的组建虚拟局域网的客户端工具， 这是MacOS版本;
- MacOS 10, MacOS11
项目基于N2N
upstream form n2n 2.9.0 macOS build by happyn.cn
happynet依赖于网络TAP虚拟网卡,所以需要首先安装驱动
- 安装Homebrew工具管理服务(如果您之前安装了brew工具套件,请跳过此步)
/bin/zsh -c "$(curl -fsSL https://gitee.com/cunkai/HomebrewCN/raw/master/Homebrew.sh)"
- 安装网卡驱动
brew tap happynclient/taps
brew install --cask tuntap
- 由于安全性的需要，安装时如果出现鉴定或者安全性警告，请输入管理员密码通过，或者是打开
系统偏好设置中的安全性与隐私，通过操作。
点击允许后，再次执行安装命令，系统可能提示需要重新启动生效;
- 安装
brew tap happynclient/taps
brew install happynet
- 修改配置文件,您需要填入的4个参数(从您的happyn web端后台登录可以获取):
- 本地地址：您的虚拟服务子网IP地址，ip网段从web界面可查，如图所示，这个服务子网为10.251.56.0/24，您可以设定从 10.251.56.1 -- 10.251.56.254 任意地址，只要保证每台机器不冲突即可
- 服务ID：从后台web界面可以得到，是分配给每个用户的唯一子网标识
- 服务密钥：从后台web界面可以得到, 是系统为您的分配的子网token，您可以自己设定，但是只有相同 "服务ID+服务密钥"的机器才能互通
- 服务器端口：从后台web界面可以得到
sudo vim /usr/local/etc/happynet.conf
# ==============================
# 这里填入您获取的服务ID
-c=VIP0xxxxx
# 这里填入您获取的服务密钥
-k=1c20743f
# 这里填入您指定的网卡MAC地址，如果不需要手工指定的话，直接用 `#` 注释掉即可
# -m=xx:xx:xx:xx:xx:xx
# 这里填入您的合法子网IP地址，这个地址不能与其它连入设备相冲突，范围是x.x.x.1--x.x.x.254
-a=10.251.56.61/24
# 这里填入您的 `服务器地址:端口`
-l=vip00.happyn.cc:30002
- 设定参数完毕后，执行以下命令启动:
sudo brew services start happynet
- 查看状态
tail -f /usr/local/var/log/homebrew.mxcl.happynet.log
如果看到
HTML
"[OK] Edge Peer <<< ================ >>> Super Node"，
表示已经成功加入子网
- 查看系统信息，您会看到一个名为 tap0的虚拟网卡
sudo ifconfig
tap0: flags=8843<UP,BROADCAST,RUNNING,SIMPLEX,MULTICAST> mtu 1290
ether 16:96:63:c6:5f:c9
inet 10.251.56.61 netmask 0xffffff00 broadcast 10.251.56.255
media: autoselect
status: active
open (pid 34807)
- 查看服务状态
$ sudo brew services ls
Name Status User Plist
happynet started root /Library/LaunchDaemons/homebrew.mxcl.happynet.plist
-
五分钟后，刷新您的Web后台，此设备会自动记录到Web界面中
-
卸载happynet 服务
brew uninstall happynet
brew uninstall tuntap
-
到发布页面直接下载我们最新的安装包
-
解压安装包
tar zxvf happynet-macos-darwin-amd64-0.2.tar.gz
- 打开终端,将可执行文件,配置文件,系统服务文件拷贝到相应的路径
sudo mkdir -p /usr/local/bin
sudo mkdir -p /usr/local/etc
sudo mkdir -p /usr/local/var/log
cd happynmacos
sudo chmod +x bin/happynet
sudo cp bin/happynet /usr/local/bin/
sudo cp conf/happynet.conf /usr/local/etc/
service/happynet.plist /Library/launchAgents/cc.happyn.happynet.plist
- 修改配置文件,您需要填入的4个参数(从您的happyn.cn web端后台登录可以获取):
sudo vim /usr/local/etc/happynet.conf
-
本地地址：您的虚拟服务子网IP地址，ip网段从web界面可查，比如，服务子网为10.251.56.0/24，您可以设定从 10.251.56.1 -- 10.251.56.254 任意地址，只要保证每台机器不冲突即可
-
服务ID：从后台web界面可以得到，是分配给每个用户的唯一子网标识
-
服务密钥：从后台web界面可以得到, 是系统为您的分配的子网token，您可以自己设定，但是只有相同 "服务ID+服务密钥"的机器才能互通
-
服务器端口：从后台web界面可以得到
- 载入服务
sudo launchctl load -w /Library/launchAgents/cc.happyn.happynet.plist
-
如果系统提示
无法打开程序,无法验证开发者; 请打开系统偏好设置>安全性与隐私>通用，这个时候有个按钮，仍然允许点击即可。 -
启动服务
sudo launchctl start /Library/launchAgents/cc.happyn.happynet.plist
- 查看log
tail -f /usr/local/var/log/happynet.log
- 停止服务
sudo launchctl kill 15 system/happynet
- 客户端支持哪些平台?
目前支持主流MacOS 64位系统；
- 我所有设备上的程序已经显示运行成功，但是我Ping不通对方，为什么？
首先请检查是否参数都正确配置了，特别要保证 "服务ID+服务密钥" 是否在所有客户端都一致，有很多时候是我们太粗心;
其次请检查自己的机器是否开启了防火墙，可以先用机器的原有IP Ping一下，看看通不通；
最后请仔细检查happynet的输出Log，看是否有"[OK]"的连接成功输出，如果没有，最大的可能是您短时间内多次连接，被系统判断为恶意扫描禁止了；此时您先点击“停止”，然后等待2分钟，再次重连即可
- 还有其它问题？
没关系，请到我们的交流论坛 向我们反馈问题，谢谢您的包容和支持！