Skip to content

用端口敲门隐藏 SSH 等管理端口 ​

SSH、远程桌面、数据库这类管理端口一旦对公网开放,就会被扫描器和暴力破解盯上。端口敲门让这些端口平时对外完全不可连接:客户端先发一个加密、带 HMAC 认证、只能用一次的敲门包,Gately 验证通过后,只为这个来源地址在几十秒内放行端口。做完本文,你的 SSH 端口在外网看起来是关着的,敲门之后才能连;在手机上还可以通过登录一个网页自动放行,不用安装客户端。

Gately 的端口敲门兼容 fwknop 客户端。想先看界面,可以打开在线演示(「演示账号一键进入」,只读)里的「安全 → 端口敲门」。

适用场景与前提 ​

  • 想从外网用 SSH、scp、IDE 远程开发等方式连接服务器或家里的机器,又不想让端口暴露给扫描器;
  • 「防火墙拦截」需要 Linux,Gately 以 root 运行或有 CAP_NET_ADMIN;Docker 部署需要 host 网络与 cap_add: [NET_ADMIN]。Windows、macOS 或没有权限时,仍可以用「需要敲门」保护经 Gately 转发的入口(第 5、6 步);
  • 客户端与服务器的时钟都要准确,报文有效期默认 120 秒;
  • 先确认你能从内网或其他途径登录这台机器,配置出错时不至于把自己锁在外面;
  • 侧边栏没有「端口敲门」时,点侧边栏底部的「添加更多功能」打开这个模块。

结果是什么样 ​

text
扫描器 ──SYN──▶ :22  ✗ 丢弃(端口看起来是关着的)

你的电脑 ──① 敲门包(UDP 62201,加密 + HMAC + 防重放)──▶ Gately
          ◀───────── 认证通过,只放行 203.0.113.17 → tcp/22,30 秒
          ──② ssh ──────────────────────────────────▶ :22  ✓
  • 放行时长内建立的连接会一直保持,到期只影响新连接;
  • 内网地址默认免敲门,在家里或机房内网照常直连。

步骤 ​

1. 添加敲门规则 ​

  1. 打开侧边栏「安全 → 端口敲门」,点「添加规则」。
  2. 填写:
    • 「名称」:SSH 敲门;
    • 「端口」:tcp/22。可以写多个,如 tcp/22,tcp/3389,最多 16 个;只写端口号时按 TCP 处理;
    • 「防火墙拦截」:打开,Gately 在系统防火墙里拦截这些端口,只放行敲门成功的地址。用来保护本机 sshd 这类不经过 Gately 的服务;
    • 「加密密钥」「HMAC 密钥」:留空自动生成(与 fwknop -k 生成的密钥格式相同),已有 fwknop 服务端时可以填原来的密钥;
    • 「HMAC 算法」:保持 SHA256(fwknop 默认);
    • 「放行时长」:默认 30 秒,敲门后在这段时间内可以建立新连接;
    • 「客户端最长时长」:客户端用 -f 请求更长时长时的上限,0 表示忽略客户端的请求;
    • 「限定用户名」:留空不限;
    • 「要求写明地址」:打开,拒绝不带放行地址的敲门包(fwknop -s),防止报文被截获后被人从别的地址抢先重放。
  3. 点「保存」。

添加敲门规则:保护本机 SSH

防止把自己锁在外面

  • 「全局设置」里的「内网免敲门」默认开启:私有地址、链路本地地址与本机网卡所在的公网 IPv6 网段无需敲门。运营商级 NAT 地址 100.64.0.0/10 不在其中,Tailscale、NetBird 用户需要免敲门时把它加到「免敲门白名单」;
  • 开启拦截时已建立的连接不受影响;
  • Gately 正常停止时删除拦截规则;被 kill -9、docker rm -f 强制结束时规则会保留,直到 Gately 重新启动。

2. 检查全局设置与防火墙 ​

  1. 点页头「全局设置」:
    • 「UDP 敲门端口」:默认 62201,与 fwknop 客户端默认值一致。填 0 不监听 UDP,只接收经协议分流发来的敲门(第 6 步);
    • 「自动放行防火墙」:打开后,Gately 在 OpenWrt fw4、firewalld、ufw 等防火墙中放行 UDP 敲门端口,拦截生效后也放行受保护端口,能否连接只由敲门决定;
    • 「内网免敲门」「免敲门白名单」:见上面的提示;
    • 「报文有效期」:默认 120 秒。
  2. 云服务器在安全组放行 UDP 62201 与 TCP 22;家里的机器在路由器上把 UDP 62201 与 TCP 22 都映射到 Gately 所在主机。

端口敲门全局设置

保存后看页面顶部的「运行状态」:「敲门端口」显示「UDP 62201 接收中」,「防火墙拦截」显示「已生效」以及使用的后端(nftables,或没有 nf_tables 时的 iptables + ipset)与受保护端口。点「查看防火墙规则」可以看到 Gately 写入的规则。下方的统计卡片分别是敲门成功、敲门被拒绝、拦截的新连接、敲门后建立的连接。

运行状态、当前授权与规则卡片

