From ee61cd7ccb7e8e376f804d61c4deaf925814633c Mon Sep 17 00:00:00 2001
From: "ithink.chan" <chenyang@autoai.com>
Date: Tue, 22 Oct 2019 14:57:21 +0800
Subject: [PATCH] =?UTF-8?q?=E8=A1=A5=E5=85=85=20Cpolar=20=E8=AE=BE?=
 =?UTF-8?q?=E7=BD=AE=E5=92=8C=E4=BD=BF=E7=94=A8.?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Signed-off-by: ithink.chan <chenyang@autoai.com>
---
 .../Applications/Cpolar/Cpolar_设置和使用.md  | 85 +++++++++++++++++++
 1 file changed, 85 insertions(+)
 create mode 100644 Software/Applications/Cpolar/Cpolar_设置和使用.md

diff --git a/Software/Applications/Cpolar/Cpolar_设置和使用.md b/Software/Applications/Cpolar/Cpolar_设置和使用.md
new file mode 100644
index 0000000..da80c6a
--- /dev/null
+++ b/Software/Applications/Cpolar/Cpolar_设置和使用.md
@@ -0,0 +1,85 @@
+# 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
+  demo1:
+    proto: tcp
+    addr: 22
+```
+
+以上配置了 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 服务。