{{ message }}
Repository navigation
How to use SSL proxy with AHC #1907
Description
I have an SSL proxy setup which works fine when using curl.
$ curl -x https://test-proxy.com:443 http://google.com
<HTML><HEAD><meta http-equiv="content-type" content="text/html;charset=utf-8">
<TITLE>301 Moved</TITLE></HEAD><BODY>
<H1>301 Moved</H1>
The document has moved
<A HREF="http://www.google.com/">here</A>.
</BODY></HTML>
I can't seem to figure out how to configure AHC with a ProxyServer instance to do the same. I've tried an older version of AHC and a newer one (see below for configurations). In both cases when I make a request it just hangs.
Configuration for 1.7.x:
var proxyServer = new ProxyServer(Protocol.HTTPS, "test-proxy.com", 443);
var config = new AsyncHttpClientConfig.Builder().setProxyServer(proxyServer).build();
var client = new AsyncHttpClient(config);
var request = client.prepareGet("http://google.com").build();
Configuration for 2.12.x:
var proxyServer = new ProxyServer.Builder("test-proxy.com", 80).setSecuredPort(443).build();
var config = new Builder().setProxyServer(proxyServer).build();
var client = new DefaultAsyncHttpClient(config);
var request = client.prepareGet("http://google.com").build();
Activity
hyperxpro commentedon Sep 11, 2023
What's the error you're getting?
xargsgrep commentedon Sep 11, 2023
The request just times out. However, it's not a connectivity issue because as mentioned the curl command works just fine.
If you look at the output below you'll see it's trying to connect to
proxy.xargsgrep.com/44.219.62.231:80. But I want to use SSL for the proxy always, regardless of the schema of the target URL. How do I force AHC 2.12.x to use SSL for the proxy always? TheProxyServer.Builderclass has asetSecuredPortmethod but that's about it.AshwinPrabhuB commentedon Sep 23, 2023
In order to work with proxies, you first need to set
org.asynchttpclient.useProxyProperties=true
in org/asynchttpclient/config/ahc.properties file in your jar.
With the above instructions, AHC would pick up the proxy from the system properties
-Dhttp.proxyHost=? -Dhttp.proxyPort=? -Dhttps.proxyHost=? -Dhttps.proxyPort=?
xargsgrep commentedon Sep 25, 2023
@AshwinPrabhuB The problem is not that AHC is not picking up the proxy settings. I am able to configure it via the code as shown in my original post. The problem is that AHC does not work when an https proxy is configured.
xeron commentedon Feb 2, 2024
From my testing:
Seems like someone tried to fix it in this PR – #1795
archit-harness commentedon Aug 28, 2025
@xeron were you able to find solution pr workaround this?
xeron commentedon Aug 29, 2025
Not really, we did a PoC with
stunnelterminating TLS locally and using HTTP proxy on AHC side instead of HTTPS, but I'm not sure what was the final solution as I don't work on that project anymore.hyperxpro commentedon Aug 29, 2025
I'm taking this PR. New one should be up soon and merged to the next release.
HTTPS Proxy Support (AsyncHttpClient#2109)