GateKeeper

GateKeeper 是一个用 Go 编写的自托管 SSH 访问网关。

它作为 SSH 前端的集中控制层，提供访问控制、MFA 强制、会话录制、审计和策略执行——全部以单个二进制文件的形式交付，并内置 Web UI。

无外部控制平面。无 SaaS 依赖。

---

它是什么（以及不是什么）

GateKeeper 不是传统意义上经过加固的跳板机式的极简“堡垒主机”。

相反，它是一个 SSH 访问网关，旨在集中管理 SSH 环境的身份验证、授权和审计。

目标是受控访问和可见性——而不是零服务加固操作系统模型。

---

功能

• 基于浏览器的 SSH 代理（WebSocket + xterm.js）
• 会话录制（asciicast v2，可选 AES-256-GCM 加密）
• 本地认证（bcrypt）+ LDAP / OIDC / SAML
• 基于 TOTP 的 MFA（策略强制）
• 具有细粒度权限的 RBAC
• 审批工作流和基于时间的访问窗口
• 审计日志记录，支持 webhook（HMAC）和 syslog 导出
• IP 允许/拒绝规则（CIDR，拒绝优先）
• 并发会话限制（全局 + 按组）
• 密钥后端（Vault 或环境变量）
• TLS 热重载
• Prometheus 指标
• /health 和 /ready 端点
• 实例身份跟踪

---

状态

GateKeeper 功能可用并经过积极测试。

• 单实例部署稳定
• SQLite 是主要开发数据库
• 支持 Postgres，但需要更广泛的真实环境验证
• HA / 多实例模式尚未达到生产就绪

---

快速开始

GateKeeper 为 Linux 构建。Linux 是受支持的生产平台。

Docker 是运行 GateKeeper 的推荐方式，可实现一致且安全的部署。

Windows 和 macOS 构建可能适用于开发，但生产部署应使用 Linux。

构建

git clone https://github.com/judsenb/gatekeeper.git
cd gatekeeper
make build
./gatekeeper

首次运行时，打开：

https://localhost:8443

---

Docker

docker compose up -d

SQLite 是默认选项。如有需要，可通过环境变量配置 Postgres。

---

配置

GateKeeper 使用 YAML 配置文件，并支持环境变量覆盖。

常用环境变量：

• GK_DB_DRIVER --- sqlite 或 postgres\
• GK_DB_DSN --- Postgres 连接字符串\
• GK_TLS_CERT / GK_TLS_KEY --- TLS 文件\
• GK_ENCRYPTION_KEY --- 32 字节密钥（hex 或 base64）\
• GK_DEPLOYMENT_MODE --- single 或 ha\
• GK_INSTANCE_ID --- 覆盖自动生成的实例 ID

如果存在 TLS 文件，HTTP 会重定向到 HTTPS。证书更新时会自动重新加载。

---

开发

make build
make test
make cover
make check

测试使用内存中的 SQLite。CI 运行代码检查、测试和漏洞检查。

---

许可证

MIT