為企業內部提供一個集中管理的 Gateway 介面，通過此介面，企業管理員可輕鬆添加和管理外部伺服器的 Proxy 位址，從而建立內外網之間的安全連線架構。利用 Mavis，企業可確保合規性並保障數據安全。

使用情境：

Mavis 架設在公司內部，並在 AWS 上設定一台安裝了 Mavis Gateway 的 Ubuntu 機器作為 Gateway Server，使用者透過 Mavis 安全連線到 Gateway Server，就能直接存取同 VPC 的內部資源。

相關介紹請參考：Gateway Management 和 Tunnel 功能

一、環境準備：

1.Gateway server 設備硬體需求

伺服器	CPU需求	記憶體需求	儲存空間需求	作業系統需求
Gateway server	2 Core	4 GB	20 GB 以上(/)	Ubuntu 16.04, 18.04, 20.04, 22.04, 23.10, 24.04 ，帳號需要有 sudo 權限

2. 為 Gateway server 準備包含域名的 SSL 憑證，並配置對應的 DNS 子域名。

Mavis 伺服器與 Gateway 伺服器之間的連線是通過Https進行存取的，因此需要一個完整的域名及相應配置。

此範例域名為 aws-tunnel01.mavisdemo.com

子域名	紀錄類型	解析內容	說明
taws-tunnel01	A	Gateway server IP 位址	用於 Mavis server與 Gateway server之間的連線

3 網路環境配置

Gateway server 需要具備對外存取 Internet 的能力，以下載並安裝必要的元件，同時支持與 Mavis server 之間的連線。

項次	來源	目的	通訊協定/埠號	規則	說明
1	Gateway server IP 位址	0.0.0.0/0 (Internet)	ALL	允許	允許 Proxy 伺服器平台存取 Internet，以下載並安裝必要的元件。
2	Mavis server IP 位址	Gateway server IP 位址	https/443	允許	允許 Mavis server連接至 Gateway server。

二、建立閘道器管理

使用者的帳戶角色需為管理員，才能從「管理介面」進行設置。

1. 選擇管理介面
2. 選擇閘道器管理
3. 選擇建立閘道器

4 閘道器區段名稱：輸入自定義名稱
5. 伺服器名稱: 輸入自定義名稱
6. IP : 輸入 Gateway server IP
7. 網域: 輸入該 Gateway server DNS
8. 儲存

9. 選擇建立好的閘道器區段,點選下載後,將配置檔案上傳到伺服器(Gateway server)

二、安裝 Gateway 服務

登入 Gateway 伺服器，切換至具有 sudo 權限的模式，並執行安裝服務的指令。

先確認是否已上傳 Gateway 配置檔案及憑證（並將 .crt 和 .key 檔案分別重新命名為 tls.crt 和 tls.key）

1. 登入到Gateway server 後,切換至具有 sudo 權限
2. 確認 Gateway 配置檔案存在
3. 確認憑證存在,檔案的名稱必須分別為 tls.crt 和 tls.key

執行安裝 Gateway 服務的指令（請將 PROXY_CONFIG 替換為您的 Proxy 配置檔案名稱）。

1. 輸入安裝指令:

curl -sSL https://pentium-repo.s3.ap-northeast-1.amazonaws.com/mavis/latest/install.sh |INSTALL_PROXY_CLUSTER=true PROXY_CONFIG=gateway-aws-aws-tunnel01-config.yaml bash

2. DB proxy connect port 可以不輸入，用預設即可
Enter Proxy node postgres proxy connect port (ex. 7993): 輸入ennter
Enter Proxy node mysql proxy connect port (ex. 7994): 輸入ennter