Simplify console guidance for client and Cloudflare wizard

Author: itresfall

CHANGELOG.md

@@ -19,6 +19,9 @@ unless `ROAD_VERSION` is set during build.
   before release.
 - Fixed Plugin Studio output so generated plugin menus point at the generated
   per-plugin server/client config files instead of generic examples.
+- Simplified first-run console output: client mode now shows the exact in-game
+  target address, and TryCloudflare mode hides noisy cloudflared logs while
+  surfacing the created tunnel URL.
 
 ## v0.1.2 - 2026-05-14
 

cmd/road/flow_client.go

@@ -4,6 +4,7 @@ import (
 	"bufio"
 	"context"
 	"fmt"
+	"net"
 	"net/url"
 	"os/signal"
 	"strings"
@@ -55,6 +56,8 @@ func startClientFlow(reader *bufio.Reader) error {
 		return err
 	}
 
+	printClientReadyInstructions(cfg)
+
 	tunnel := client.New(cfg, logging.New(cfg.Logging.Format, "road-proxy-client"))
 	ctx, cancel := signal.NotifyContext(context.Background(), syscall.SIGINT, syscall.SIGTERM)
 	defer cancel()
@@ -189,3 +192,38 @@ func applyClientProfileFromServer(cfg *config.ClientConfig, requireProfile bool)
 	}
 	return nil
 }
+
+func printClientReadyInstructions(cfg *config.ClientConfig) {
+	target, host, port := splitDisplayTarget(cfg.ListenAddr)
+
+	fmt.Println(msg("client.ready"))
+	fmt.Printf(msg("client.game_target_line"), target)
+	if host != "" && port != "" {
+		fmt.Printf(msg("client.game_host_port_line"), host, port)
+	}
+	fmt.Printf(msg("client.remote_line"), cfg.ServerWSURL)
+	if strings.TrimSpace(cfg.PluginName) != "" {
+		fmt.Printf(msg("client.active_plugin_line"), cfg.PluginName)
+	}
+	fmt.Println(msg("client.stop_hint"))
+	fmt.Println()
+	fmt.Println(msg("client.logs_follow"))
+}
+
+func splitDisplayTarget(addr string) (target string, host string, port string) {
+	target = strings.TrimSpace(addr)
+	if target == "" {
+		return "", "", ""
+	}
+
+	host, port, err := net.SplitHostPort(target)
+	if err != nil {
+		return target, "", ""
+	}
+	host = strings.Trim(host, "[]")
+	switch host {
+	case "", "0.0.0.0", "::":
+		host = "127.0.0.1"
+	}
+	return net.JoinHostPort(host, port), host, port
+}

cmd/road/main_test.go

@@ -287,6 +287,20 @@ func TestApplyClientConnectionInputPromptsForPublicAuthToken(t *testing.T) {
 	}
 }
 
+func TestSplitDisplayTargetNormalizesWildcardHost(t *testing.T) {
+	target, host, port := splitDisplayTarget("0.0.0.0:25568")
+	if target != "127.0.0.1:25568" || host != "127.0.0.1" || port != "25568" {
+		t.Fatalf("unexpected display target: target=%q host=%q port=%q", target, host, port)
+	}
+}
+
+func TestSplitDisplayTargetKeepsConcreteHost(t *testing.T) {
+	target, host, port := splitDisplayTarget("192.168.1.50:8303")
+	if target != "192.168.1.50:8303" || host != "192.168.1.50" || port != "8303" {
+		t.Fatalf("unexpected display target: target=%q host=%q port=%q", target, host, port)
+	}
+}
+
 func TestApplyClientConnectionInputBlankPublicAuthKeepsExistingToken(t *testing.T) {
 	cfg := config.DefaultClient()
 	cfg.AuthToken = "existing-token"
@@ -520,6 +534,21 @@ func TestTunnelURLCaptureFindsTryCloudflareURL(t *testing.T) {
 	}
 }
 
