# goodlink

**Repository Path**: xunlesheng/goodlink

## Basic Information

- **Project Name**: goodlink
- **Description**: 全网最简单、零成本的内网穿透，一条命令将互联网任意两台主机直连！无中转、无安装、无注册。新增TUN模式，IP直连，不限端口
- **Primary Language**: Go
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: https://goodlink.kony.vip
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 197
- **Created**: 2025-03-31
- **Last Updated**: 2025-03-31

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

<img src="https://gitee.com/konyshe/goodlink/raw/master/assert/letter-g-2.png" width="400" height="100">

由于经常异地办公, 对于市面上的远程桌面工具, 无论速度、画面等, 都不如 windows 自带的远程桌面, 但异地如使用 windows远程桌面呢？

是否可以无需远程桌面, 直接浏览器访问公司的内网 WEB, GIT, SSH 等, 和在公司一模一样？

**注: 作者开发该项目的初衷，是方便自己的同时，方便大家，提升热度，希望对未来有所帮助。该项目仅用于学习研究, 目前没有任何商业合作，更没有任何恶意行为。如果未来有广告之类盈利的行为，会郑重告知大家。另外声明：严禁用于违法行为！！！**

[切换回1.6版文档](https://gitee.com/konyshe/goodlink/blob/v1.6/README.md)

# 特点

1. 两台主机之间直连！直连！直连！不经过第三方服务器, 不用担心数据泄露

2. 一条命令搞定, 无需安装、无需注册, 无需公网 IP, 无需配置文件

![原理图](https://gitee.com/konyshe/goodlink/raw/master/assert/prototype_cn.gif "原理图")

# 重点

1. 本程序即支持命令行方式, 也支持 docker 方式, windows 版本还新增了UI版本, 适合新手。以下举例仅作参考, 可随意搭配

2. 两端主机运行同一个程序 / Docker, 一端使用--remote 选项(以下称 remote 端), 另一端使用--local 选项(以下称 local 端)

3. 可以在 local 端访问 remote 端, 但是反过来不可以

4. 可以无限个 local 端连接同一个 remote 端, 但一个 local 端不能同时连接多个 remote 端。通过相同的密钥(--key)确认连接关系

5. 由于直连过程复杂, 会出现反复重试, 通常 10 分钟内成功。如果长时间无法连接, [反馈我解决](https://gitee.com/konyshe/goodlink/issues)

6. windows 自带杀毒软件, 会将所有 go 语言写的程序都默认为病毒。本程序已开源, 可放心食用

7. 以下举例说明中的密钥(--key), 请不要使用, 否则会连上别人的 remote 端, 或者被别人的 local 端连上。自己随机一个 16-24 字节长度的密钥

 <table>
	<th>Remote端</th><th>Local端</th><th>P2P成功</th>
	<tr><td>NAT1-3</td><td>NAT1-4</td><td>YES</td></tr>
      <tr><td>NAT1-4</td><td>NAT1-3</td><td>YES</td></tr>
	<tr><td>NAT4</td><td>NAT4</td><td>由于运营商算法调整，不保证100%</td></tr>
  </table>

# 工作模式

注：以下两个模式同时存在, 无需选择

### TUN模式

    Local端会创建一个虚拟网卡, 因此需要管理员权限运行。连接成功后，界面会显示: 对端IP

    不限端口，访问对端IP的任意端口，都相当于访问Remote端本机的任意端口

    对端IP目前固定为: 192.17.19.1 , 具体以界面或者日志显示为准

    举例: 在家里电脑(或出差电脑), 打开 windows 远程桌面, 填写对端IP, 即可访问公司电脑的远程桌面

    注: 目前仅支持TCP协议

### 代理模式

    代理端口目前固定为: 1080

    代理地址端口: socket5://对端IP:1080

    local端需要在系统或者软件中配置Socket5代理, 访问任意主机端口, 相当于Remote端自己在访问

    举例: 在公司电脑上配置代理: socks5://对端IP:1080, 访问家里包括 NAS 在内的所有主机端口

    注: 目前仅支持TCP代理，浏览器可安装插件 SwitchyOmega。其他 GIT, SVN, SSH 等, 都支持socks5代理

# 简单使用

## 举例 1

###  **启动 remote端** 

#### windows, UI

注: 当最下方的按钮变成绿色, 表示启动成功

![使用说明](https://gitee.com/konyshe/goodlink/raw/master/assert/v2/5.png "使用说明")

###  **启动 local端** 

#### windows, UI

注: 当最下方的按钮变成绿色, 表示连接成功

![使用说明](https://gitee.com/konyshe/goodlink/raw/master/assert/v2/6.png "使用说明")

## 举例 2

###  **启动 remote端** 

#### linux, Docker

```
docker rm goodlink -f; docker run -d --name=goodlink --net=host --restart=always registry.cn-shanghai.aliyuncs.com/kony/goodlink --key=nas_202412140928 --remote
```

#### linux, 命令行

```
./goodlink-linux-amd64 --key=nas_202412140928 --remote
```

#### windows, 命令行

```
.\goodlink-windows-amd64.exe --key=nas_202412140928 --remote
```

###  **启动 local端** 

#### linux, Docker

```
docker rm goodlink -f; docker run -d --name=goodlink --net=host --restart=always registry.cn-shanghai.aliyuncs.com/kony/goodlink  --key=nas_202412140928 --local
```

#### linux, 命令行

```
./goodlink-linux-amd64 --key=nas_202412140928 --local
```

#### windows, 命令行

```
.\goodlink-windows-amd64.exe --key=nas_202412140928 --local
```


# 感谢支持

  danshiyuan

# [问题解答](https://gitee.com/konyshe/goodlink/issues)