快速开始

快速掌握joggle客户端使用方法，快速体验将本地端口映射到公共网络。本篇文章主要介绍两种不同的启动joggle客户端的方式，具体如下：

• 1、命令行启动或服务安装；
• 2、docker方式启动。

首先您需要登录到平台 https://www.joggle.cn 注册一个账号，激活后您将获得一个雪花域名（激活账号后才有哦）。

一、使用命令行启动

1、下载joggle客户端

2、运行脚本

进入到joggle根路径，执行启动脚本。

cd /opt/joggle
./bin/start.sh

执行后会输出设备码，设备码用于登录到joggle网页端绑定账号关系，也可以通过公网ip自动识别到设备码。

除了命令行启动方式外，可以通过service命令安装为linux服务或windows服务，服务器重启后自动启动joggle。

# 安装joggle服务
./bin/service install
# 卸载joggle服务
./bin/service uninstall

如果您觉得以上的操作都非常麻烦，那就可以选择使用docker容器方式运行。继续浏览后面的内容。

二、使用docker启动

joggle的镜像是通过dockerbuildx构建，推送在阿里云免费ACR服务上的。因此需要指定镜像域名地址才能拉取到joggle的镜像。

配置文件存储路径和日志输出路径通过volume挂载方式映射到宿主机上。

1、docker run启动

docker run --rm \
    -v /opt/joggle/conf:/opt/joggle/conf \
    -v /opt/joggle/logs:/opt/joggle/logs \
    registry.cn-chengdu.aliyuncs.com/wuweiit/joggle:159

2、docker-compose编排

docker-compose.yml

version: '3'
services:
  joggle-client:
    image: registry.cn-chengdu.aliyuncs.com/wuweiit/joggle:159
    restart: always
    volumes:
      - /opt/joggle/conf:/opt/joggle/conf
      - /opt/joggle/logs:/opt/joggle/logs

启动joggle

docker-compose up -d

三、joggle启动后，第一个域名映射

假设内网中有一个IP：192.168.1.1 路由器的网页服务，运行在80端口。通过joggle网页端操作映射到公网地址。

四、环境变量配置