XX-net/XX-Net · warning

connect fail

Error message

connect fail

What it means

CLI main of the cloudflare check_ip tool: check_ip(...) returned None, meaning no connection result was produced within the wait time (connect attempt failed outright).

Source

Thrown at code/default/x_tunnel/local/cloudflare_front/check_ip.py:180

    # print("Usage: check_ip.py [ip] [top_domain] [wait_time=0]")
    xlog.info("test ip:%s", ip)
    xlog.info("host:%s", host)
    xlog.info("sni:%s", sni)

    wait_time = 0

    ca_certs = os.path.join(current_path, "cacert.pem")
    openssl_context = SSLContext(logger, ca_certs=ca_certs)
    host_manager = HostManagerBase()
    connect_creator = ConnectCreator(logger, config, openssl_context, host_manager, debug=True)
    check_ip = CheckIp(logger, config, connect_creator)

    #check_all_domain(check_ip)
    #check_all_ip(check_ip)

    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)
    else:
        xlog.warn("not support")

    front.stop()
    sys.exit(0)

View on GitHub (pinned to cfa5bc17b6)

Solutions

  1. Increase wait_time
  2. Verify the IP/port are reachable (ping/telnet)
  3. Confirm SNI/domain is served by that IP
Defensive patterns

Strategy: retry

Validate before calling

import socket
socket.setdefaulttimeout(10)
assert socket.gethostbyname(ip)  # IP resolvable/reachable baseline

Prevention

When it happens

Trigger: Running check_ip.py as a script with an ip/sni/host that cannot be reached or handshake never completes within wait_time.

Common situations: Testing a dead IP, wrong port blocked by firewall, or wait_time too short.

Related errors

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