corplink-rs

corplink-rs

使用 rust 实现的 飞连 客户端，支持 Linux/Windows10/MacOS

安装

ArchLinux

下载 release 中的安装包，并安装

pacman -U corplink-rs-4.1-1-x86_64.pkg.tar.zst

欢迎贡献其它包管理器的打包脚本

手动编译

linux/macos

git clone https://github.com/PinkD/corplink-rs --depth 1
cd corplink-rs
# build libwg
cd libwg
./build.sh
# if you are using Windows, you can clone and build libwg maunally
# ref: wireguard-go/Makefile:libwg

cargo build --release
# install corplink-rs to your PATH
mv target/release/corplink-rs /usr/bin/

windows

前提: 需要 Go (≥1.22)、GCC (MinGW-w64)、make、Rust (GNU 工具链)。

安装工具链后，在 PowerShell 中执行：

# 1. 构建 libwg（生成 libwg.a + libwg.h）
cd libwg
.\build.ps1

# 2. 构建 Rust 项目
cd ..
rustup toolchain install stable-gnu
rustup default stable-x86_64-pc-windows-gnu
cargo build --release

编译的 build.ps1 会调用 make libwg，该目标会以 CGO_ENABLED=1 编译 Go 代码。 MinGW GCC 需要在 PATH 中，且 make 需要支持 bash 风格环境变量语法。 也可在 MSYS2 UCRT64 环境中执行 ./build.sh（同样需要 Go + GCC）。

用法

该程序需要 root 权限来启动 wg-go (windows 上需要管理员权限)

# direct
corplink-rs config.json
# systemd
# config is /etc/corplink/config.json
systemctl start corplink-rs.service
# auto start
systemctl enable corplink-rs.service

# systemd with custom config
# config is /etc/corplink/test.json
# NOTE: cookies.json is reserved by cookie storage
systemctl start [email protected]

windows 使用说明

快速开始（推荐使用预编译版本）

1. 从 Releases 下载 corplink-rs-*-windows.zip
2. 解压到任意目录
3. 运行 setup.ps1 自动获取 wintun.dll：

powershell -ExecutionPolicy Bypass -File setup.ps1

1. 编辑 config.json，填入公司代码和登录信息（见下方配置文件实例）
2. 以管理员身份打开 PowerShell，运行：

.\corplink-rs.exe config.json

# 调试模式
$env:RUST_LOG="debug"; .\corplink-rs.exe config.json

wintun.dll 说明

corplink-rs 依赖 Wintun 虚拟网卡驱动来创建 WireGuard 隧道。由于 Wintun 的许可证要求用户从官网直接获取，我们无法在 release 包中附带该文件。

setup.ps1 脚本会自动从 wintun.net 下载并解压 amd64 版本的 wintun.dll 到当前目录。

手动获取：访问 wintun.net，下载 zip 包，将 bin/amd64/wintun.dll 复制到 corplink-rs.exe 所在目录。

管理员权限

程序需要管理员权限，原因：

• wg-go 需要创建 TUN 虚拟网卡
• 配置系统路由表（自动添加 VPN 路由）

如果运行时提示 please run as administrator，右键 PowerShell 选择"以管理员身份运行"。

常见问题

• wintun.dll 找不到：运行 setup.ps1 或手动下载放入同目录
• 配置文件 JSON 不支持注释：示例中的 // comment 需要删除
• 路由未生效：检查是否以管理员运行，关闭其他 VPN 软件避免路由冲突

macos 特殊说明

macos 要求 tun 设备的名称满足正则表达式 utun[0-9]* ，因此需要将配置文件中的 interface_name 改为符合正则的名字，例如 utun12345
另外， utun 后的数字类型应该是 int16 ，如果大于 32767 会报错 Failed to create TUN device: invalid argument 。具体参考 #46

log level 配置

本项目使用 env_logger 作为 log 库，修改 log level 需要使用环境变量，示例：

RUST_LOG=debug ./corplink-rs config.json

配置文件实例

最小配置

{
  "company_name": "company code name",
  "username": "your_name"
}

推荐配置(自用配置)

{
  "company_name": "company code name",
  "username": "your_name",
  "password": "your_pass",
  "platform": "ldap"
}

完整配置

…

SOCKS5 / netstack 模式

设置 socks5_listen 后，corplink-rs 不再创建内核 TUN 网卡，而是用 wg-go 的 gVisor netstack 在用户态跑 WireGuard，并在该地址上暴露一个 SOCKS5 代理：

• 无需 root / 不改系统路由和 DNS / 不建网卡，适合容器、无权限环境或只想给单个应用走 VPN 的场景
• 支持 TCP CONNECT 和 UDP ASSOCIATE，域名在隧道内解析（用 --socks5-hostname 让客户端把 DNS 也交给代理）
• 可选用户名/密码认证（RFC 1929）：设置 socks5_username（及 socks5_password）即开启；留空则免认证

