Component
core/ai-agent/dify-ssrf-proxy
The egress proxy a Dify installation routes user-directed outbound requests through. A Dify workflow fetches whatever address its author or its end user supplies — a web page to crawl, a file to load, an HTTP request node's target — and a service that made those calls itself would be reachable proof of every address the cluster can see. This component is the chokepoint that removes that: it is a Squid forward proxy configured to refuse any destination in private, loopback, link-local or multicast address space, so a supplied address can reach the public internet and cannot reach the cluster's own services or the node's metadata endpoint. Its allowlist of private destinations is empty by default and is widened only by naming addresses explicitly. Holds no state — its cache is in memory and discarded with the process — so it renders as a stateless server. Exports its host, port and protocol to consumers via the uses topology, which is how each caller learns the proxy address to send through.
Происхождение
- Дайджест содержимого
- sha256:aea991ce87ad647db2f03ef6900566d99bd591c18a903d8c9f5a4bc515a42399
- Опубликовано
- 2026-11-10T10:07:51Z
- Идентичность подписи
- https://token.actions.githubusercontent.com/https://github.com/aggrega-ai/aggrega-hub/.github/workflows/catalog-publish-sign.yml@refs/heads/main
Подпись
- Официальныйapplication/vnd.dev.sigstore.bundle.v0.3+json
https://token.actions.githubusercontent.com/https://github.com/aggrega-ai/aggrega-hub/.github/workflows/catalog-publish-sign.yml@refs/heads/main
sha256:41ce27fc1bd98aa86e3894ac9dd8ff6ac9ff537d6a9e66b00ef694b92a7cf24e
Ссылка на эту версию
oci://hub.aggrega.ai/component/core/ai-agent/dify-ssrf-proxy:1.0.0Параметры разработчика
Значения, которые разработчик задаёт в сущности Aggregate.
| Имя | Тип | По умолчанию | Обязательный | Описание |
|---|---|---|---|---|
| allowed_private_networks | array | — | нет | Private-address ranges the proxy permits as destinations, each in CIDR notation, permitted ahead of the private-network refusal. Left unset, no private destination is reachable through the proxy. Naming a range here is how an installation lets a workflow reach a service inside its own cluster, and each entry widens what a supplied address can reach, so the list stays as short as the installation needs. |
| allowed_domains | array | — | нет | Domains the proxy permits as destinations regardless of the address they resolve to, each written as the domain or a leading-dot suffix match. Left unset, only the plugin marketplace the platform installs from is named. |
| max_request_body_size | string | 100 MB | нет | Largest request body the proxy will buffer, as a Squid size quantity. |
Размеры, задаваемые оператором
Размеры инфраструктуры, которые оператор настраивает для каждого окружения.
| Имя | Тип | По умолчанию | Обязательный | Описание |
|---|---|---|---|---|
| port | integer (min 1024, max 65535) | 3128 | нет | Forward-proxy listen port callers send through. |
| engine_version | string | 6.6-24.04_edge | нет | Squid container image tag. |
| compute | object | — | нет | — |
| overrides | object (open) | — | нет | Provider-specific overrides. Accepts any nested structure. Each Recipe documents which keys it reads. |
Контракт выходных значений
Значения, которые этот компонент публикует для потребителей через топологию uses.
| Имя | Тип | По умолчанию | Обязательный | Описание |
|---|---|---|---|---|
| host | string | — | да | In-cluster DNS name of the Service fronting the egress proxy. A caller sets it as its proxy address rather than as a request target, so its outbound calls leave through the proxy. |
| port | integer | — | да | TCP port the proxy accepts forwarded requests on. It follows the port an operator set in the Release, so a caller reads it rather than assuming a default. |
| protocol | string | — | нет | URL scheme to reach `host` and `port` over, which a caller composes its proxy address on. |
Сокеты uses
Сокеты зависимостей, через которые подключается этот компонент. Цель каждого соединения, проведённого через сокет, должна удовлетворять его селектору меток, и каждое соединение может нести подключение в слотах, которые объявляет сокет. Обязательный слот должен заполнить каждое соединение, которое сущность Aggregate или сущность Release проводит через сокет.
Сокеты uses не объявлены.
Слоты подключения
Именованные точки привязки, в которых Feature подключается к этому компоненту. Селектор слота ограничивает, какая сущность Feature может его заполнить, а его список внедрения указывает, как могут доставляться материалы сущности Feature. Обязательный слот должен быть привязан в каждом экземпляре — подключением в самом экземпляре или в области выше него, — а конфиденциальный слот объявляется для работы с секретными материалами. Feature также может подключаться под именем, которое не объявляет ни один слот.
Слоты подключения не объявлены.
Список разрешённых самовнедрений
Каналы самовнедрения не объявлены.
Связи
Типизированные рёбра к другим опубликованным сущностям и от них. Ссылка без опубликованной цели отображается как разорванное ребро, а не как ссылка.
Использует
Эта сущность ничего не использует из каталога.
Используется в
использует сокет «runner»
использует сокет «api»
использует сокет «runner»
использует сокет «api»
использует сокет «services»
использует сокет «api»
использует сокет «services»
использует сокет «services»
использует сокет «sandbox»
использует сокет «plugin_daemon»
использует сокет «ssrf_proxy»
использует сокет «sandbox»
использует сокет «plugin_daemon»
использует сокет «ssrf_proxy»
использует сокет «api»
использует сокет «ssrf_proxy»
использует сокет «api»
использует сокет «api»
использует сокет «sandbox»
использует сокет «plugin_daemon»
использует сокет «ssrf_proxy»
использует сокет «sandbox»
использует сокет «plugin_daemon»
использует сокет «ssrf_proxy»
использует сокет «target_agent»
использует сокет «upstream»
использует сокет «forward_target»
использует сокет «scrape_target»
использует сокет «store»
применяется к
применяется к
применяется к
применяется к
применяется к
применяется к
применяется к
реализует
реализует