防火墙拦截显示「未生效」时,页面顶部会给出原因,例如没有修改防火墙的权限、找不到 nft,按提示处理。

3. 配置 fwknop 客户端 ​

  1. 在客户端电脑安装 fwknop:
    • macOS:brew install fwknop;
    • Debian / Ubuntu:apt install fwknop-client;
    • Windows:在 WSL 中按 Linux 的方式安装。
  2. 在规则卡片上点「客户端」,填写「服务器地址」(域名或公网 IP,例如 ssh.example.com),选择:
    • 「发送方式」:UDP 62201;只开一个 TCP 端口时选「经协议分流(TCP)」并填端口(第 6 步);
    • 「放行地址」:推荐「自动获取公网 IP」(-R),客户端先查询自己的公网 IPv4 写进报文;「来源地址」(-s)在规则开启了「要求写明地址」时会被拒绝;「指定地址」(-a)用于替另一台设备敲门;
    • 「请求端口」:勾选要放行的端口。
  3. 复制「~/.fwknoprc 配置段」,追加到客户端的 ~/.fwknoprc,然后执行 chmod 600 ~/.fwknoprc。

fwknop 客户端配置:~/.fwknoprc 配置段与命令行

配置段的名称由规则名称生成,例如 gately-ssh。之后每次连接前敲一次门:

bash
fwknop -n gately-ssh && ssh user@ssh.example.com

对话框下方的「命令行」是不依赖配置文件的写法,密钥会留在 shell 历史与进程列表中,优先用配置段。fwknop 客户端只能经 IPv4 发送敲门包、放行 IPv4 地址,服务器地址需要能经 IPv4 访问。

手机上怎么敲门。 Android 可以试用支持 fwknop 的第三方 App(例如 Fwknop2),按配置段里的 KEY_BASE64、HMAC_KEY_BASE64 填写 Rijndael 密钥与 HMAC 密钥,勾选 base64 编码,端口填 tcp/22,兼容性请自行验证。iOS 上没有常用的 fwknop App,推荐用第 7 步的网页登录放行。

4. 测试敲门 ​

  1. 在外网(例如手机热点)直接 ssh user@ssh.example.com,连接超时,说明拦截生效;
  2. 执行 fwknop -n gately-ssh,再 30 秒内 ssh,能正常登录;
  3. 回到「端口敲门」页:「当前授权」出现你的公网 IP、规则名、端口与剩余时间,可以点「撤销」立即收回;规则卡片的「敲门」一栏显示「成功 N 次,拒绝 N 次」与最近一次敲门的地址和时间。

5. 保护经 Gately 转发的入口:需要敲门 ​

防火墙拦截保护的是本机端口。连接经 Gately 的端口转发、协议分流或 STUN 内置转发到达内网机器时,在这些规则上选择「需要敲门」,由 Gately 自己判断,不需要防火墙权限,Windows、macOS 与没有 NET_ADMIN 的容器也能用。

以端口转发为例,把外网 2222 转到内网 192.168.1.10:22,只对敲门成功的来源开放:

  1. 打开「网络 → 端口转发」,点「添加规则」;
  2. 「名称」SSH 外网入口,协议 TCP,「监听端口」2222,「目标地址」192.168.1.10,「目标端口」22;
  3. 展开「高级设置」,在「需要敲门」中选择刚才的 SSH 敲门 规则;
  4. 保存。

端口转发规则:需要敲门

Gately 入口按「来源地址是否持有这条规则的授权」判断,与端口无关:客户端照常用 fwknop -n gately-ssh(-A tcp/22)敲门,成功后就能连 2222。只供入口引用、不保护本机端口的规则可以关闭「防火墙拦截」。未敲门的来源连上 2222 后会被直接断开。「需要敲门」与「IP 访问控制」的白名单 / 黑名单可以同时设置,两者都要满足。被端口转发、协议分流或 STUN 引用的敲门规则不能删除,卡片上的「被引用」列出了引用方。

端口转发到本机 127.0.0.1:22

经 Gately 转发到本机回环地址的连接不受防火墙拦截影响。这种情况在端口转发规则上选择「需要敲门」即可。

6. 只开一个端口:在 443 上敲门并分流 SSH ​

只能开放一个 TCP 端口(例如 443)时,用协议分流同时承载 HTTPS、敲门包与 SSH:

  1. 打开「网络 → 协议分流」,点「添加规则」,「名称」443 入口,「监听端口」443;
  2. 第 1 条路由:协议选「端口敲门(fwknop -P tcp)」,名称 knock。这条路由把报文交给端口敲门模块认证,不转发、不回复;
  3. 点「添加路由」,第 2 条路由:协议 SSH,名称 ssh,目标 127.0.0.1、端口 22,「需要敲门」选 SSH 敲门 规则;
  4. 「默认目标」127.0.0.1,「目标端口」8443,「默认目标 PROXY」选「PROXY v2」,网站照常对所有人开放(Web 监听的设置见一个 443 端口跑所有服务);
  5. 保存。

协议分流:敲门路由与需要敲门的 SSH 路由

