Skip to content

教程 ​

这里的教程按难度排列,每篇都从一个具体目标出发,带着你在管理界面里一步步完成,并给出验证方法和常见问题。还没装好 Gately 的话,先看安装;想先看看界面长什么样,可以打开在线演示,点「演示账号一键进入」随便看(只读,每小时重置)。

教程里的截图都来自演示实例,域名、地址都是示例值(example.com、192.0.2.x、203.0.113.x 等),照着做时换成你自己的。

入门 ​

刚装好 Gately,从这里开始:认识界面,把第一个服务用域名和 HTTPS 发布出去。

进阶 ​

按需挑选:给站点加登录和访问控制,自动封禁扫描器,接收告警,没有公网 IPv4 时的穿透与组网,以及自动化。

01站点访问控制与登录认证给 Gately 站点分层加访问控制:共享用户、TOTP、Passkey、GitHub/Google 登录,按路径让 API 免登录、管理页只对内网,IP 白名单与订阅 IP 列表、国家过滤、拒绝时断开连接、信任已登录用户,并给出家庭相册的完整组合示例。30 分钟视频02入侵防护与 WAF:封禁扫描器,拦截 Web 攻击用 Gately 的入侵防护封禁 SSH 爆破、Web 路径扫描、异常 TLS 握手与端口扫描,同步到 nftables / iptables;再给站点挂上 OWASP CRS 的 WAF,从仅检测过渡到拦截,处理误报,查看封禁与拦截日志。30 分钟03让 Gately 出问题时主动通知你让 Gately 在证书快到期、DDNS 更新失败、IP 被封禁、有人登录后台、CPU 或站点错误率异常时主动通知你:配置 Telegram、邮件、企业微信、钉钉、Webhook 等渠道,测试发送,用规则挑选事件,再给性能监控加告警规则。20 分钟04配置历史、备份与迁移改坏了配置怎么退回、机器坏了怎么恢复、换一台机器怎么搬:配置历史的对比与回滚,手动下载与恢复备份,加密的定时备份写到 NAS,导出诊断包,以及把配置迁到新机器和从 Lucky、nginx 导入的入口。15 分钟05搭建导航面板用 Web 服务的导航面板给家庭或团队做一个主页:建面板、加分组与链接、内外网自动切换地址、多入口选择、链接尺寸与 App 图标样式、获取图标、搜索引擎、换肤与背景、登录后可见,最后作为站点发布,或从 Sun-Panel 导入。20 分钟06用 STUN 穿透拿到公网端口没有公网 IPv4、上级 NAT 是全锥形(NAT1)时,用 Gately 的 STUN 穿透拿到公网端口:判断 NAT 类型、TCP/UDP 规则、UPnP 映射、自动放行防火墙、把地址写进 DDNS 与重定向、地址变化通知和排错。25 分钟07用 frp 把家里的服务映射到 VPS用 Gately 托管的 frps 与 frpc 把家里的服务映射到 VPS:在线安装 frp、配置 frps 的端口、令牌、KCP/QUIC、来源 IP 白名单与自动放行防火墙,在家里添加 TCP、HTTP/HTTPS 子域名与 STCP 代理,再查看状态、日志并保留访客真实 IP。30 分钟08异地组网:Tailscale、NetBird 与 EasyTier用 Gately 托管 Tailscale、NetBird、EasyTier 把家里、公司和手机组成私有网络:在线安装、登录与授权、子网路由与出口节点、节点状态、自建控制服务器与中继,以及用 Cloudflare 隧道发布网页服务。30 分钟09用端口敲门隐藏 SSH 等管理端口用 Gately 的端口敲门(兼容 fwknop 的单包授权 SPA)隐藏 SSH 等管理端口:新建敲门规则与密钥、配置 fwknop 客户端、防火墙拦截、与端口转发和协议分流结合、只开一个端口敲门,以及网页登录后自动放行。25 分钟10Docker 管理与 Web 终端在 Gately 管理界面里管容器、登服务器:打开 Docker 管理与 Web 终端模块,查看容器日志、启停与升级镜像、管理 Compose 项目和磁盘占用;添加 SSH 与本机 Shell 连接、核对主机密钥、用 SFTP 传文件、在手机上操作终端,以及该开的安全设置。20 分钟11用 Gately 账号登录 Gitea、Grafana、OpenList(OIDC 单点登录)把 Gately 作为 OIDC 身份提供方,让 Gitea、Grafana、OpenList 用共享用户登录:准备签发者域名、启用 OIDC、添加客户端,各应用的完整配置、与站点网页认证一起实现一次登录处处免登,以及常见报错的排查。30 分钟12API、命令行与 MCP 自动化用脚本和 AI 助手管理 Gately:创建只带所需权限、会过期的 API 令牌,用 curl 列出站点、触发 DDNS 同步、签发证书,在界面里查接口文档与 OpenAPI,用 gately ctl 命令行调用,再通过 gately mcp 让 Claude、Cursor 等 AI 客户端读取和修改配置。20 分钟

