关于 Envoy on Windows

Window Image in hub.cocker.com

envoy 的镜像位于 https://hub.docker.com/u/envoyproxy 之下，其中 Windows 包括如下 4 个版本。

envoy-windows

https://hub.docker.com/r/envoyproxy/envoy-windows
envoy-windows-dev

https://hub.docker.com/r/envoyproxy/envoy-windows-dev
envoy-windows-ltsc2022

https://hub.docker.com/r/envoyproxy/envoy-windows-ltsc2022
envoy-windows-ltsc2022-dev

https://hub.docker.com/r/envoyproxy/envoy-windows-ltsc2022
envoy-build-windows2019

https://hub.docker.com/r/envoyproxy/envoy-build-windows2019

在 Windows 上安装 Envoy

可以使用官方的 Windows Docker 镜像运行 Envoy

$ docker pull envoyproxy/envoy-windows-dev:af915efe430a670a9eed89bd57778657374acd4e

$ docker run --rm envoyproxy/envoy-windows-dev:af915efe430a670a9eed89bd57778657374acd4e --version

See: https://www.envoyproxy.io/docs/envoy/latest/start/install#install-envoy-on-windows

使用 Docker 安装 Envoy

使用官方 Docker 镜像来运行 Envoy.

下面的命令将拉取并显示当前镜像的版本

docker pull envoyproxy/envoy:dev-af915efe430a670a9eed89bd57778657374acd4e

docker run --rm envoyproxy/envoy:dev-af915efe430a670a9eed89bd57778657374acd4e --version

支持的 Tag

对于稳定版本的 Envoy 镜像和最新的小版本。

例如，如果最新版本的 v1.73.x 系列是 1.73.7，那么镜像被创建为

envoyproxy/envoy:x1.73.7
envoyproxy/envoy:v1.73-latest

类似的策略用于每个版本。

支持的架构

对于 Linux 构建和镜像来说，Envoy 项目目前支持 amd64 和 arm64 架构

Issues of Envoy on Windows

https://github.com/envoyproxy/envoy/labels/area%2Fwindows

Windows Build

Currently, your releases include Linux binaries (which is an improvement, because before there were no binaries). However, the Windows binaries are still not included. This is a huge pain. Can we please include the Windows binaries in the releases for new releases?

https://github.com/envoyproxy/envoy/issues/24711

For the time being I believe the best option is to copy the executable out of the Windows Docker image. Hopefully this will change soon.

https://github.com/envoyproxy/envoy/issues/30374

windows is no longer supported by the project as it was mostly unused, came with a very high CI cost and was adding a lot of burden to devs

we are however open to fixes to make things work and if there is a community of users that rely on this would encourage setting up a downstream project to track Envoy changes

See: https://github.com/envoyproxy/envoy/issues/33561

获得 envoy.exe

在 GitHub 上有一个项目 extract-envoy. 介绍了如何使用 GitHub 的 Action 从 Windows 的镜像中提取 envoy.exe。

Extracts envoy.exe from the Envoy Proxy Windows container. envoy.exe can be found in Releases.

How it works

Downloads static docker.exe and dockerd.exe for Windows
Generates a daemon.json config for dockerd
Starts the Docker daemon, dockerd
Pulls the Envoy Windows iamge
Creates a container of the Envoy image
Copies envoy.exe out of the container
Deletes the container
Uploads envoy.exe as a release

并且提供了已经提取完成的二进制文件，见：https://github.com/eduphoria/extract-envoy/releases ，目前最新的版本是构建于 2023/3/4 的 v1.25.1

见：https://github.com/eduphoria/extract-envoy

直接执行的输出如下：

> ./envoy

[2024-04-22 12:55:19.334][50604][info][main] [source/server/server.cc:404] initializing epoch 0 (base id=0, hot restart version=disabled)

[2024-04-22 12:55:19.334][50604][info][main] [source/server/server.cc:406] statically linked extensions:

[2024-04-22 12:55:19.334][50604][info][main] [source/server/server.cc:408]   envoy.thrift_proxy.filters: envoy.filters.thrift.header_to_metadata, envoy.filters.thrift.payload_to_metadata, envoy.filters.thrift.rate_limit, envoy.filters.thrift.router

[2024-04-22 12:55:19.334][50604][info][main] [source/server/server.cc:408]   envoy.listener_manager_impl: envoy.listener_manager_impl.default

[2024-04-22 12:55:19.335][50604][info][main] [source/server/server.cc:408]   envoy.path.rewrite: envoy.path.rewrite.uri_template.uri_template_rewriter

