What is 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協定的封包。
How it works
1. Holer使用
1.1. 安裝 Java
安裝Java 1.7或者更高版本；
執行指令
java -version
檢查Java是否可用。
1.2. 安裝Web服務端
以Tomcat為例，安裝并啟動Tomcat
在浏覽器裡輸入如下URL來檢查Tomcat服務是否可以正常通路：
http://127.0.0.1:8080
1.3. 配置Holer
下載下傳并解壓軟體包
holer-client.zip
修改配置檔案：
holer-client/conf/holer.conf
設定
HOLER_ACCESS_KEY
如下：
HOLER_ACCESS_KEY=HOLER_CLIENT-2F8D8B78B3C2A0AE
1.4. 啟動Holer
cd holer-client/bin
Windows系統:
startup.bat
或者輕按兩下
startup.bat
Linux系統:
sh startup.sh
然後就可以通過如下URL來通路Web應用：
http://holer65530.wdom.net
或者
http://holer.org:65530
1.5. 公網和内網的位址映射關系
| Holer Access Key | Domain Name | Internet Address | Local Address |
|---|---|---|---|
| HOLER_CLIENT-2F8D8B78B3C2A0AE | holer65530.wdom.net | holer.org:65530 | 127.0.0.1:8080 |
| 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 | |
| HOLER_CLIENT-27DD1389DF1D4DBC | holer.org:65535 | 127.0.0.1:3306 |
如果您本地的Tomcat端口是80或者8088，請選擇比對的key進行設定。
請參考
部落格文章獲得更多的使用示例和幫助。
1.6. 其他版本的Holer軟體
這些Holer軟體（
源代碼，
軟體包）是由GO語言實作，支援多種作業系統和硬體架構。
這裡以
Windows & Linux x86-64bit
為例，啟動Holer執行如下指令：
holer-windows-amd64.exe -k HOLER_CLIENT-2F8D8B78B3C2A0AE
nohup ./holer-linux-amd64 -k HOLER_CLIENT-2F8D8B78B3C2A0AE &
2. Holer服務端軟體使用
使用者也可以下載下傳
holer-server.zip搭建自己的Holer服務端。
2.1. 搭建Holer服務端準備工作
(1) 準備一台Linux系統或者Windows系統主機；
(2) 安裝Java 1.8及以上版本，執行指令
java -version
檢查Java是否可用；
(3) 安裝并啟動Nginx, 建議安裝其穩定版本；
(4) 安裝MariaDB并設定root使用者密碼；
(5) 設定安全規則，允許通路Holer服務端端口6060、600以及端口映射規則所涉及的端口；
(6) 建議申請域名并且完成域名備案，如果沒有域名可以直接使用IP和端口通路。
2.2. 配置并啟動Holer服務端
解壓軟體包，打開配置檔案
holer-server/resources/application.yaml
2.2.1. 修改資料庫使用者名和密碼
spring:
datasource:
username: root
password: 123456 2.2.2. 修改域名和Nginx主目錄
holer
domain:
name: your-domain.com
nginx:
#home: /usr/local/nginx
home: C:/nginx-1.14.2 Linux系統預設安裝Nginx路徑
/usr/local/nginx
Windows系統中可以先将Nginx複制到某個目錄下，然後在配置檔案中指定其主目錄。
如果需要用到HTTPS功能，Window系統版本的Nginx預設支援HTTPS功能，Linux系統需要下載下傳Nginx源碼，配置和編譯以及安裝執行如下指令：
./configure --with-http_ssl_module
make;make install 2.2.3 啟動Holer服務端
Linux系統執行啟動指令如下：
cd holer-server
chmod 755 holer
./holer start Windows系統執行啟動指令如下：
cd holer-server
startup.bat startup.bat
2.3. 建立端口映射
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.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.3.3. 配置Holer用戶端使其與Holer服務端實作端口映射功能
在使用者清單頁面中選中一條用戶端記錄，在頁面右上角點選詳情按鈕，彈出的詳情框下點選複制按鈕；
然後将詳情資訊粘貼到記事本裡，嚴格按照詳情資訊裡的使用說明進行操作，這樣即可完成Holer用戶端配置，進而實作基于自己Holer服務端的端口映射功能。
Support
All of the above holer access keys and ports have been shared to public. Users can also apply for exclusive holer services.
If you want to have exclusive holer services, please contact by QQ for application. For more details about holer services, please visit
Wisdom.
以上的全部key和端口都已公開共享。使用者也可以申請專屬的holer服務，如果您需要專屬的holer服務，請QQ聯系開通。Holer服務詳情，請通路
。
QQ : 2353941272