实战场景 ​

把多个功能组合起来解决一个完整问题,适合已经熟悉基础操作、想照着搭一套的读者。

01家庭 NAS 外网访问全流程一篇从零做完的实战:把家里 NAS 上的相册、影音、文件和 Home Assistant 安全发布到外网,依次完成网络判断、DDNS、泛域名证书、HTTPS 监听与多站点、家人共享账号、入侵防护与 WAF、通知、家庭导航页和配置备份。90 分钟02没有公网 IPv4 怎么从外面访问 NAS没有公网 IPv4 怎么从外面访问 NAS:IPv6 加 DDNS、STUN 穿透、frp(自有 VPS)、Cloudflare Tunnel 四条路线的前提、优缺点和在 Gately 里的配置步骤。20 分钟03一个 443 端口跑所有服务用 Gately 的协议分流让 HTTPS 网站、SSH、RDP 共用一个 443 端口,网站保留访客真实 IP,步骤、验证命令与排查。15 分钟04给 Jellyfin、Immich、Home Assistant、Vaultwarden 加 HTTPS 和登录给 Jellyfin、Immich、Home Assistant、Vaultwarden 加 HTTPS 和登录:WebSocket、大文件上传与 WAF 请求体上限、信任代理设置,以及网页认证挡住手机 App 时的几种办法。20 分钟05泛域名证书与动态域名,10 分钟配好用 Gately 十分钟配好动态域名与泛域名 HTTPS 证书:Cloudflare 与阿里云各一版,DNS-01 验证,无需开放 80 或 443 端口,到期自动续签。10 分钟06云服务器做入口,回家保留真实 IP家里没有公网 IP,用一台 VPS 上的 Gately 做公网入口:frps 与 frpc 建隧道,协议分流在 443 上按协议分发,PROXY 协议穿过隧道把访客真实 IP 带回家;证书放在家里或放在 VPS 的两种方案、DDNS、SSH、带宽延迟与排查。60 分钟07从 nginx 或 Nginx Proxy Manager 迁移从 nginx 或 Nginx Proxy Manager 迁移到 Gately:导入 nginx -T 输出(NPM 在容器内执行)、与 nginx 并行验证、逐站切换与回滚,以及 NPM 各项设置的转换结果。30 分钟08云服务器上替换 haproxy + nginx + fail2ban + acme.sh在云服务器上用 Gately 一个程序替换 haproxy + nginx + fail2ban + acme.sh:逐项对照、迁移顺序、回滚办法,以及同机对比的性能数据。40 分钟

找不到想要的? ​

  • 每个功能的完整说明在功能模块里,教程只讲最常用的路径;
  • 使用中遇到问题,欢迎到 Telegram 群交流,或在 GitHub 讨论区提问。

以 Apache-2.0 许可证开源发布。