[2024-04-22 12:55:19.335][50604][info][main] [source/server/server.cc:408]   envoy.matching.http.input: envoy.matching.inputs.destination_ip, envoy.matching.inputs.destination_port, envoy.matching.inputs.direct_source_ip, envoy.matching.inputs.dns_san, envoy.matching.inputs.request_headers, envoy.matching.inputs.request_trailers, envoy.matching.inputs.response_headers, envoy.matching.inputs.response_trailers, envoy.matching.inputs.server_name, envoy.matching.inputs.source_ip, envoy.matching.inputs.source_port, envoy.matching.inputs.source_type, envoy.matching.inputs.status_code_class_input, envoy.matching.inputs.status_code_input, envoy.matching.inputs.subject, envoy.matching.inputs.uri_san

[2024-04-22 12:55:19.335][50604][info][main] [source/server/server.cc:408]   envoy.filters.http: envoy.bandwidth_limit, envoy.buffer, envoy.cors, envoy.csrf, envoy.ext_authz, envoy.ext_proc, envoy.fault, envoy.filters.http.adaptive_concurrency, envoy.filters.http.admission_control, envoy.filters.http.alternate_protocols_cache, envoy.filters.http.aws_lambda, envoy.filters.http.aws_request_signing, envoy.filters.http.bandwidth_limit, envoy.filters.http.buffer, envoy.filters.http.cache, envoy.filters.http.cdn_loop, envoy.filters.http.composite, envoy.filters.http.compressor, envoy.filters.http.cors, envoy.filters.http.csrf, envoy.filters.http.custom_response, envoy.filters.http.decompressor, envoy.filters.http.dynamic_forward_proxy, envoy.filters.http.ext_authz, envoy.filters.http.ext_proc, envoy.filters.http.fault, envoy.filters.http.gcp_authn, envoy.filters.http.grpc_http1_bridge, envoy.filters.http.grpc_http1_reverse_bridge, envoy.filters.http.grpc_json_transcoder, envoy.filters.http.grpc_stats, envoy.filters.http.grpc_web, envoy.filters.http.header_to_metadata, envoy.filters.http.health_check, envoy.filters.http.ip_tagging, envoy.filters.http.jwt_authn, envoy.filters.http.local_ratelimit, envoy.filters.http.lua, envoy.filters.http.match_delegate, envoy.filters.http.oauth2, envoy.filters.http.on_demand, envoy.filters.http.original_src, envoy.filters.http.rate_limit_quota, envoy.filters.http.ratelimit, envoy.filters.http.rbac, envoy.filters.http.router, envoy.filters.http.set_metadata, envoy.filters.http.stateful_session, envoy.filters.http.tap, envoy.filters.http.wasm, envoy.grpc_http1_bridge, envoy.grpc_json_transcoder, envoy.grpc_web, envoy.health_check, envoy.ip_tagging, envoy.local_rate_limit, envoy.lua, envoy.rate_limit, envoy.router

[2024-04-22 12:55:19.335][50604][info][main] [source/server/server.cc:408]   envoy.http.header_validators: envoy.http.header_validators.envoy_default

[2024-04-22 12:55:19.335][50604][info][main] [source/server/server.cc:408]   envoy.matching.common_inputs: envoy.matching.common_inputs.environment_variable

[2024-04-22 12:55:19.335][50604][info][main] [source/server/server.cc:408]   envoy.quic.server.crypto_stream: envoy.quic.crypto_stream.server.quiche

[2024-04-22 12:55:19.336][50604][info][main] [source/server/server.cc:408]   envoy.matching.input_matchers: envoy.matching.matchers.consistent_hashing, envoy.matching.matchers.ip

[2024-04-22 12:55:19.336][50604][info][main] [source/server/server.cc:408]   envoy.retry_priorities: envoy.retry_priorities.previous_priorities

[2024-04-22 12:55:19.336][50604][info][main] [source/server/server.cc:408]   envoy.matching.network.input: envoy.matching.inputs.application_protocol, envoy.matching.inputs.destination_ip, envoy.matching.inputs.destination_port, envoy.matching.inputs.direct_source_ip, envoy.matching.inputs.dns_san, envoy.matching.inputs.server_name, envoy.matching.inputs.source_ip, envoy.matching.inputs.source_port, envoy.matching.inputs.source_type, envoy.matching.inputs.subject, envoy.matching.inputs.transport_protocol, envoy.matching.inputs.uri_san