# 例：通过代理访问内网
curl --socks5-hostname user:[email protected]:1080 https://intranet.example.com/

此模式下 interface_name、use_vpn_dns、auto_setup_routes 等与系统网卡/路由相关的设置不生效。

原理和分析

飞连 是基于 wg-go 魔改的企业级 VPN 产品

配置原理

魔改了配置的方式，加了鉴权

猜测是：

• 动态管理 peer
• 客户端通过验证后，使用 public key 来请求连接，然后服务端就将客户端的 key 加到 peer 库里，然后将配置返回给客户端，等待客户端连接
  • wg 是支持同一个接口上连多个 peer ，所以这样是 OK 的
• 定时将不活跃的客户端清理，释放分配的 IP
• ...

因此，我们只需要生成 wg 的 key ，然后去找服务端拿配置，然后写到 wg 配置里，启动 wg ，就能连上服务端了

后续改动

2.0.9 版本(或者更早)新增了 protocol_version 字段，需要使用魔改后的 wg-corplink 才能连接

请求流程

Linux

graph TD;
    A[Password Login];
    B[Request Email Code];
    C[Email Login];
    D[Verify 2-FA];
    E[List VPN];
    F[Ping VPN];
    G[Connect VPN];
    A-->D;
    B-->C-->D;
    D-->E-->F-->G;

Android

graph TD;
    A[Password Login];
    B[Request Email Code];
    C[Email Login];
    D[List VPN];
    E[Ping VPN];
    F[Connect VPN With 2-FA Code];
    A-->D;
    B-->C;
    C-->D-->E-->F;

otp 实现

飞连的 otp 是使用的标准的 totp ，在 ua 为 Android 时，会在登录时返回 totp 的 token ，然后使用 totp 算法就能生成出当前时间的验证码了，然后在获取连接信息时传输该验证码，就不需要单独验证验证码了

TODO

• 使用 Tauri 实现界面(或许大概可能永远不会有)
  • 参考实现：https://github.com/huangzheng2016/ecorplink
• 实现 TCP 版的 wg 协议
• 为不同配置生成不同的 cookies.json
• windows/mac 实现
• 自动使用从服务器返回的请求中的时间戳同步时间
• 自动生成 wg key
• 修复服务端异常断开连接后客户端不会退出的问题

Changelog

• 0.5.5
  • add more route configs(@yanickxia @zier-one @kfxhjz @ZeppLu)
  • support protocol override config(@n-WN)
  • usermode proxy with socks5(@wilinz)
  • minor fix(@Ben8368 @huangzheng2016)
• 0.5.4
  • fix memory leak in unsafe code
  • refactor error handling with anyhow
  • fix default log level
  • add ci for push event(@yanyongyu)
• 0.5.3
  • remove keep-alive api call
• 0.5.2
  • add ipv6 support(@hexchain @ManiaciaChao)
• 0.5.1
  • support using dns from server for macos(@fanwenlin)
  • fix high cpu usage
• 0.5.0
  • add tcp support for wg-go
• 0.4.4
  • add macos release(by @overvenus)
  • fix single ip route(by @simpleapples)
  • add qr code suuport for feishu login(@simpleapples)
• 0.4.3
  • support corplink 2.2.x(by @jixiuf)
• 0.4.2
  • add OIDC platform support(by @Jinxuyang)
• 0.4.1
  • fix Windows device up
  • fix undefined behavior for c str
• 0.4.0
  • embed wg-go with cgo
• 0.3.6
  • fix wg-corplink not exit(by @LionheartLann)
  • fix session is expired(by @XYenon)
• 0.3.5
  • fix empty login method list
  • fix write long data to uapi(by @nolouch)
  • add vpn server name option(by @nolouch)
• 0.3.4
  • fix cookie out of date
• 0.3.3
  • add feishu tps login support
  • upgrade dependency
• 0.3.2
  • separate cookies.json
  • add debug flag for wg-go
• 0.3.1
  • fix mac support(on wg-corplink)
• 0.3.0
  • add windows/mac support
• 0.2.3
  • fix empty protocol_version
  • add privilege check
• 0.2.2
  • fix wg-corplink not exit if corplink-rs exit accidently
• 0.2.1
  • use modified wireguard-go
    • don't generate config anymore
  • remove conf_name/conf_dir and add interface_name/wg_binary in config
• 0.1.4
  • get company name from company code automatically
  • support ldap
  • check and skip tcp wg server
  • optimize config
• 0.1.3
  • disconnect if wireguard handshake timeout
• 0.1.2
  • support time correction for totp
• 0.1.1
  • support generate wg key
• 0.1.0
  • first version

参考链接

• wg-go
• totp
• python 版本
• wg-corplink
• wintun
• Tauri

License

…