通過holer将端口映射到公網通路詳細實作教程1. Holer簡介2. Holer使用3. 支援與幫助
1. Holer簡介
Holer exposes local servers behind NATs and firewalls to the public internet over secure tunnels.
Support forwarding message based on TCP protocol.
Holer是一個将區域網路中的應用映射到公網通路的端口映射軟體，支援轉發基于TCP協定的封包。
2. Holer使用
Holer支援以下兩種使用方式，根據實際需求，任選其中一種方式即可：
方式一：使用公開的holer映射或者開通holer服務，通過holer用戶端軟體經holer伺服器實作公網通路，詳見
2.1節。
方式二：使用holer服務端軟體搭建holer服務，通過holer用戶端軟體經自己伺服器實作公網通路，詳見
2.2節Holer用戶端軟體有Java版本詳見
2.1.1節和Go版本詳見
2.1.2節，根據偏好，任選其中一種版本使用即可。
如果下載下傳holer軟體遇到問題，更多的下載下傳位址詳見
3.2節2.1 使用公開的holer映射或者開通holer服務
方式一:使用公開的holer映射或者開通holer服務，通過holer用戶端軟體經holer伺服器實作公網通路。
公開的holer映射詳情如下：
| 通路密鑰 | 通路域名 | 公網位址 | 本地位址 | 使用場景 |
|---|---|---|---|---|
| HOLER_CLIENT-2F8D8B78B3C2A0AE | holer65530.wdom.net | holer.org:65530 | 127.0.0.1:8080 | WEB |
| HOLER_CLIENT-3C07CDFD1BF99BF2 | holer65531.wdom.net | holer.org:65531 | 127.0.0.1:8088 | |
| HOLER_CLIENT-2A623FCB6E2A7D1D | holer65532.wdom.net | holer.org:65532 | 127.0.0.1:80 | |
| HOLER_CLIENT-AF3E6391525F70E4 | N/A | holer.org:65533 | 127.0.0.1:3389 | 遠端桌面 |
| HOLER_CLIENT-822404317F9D8ADD | holer.org:65534 | 127.0.0.1:22 | SSH | |
| HOLER_CLIENT-27DD1389DF1D4DBC | holer.org:65535 | 127.0.0.1:3306 | 資料庫 |
這裡以映射本地Tomcat預設端口8080為例，選擇表中的第一條映射進行配置；如果Web服務端的端口是80或者8088，請選擇相比對的端口映射，其他TCP端口映射步驟類似，更多的使用示例請參考
官方文檔2.1.1 使用Java版本的holer用戶端實作步驟
Java版本的holer用戶端軟體（
源代碼，
軟體包）是由Java語言實作，支援跨平台。
2.1.1.1 安裝 Java
安裝Java 1.7或者更高版本，執行指令
java -version
檢查Java是否可用。
2.1.1.2 安裝Web服務端
以Tomcat為例，安裝并啟動Tomcat，預設安裝的端口是8080；
在浏覽器裡輸入如下URL來檢查Tomcat服務是否可以正常通路：
http://127.0.0.1:8080
2.1.1.3 下載下傳并配置holer用戶端
下載下傳并解壓軟體包
holer-client.zip
修改配置檔案：
holer-client/conf/holer.conf
設定
HOLER_ACCESS_KEY
如下：
HOLER_ACCESS_KEY=HOLER_CLIENT-2F8D8B78B3C2A0AE
2.1.1.4 啟動holer
進入目錄：
cd holer-client/bin
Windows系統:
執行指令
startup.bat
或輕按兩下
startup.bat
如果需要停止程序，執行指令
shutdown.bat
shutdown.bat
Linux系統:
bash startup.sh
bash shutdown.sh
然後就可以通過如下URL來通路Web應用：
http://holer65530.wdom.net
或者
http://holer.org:65530
2.1.1.5 設定開機啟動
cd holer-client/bin
輕按兩下
setup.vbs
注意事項：
請確定目前使用者對如下目錄具有讀取、寫入、執行、修改等權限：
C:\ProgramData\Microsoft\Windows\Start Menu\Programs\StartUp
bash setup.sh
CentOS 7, RedHat 7, Ubuntu 18 及更高版本，建議執行指令
bash setup-service.sh
設定開機啟動；
根據提示輸入holer access key和holer server host
輸入示例：
------------------------------------------
Enter holer access key: HOLER_CLIENT-2F8D8B78B3C2A0AE
------------------------------------------
Enter holer server host: holer.org
------------------------------------------ 2.1.2 使用Go版本的holer用戶端實作步驟
Go版本的holer用戶端軟體（
）是由GO語言實作，支援多種作業系統和硬體架構。
2.1.2.1 安裝Web服務端
http://127.0.0.1:8080
2.1.2.2 下載下傳holer用戶端
根據實際的系統平台，選擇比對的軟體包下載下傳并解壓
holer-xxx.tar.gz
2.1.2.3 啟動holer
這裡以
Windows & Linux x86-64bit
為例，啟動holer執行如下指令：
holer-windows-amd64.exe -k HOLER_CLIENT-2F8D8B78B3C2A0AE -s holer.org
也可以執行指令
startup.bat
或者輕按兩下
startup.bat
shutdown.bat
shutdown.bat
nohup ./holer-linux-amd64 -k HOLER_CLIENT-2F8D8B78B3C2A0AE -s holer.org &
bash startup.sh
bash shutdown.sh
首次啟動根據提示輸入holer access key和holer server host
------------------------------------------
Enter holer access key: HOLER_CLIENT-2F8D8B78B3C2A0AE
------------------------------------------
Enter holer server host: holer.org
------------------------------------------ 2.1.2.4 設定開機啟動
cd holer-client/bin
setup.vbs
C:\ProgramData\Microsoft\Windows\Start Menu\Programs\StartUp
bash setup.sh
bash setup-service.sh
------------------------------------------
Enter holer access key: HOLER_CLIENT-2F8D8B78B3C2A0AE
------------------------------------------
Enter holer server host: holer.org
------------------------------------------ 2.2 使用holer服務端軟體搭建holer服務
方式二:使用holer服務端軟體搭建holer服務，通過holer用戶端軟體經自己伺服器實作公網通路。
使用者也可以下載下傳
holer-server.zip搭建自己的holer服務。
2.2.1 搭建holer服務端準備工作
(1) 準備一台可以經公網IP通路的Linux系統或者Windows系統主機；
(2) 安裝Java 1.8及以上版本，執行指令
java -version
檢查Java是否可用；
(3) 安裝并啟動Nginx, 建議安裝其穩定版本；
(4) 安裝MariaDB并設定root使用者密碼；
(5) 設定安全規則，允許通路holer服務端端口6060、600以及端口映射規則所涉及的端口；
(6) 建議申請域名并且完成域名備案，并設定域名泛解析（*.域名）和直接解析主域名（@.域名），如果沒有域名可以直接使用IP和端口通路。
2.2.2 配置并啟動holer服務端
解壓軟體包，打開配置檔案
holer-server/resources/application.yaml
2.2.2.1 修改資料庫使用者名和密碼
spring:
datasource:
username: root
password: 123456 2.2.2.2 修改域名和Nginx主目錄
holer
domain:
name: your-domain.com
nginx:
#home: /usr/local/nginx
home: C:/nginx-1.14.2 将示例中的域名
your-domain.com
修改成自己備案過的域名，如果沒有域名，請忽略該配置項。
Linux系統預設安裝Nginx路徑
/usr/local/nginx
Windows系統中可以先将Nginx複制到某個目錄下，然後在配置檔案中指定其主目錄。
請確定Nginx主目錄下存在配置檔案：
conf/nginx.conf
Nginx目錄結構示例：
Nginx主目錄
├── conf
│ ├── nginx.conf
. .
. . 如果需要用到HTTPS功能，Window系統版本的Nginx預設支援HTTPS功能，Linux系統需要下載下傳Nginx源碼，配置和編譯以及安裝執行如下指令：
./configure --with-http_ssl_module
make;make install 2.2.2.3 啟動holer服務端
Linux系統執行啟動指令如下：
cd holer-server
chmod 755 holer
bash holer start bash holer stop
Windows系統執行啟動指令如下：
cd holer-server
startup.bat startup.bat
shutdown.bat
shutdown.bat
2.2.2.4 設定開機啟動
cd holer-server/bin
setup.vbs
C:\ProgramData\Microsoft\Windows\Start Menu\Programs\StartUp
bash setup.sh
bash setup-service.sh
設定開機啟動。
2.2.3 建立端口映射
2.2.3.1 登入holer管理系統
如果配置檔案
application.yaml
中設定了域名，并且指定了Nginx主目錄，則在浏覽器輸入URL
http://holer.your-domain.com
如果沒有設定域名通路，則通過IP和端口登入系統
http://IP位址:600
登入系統需要輸入預設的管理者賬号，預設使用者名：
admin
密碼：
admin123
使用者也可以在檔案
holer-server/resources/conf/holer-data.sql
中修改預設的使用者名和密碼，然後重新開機holer服務端使其生效。
2.2.3.2 建立用戶端和端口映射
在使用者清單頁面中建立一個holer用戶端
http://holer.your-domain.com/view/holer-client.html
在端口映射頁面中為該holer用戶端建立端口映射
http://holer.your-domain.com/view/holer-port.html
在資料統計頁面中檢視報表資訊
http://holer.your-domain.com/view/holer-report.html
2.2.3.3 配置holer用戶端使其與holer服務端實作端口映射功能
在使用者清單頁面中選中一條用戶端記錄，在頁面右上角點選詳情按鈕，彈出的詳情框下點選複制按鈕；
然後将詳情資訊粘貼到記事本裡，請嚴格按照詳情資訊裡的使用說明進行操作，這樣可以順利完成holer用戶端配置，進而實作基于自己holer服務端的端口映射功能。
3. 支援與幫助
3.1 Holer使用示例
獲得更多的holer使用示例，請參考
3.2 Holer下載下傳
3.2.1 Holer用戶端軟體
軟體位址一 軟體位址二3.2.2 Holer服務端軟體
3.3 問題幫助
使用中遇到問題可以檢視holer日志資訊來排查問題的具體原因。
3.3.1 Holer用戶端日志
3.3.1.1 Java版本的holer用戶端
檢視日志檔案：
holer-client/logs/holer-client.log
3.3.1.2 Go版本的holer用戶端
Linux系統
檢視可執行程式所在目錄下的日志檔案
logs/holer-client.log
nohup.out
檔案。
Windows系統
logs/holer-client.log
3.3.2 Holer服務端日志
holer-server/logs/holer-server.log
3.4 申請holer服務
使用者可以使用上述公開的holer映射詳見
，也可以申請holer服務；
Holer服務詳情，請通路
Wisdom