[2024-04-22 12:55:19.336][50604][info][main] [source/server/server.cc:408]   envoy.transport_sockets.downstream: envoy.transport_sockets.alts, envoy.transport_sockets.quic, envoy.transport_sockets.raw_buffer, envoy.transport_sockets.starttls, envoy.transport_sockets.tap, envoy.transport_sockets.tcp_stats, envoy.transport_sockets.tls, raw_buffer, starttls, tls

[2024-04-22 12:55:19.336][50604][info][main] [source/server/server.cc:408]   envoy.formatter: envoy.formatter.metadata, envoy.formatter.req_without_query

[2024-04-22 12:55:19.336][50604][info][main] [source/server/server.cc:408]   envoy.resolvers: envoy.ip

[2024-04-22 12:55:19.336][50604][info][main] [source/server/server.cc:408]   envoy.http.stateful_session: envoy.http.stateful_session.cookie, envoy.http.stateful_session.header

[2024-04-22 12:55:19.336][50604][info][main] [source/server/server.cc:408]   envoy.dubbo_proxy.protocols: dubbo

[2024-04-22 12:55:19.336][50604][info][main] [source/server/server.cc:408]   envoy.tracers: envoy.tracers.opentelemetry, envoy.tracers.skywalking, envoy.tracers.xray, envoy.tracers.zipkin, envoy.zipkin

[2024-04-22 12:55:19.336][50604][info][main] [source/server/server.cc:408]   envoy.filters.http.upstream: envoy.buffer, envoy.filters.http.admission_control, envoy.filters.http.buffer, envoy.filters.http.upstream_codec

[2024-04-22 12:55:19.337][50604][info][main] [source/server/server.cc:408]   envoy.thrift_proxy.protocols: auto, binary, binary/non-strict, compact, twitter

[2024-04-22 12:55:19.337][50604][info][main] [source/server/server.cc:408]   envoy.connection_handler: envoy.connection_handler.default

[2024-04-22 12:55:19.337][50604][info][main] [source/server/server.cc:408]   envoy.route.early_data_policy: envoy.route.early_data_policy.default

[2024-04-22 12:55:19.337][50604][info][main] [source/server/server.cc:408]   envoy.request_id: envoy.request_id.uuid

[2024-04-22 12:55:19.337][50604][info][main] [source/server/server.cc:408]   envoy.wasm.runtime: envoy.wasm.runtime.null

[2024-04-22 12:55:19.337][50604][info][main] [source/server/server.cc:408]   envoy.config.validators: envoy.config.validators.minimum_clusters, envoy.config.validators.minimum_clusters_validator

[2024-04-22 12:55:19.337][50604][info][main] [source/server/server.cc:408]   envoy.access_loggers: envoy.access_loggers.file, envoy.access_loggers.http_grpc, envoy.access_loggers.open_telemetry, envoy.access_loggers.stderr, envoy.access_loggers.stdout, envoy.access_loggers.tcp_grpc, envoy.access_loggers.wasm, envoy.file_access_log, envoy.http_grpc_access_log, envoy.open_telemetry_access_log, envoy.stderr_access_log, envoy.stdout_access_log, envoy.tcp_grpc_access_log, envoy.wasm_access_log

[2024-04-22 12:55:19.337][50604][info][main] [source/server/server.cc:408]   network.connection.client: default, envoy_internal

[2024-04-22 12:55:19.337][50604][info][main] [source/server/server.cc:408]   envoy.common.key_value: envoy.key_value.file_based

[2024-04-22 12:55:19.337][50604][info][main] [source/server/server.cc:408]   envoy.dubbo_proxy.serializers: dubbo.hessian2

[2024-04-22 12:55:19.338][50604][info][main] [source/server/server.cc:408]   envoy.matching.network.custom_matchers: envoy.matching.custom_matchers.trie_matcher

[2024-04-22 12:55:19.338][50604][info][main] [source/server/server.cc:408]   envoy.retry_host_predicates: envoy.retry_host_predicates.omit_canary_hosts, envoy.retry_host_predicates.omit_host_metadata, envoy.retry_host_predicates.previous_hosts

[2024-04-22 12:55:19.338][50604][info][main] [source/server/server.cc:408]   envoy.health_checkers: envoy.health_checkers.redis, envoy.health_checkers.thrift

[2024-04-22 12:55:19.338][50604][info][main] [source/server/server.cc:408]   quic.http_server_connection: quic.http_server_connection.default

[2024-04-22 12:55:19.338][50604][info][main] [source/server/server.cc:408]   envoy.http.custom_response: envoy.extensions.http.custom_response.local_response_policy, envoy.extensions.http.custom_response.redirect_policy