敲门规则不用改:报文经 443 送达,-A 仍请求规则里的 tcp/22,认证通过后来源地址取得这条规则的授权,SSH 路由随即放行。不需要 UDP 时把「UDP 敲门端口」设为 0。客户端对话框的「发送方式」选「经协议分流(TCP)」并填 443,生成的命令类似:

bash
fwknop -A tcp/22 -P tcp -p 443 -R -D ssh.example.com --use-hmac \
  --key-base64-rijndael '<加密密钥>' --key-base64-hmac '<HMAC 密钥>'
ssh -p 443 user@ssh.example.com

带敲门路由的协议分流端口不能出现在开启了防火墙拦截的规则中(拦截后敲门包本身无法送达),保存时会检查。

7. 网页登录后放行(手机、临时电脑) ​

不方便装 fwknop 的设备,可以通过登录一个 Web 站点取得敲门授权:

  1. 选一个已经开启了「网页认证」或「基本认证」的站点(例如 photos.example.com),在「Web → Web 服务」里点站点的「编辑」,切到「安全」页;
  2. 「登录后放行」选择 SSH 敲门 规则;
  3. 「放行时长」默认 360 分钟(5 分钟到 7 天);「IPv6 放行范围」默认 /64,覆盖同一设备的临时地址轮换;
  4. 手机浏览器常经 IPv6 登录,而 App 经 IPv4 连接:在「双栈探测」中选择本站点下只有 A 记录、只有 AAAA 记录的两个域名(需添加到本站点并由证书覆盖),放行页面会两种地址都放行;
  5. 保存。「放行页面」一栏显示入口地址,例如 https://photos.example.com/__gately_knock。

站点安全页:敲门准入与登录后放行

访客登录这个站点后,其来源 IP 就获得 SSH 敲门 规则的授权;继续访问站点时自动续期。打开 /__gately_knock 可以查看已放行的地址与到期时间、撤销当前网段或全部放行;在站点退出登录会撤销当前网段。规则开启了防火墙拦截时,登录后同样会在系统防火墙中放行实际登录的地址,可以直接连 SSH。「当前授权」里这类授权带「网页登录」标记,并显示用户与入口站点。

同一页的「敲门准入」是反方向的用法:只有持有敲门授权的来源才能连到这个站点,准入只决定能否连上,站点自己的登录照常生效。建议同时把「拒绝方式」设为「断开连接」,没放行的访客与扫描器看不到这个站点。放行入口不能同时要求同一条规则的准入。

不会被放行的地址

回环、内网、链路本地与 100.64.0.0/10 地址不会经网页登录放行。Gately 前面有 CDN 或反向代理时,必须先配置可信代理取得访客真实 IP(见 Web 服务 · 敲门准入与登录后放行),否则放行的是代理的地址。

8. 与入侵防护联动(可选) ​

经协议分流 TCP 端口发来的无效敲门会发布「端口敲门被拒绝」事件。打开「安全 → 入侵防护」,用「端口敲门失败」模板创建规则(默认 10 分钟内 5 次即封禁 1 天),持续发送无效报文的来源会被封禁。经 UDP 发来的被拒绝敲门只计数、写日志,因为 UDP 来源地址可以伪造。配置方法见入侵防护与 WAF。

验证 ​

bash
# 未敲门:外网连接超时
nc -vz -w 5 ssh.example.com 22

# 敲门后 30 秒内可以连接
fwknop -n gately-ssh
nc -vz -w 5 ssh.example.com 22
ssh user@ssh.example.com
  • 「端口敲门」页的「敲门成功」「拦截的新连接」「敲门后建立的连接」数字增长;
  • 运行日志中有每次敲门成功与被拒绝的记录(含原因,例如时间戳过期、端口不在规则中);
  • 端口转发、协议分流规则的卡片上,未敲门被断开的连接计入「已拒绝」或「未敲门被断开」。

常见问题 ​

敲门后仍然连不上。 按顺序检查:UDP 62201 是否放行与映射到了 Gately;运行状态里「敲门被拒绝」有没有增长;客户端 -A 中的端口是否全部在规则的「端口」列表中;30 秒放行时长是否已过。

日志显示报文过期或时间戳超出有效期。 客户端或服务器时钟不准,开启 NTP 同步;或把「报文有效期」适当调大。

开启了「要求写明地址」后敲门被拒绝。 客户端用了「来源地址」(-s),改用「自动获取公网 IP」(-R)。

-R 拿到的地址与实际出口不一致。 客户端在多出口或代理环境里(例如开着全局代理),查询到的公网 IP 是代理的出口。关闭代理后再敲门,或改用「指定地址」(-a)写明实际出口。

服务器只有 IPv6。 fwknop 客户端只能经 IPv4 发送,改用网页登录放行(第 7 步)。

防火墙拦截只覆盖 IPv4。 运行状态出现这条提示时,系统没有可用的 ip6tables 或缺少 IPv6 的 mangle 表,受保护端口经 IPv6 仍可直接访问。按提示安装 ip6tables 与 ip6table_mangle 模块,或在 IPv6 上另行限制这些端口。

Gately 重启后要重新敲门。 敲门授权保存在内存中,重启后需要重新敲门或重新打开放行页面,已建立的连接不受影响。

下一步 ​

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