教程
这里的教程按难度排列,每篇都从一个具体目标出发,带着你在管理界面里一步步完成,并给出验证方法和常见问题。还没装好 Gately 的话,先看安装;想先看看界面长什么样,可以打开在线演示,点「演示账号一键进入」随便看(只读,每小时重置)。
教程里的截图都来自演示实例,域名、地址都是示例值(example.com、192.0.2.x、203.0.113.x 等),照着做时换成你自己的。
入门
刚装好 Gately,从这里开始:认识界面,把第一个服务用域名和 HTTPS 发布出去。
01安装后的第一步刚装好 Gately 后的第一步:登录管理界面并修改默认密码,按使用场景精简功能,开启两步验证或 Passkey,认识侧边栏、概览卡片、网络自检、全局搜索、语言与主题切换,以及设置页的常用项。02第一个反向代理站点在局域网里用 http://nas.example.com 这样的域名访问 NAS 或其他应用:添加 HTTP 监听与反向代理站点,用路由器 DNS 或 hosts 让域名指向 Gately,验证访问,并查看站点统计与访问日志。03申请 HTTPS 证书用 Gately 的「SSL 证书」免费申请 HTTPS 证书:DNS 验证与 HTTP 验证怎么选、证书颁发机构、自动续签与到期提醒,把 HTTP 监听升级为 HTTPS 并自动跳转,以及部署给其他程序。04动态域名入门家里公网 IP 会变,用 Gately 的动态域名让域名自动跟着走:创建任务、填写服务商凭据、选择 IPv4 / IPv6 获取方式、添加解析记录、查看同步状态与日志、Webhook 通知,附 IPv6 场景说明。05端口转发入门:把一个端口转到内网设备用 Gately 的端口转发把公网或局域网端口转到内网设备:Windows 远程桌面、UDP 游戏服务器、端口段、主备目标、来源 IP 白名单、连接数限制、PROXY 协议、自动放行防火墙,以及连接统计与日志排查。
进阶
按需挑选:给站点加登录和访问控制,自动封禁扫描器,接收告警,没有公网 IPv4 时的穿透与组网,以及自动化。
01站点访问控制与登录认证给 Gately 站点分层加访问控制:共享用户、TOTP、Passkey、GitHub/Google 登录,按路径让 API 免登录、管理页只对内网,IP 白名单与订阅 IP 列表、国家过滤、拒绝时断开连接、信任已登录用户,并给出家庭相册的完整组合示例。02入侵防护与 WAF:封禁扫描器,拦截 Web 攻击用 Gately 的入侵防护封禁 SSH 爆破、Web 路径扫描、异常 TLS 握手与端口扫描,同步到 nftables / iptables;再给站点挂上 OWASP CRS 的 WAF,从仅检测过渡到拦截,处理误报,查看封禁与拦截日志。03让 Gately 出问题时主动通知你让 Gately 在证书快到期、DDNS 更新失败、IP 被封禁、有人登录后台、CPU 或站点错误率异常时主动通知你:配置 Telegram、邮件、企业微信、钉钉、Webhook 等渠道,测试发送,用规则挑选事件,再给性能监控加告警规则。04配置历史、备份与迁移改坏了配置怎么退回、机器坏了怎么恢复、换一台机器怎么搬:配置历史的对比与回滚,手动下载与恢复备份,加密的定时备份写到 NAS,导出诊断包,以及把配置迁到新机器和从 Lucky、nginx 导入的入口。05搭建导航面板用 Web 服务的导航面板给家庭或团队做一个主页:建面板、加分组与链接、内外网自动切换地址、多入口选择、链接尺寸与 App 图标样式、获取图标、搜索引擎、换肤与背景、登录后可见,最后作为站点发布,或从 Sun-Panel 导入。06用 STUN 穿透拿到公网端口没有公网 IPv4、上级 NAT 是全锥形(NAT1)时,用 Gately 的 STUN 穿透拿到公网端口:判断 NAT 类型、TCP/UDP 规则、UPnP 映射、自动放行防火墙、把地址写进 DDNS 与重定向、地址变化通知和排错。07用 frp 把家里的服务映射到 VPS用 Gately 托管的 frps 与 frpc 把家里的服务映射到 VPS:在线安装 frp、配置 frps 的端口、令牌、KCP/QUIC、来源 IP 白名单与自动放行防火墙,在家里添加 TCP、HTTP/HTTPS 子域名与 STCP 代理,再查看状态、日志并保留访客真实 IP。08异地组网:Tailscale、NetBird 与 EasyTier用 Gately 托管 Tailscale、NetBird、EasyTier 把家里、公司和手机组成私有网络:在线安装、登录与授权、子网路由与出口节点、节点状态、自建控制服务器与中继,以及用 Cloudflare 隧道发布网页服务。09用端口敲门隐藏 SSH 等管理端口用 Gately 的端口敲门(兼容 fwknop 的单包授权 SPA)隐藏 SSH 等管理端口:新建敲门规则与密钥、配置 fwknop 客户端、防火墙拦截、与端口转发和协议分流结合、只开一个端口敲门,以及网页登录后自动放行。10Docker 管理与 Web 终端在 Gately 管理界面里管容器、登服务器:打开 Docker 管理与 Web 终端模块,查看容器日志、启停与升级镜像、管理 Compose 项目和磁盘占用;添加 SSH 与本机 Shell 连接、核对主机密钥、用 SFTP 传文件、在手机上操作终端,以及该开的安全设置。11用 Gately 账号登录 Gitea、Grafana、OpenList(OIDC 单点登录)把 Gately 作为 OIDC 身份提供方,让 Gitea、Grafana、OpenList 用共享用户登录:准备签发者域名、启用 OIDC、添加客户端,各应用的完整配置、与站点网页认证一起实现一次登录处处免登,以及常见报错的排查。12API、命令行与 MCP 自动化用脚本和 AI 助手管理 Gately:创建只带所需权限、会过期的 API 令牌,用 curl 列出站点、触发 DDNS 同步、签发证书,在界面里查接口文档与 OpenAPI,用 gately ctl 命令行调用,再通过 gately mcp 让 Claude、Cursor 等 AI 客户端读取和修改配置。
实战场景
把多个功能组合起来解决一个完整问题,适合已经熟悉基础操作、想照着搭一套的读者。
01家庭 NAS 外网访问全流程一篇从零做完的实战:把家里 NAS 上的相册、影音、文件和 Home Assistant 安全发布到外网,依次完成网络判断、DDNS、泛域名证书、HTTPS 监听与多站点、家人共享账号、入侵防护与 WAF、通知、家庭导航页和配置备份。02没有公网 IPv4 怎么从外面访问 NAS没有公网 IPv4 怎么从外面访问 NAS:IPv6 加 DDNS、STUN 穿透、frp(自有 VPS)、Cloudflare Tunnel 四条路线的前提、优缺点和在 Gately 里的配置步骤。03一个 443 端口跑所有服务用 Gately 的协议分流让 HTTPS 网站、SSH、RDP 共用一个 443 端口,网站保留访客真实 IP,步骤、验证命令与排查。04给 Jellyfin、Immich、Home Assistant、Vaultwarden 加 HTTPS 和登录给 Jellyfin、Immich、Home Assistant、Vaultwarden 加 HTTPS 和登录:WebSocket、大文件上传与 WAF 请求体上限、信任代理设置,以及网页认证挡住手机 App 时的几种办法。05泛域名证书与动态域名,10 分钟配好用 Gately 十分钟配好动态域名与泛域名 HTTPS 证书:Cloudflare 与阿里云各一版,DNS-01 验证,无需开放 80 或 443 端口,到期自动续签。06云服务器做入口,回家保留真实 IP家里没有公网 IP,用一台 VPS 上的 Gately 做公网入口:frps 与 frpc 建隧道,协议分流在 443 上按协议分发,PROXY 协议穿过隧道把访客真实 IP 带回家;证书放在家里或放在 VPS 的两种方案、DDNS、SSH、带宽延迟与排查。07从 nginx 或 Nginx Proxy Manager 迁移从 nginx 或 Nginx Proxy Manager 迁移到 Gately:导入 nginx -T 输出(NPM 在容器内执行)、与 nginx 并行验证、逐站切换与回滚,以及 NPM 各项设置的转换结果。08云服务器上替换 haproxy + nginx + fail2ban + acme.sh在云服务器上用 Gately 一个程序替换 haproxy + nginx + fail2ban + acme.sh:逐项对照、迁移顺序、回滚办法,以及同机对比的性能数据。
找不到想要的?
- 每个功能的完整说明在功能模块里,教程只讲最常用的路径;
- 使用中遇到问题,欢迎到 Telegram 群交流,或在 GitHub 讨论区提问。