[2024-04-22 12:55:19.338][50604][info][main] [source/server/server.cc:408]   envoy.regex_engines: envoy.regex_engines.google_re2

[2024-04-22 12:55:19.338][50604][info][main] [source/server/server.cc:408]   envoy.dubbo_proxy.filters: envoy.filters.dubbo.router

[2024-04-22 12:55:19.338][50604][info][main] [source/server/server.cc:408]   envoy.http.cache: envoy.extensions.http.cache.simple

[2024-04-22 12:55:19.338][50604][info][main] [source/server/server.cc:408]   envoy.quic.connection_id_generator: envoy.quic.deterministic_connection_id_generator

[2024-04-22 12:55:19.338][50604][info][main] [source/server/server.cc:408]   envoy.access_loggers.extension_filters: envoy.access_loggers.extension_filters.cel

[2024-04-22 12:55:19.338][50604][info][main] [source/server/server.cc:408]   envoy.http.original_ip_detection: envoy.http.original_ip_detection.custom_header, envoy.http.original_ip_detection.xff

[2024-04-22 12:55:19.338][50604][info][main] [source/server/server.cc:408]   envoy.clusters: envoy.cluster.eds, envoy.cluster.logical_dns, envoy.cluster.original_dst, envoy.cluster.static, envoy.cluster.strict_dns, envoy.clusters.aggregate, envoy.clusters.dynamic_forward_proxy, envoy.clusters.redis

[2024-04-22 12:55:19.338][50604][info][main] [source/server/server.cc:408]   envoy.compression.compressor: envoy.compression.brotli.compressor, envoy.compression.gzip.compressor, envoy.compression.zstd.compressor

[2024-04-22 12:55:19.339][50604][info][main] [source/server/server.cc:408]   envoy.guarddog_actions: envoy.watchdog.abort_action, envoy.watchdog.profile_action

[2024-04-22 12:55:19.339][50604][info][main] [source/server/server.cc:408]   envoy.http.stateful_header_formatters: envoy.http.stateful_header_formatters.preserve_case, preserve_case

[2024-04-22 12:55:19.339][50604][info][main] [source/server/server.cc:408]   envoy.network.dns_resolver: envoy.network.dns_resolver.cares, envoy.network.dns_resolver.getaddrinfo

[2024-04-22 12:55:19.339][50604][info][main] [source/server/server.cc:408]   envoy.path.match: envoy.path.match.uri_template.uri_template_matcher

[2024-04-22 12:55:19.339][50604][info][main] [source/server/server.cc:408]   envoy.grpc_credentials: envoy.grpc_credentials.aws_iam, envoy.grpc_credentials.default, envoy.grpc_credentials.file_based_metadata

[2024-04-22 12:55:19.339][50604][info][main] [source/server/server.cc:408]   envoy.upstream_options: envoy.extensions.upstreams.http.v3.HttpProtocolOptions, envoy.extensions.upstreams.tcp.v3.TcpProtocolOptions, envoy.upstreams.http.http_protocol_options, envoy.upstreams.tcp.tcp_protocol_options

[2024-04-22 12:55:19.339][50604][info][main] [source/server/server.cc:408]   envoy.thrift_proxy.transports: auto, framed, header, unframed

[2024-04-22 12:55:19.339][50604][info][main] [source/server/server.cc:408]   envoy.matching.action: envoy.matching.actions.format_string, filter-chain-name

[2024-04-22 12:55:19.339][50604][info][main] [source/server/server.cc:408]   envoy.compression.decompressor: envoy.compression.brotli.decompressor, envoy.compression.gzip.decompressor, envoy.compression.zstd.decompressor

[2024-04-22 12:55:19.339][50604][info][main] [source/server/server.cc:408]   envoy.internal_redirect_predicates: envoy.internal_redirect_predicates.allow_listed_routes, envoy.internal_redirect_predicates.previous_routes, envoy.internal_redirect_predicates.safe_cross_scheme

[2024-04-22 12:55:19.339][50604][info][main] [source/server/server.cc:408]   envoy.rate_limit_descriptors: envoy.rate_limit_descriptors.expr

[2024-04-22 12:55:19.339][50604][info][main] [source/server/server.cc:408]   envoy.load_balancing_policies: envoy.load_balancing_policies.least_request, envoy.load_balancing_policies.random, envoy.load_balancing_policies.round_robin

[2024-04-22 12:55:19.339][50604][info][main] [source/server/server.cc:408]   envoy.udp_packet_writer: envoy.udp_packet_writer.default

