返回资讯中心
外部精选
软件工程
#开发者实时流

Aegis:用 Go 写的 Postgres 第四层代理,拦截破坏性 AI SQL

来源标题:Show HN: Aegis – A Layer-4 Postgres proxy in Go to block destructive AI SQL

Aegis 是一个用 Go 语言编写的第四层 Postgres 代理,在应用与数据库之间拦截 DROP TABLE、无过滤 DELETE 等破坏性查询,使其在执行前就被阻断。被拦截的查询不会到达数据库,连接会被直接终止;良性查询则经 TLS 正常转发。应用侧无需改动数据库代码。

Hacker News 最新raymondartin2026/11/15 · 2 天前24 分钟阅读

以下正文由 AI 翻译自 Hacker News 最新(原文版权归原站所有),可能存在偏差,重要内容请以原文为准。

Aegis 位于你的应用和 Postgres 数据库之间,在破坏性查询执行之前将其拦截,而你无需改动任何数据库代码。

👋 提示:如果你克隆这个仓库是为了在本地测试 Wasm AST 解析器,请给仓库点个 ⭐!这能让我知道确实有人在用开源版本。

sequenceDiagram
    participant App as 你的应用<br/>(psycopg2 或任意客户端)
    participant Proxy as Aegis 代理<br/>:5433 TCP 拦截 / :5434 管理+指标
    participant DB as 你的数据库<br/>(例如 Neon Postgres)
    App->>Proxy: SELECT ...(良性查询)
    Proxy->>DB: 通过 TLS 转发
    DB-->>Proxy: 返回数据行
    Proxy-->>App: 返回数据行
    App->>Proxy: DROP TABLE ...(破坏性查询)
    Note over Proxy: 解析、拦截、终止连接<br/>(即"断头台")
    Proxy-->>App: 致命错误
    Note over DB: 从未到达

你的应用从不直接与数据库通信——每条查询都先经过代理。良性查询会被转发,数据行原样返回。破坏性查询(DROP TABLE、未加过滤的 DELETE 等)则会被拦截,连接在到达数据库之前就被终止。

你的应用                Aegis 代理                     你的数据库
(psycopg2 或任意客户端)                          (例如 Neon Postgres)
+--------------------+  Postgres 协议  +-----------------------------+  TLS  +--------------------+
|                    | --------------> | :5433 TCP 拦截              | ----> |                    |
| SELECT ...         |                 | - 解析每条查询              |       | 真实数据库         |
| DROP TABLE ...     | <-------------- | - 执行速率限制              | <---- |                    |
|                    | 数据行,或被拦截 | - 拦截破坏性语句            |       |                    |
+--------------------+ 时的致命错误    |   ("断头台")              |       +--------------------+
                                       | :5434 管理 + 指标 API       |
                                       +-----------------------------+

快速开始 三步,一条命令启动整套服务,得到一个运行中的代理。

安装 Aegis 的主要方式是从 Docker Hub 直接拉取已发布的镜像:

docker pull raymondartin2/aegis-proxy

预期输出(tag/digest 会随版本变化):

latest: Pulling from raymondartin2/aegis-proxy
Digest: sha256:...
Status: Downloaded newer image for raymondartin2/aegis-proxy:latest
docker.io/raymondartin2/aegis-proxy:latest

运行整套服务仍然需要本仓库的 docker-compose.yml 和 .env.sample,所以也把它们取下来:

git clone https://github.com/raymondhani/aegis-proxy.git
cd aegis-proxy
cp .env.sample .env

也支持自行构建镜像而不是拉取(见本仓库的 Dockerfile),但拉取已发布的镜像是推荐的、主要的方式。

现在打开 .env,把四个占位符替换成你自己的值: 这些都不是可选项:如果缺少 AEGIS_JWT_SECRET,代理会在启动时立即退出,下面每一步都假设这四个值已设置。

docker compose up -d

预期输出(容器名可能因你的文件夹名而略有不同):

Container aegis-proxy Started

这一条命令会启动 Aegis 所需的容器:代理本身,监听 5433(数据库连接)和 5434(管理/指标 API)。开源版代理运行在内存状态之上,不硬依赖 Redis——Redis 仅由企业版用于分布式/高可用状态。

curl -s http://localhost:5434/metrics

预期输出:

{"queries_processed":0,"queries_blocked":0,"active_connections":0,"sessions_jailed":0,"anomalies_detected":0}

如果看到这个输出,说明代理已启动并可以接受连接。

安装 SDK 和 Postgres 驱动,然后针对你刚启动的这套服务运行下面的代码——除了你已在 .env 中设置的凭据,这里无需任何修改。

pip install aegis-proxy-sdk psycopg2-binary
import psycopg2
from aegis_sdk import safe_db_run

def run_demo(db_url: str):
    conn = psycopg2.connect(db_url)
    conn.autocommit = True
    cursor = conn.cursor()

    print("Running an ordinary query...")
    cursor.execute("SELECT 1;")
    print(f"Result: {cursor.fetchone()}")

    print("Running a destructive query: DROP TABLE users;")
    cursor.execute("DROP TABLE users;")

if __name__ == "__main__":
    try:
        run_demo()
    except psycopg2.OperationalError as e:
        print(f"\n[Aegis] Connection severed by the proxy: {e}")

@safe_db_run() 装饰器帮你完成准备工作:它开通一个一次性的 Neon 数据库分支,签发会话 token,并让 db_url 指向本地代理而不是真实数据库——然后在函数返回时再次删除该分支。你的函数只需接收一个可用的 db_url,像使用任何其他 Postgres 连接字符串一样使用它。

Running an ordinary query...
Result: (1,)
Running a destructive query: DROP TABLE users;
[Aegis] Connection severed by the proxy: server closed the connection unexpectedly
	This probably means the server terminated abnormally
	before or while processing the request.

SELECT 1 正常成功。DROP TABLE 从未到达数据库——代理检测到它,终止连接,psycopg2 将其表现为 OperationalError。在你预期会被拦截的特定调用周围捕获该异常是预期的用法,而不是权宜之计。

由于 Aegis 完全透明地在 Layer-4(网络层)工作,开发者无需编写自定义应用代码、安装框架特定插件或改动他们的 AI 逻辑。要保护 AI agent 免受幻觉影响,只需启动 Aegis,并把标准的数据库连接端口从 5432 改为 5433。

# 旧的、危险的方式(直连数据库):
db = SQLDatabase.from_uri("postgresql://user:pass@localhost:5432/my_db")

# 安全的 Aegis 方式(经由 Layer-4 代理路由):
db = SQLDatabase.from_uri("postgresql://user:pass@localhost:5433/my_db")

各版本提供什么 Aegis 以三个产品形式发布,构建在同一个核心之上。下面每一项能力都由代理本身强制执行,而不只是写在文档里——本工作区中的自动化基准测试套件会针对每个版本的运行实例直接断言每一项。

症状 原因 修复 端口不对——你的应用在连接 5432 时挂起或超时

(原文较长,此处译出前 6000 字,完整内容请点「打开原文」。)

正文由 探How 从来源站点 RSS 同步,内容未经改写;遇到排版缺失或需要图片、视频时请以原文为准。

打开原文
去社区讨论 →