+func TestTunnelURLCaptureWorksWithoutOutputWriter(t *testing.T) {
+	capture := newTunnelURLCapture(nil)
+	if _, err := capture.Write([]byte("INF noisy cloudflared line\nhttps://quiet.trycloudflare.com\n")); err != nil {
+		t.Fatalf("write failed: %v", err)
+	}
+	select {
+	case got := <-capture.found:
+		if got != "https://quiet.trycloudflare.com" {
+			t.Fatalf("unexpected URL: %s", got)
+		}
+	default:
+		t.Fatal("expected captured URL")
+	}
+}
+
 func TestPublicEndpointFromHTTPS(t *testing.T) {
 	endpoint, host, err := publicEndpointFromHTTPS("https://abc-def.trycloudflare.com")
 	if err != nil {

cmd/road/tunnel_trycloudflare.go

@@ -60,7 +60,7 @@ func startTryCloudflareTunnel(ctx context.Context, bin string, originURL string)
 		return nil, nil, err
 	}
 
-	capture := newTunnelURLCapture(os.Stdout)
+	capture := newTunnelURLCapture(nil)
 	args := []string{
 		"tunnel",
 		"--config", isolatedConfig,
@@ -97,6 +97,7 @@ func waitForTunnelURL(ctx context.Context, urlCh <-chan string, proc *cloudflare
 		select {
 		case url := <-urlCh:
 			fmt.Println()
+			fmt.Printf(msg("cloudflared.tunnel_url_ready"), url)
 			return url, nil
 		case err := <-proc.done:
 			fmt.Println()

cmd/road/wizard.go

@@ -308,14 +308,19 @@ func readRequiredLine(reader *bufio.Reader, prompt string) (string, error) {
 func printPublicServerReady(info publicServerRuntime) {
 	fmt.Println()
 	fmt.Println(msg("public.ready"))
-	fmt.Printf(msg("public.endpoint_line"), info.Endpoint)
+	fmt.Println(msg("public.share_header"))
+	fmt.Printf(msg("public.client_endpoint_line"), info.Endpoint)
+	fmt.Printf(msg("public.client_token_line"), info.Token)
+	fmt.Printf(msg("public.client_plugin_line"), info.PluginName)
+	fmt.Println()
+	fmt.Println(msg("public.host_header"))
+	fmt.Printf(msg("public.dashboard_line"), info.DashboardURL)
+	fmt.Println()
+	fmt.Println(msg("public.advanced_header"))
 	fmt.Printf(msg("public.auth_header_line"), "X-ROAD-Token")
-	fmt.Printf(msg("public.auth_token_line"), info.Token)
-	fmt.Printf(msg("public.plugin_line"), info.PluginName)
 	fmt.Printf(msg("public.local_origin_line"), info.LocalOriginURL)
 	fmt.Printf(msg("public.server_config_line"), info.ConfigPath)
 	fmt.Printf(msg("public.client_config_line"), info.ClientConfigPath)
-	fmt.Printf(msg("public.dashboard_line"), info.DashboardURL)
 	fmt.Println()
 	fmt.Println(msg("public.stop_hint"))
 }

internal/client/tunnel.go

@@ -104,7 +104,7 @@ func (t *Tunnel) startTCP(ctx context.Context) error {
 		return err
 	}
 
-	t.logger.Printf("client tunnel started: local=%s remote=%s", t.cfg.ListenAddr, targetWS)
+	t.logger.Printf("client listener active: game_target=%s road_server=%s plugin=%s network=tcp", t.cfg.ListenAddr, targetWS, t.cfg.PluginName)
 
 	for {
 		localConn, err := listener.Accept()
@@ -142,7 +142,7 @@ func (t *Tunnel) startUDP(ctx context.Context) error {
 		return err
 	}
 
-	t.logger.Printf("client udp tunnel started: local=%s remote=%s", t.cfg.ListenAddr, targetWS)
+	t.logger.Printf("client listener active: game_target=%s road_server=%s plugin=%s network=udp", t.cfg.ListenAddr, targetWS, t.cfg.PluginName)
 
 	sessions := map[string]*udpSession{}
 	var sessionsMu sync.Mutex

locales/en.json

@@ -12,6 +12,13 @@
   "client.server_ws_url_repair_failed": "Invalid server address: %v\n",
   "client.server_ws_url_repair_prompt": "Enter ROAD server address to repair server_ws_url (default: %s): ",
   "client.starting": "Starting client...",
+  "client.ready": "ROAD Client is ready.",
+  "client.game_target_line": "Use this as the game/server address: %s\n",
+  "client.game_host_port_line": "If the game asks separately, enter Host/IP=%s Port=%s.\n",
+  "client.remote_line": "Connected ROAD server: %s\n",
+  "client.active_plugin_line": "Active plugin: %s\n",
+  "client.stop_hint": "Press Ctrl+C to stop.",
+  "client.logs_follow": "Technical logs follow; normal users do not need to watch this section.",
   "common.error_line": "Error: %v\n\n",
   "common.runtime_line": "Runtime: %s\n",
   "config.template_load_failed": "template config could not be loaded (%s): %w",
@@ -72,6 +79,12 @@
   "protocol.unsupported": "unsupported protocol: %s",
   "public.auth_header_line": "Auth header: %s\n",
   "public.auth_token_line": "Auth token: %s\n",
+  "public.share_header": "Give this to the client/player:",
+  "public.client_endpoint_line": "  ROAD address: %s\n",
+  "public.client_token_line": "  Auth token: %s\n",
+  "public.client_plugin_line": "  Plugin: %s\n",
+  "public.host_header": "Host side:",
+  "public.advanced_header": "Technical details:",
   "public.choice_1_4_default_1": "Choice (1-4, default: 1): ",
   "public.client_config_line": "Client config: %s\n",
   "public.cloudflare_mode": "Cloudflare mode:",
@@ -127,6 +140,7 @@
   "cloudflared.tunnel_reuse_prompt": "Reuse the existing tunnel?",
   "cloudflared.tunnel_reusing_uuid": "Using existing tunnel: %s\n",
   "cloudflared.tunnel_url_wait": "Waiting for tunnel URL",
+  "cloudflared.tunnel_url_ready": "Tunnel started: %s\n",
   "cloudflared.tunnel_uuid_missing": "Warning: tunnel UUID was not found; continuing by tunnel name.",
   "runtime.generated_config_dir_failed": "generated config dir create failed: %w",
   "runtime.marshal_failed": "%s could not be marshaled: %w",

locales/tr.json

@@ -12,6 +12,13 @@
   "client.server_ws_url_repair_failed": "Geçersiz server adresi: %v\n",
   "client.server_ws_url_repair_prompt": "server_ws_url düzeltmek için ROAD server adresini girin (varsayılan: %s): ",
   "client.starting": "Client başlatılıyor...",
+  "client.ready": "ROAD Client hazır.",
+  "client.game_target_line": "Oyunda/server adresi olarak bunu yazın: %s\n",
+  "client.game_host_port_line": "Oyun ayrı alan istiyorsa Host/IP=%s Port=%s girin.\n",
+  "client.remote_line": "Bağlı ROAD server: %s\n",
+  "client.active_plugin_line": "Aktif plugin: %s\n",
+  "client.stop_hint": "Durdurmak için Ctrl+C.",
+  "client.logs_follow": "Teknik loglar aşağıda; normal kullanımda bu kısmı izlemeniz gerekmez.",
   "common.error_line": "Hata: %v\n\n",
   "common.runtime_line": "Çalışma dizini: %s\n",
   "config.template_load_failed": "template config okunamadı (%s): %w",
@@ -72,6 +79,12 @@
   "protocol.unsupported": "desteklenmeyen protokol: %s",
   "public.auth_header_line": "Auth header: %s\n",
   "public.auth_token_line": "Auth token: %s\n",
+  "public.share_header": "Arkadaşına/client tarafına şu bilgileri verin:",
+  "public.client_endpoint_line": "  ROAD adresi: %s\n",
+  "public.client_token_line": "  Auth token: %s\n",
+  "public.client_plugin_line": "  Plugin: %s\n",
+  "public.host_header": "Host tarafı:",
+  "public.advanced_header": "Teknik bilgiler:",
   "public.choice_1_4_default_1": "Seçim (1-4, varsayılan: 1): ",
   "public.client_config_line": "Client config: %s\n",
   "public.cloudflare_mode": "Cloudflare modu:",
@@ -127,6 +140,7 @@
   "cloudflared.tunnel_reuse_prompt": "Mevcut tunnel yeniden kullanılsın mı?",
   "cloudflared.tunnel_reusing_uuid": "Mevcut tunnel kullanılıyor: %s\n",
   "cloudflared.tunnel_url_wait": "Tunnel URL bekleniyor",
+  "cloudflared.tunnel_url_ready": "Tunnel başladı: %s\n",
   "cloudflared.tunnel_uuid_missing": "Uyarı: tunnel UUID bulunamadı, isim ile devam edilecek.",
   "runtime.generated_config_dir_failed": "generated config klasörü oluşturulamadı: %w",
   "runtime.marshal_failed": "%s yazılamadı: %w",