[2024-04-22 12:55:19.340][50604][info][main] [source/server/server.cc:408]   envoy.filters.network: envoy.echo, envoy.ext_authz, envoy.filters.network.connection_limit, envoy.filters.network.direct_response, envoy.filters.network.dubbo_proxy, envoy.filters.network.echo, envoy.filters.network.ext_authz, envoy.filters.network.http_connection_manager, envoy.filters.network.local_ratelimit, envoy.filters.network.mongo_proxy, envoy.filters.network.ratelimit, envoy.filters.network.rbac, envoy.filters.network.redis_proxy, envoy.filters.network.sni_cluster, envoy.filters.network.sni_dynamic_forward_proxy, envoy.filters.network.tcp_proxy, envoy.filters.network.thrift_proxy, envoy.filters.network.wasm, envoy.filters.network.zookeeper_proxy, envoy.http_connection_manager, envoy.mongo_proxy, envoy.ratelimit, envoy.redis_proxy, envoy.tcp_proxy

[2024-04-22 12:55:19.340][50604][info][main] [source/server/server.cc:408]   envoy.quic.proof_source: envoy.quic.proof_source.filter_chain

[2024-04-22 12:55:19.340][50604][info][main] [source/server/server.cc:408]   envoy.transport_sockets.upstream: envoy.transport_sockets.alts, envoy.transport_sockets.http_11_proxy, envoy.transport_sockets.internal_upstream, envoy.transport_sockets.quic, envoy.transport_sockets.raw_buffer, envoy.transport_sockets.starttls, envoy.transport_sockets.tap, envoy.transport_sockets.tcp_stats, envoy.transport_sockets.tls, envoy.transport_sockets.upstream_proxy_protocol, raw_buffer, starttls, tls

[2024-04-22 12:55:19.340][50604][info][main] [source/server/server.cc:408]   envoy.upstreams: envoy.filters.connection_pools.tcp.generic

[2024-04-22 12:55:19.340][50604][info][main] [source/server/server.cc:408]   envoy.stats_sinks: envoy.dog_statsd, envoy.graphite_statsd, envoy.metrics_service, envoy.stat_sinks.dog_statsd, envoy.stat_sinks.graphite_statsd, envoy.stat_sinks.hystrix, envoy.stat_sinks.metrics_service, envoy.stat_sinks.statsd, envoy.stat_sinks.wasm, envoy.statsd

[2024-04-22 12:55:19.340][50604][info][main] [source/server/server.cc:408]   envoy.bootstrap: envoy.bootstrap.internal_listener, envoy.bootstrap.wasm, envoy.extensions.network.socket_interface.default_socket_interface

[2024-04-22 12:55:19.340][50604][info][main] [source/server/server.cc:408]   envoy.resource_monitors: envoy.resource_monitors.fixed_heap, envoy.resource_monitors.injected_resource

[2024-04-22 12:55:19.340][50604][info][main] [source/server/server.cc:408]   envoy.filters.udp_listener: envoy.filters.udp.dns_filter, envoy.filters.udp_listener.udp_proxy

[2024-04-22 12:55:19.340][50604][info][main] [source/server/server.cc:408]   envoy.tls.cert_validator: envoy.tls.cert_validator.default, envoy.tls.cert_validator.spiffe

[2024-04-22 12:55:19.340][50604][info][main] [source/server/server.cc:408]   envoy.filters.listener: envoy.filters.listener.http_inspector, envoy.filters.listener.original_dst, envoy.filters.listener.original_src, envoy.filters.listener.proxy_protocol, envoy.filters.listener.tls_inspector, envoy.listener.http_inspector, envoy.listener.original_dst, envoy.listener.original_src, envoy.listener.proxy_protocol, envoy.listener.tls_inspector

[2024-04-22 12:55:19.340][50604][info][main] [source/server/server.cc:408]   envoy.matching.http.custom_matchers: envoy.matching.custom_matchers.trie_matcher

[2024-04-22 12:55:19.341][50604][info][main] [source/server/server.cc:408]   envoy.http.early_header_mutation: envoy.http.early_header_mutation.header_mutation

[2024-04-22 12:55:19.341][50604][info][main] [source/server/server.cc:408]   envoy.rbac.matchers: envoy.rbac.matchers.upstream_ip_port

[2024-04-22 12:55:19.341][50604][critical][main] [source/server/server.cc:131] error initializing configuration '': At least one of --config-path or --config-yaml or Options::configProto() should be non-empty

[2024-04-22 12:55:19.341][50604][info][main] [source/server/server.cc:972] exiting

At least one of --config-path or --config-yaml or Options::configProto() should be non-empty

PS C:\software\envoy>