XX-net/XX-Net · warning

connect fail

Error message

connect fail

What it means

CloudFront check_ip script main: check_ip returned None — the connect/handshake never produced a result within the wait window.

Source

Thrown at code/default/x_tunnel/local/cloudfront_front/check_ip.py:147

    if len(sys.argv) > 3:
        wait_time = int(sys.argv[3])
    else:
        wait_time = 0

    config_path = os.path.join(module_data_path, "cloudfront_front.json")
    config = Config(config_path)

    openssl_context = SSLContext(logger, support_http2=True)
    host_manager = HostManagerBase()
    connect_creator = ConnectCreator(logger, config, openssl_context, host_manager, debug=True)
    check_ip = CheckIp(logger, config, connect_creator)

    #check_all_ip(check_ip)
    #exit(0)

    res = check_ip.check_ip(ip, sni=sni, host=host, wait_time=wait_time)
    if not res:
        xlog.warn("connect fail")
    elif res.ok:
        xlog.info("success, domain:%s handshake:%d", res.host, res.handshake_time)
        xlog.info("response:%s",res.response.content)
    else:
        xlog.warn("not support")

View on GitHub (pinned to cfa5bc17b6)

Solutions

  1. Increase wait_time
  2. Verify IP:443 reachability
  3. Confirm the domain is a CloudFront distribution
Defensive patterns

Strategy: retry

Validate before calling

import socket
socket.setdefaulttimeout(10)
socket.gethostbyname(ip)  # baseline reachability check

Prevention

When it happens

Trigger: Running check_ip.py with an unreachable CloudFront IP or too-small wait_time.

Common situations: Dead IP, blocked port 443, or firewall resetting TLS to CloudFront endpoints.

Related errors

AI-assisted analysis of XX-net/XX-Net@cfa5bc17b6 (2026-08-27). Data as JSON: /api/errors/fca91ba2538692a0. Report an issue: GitHub.