一个高可用,低时延,反审查的组网工具.
这个项目编译出的命令行版本可执行文件根据参数区分以服务端模式运行还是客户端模式运行,因此安装不区分客户端与服务端.
建议使用 Docker 镜像,已上传到 Docker Hub 和 Github Packages.
容器需要管理员权限读取设备创建虚拟网卡并设置路由,同时需要 Host 网络命名空间共享虚拟网卡.
docker run --rm --privileged=true --net=host docker.io/lanthora/candy:latest --help使用 AUR 或者 archlinuxcn 仓库
# 安装 AUR 版本,由于依赖可能会升级,需要先完整更新系统
paru -Syu candy
# 安装 archlinuxcn 版本
pacman -S candy使用 GURU 仓库
eselect repository enable guru
emerge --sync guru && emerge -av candy使用 OBS 仓库
# 以 Tumbleweed 为例,更新仓库缓存时选择信任签名
zypper addrepo https://download.opensuse.org/repositories/home:lanthora:candy/openSUSE_Tumbleweed/home:lanthora:candy.repo
zypper refresh && zypper install candy在 Release 中提供 deb 安装包.
请参考 Homebrew 仓库中提供的方法安装.
Cake 是将本项目作为依赖库构建的 GUI 版本,其 Release 中提供安装包.
在 Release 中提供了由 CI 构建的命令行版本.用户可以在此基础上自行定制.
依赖 C++20 的编译器.
cmake -B build -DCANDY_STATIC=1
cmake --build build
cmake --install build交叉编译脚本自动下载编译器到工作目录并构建对应目标的可执行程序.目前支持以下 TARGET, 请根据需要自行选择.
- aarch64
- armv7l-eabihf
- armv7m-eabi
- arm-eabi
- arm-eabihf
- mips
- mipsel
- i686
- x86_64
以构建 aarch64 为例
# 设置工作目录
export WORKSPACE=/tmp/candy
# 设置架构
export TARGET=aarch64
# 设置是否 strip
export ENABLE_STRIP=1执行构建脚本
scripts/build-single-file-exe.sh生成的二进制文件为 $WORKSPACE/output/$TARGET/candy.
客户端的默认配置会连到测试网络并被随机分配一个地址.
客户端会缓存服务端分配的地址,并在下次启动时优先申请使用这个地址,地址保存在 /var/lib/candy 目录下,启动容器服务前需要在 Host 创建一个目录用于映射,否则容器重启丢失数据将导致重新分配地址.
创建与容器内相同的目录以方便理解.
mkdir -p /var/lib/candy以容器的方式接入测试网络
docker run --rm --privileged=true --net=host --volume /var/lib/candy:/var/lib/candy docker.io/lanthora/candy:latest当成功部署两个及以上客户端后,客户端之间可以相互访问.得益于路由功能,网络中的客户端数量越多,访问时延越低.
参数可以由命令行指定
# 查看可用的命令行参数
candy --help也可以通过配置文件指定.使用配置文件时需要指定路径.推荐使用配置文件,可以在不重建容器的情况下修改配置.
# 指定配置文件路径
candy -c /path/to/candy.cfg监听所有网卡的 80 端口,客户端连接后自动在 10.0.0.0/24 子网分配地址,并设置登录口令为 123456
# 以服务端模式工作
mode = "server"
# 服务端不支持 wss, 需要由外部的服务加密,例如 nginx/caddy, 生产环境建议使用 wss
websocket = "ws://0.0.0.0:80"
# 不配置此项时,客户端需要指定静态地址
dhcp = "10.0.0.0/24"
# 不配置此项时,口令为空
password = "123456"与上述服务端匹配的客户端配置
# 以客户端模式工作
mode = "client"
# 示例以 ws 传输明文,客户端支持 wss 协议
websocket = "ws://127.0.0.1:80"
# 需要与服务端配置保持一致
password = "123456"
# 静态地址,服务端配置 dhcp 的情况下可以不配置此项,由服务端随机分配地址
tun = "10.0.0.1/24"
# 网卡名,区分单个机器上的多个客户端,同一台主机的网卡名不能冲突,不配置此项表示使用默认网卡名 candy
name = "test"
# STUN 服务器,用于获取建立对等连接所需的公网信息,不配置此项表示不启用对等连接
stun = "stun://stun.canets.org"
# 指定对等连接监听的本地 UDP 端口,不配置此项表示由操作系统随机分配
port = 0关于路由的配置
# 路由功能在对等连接的基础上工作,对等连接是被动启动,
# 有些设备本可以作为中继,但由于此前没有与中继设备的流量导致无法使用路由.
# 此配置以秒为单位周期性的尝试让网络中的其他设备与本设备建立对等连接.
# 不添加此配置或者配置为 0 表示不启用主动发现.
discovery = 300
# 当消息通过本机作为中继转发时在本机内部消耗的代价.
# 此配置以毫秒为单位与直连设备间的真实时延求和作为以本机为路由的代价广播.
# 不配置或者配置配置为 0 表示不启用路由加速.
route = 5关于局域网内建立对等的配置
# 用于建立对等连接的本机局域网 IP 地址,不配置此项时将尝试自动获取.
# 有多个物理网卡时建议手动配置.
localhost = "127.0.0.1"目前已经达成了最初的目标: 让装了客户端的设备之间可以通过虚拟 IP 相互访问.对于 C++ 版本,将尽可能维持稳定,不添加新功能.
- EasyTier: A simple, decentralized mesh VPN with WireGuard support
- TG: Click to Join
- QQ: 768305206