穿透部署

LincAccess软件使用说明书 – 服务器图片链接

LincAccess软件使用说明书

 


目录

一、概述

二、被穿透机器的配置

  • Linux 系统
  • Windows 系统

三、穿透机器的配置

  • Windows 系统

四、常见问题及解决方法


一、概述

LincAccess是一款基于反向代理技术的软件,用于实现远程访问内网设备。通过该软件,无需配置复杂的网络环境即可轻松访问内网资源。本文为首次使用 LincAccess的用户提供详细的安装和操作指导。

img

二、被穿透机器的配置

被穿透机器指的是希望通过 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. 拉取镜像并运行容器
  1. 使用 Docker 拉取 LincAccess镜像:
bash

docker pull kriswhale/linc-access-app:[版本号]

最新版本号可以到https://hub.docker.com/r/kriswhale/linc-access-app/tags处查看

如若出现拉取错误,则可能是镜像加速地址不可用(可参考第四部分第一点的镜像配置)

 

  1. 运行容器:
bash

docker run -dp 8099:80 --name linc-access-app kriswhale/linc-access-app:[版本号]

此处8099 为主机映射端口,您可以根据需求更改。

-p 8099:80:这个标志表示将主机的 8099 端口映射到容器的 80 端口。

3. 在浏览器中访问容器
  1. 在能访问浏览器的任意设备上打开浏览器,访问以下地址:

    http://[被穿透机器的IP]:[上一步执行运行容器命令时设置的端口号8099]
    

    示例:若被穿透机器 IP 为 192.168.31.100,且您在上一步执行运行容器命令时设置的端口号为8099,则访问 http://192.168.31.100:8099

  2. 在页面中输入正确的账号、密码,并设置一个自定义验证码(作为穿透凭证)。请妥善保存该验证码。

    • 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可以正常使用了。

docker-hello

 

(2)拉取镜像并运行容器
  • 打开 PowerShell 或命令提示符,拉取 LincAccess镜像:
powershell

docker pull kriswhale/linc-access-app:[版本号]

最新版本号可以到https://hub.docker.com/r/kriswhale/linc-access-app/tags处查看

如若出现无法拉取,则很可能是镜像加速地址不可用。建议更换可靠的加速地址

docker-image

  • 运行容器:
powershell

docker run -dp 8099:80 --name linc-access-app kriswhale/linc-access-app:[版本号]

此处8080 为主机映射端口,您可以根据需求更改。

-p 8080:80:这个标志表示将主机的 8099 端口映射到容器的 80 端口。这意味着你可以通过访问 localhost:8099 来访问容器内运行的应用。

docker-container

(3)在浏览器中访问容器
  • 在本机设备上打开浏览器,访问以下地址:
http://127.0.0.1:[上一步执行运行容器命令时设置的端口号8099]

示例:若被穿透机器为本机 ,且您在上一步执行运行容器命令时设置的端口号为8099,则也可以访问 http://localhost:8099

 

在页面中输入正确的账号、密码,并设置一个自定义验证码(作为穿透凭证)。请妥善保存该验证码。

  • LincAccess Account:您的账号 测试账号:LINCAX0138F36C2BF39F48FA9CC63CA44A95AD09000007

  • LincAccess Password:您的密码 测试密码:pxs8Ya3OAJypslHX

  • Pairing Code :验证码(验证码是穿透的重要凭证,务必做好保密措施)

    severlogin

2. windows服务端配置方法二(仅可用于windows系统)
(1)下载安装并打开 linc_access.exe

serveropen

(2)输入信息

在页面中输入正确的账号、密码,并设置一个自定义验证码(作为穿透凭证)。请妥善保存该验证码。

  • LincAccess Account:您的账号 测试账号:LINCAX0138F36C2BF39F48FA9CC63CA44A95AD09000007
  • LincAccess Password:您的密码 测试密码:pxs8Ya3OAJypslHX
  • Pairing Code :验证码(验证码是穿透的重要凭证,务必做好保密措施)

serverlogin2


三、穿透机器的配置

穿透机器指的是用于远程访问被穿透设备的设备。以下为 Windows 系统的配置步骤。

Windows 系统

1. 下载安装并打开 linc_access.exe
  1. 打开网页https://www.lincos.ai/zh/lincaccess-download/,点击下载Windows 客户端软件包【LincAccess Windows版】
  1. 待zip包下载完毕后将其解压
  1. 在解压后的文件夹中,双击 linc_access.exe 启动程序。

clientopen

2. 输入账号和验证码
  1. 在程序主界面,输入您的账号和在被穿透机器上设置的验证码。

  2. 点击 Connect 登录。

    clientlogin

3. 添加端口映射配置
  1. 点击

    Add Port Mapping

    按钮,填写以下信息:

    • Remote Host:被穿透机器的 IP 地址(例如 192.168.31.100)。
    • Remote Port:被穿透机器中您想访问的任意端口号(例如 8080)。
    • Local Port:本地机器上用于映射的端口号(例如 8100)。
  2. 配置完成后,点击 Start 启动端口映射。

    clientsettingpng

4. 在浏览器中访问远程资源

打开浏览器,访问以下地址:

http://127.0.0.1:[本机端口号]

例如:若本地端口号为 8100,则访问 http://127.0.0.1:8100

clientweb


四、常见问题及解决方法

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. 端口映射后仍无法访问远程资源

  • 确保被穿透机器上的防火墙规则允许访问相应端口。

 

滚动至顶部