GoodLink 技术文档:跨网络直连工具使用指南
1. 项目概述
GoodLink 是一款基于P2P技术的跨网络直连工具,旨在解决用户在外出办公时访问公司内网资源的需求。通过直连技术,用户无需公网IP或第三方服务器中转,即可安全访问内网的WEB、GIT、SSH等服务。
2. 安装指南
2.1 系统要求
- 支持操作系统:Windows/Linux
- 网络要求:NAT类型1-3(推荐)
- 硬件要求:x86-64架构
2.2 下载方式
从项目发布页面获取对应平台的二进制文件:
- Windows: goodlink-windows-amd64.exe
- Linux: goodlink-linux-amd64
2.3 安装步骤
Windows安装
- 下载Windows版本可执行文件
- 右键以管理员身份运行(需要虚拟网卡创建权限)
Linux安装
- 下载Linux版本二进制文件
- 赋予执行权限:
chmod +x goodlink-linux-amd64
Docker安装(仅Remote端)
docker run -d --name=goodlink --net=host --restart=always registry.cn-shanghai.aliyuncs.com/kony/goodlink --key=YOUR_KEY --remote
3. 使用说明
3.1 基本概念
- Remote端:内网主机,提供接入服务
- Local端:外网主机,连接内网服务
- 密钥(--key):16-24字节长度的连接凭证
3.2 工作模式
TUN模式(虚拟网卡)
- Local端创建虚拟网卡
- 通过Remote端IP直接访问内网服务
- 支持Windows远程桌面等原生连接
代理模式
- SOCKS5代理地址:socks5://Remote端IP:1080
- 支持浏览器、GIT、SSH等TCP协议代理
3.3 启动方式
Remote端启动
Windows命令行:
.\goodlink-windows-amd64.exe --fork --key=YOUR_KEY --remote
Linux命令行:
./goodlink-linux-amd64 --key=YOUR_KEY --remote
Local端启动
Windows命令行:
.\goodlink-windows-amd64.exe --fork --key=YOUR_KEY --local
Linux命令行:
./goodlink-linux-amd64 --key=YOUR_KEY --local
4. API使用文档
GoodLink目前提供两种接入方式:
4.1 命令行参数
| 参数 | 说明 | 示例 |
|---|---|---|
| --key | 连接密钥(16-24字节) | --key=AbCdEfGh1234567890 |
| --remote | 作为Remote端运行 | --remote |
| --local | 作为Local端运行 | --local |
| --fork | 后台运行(Windows) | --fork |
4.2 网络接口
- TUN接口:自动创建的虚拟网卡,IP由Remote端分配
- SOCKS5代理:1080端口,支持标准SOCKS5协议
5. 注意事项
- 防火墙设置:关闭路由器防火墙或设置DMZ主机
- NAT类型要求:推荐NAT1-3类型,NAT4可能无法连接
- 安全提示:
- 使用自定义密钥,避免示例密钥
- Windows Defender可能误报,需添加信任
- 连接限制:
- 一个Local端只能连接一个Remote端
- 多个Local端可连接同一个Remote端
- 移动网络:2G-5G网络不支持直连
6. 常见问题
- 连接超时:检查NAT类型,联系ISP修改为NAT1-3
- 虚拟网卡创建失败:以管理员权限运行程序
- 代理不生效:检查应用是否支持SOCKS5代理
注:本文档基于GoodLink项目README整理,具体实现可能随版本更新而变化。使用前请确保符合当地法律法规。
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考



