LincAccess软件使用说明书
目录
一、概述
二、被穿透机器的配置
- Linux 系统
- Windows 系统
三、穿透机器的配置
- Windows 系统
四、常见问题及解决方法
一、概述
LincAccess是一款基于反向代理技术的软件,用于实现远程访问内网设备。通过该软件,无需配置复杂的网络环境即可轻松访问内网资源。本文为首次使用 LincAccess的用户提供详细的安装和操作指导。
二、被穿透机器的配置
被穿透机器指的是希望通过 LincAccess远程访问的设备。以下分别介绍 Linux 和 Windows 系统中配置的具体步骤。
Linux 系统
1. 安装 Docker并配置Docker镜像加速地址
Docker 是运行 LincAccess容器的基础环境,请先确保 Linux 系统中安装了 Docker。可以参考以下链接完成Docker的安装:
debian系统下安装docker:https://docs.docker.com/engine/install/debian/
查看docker是否运行正常:
bash
docker pull hello-world
Using default tag: latest
latest: Pulling from library/hello-world
c1ec31eb5944: Pull complete
Digest: sha256:305243c734571da2d100c8c8b3c3167a098cab6049c9a5b066b6021a60fcb966
Status: Downloaded newer image for hello-world:latest
docker.io/library/hello-world:latest
如果显示Pull complete,则表示docker安装成功了。
2. 拉取镜像并运行容器
- 使用 Docker 拉取 LincAccess镜像:
bash
docker pull kriswhale/linc-access-app:[版本号]
最新版本号可以到https://hub.docker.com/r/kriswhale/linc-access-app/tags处查看
如若出现拉取错误,则可能是镜像加速地址不可用(可参考第四部分第一点的镜像配置)
- 运行容器:
bash
docker run -dp 8099:80 --name linc-access-app kriswhale/linc-access-app:[版本号]
此处
8099
为主机映射端口,您可以根据需求更改。
-p 8099:80
:这个标志表示将主机的 8099 端口映射到容器的 80 端口。
3. 在浏览器中访问容器
在能访问浏览器的任意设备上打开浏览器,访问以下地址:
http://[被穿透机器的IP]:[上一步执行运行容器命令时设置的端口号8099]
示例:若被穿透机器 IP 为
192.168.31.100
,且您在上一步执行运行容器命令时设置的端口号为8099,则访问http://192.168.31.100:8099
。在页面中输入正确的账号、密码,并设置一个自定义验证码(作为穿透凭证)。请妥善保存该验证码。
- LincAccess Account:您的账号
- LincAccess Password:您的密码
- Pairing Code :验证码(验证码是穿透的重要凭证,务必做好保密措施)
Windows 系统
1.windows服务端配置方法一(可用于linux和windows)
(1)安装 Docker
- 下载 Docker Desktop for Windows。
下载网址为https://www.docker.com/products/docker-desktop/
- 按提示安装并启动 Docker Desktop。
- 查看docker是否可以正常使用:
powershell
C:\Users\wzw>docker pull hello-world
Using default tag: latest
latest: Pulling from library/hello-world
c1ec31eb5944: Pull complete
Digest: sha256:305243c734571da2d100c8c8b3c3167a098cab6049c9a5b066b6021a60fcb966
Status: Downloaded newer image for hello-world:latest
docker.io/library/hello-world:latest
如果显示Pull complete,则表示docker可以正常使用了。
(2)拉取镜像并运行容器
- 打开 PowerShell 或命令提示符,拉取 LincAccess镜像:
powershell
docker pull kriswhale/linc-access-app:[版本号]
最新版本号可以到https://hub.docker.com/r/kriswhale/linc-access-app/tags处查看
如若出现无法拉取,则很可能是镜像加速地址不可用。建议更换可靠的加速地址
- 运行容器:
powershell
docker run -dp 8099:80 --name linc-access-app kriswhale/linc-access-app:[版本号]
此处8080
为主机映射端口,您可以根据需求更改。
-p 8080:80
:这个标志表示将主机的 8099 端口映射到容器的 80 端口。这意味着你可以通过访问 localhost:8099
来访问容器内运行的应用。
(3)在浏览器中访问容器
- 在本机设备上打开浏览器,访问以下地址:
http://127.0.0.1:[上一步执行运行容器命令时设置的端口号8099]
示例:若被穿透机器为本机 ,且您在上一步执行运行容器命令时设置的端口号为8099,则也可以访问 http://localhost:8099
在页面中输入正确的账号、密码,并设置一个自定义验证码(作为穿透凭证)。请妥善保存该验证码。
LincAccess Account:您的账号 测试账号:LINCAX0138F36C2BF39F48FA9CC63CA44A95AD09000007
LincAccess Password:您的密码 测试密码:pxs8Ya3OAJypslHX
Pairing Code :验证码(验证码是穿透的重要凭证,务必做好保密措施)
2. windows服务端配置方法二(仅可用于windows系统)
(1)下载安装并打开 linc_access.exe
- 打开网页https://www.lincos.ai/zh/lincaccess-download/,点击下载【LincAccessHost Windows版】
- 待zip包下载完毕后将其解压
- 在解压后的文件夹中,双击
linc_access.exe
启动程序。
(2)输入信息
在页面中输入正确的账号、密码,并设置一个自定义验证码(作为穿透凭证)。请妥善保存该验证码。
- LincAccess Account:您的账号 测试账号:LINCAX0138F36C2BF39F48FA9CC63CA44A95AD09000007
- LincAccess Password:您的密码 测试密码:pxs8Ya3OAJypslHX
- Pairing Code :验证码(验证码是穿透的重要凭证,务必做好保密措施)
三、穿透机器的配置
穿透机器指的是用于远程访问被穿透设备的设备。以下为 Windows 系统的配置步骤。
Windows 系统
1. 下载安装并打开 linc_access.exe
- 打开网页https://www.lincos.ai/zh/lincaccess-download/,点击下载Windows 客户端软件包【LincAccess Windows版】
- 待zip包下载完毕后将其解压
- 在解压后的文件夹中,双击
linc_access.exe
启动程序。
2. 输入账号和验证码
在程序主界面,输入您的账号和在被穿透机器上设置的验证码。
点击 Connect 登录。
3. 添加端口映射配置
点击
Add Port Mapping
按钮,填写以下信息:
- Remote Host:被穿透机器的 IP 地址(例如
192.168.31.100
)。 - Remote Port:被穿透机器中您想访问的任意端口号(例如
8080
)。 - Local Port:本地机器上用于映射的端口号(例如
8100
)。
- Remote Host:被穿透机器的 IP 地址(例如
配置完成后,点击 Start 启动端口映射。
4. 在浏览器中访问远程资源
打开浏览器,访问以下地址:
http://127.0.0.1:[本机端口号]
例如:若本地端口号为 8100
,则访问 http://127.0.0.1:8100
。
四、常见问题及解决方法
1. 镜像常用地址不可用
可以参考:https://www.jianshu.com/p/96761991d040
确保 Docker Desktop 已启动,并点击设置中的Docker Engine菜单,并编辑文件中的registry-mirrors属性,给docker配置镜像加速地址。国内常用的镜像加速地址如下:
"registry-mirrors": [
"https://dockerproxy.cn",
"https://ccr.ccs.tencentyun.com/",
"https://d3otofqj.mirror.aliyuncs.com",
"https://hub-mirror.c.163.com",
"https://repo.huaweicloud.com",
"https://do.nark.eu.org",
"https://dc.j8.work",
"https://docker.m.daocloud.io",
"https://dockerproxy.com",
"https://docker.mirrors.ustc.edu.cn",
"https://docker.nju.edu.cn",
"https://registry.docker-cn.com",
"https://docker.mirrors.ustc.edu.cn",
"http://hub-mirror.c.163.com",
"https://docker.mirrors.ustc.edu.cn"
]
2. 浏览器无法访问容器页面
检查容器是否正常运行,可使用以下命令查看容器状态:
bash docker ps
确保端口未被其他服务占用。
3. Docker 服务启动失败
- 检查系统是否支持 Docker。若不支持,可尝试升级操作系统或使用虚拟机运行 Docker。
4. 无法登录 Windows 客户端
- 请检查账号和验证码是否输入正确。
5. 端口映射后仍无法访问远程资源
- 确保被穿透机器上的防火墙规则允许访问相应端口。