diff --git a/viewer-core/examples/headless_check.rs b/viewer-core/examples/headless_check.rs
index 9a8adf7..f009c88 100644
--- a/viewer-core/examples/headless_check.rs
+++ b/viewer-core/examples/headless_check.rs
@@ -50,13 +50,15 @@ async fn main() -> Result<()> {
         .transpose()?
         .unwrap_or(47800);
     let code = arg("--code").unwrap_or_else(|| "123456".into());
+    // --host：默认 127.0.0.1；填局域网 IP 可顺带验证防火墙入站路径
+    let host = arg("--host").unwrap_or_else(|| "127.0.0.1".into());
     let frames_wanted: u64 = arg("--frames")
         .map(|s| s.parse())
         .transpose()?
         .unwrap_or(60);
 
-    let mut session = Session::connect(ConnectConfig::direct("127.0.0.1", port, code)).await?;
-    println!("[check] 连接成功 peer={}", session.peer_addr());
+    let mut session = Session::connect(ConnectConfig::direct(&host, port, code)).await?;
+    println!("[check] 连接成功 host={host} peer={}", session.peer_addr());
 
     let mut decoder = openh264::decoder::Decoder::new()?;
     let mut last_seq: Option<u64> = None;