让深信服开发的非自由的 EasyConnect 代理软件运行在 docker 中，并开放 Socks5 供宿主机连接以使用代理。
这个 image 基于 EasyConnect 官方“Linux”版的 deb 包以及 @shmille 提供的命令行版客户端 deb 包。
如何运行“Linux”版 EasyConnect (7.6.3.0.86415版) (doc/run-linux-easyconnect-how-to.md)是这次折腾的总结。
另有 @shmilee 的 easyconnect-in-docker 方案（另见 #35）实现了多 EasyConnect 版本共用容器，其中还有另一个纯 cli 版本的容器。
如果希望使用全局代理，可参考 记折腾容器化 EasyConnect 的全局透明代理 一文设置宿主机路由（或许有更好的办法，欢迎反馈）。
望批评、指正。欢迎提交 issue、PR，包括但不仅限于 bug、各种疑问、代码和文档的改进。
- 安装Docker并运行；
- 在终端输入：
其中
touch ~/.easyconn docker run --device /dev/net/tun --cap-add NET_ADMIN -ti -v $HOME/.easyconn:/root/.easyconn -p 127.0.0.1:1080:1080 -e EC_VER=7.6.3 hagb/docker-easyconnect:cli
-e EC_VER=7.6.3表示使用7.6.3版本的 EasyConnect，请根据实际情况修改版本号； - 根据提示输入服务器地址、登录凭据；
- 浏览器单独配置socks5代理（可以通过插件配置），地址: 127.0.0.1, 端口: 1080
- 此时你应该就可以通过浏览器连接到内网了。
- 安装Docker并运行；
- 在终端输入：
docker run --device /dev/net/tun --cap-add NET_ADMIN -ti -e PASSWORD=xxxx -v $HOME/.ecdata:/root -p 127.0.0.1:5901:5901 -p 127.0.0.1:1080:1080 hagb/docker-easyconnect:7.6.3（末尾 EasyConnect 版本号7.6.3请根据实际情况修改）； - 使用vnc客户端连接vnc， 地址：127.0.0.1, 端口: 5901, 密码 xxxx ;
- 成功连上后你应该能看到easyconnect的登录窗口，填写并登录easyconnect；
- 浏览器单独配置socks5代理（可以通过插件配置），地址: 127.0.0.1, 端口: 1080
- 此时你应该就可以通过浏览器连接到内网了。
注意：如果你要将系统代理设置为127.0.0.1:1080而不是单独配置浏览器，请保证docker engine本身不会通过系统代理联网。
ec_urls 目录中以版本号.txt为文件名的文本文件保存了下载链接。（欢迎提交 issue 或 PR）
7.6.3版（http://download.sangfor.com.cn/download/product/sslvpn/pkg/linux_01/EasyConnect_x64.deb）.
7.6.7版（http://download.sangfor.com.cn/download/product/sslvpn/pkg/linux_767/EasyConnect_x64_7_6_7_3.deb）.
7.6.8版（https://github.com/shmilee/scripts/releases/download/v0.0.1/easyconn_7.6.8.2-ubuntu_amd64.deb）.
请通过设置下文叙述的EC_URL变量进行测试，欢迎提交 issue 或 PR.
docker pull hagb/docker-easyconnect:TAG
其中 TAG 可以是如下值（不带 VNC 服务端的 image 比带 VNC 服务端的 image 小）：
latest: 默认值，带 VNC 服务端的7.6.3版 image，cli: 多版本（7.6.3,7.6.7,7.6.8）纯命令行版vncless: 不带 VNC 服务端的7.6.3版 image7.6.3: 带 VNC 服务端的7.6.3版 imagevncless-7.6.3: 不带 VNC 服务端的7.6.3版 image7.6.7: 带 VNC 服务端的7.6.7版 imagevncless-7.6.7: 不带 VNC 服务端的7.6.7版 image
git clone https://github.com/hagb/docker-easyconnect.git --branch cli
cd docker-easyconnect
docker image build --tag hagb/docker-easyconnect -f Dockerfile.cli .git clone https://github.com/hagb/docker-easyconnect.git
cd docker-easyconnect
EC_VER=7.6.3 # 此变量填写 ec_urls 文件夹中的版本，`7.6.3`或`7.6.7`
docker image build --build-arg EC_URL=$(cat ec_urls/${EC_VER}.txt) --tag hagb/docker-easyconnect -f Dockerfile .git clone https://github.com/hagb/docker-easyconnect.git
cd docker-easyconnect
EC_VER=7.6.3 # 此变量填写 ec_urls 文件夹中的版本，`7.6.3`或`7.6.7`
docker image build --build-arg EC_URL=$(cat ec_urls/${EC_VER}.txt) --tag hagb/docker-easyconnect -f Dockerfile.vncless .如果需要测试ec_urls目录中尚未包含的 EasyConnect 版本，可以将该版本的 deb 安装包下载地址写入到文本文件ec_urls/版本号.txt中，或者直接将地址赋予编译变量EC_URL（以上文为例则是用该地址替换$(cat ec_urls/${EC_VER}.txt)）
参数里的--device /dev/net/tun --cap-add NET_ADMIN是不可少的。 因为 EasyConnect 要创建虚拟网络设备tun0。
EC_URL（仅适用于图形界面版）: EasyConnect 的 deb 包下载地址EC_763_URL（仅适用于命令行版）:7.6.3版 EasyConnect 的 deb 包下载地址，默认为http://download.sangfor.com.cn/download/product/sslvpn/pkg/linux_01/EasyConnect_x64.deb，将其设为空值时构建的镜像不包含7.6.3版的配置文件EC_767_URL（仅适用于命令行版）:7.6.7版 EasyConnect 的 deb 包下载地址，默认为http://download.sangfor.com.cn/download/product/sslvpn/pkg/linux_767/EasyConnect_x64_7_6_7_3.deb，将其设为空值时构建的镜像不包含7.6.7版的配置文件EC_CLI_URL（仅适用于命令行版）: @shmilee 提供的命令行7.6.8版 deb 包的下载地址，默认为https://github.com/shmilee/scripts/releases/download/v0.0.1/easyconn_7.6.8.2-ubuntu_amd64.deb
-
TYPE（仅适用于带 vnc 的 image）: 如何显示 EasyConnect 前端（目前没有找到纯 cli 的办法）。有以下两种选项:-
x11或X11: 将直接通过DISPLAY环境变量的值显示 EasyConnect 前端，请同时设置DISPLAY环境变量。 -
其它任何值（默认值）: 将在
5901端口开放 vnc 服务以操作 EasyConnect 前端。
-
-
DISPLAY（仅适用于图形界面版）:$TYPE为x11或使用无 vnc 的 image 时通过该变量来显示 EasyConnect 界面。 -
PASSWORD（仅适用于图形界面版）: 用于设置 vnc 服务的密码，该变量的值默认为空字符串，表示密码不作改变。变量不为空时，密码（应小于或等于 8 位）就会被更新到变量的值。默认密码是password. -
URLWIN（仅适用于图形界面版）: 默认为空，此时当 EasyConnect 想要调用浏览器时，不会弹窗，若该变量设为任何非空值，则会弹出一个包含链接文本框。 -
EXIT: 默认为空，此时前端退出后会自动重连。不为空时，前端退出后不自动重启。 -
MAX_RETRY: 最大重连次数，默认为空。 -
NODANTED: 默认为空。不为空时提供 socks5 代理的danted将不会启动（可用于和--net host参数配合，提供全局透明代理）。 -
ECPASSWORD（仅适用于图形界面版）: 默认为空，使用 vnc 时用于将密码放入粘帖板，应对密码复杂且无法保存的情况 (eg: 需要短信验证登录)。 -
IPTABLES_LEGACY: 默认为空。设为非空值时强制要求iptables-legacy。在 Windows 的 docker 和部分其他环境下须开启，详见已知问题 -
EC_VER（仅适用于纯命令行版）: 指定运行的 EasyConnect 版本，必填 -
CLI_OPTS（仅适用于纯命令行版）: 默认为空，给easyconn login加上的额外参数，可用参数如下：-d vpn address, make sure it's assigned and the format is right, like "199.201.73.191:443" -t login type, "pwd" means username/password authentication "cert" means certificate authentication -u username -p password -c certificate path -m password for certificate -l certificate used to be authentication例如
CLI_OPTS="-d 服务器地址 -u 用户名 -p 密码"可实现原登录信息失效时自动登录。
EasyConnect 创建tun0后，Socks5 代理会在容器的1080端口开启。这可用-p参数转发到127.0.0.1上。
带 VNC 时，默认情况下，环境变量TYPE留空会在5901端口开启 VNC 服务器。
处理成将链接（追加）写入/root/open-urls，如果设置了URLWIN环境变量为非空值，还会弹出一个包含链接的文本框。
用 -v 参数将宿主机的登录信息文件（请确定该文件已存在）挂载到容器的 /root/.easyconn，如 -v $HOME/.easyconn:/root/.easyconn .
只需要用-v参数将宿主机的目录挂载到容器的 /root 。
如-v $HOME/.ecdata:/root。
由此还能实现全自动登录。
以下例子中，开放的 Socks5 在127.0.0.1:1080（-p 127.0.0.1:1080:1080）。图形界面（X11 socket 和 vnc）两例中，登录信息均保存在~/.ecdata/文件夹（-v $HOME/.ecdata:/root）
下列例子可启动纯命令行的 EasyConnect 7.6.3（-e EC_VER=7.6.3），并且退出后不会自动重启（-e EXIT=1）。
touch ~/.easyconn
docker run --device /dev/net/tun --cap-add NET_ADMIN -ti -v $HOME/.easyconn:/root/.easyconn -e EC_VER=7.6.3 -e EXIT=1 -p 127.0.0.1:1080:1080 hagb/docker-easyconnect下面这个例子可以在当前桌面环境中启动 EasyConnect 前端，并且该前端退出后不会自动重启（-e EXIT=1），EasyConnect 要进行浏览器弹窗时会弹出含链接的文本框（-e URLWIN=1）。
xhost +LOCAL:
docker run --device /dev/net/tun --cap-add NET_ADMIN -ti -v /tmp/.X11-unix:/tmp/.X11-unix -v $HOME/.Xauthority:/root/.Xauthority -e EXIT=1 -e DISPLAY=$DISPLAY -e URLWIN=1 -e TYPE=x11 -v $HOME/.ecdata:/root -p 127.0.0.1:1080:1080 hagb/docker-easyconnect
xhost -LOCAL:下面这个例子中，前端退出会自动重启前端，VNC 服务器在127.0.0.1:5901（-p 127.0.0.1:5901:5901），密码为xxxx（-e PASSWORD=xxxx）。
docker run --device /dev/net/tun --cap-add NET_ADMIN -ti -e PASSWORD=xxxx -v $HOME/.ecdata:/root -p 127.0.0.1:5901:5901 -p 127.0.0.1:1080:1080 hagb/docker-easyconnect出现多条报错：Couldn't load match 'state':No such file or directory 或 ip: RTNETLINK answers: Operation not permitted
此为运行环境不支持 nft 且未被容器脚本检测出来所致。可以通过设置环境变量 IPTABLES_LEGACY 为 1 明确让容器使用 legacy iptables 来解决。
该问题在7.6.3版上有出现，7.6.7版上未知。
有时登录时卡一小会儿，然后弹出Failed to login in with this user account, for a user is online!的窗口，但实际上同一账号并没有其他客户端同时在线。点击OK后 EasyConnect 退出。
在 docker 命令行内临时删去设置EXIT环境变量的-e EXIT=参数（如果有），在弹窗发生后点击OK，使客户端重启，重启后问题消失。
原因是 image 内无中文字体。可以通过修改 EasyConnect 前端的语言为英语来绕过中文显示的问题。也可以安装或挂载中文字体进容器中。
详见 #2。
登录过程的一个 hack (docker-root/usr/local/bin/start-sangfor.sh)参考了这篇文章：https://blog.51cto.com/13226459/2476193。在此对该文作者表示感谢。
Copyright © 2020 contributors
This work is free. You can redistribute it and/or modify it under the
terms of the Do What The Fuck You Want To Public License, Version 2,
as published by Sam Hocevar. See the COPYING file for more details.
可以对这份东西做任何事情。
DO WHAT THE FUCK YOU WANT TO PUBLIC LICENSE Version 2, December 2004Copyright (C) 2004 Sam Hocevar sam@hocevar.net
Everyone is permitted to copy and distribute verbatim or modified
copies of this license document, and changing it is allowed as long
as the name is changed.DO WHAT THE FUCK YOU WANT TO PUBLIC LICENSETERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION
- You just DO WHAT THE FUCK YOU WANT TO.