# Cpolar 设置和使用

Cpolar 可用于实现内网穿透。它的使用和配置非常简单，而且有国内服务器。

使用前，先到 [Cpolar 官网](https://www.cpolar.com) 完成注册，注册过程也非常简单，提供邮箱和电话就可以了。

注册后在“仪表盘->验证->你的隧道 Authtoken“中得到你的 token，这个 token 将在后边用到。

## 服务器端初始化

在 [Cpolar 官网](https://www.cpolar.com) 找到下载接口，按系统选择 Windows、Linux 或 Mac 版本。这里以 Linux 版本为例进行说明，其他系统下大同小异，细节可以参考[Cpolar 官方文档](https://www.cpolar.com/docs)。

```sh
unzip cpolar-stable-linux-amd64.zip
```

得到 cpolar 可执行程序。将 cpolar 移动到您需要的目录下，还可以将其添加到系统环境变量中，便于日后使用。然后在命令行中执行一次以下命令：

```sh
cpolar authtoken <token>
```

该命令将之前记录的 token 保存下来以便使用。以后只要 token 不变，就不需要再次执行该命令。

## Cpolar 的使用

在完成上述步骤后，就可以通过 Cpolar 开启隧道了。

```sh
# secure public URL for port 80 web server
cpolar http 80
# tunnel arbitrary TCP traffic to port 22
cpolar tcp 22
```

## Cpolar 的配置

一个 cpolar 进程可以支持多个隧道，首先要将这些隧道信息配置到 cpolar 配置文件中（Linux 下 cpolar 默认配置文件为 ~/.cpolar/cpolar.yml）：

```sh
authtoken: XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX

tunnels:
  demo0:
    proto: http
    addr: 80
    region: cn
  demo1:
    proto: tcp
    addr: 22
    region: cn
```

以上配置了 http 和 tcp 服务，并选择使用中国服务器，注意上述配置 http 的同时将自动产生一个 https 的隧道监听配置。之后使用：

```sh
# Start tunnels by name from config file
cpolar start [tunnel] [...]
# Start all tunnels defined in config file
cpolar start-all
```

命令开启某个隧道，或开启全部隧道。

## 访问 Cpolar 服务

上述配置使用 start-all 命令后，将得到如下输出：

```sh
Tunnel Status                 online
Account                       username (Plan: xxx)
Version                       2.39/2.46
Web Interface                 127.0.0.1:4040
Forwarding                    tcp://1.tcp.cpolar.io:10078 -> 127.0.0.1:22
Forwarding                    http://xxxxxxxx.cpolar.io -> localhost:80
Forwarding                    https://xxxxxxxx.cpolar.io -> localhost:80
# Conn                        0
Avg Conn Time                 0.00ms
```

上述 Forwarding 后面的内容即为远程访问用的网址。浏览器中直接输入 <http://xxxxxxxx.cpolar.io> 即可访问运行 Cpolar 服务的设备的 80 端口所提供的 Web 服务。输入：

```sh
ssh username@tcp://1.tcp.cpolar.io -p 10078
```

就可以访问运行 Cpolar 服务的设备的 22 端口所提供的 ssh 服务。