Gremlin Console通过企业代理连接Azure Cosmos DB失败求助

问题原因 #

Gremlin Driver基于Netty框架实现，而Netty默认不会自动读取系统的HTTP_PROXY/HTTPS_PROXY环境变量，因此你之前设置的环境变量无法生效，导致连接被企业代理拦截拒绝。

两种可行的解决方案 #

方案1：通过JVM系统参数配置代理（修改gremlin.bat） #

直接在启动Gremlin Console的JVM参数中添加代理配置，这是最简单的方式：

1. 打开gremlin.bat文件
2. 修改JAVA_OPTIONS的定义，加入代理相关参数：

set JAVA_OPTIONS=-Dhttp.proxyHost=proxy-adress -Dhttp.proxyPort=3128 ^
-Dhttps.proxyHost=proxy-adress -Dhttps.proxyPort=3128 ^
-Dhttp.proxyUser=username -Dhttp.proxyPassword=password ^
-Dhttps.proxyUser=username -Dhttps.proxyPassword=password

3. 保留原有启动命令，保存文件后重启Gremlin Console

说明：如果代理不需要认证，可去掉包含proxyUser和proxyPassword的参数；若有内部域名无需走代理，可添加-Dhttp.nonProxyHosts="*.internal.com|localhost"（用|分隔多个域名）。

方案2：在remote-secure.yaml中配置Netty代理（更精准） #

利用Gremlin支持的Netty通道配置，直接在连接配置文件中指定代理：

1. 打开conf/remote-secure.yaml
2. 在现有配置基础上添加channelizer和netty代理配置，完整配置如下：

hosts: [xxxxxx.gremlin.cosmos.azure.com]
port: 443
username: /dbs/graph-test/colls/pk1
password: xyz
connectionPool: {
  enableSsl: true
}
serializer: {className: org.apache.tinkerpop.gremlin.driver.ser.GraphSONMessageSerializerV2d0, config: { serializeResultToString: true } }
# 新增代理配置
channelizer: org.apache.tinkerpop.gremlin.driver.channel.WebSocketChannelizer
netty: {
  proxy: {
    type: HTTP,
    host: proxy-adress,
    port: 3128,
    username: username,
    password: password
  }
}

3. 保存文件后，重新执行连接命令:remote connect tinkerpop.server conf/remote-secure.yaml

额外排查点 #

• 确认企业代理允许WebSocket（WSS）流量：Azure Cosmos DB的Gremlin端点使用wss://协议，需确保代理未拦截WebSocket请求
• 检查代理参数正确性：代理地址、端口、用户名密码是否准确，若密码包含特殊字符（如@、%），需在yaml中用引号包裹或进行URL编码
• 验证代理连通性：可先用curl或浏览器测试通过代理访问wss://xxxxxx.gremlin.cosmos.azure.com:443/gremlin是否正常

内容的提问来源于stack exchange，提问作者Francois