feat(cli): add --host support (#253)

* feat: add --host

* feat: add --host to msb

* chore: add constant defines

Author: Sun-ZhenXing

microsandbox-cli/bin/msb/handlers.rs

@@ -423,14 +423,15 @@ pub async fn clean_subcommand(
 }
 
 pub async fn server_start_subcommand(
+    host: Option<String>,
     port: Option<u16>,
     namespace_dir: Option<PathBuf>,
     dev_mode: bool,
     key: Option<String>,
     detach: bool,
     reset_key: bool,
 ) -> MicrosandboxCliResult<()> {
-    microsandbox_server::start(key, port, namespace_dir, dev_mode, detach, reset_key).await?;
+    microsandbox_server::start(key, host, port, namespace_dir, dev_mode, detach, reset_key).await?;
     Ok(())
 }
 

microsandbox-cli/bin/msb/main.rs

@@ -219,6 +219,7 @@ async fn main() -> MicrosandboxCliResult<()> {
         }
         Some(MicrosandboxSubcommand::Server { subcommand }) => match subcommand {
             ServerSubcommand::Start {
+                host,
                 port,
                 namespace_dir,
                 dev_mode,
@@ -227,6 +228,7 @@ async fn main() -> MicrosandboxCliResult<()> {
                 reset_key,
             } => {
                 handlers::server_start_subcommand(
+                    host,
                     port,
                     namespace_dir,
                     dev_mode,

microsandbox-cli/bin/msbserver.rs

@@ -35,6 +35,7 @@ pub async fn main() -> MicrosandboxCliResult<()> {
     // Create configuration from arguments
     let config = Arc::new(Config::new(
         args.key,
+        args.host,
         args.port,
         args.namespace_dir.clone(),
         args.dev_mode,

microsandbox-cli/lib/args/msb.rs

@@ -608,6 +608,10 @@ pub enum MicrosandboxSubcommand {
 pub enum ServerSubcommand {
     /// Start the sandbox server which is also an MCP server
     Start {
+        /// Host to listen on
+        #[arg(long)]
+        host: Option<String>,
+
         /// Port to listen on
         #[arg(long)]
         port: Option<u16>,

microsandbox-cli/lib/args/msbserver.rs

@@ -1,7 +1,7 @@
 use std::path::PathBuf;
 
 use clap::Parser;
-use microsandbox_utils::DEFAULT_SERVER_PORT;
+use microsandbox_utils::{DEFAULT_SERVER_HOST, DEFAULT_SERVER_PORT};
 
 use crate::styles;
 
@@ -17,6 +17,10 @@ pub struct MsbserverArgs {
     #[arg(short = 'k', long = "key")]
     pub key: Option<String>,
 
+    /// Host address to listen on
+    #[arg(long, default_value = DEFAULT_SERVER_HOST)]
+    pub host: String,
+
     /// Port number to listen on
     #[arg(long, default_value_t = DEFAULT_SERVER_PORT)]
     pub port: u16,

microsandbox-server/lib/config.rs

@@ -12,13 +12,13 @@
 //! - Environment-based configuration loading
 //! - Namespace directory management
 
-use std::{net::SocketAddr, path::PathBuf};
+use std::{net::{IpAddr, SocketAddr}, path::PathBuf};
 
 use getset::Getters;
 use microsandbox_utils::{env, NAMESPACES_SUBDIR};
 use serde::Deserialize;
 
-use crate::{port::LOCALHOST_IP, MicrosandboxServerError, MicrosandboxServerResult};
+use crate::{MicrosandboxServerError, MicrosandboxServerResult};
 
 //--------------------------------------------------------------------------------------------------
 // Constants
@@ -45,6 +45,12 @@ pub struct Config {
     /// Whether to run the server in development mode
     dev_mode: bool,
 
+    /// Host address to listen on
+    host: IpAddr,
+
+    /// Port number to listen on
+    port: u16,
+
     /// Address to listen on
     addr: SocketAddr,
 }
@@ -57,6 +63,7 @@ impl Config {
     /// Create a new configuration
     pub fn new(
         key: Option<String>,
+        host: String,
         port: u16,
         namespace_dir: Option<PathBuf>,
         dev_mode: bool,
@@ -72,14 +79,21 @@ impl Config {
             }
         };
 
-        let addr = SocketAddr::new(LOCALHOST_IP, port);
+        // Parse host string to IpAddr
+        let host_ip: IpAddr = host.parse().map_err(|_| {
+            MicrosandboxServerError::ConfigError(format!("Invalid host address: {}", host))
+        })?;
+
+        let addr = SocketAddr::new(host_ip, port);
         let namespace_dir = namespace_dir
             .unwrap_or_else(|| env::get_microsandbox_home_path().join(NAMESPACES_SUBDIR));
 
         Ok(Self {
             key,
             namespace_dir,
             dev_mode,
+            host: host_ip,
+            port,
             addr,
         })
     }

microsandbox-server/lib/management.rs

@@ -71,6 +71,7 @@ pub struct Claims {
 /// Start the sandbox server
 pub async fn start(
     key: Option<String>,
+    host: Option<String>,
     port: Option<u16>,
     namespace_dir: Option<PathBuf>,
     dev_mode: bool,
@@ -143,6 +144,10 @@ pub async fn start(
         command.arg("--dev");
     }
 
+    if let Some(host) = host {
+        command.arg("--host").arg(host);
+    }
+
     if let Some(port) = port {
         command.arg("--port").arg(port.to_string());
     }

microsandbox-utils/lib/defaults.rs

@@ -69,6 +69,9 @@ pub const DEFAULT_WORKDIR: &str = "/";
 /// The default namespace for the sandbox server.
 pub const DEFAULT_SERVER_NAMESPACE: &str = "default";
 
+/// The default localhost address.
+pub const DEFAULT_SERVER_HOST: &str = "127.0.0.1";
+
 /// The default microsandbox-server port.
 pub const DEFAULT_SERVER_PORT: u16 = 5555;