Feat/configurable bind host (#402)
* feat: configurable bind host for WebUI and langgraph dev (refs #400) WebUI mode was only reachable from the machine running it: the front-end got no bind interface, and `start_langgraph_dev(...)` was called without a host, so both servers stayed on loopback with no way to widen them. Adds two config fields with deliberately different defaults: webui_host = 0.0.0.0 front-end serves the app shell, no secrets langgraph_dev_host = 127.0.0.1 unauthenticated API, agent can run shell The design hinges on separating bind address from client address. Only bind() uses the configured interface; every consumer that *connects* (health probes, occupancy checks, async sub-agent self-dispatch) goes through the new `_probe_host`, which maps a wildcard bind back to loopback and honors a pinned interface verbatim. `_can_bind_port` is the one exception and binds the literal host, since it must replicate the bind the server itself will attempt. - manager.py: `_probe_host`, `_is_loopback_host`, `_format_hostport`; host kwarg threaded through the probes and `start_langgraph_dev`, which now emits `--host` and propagates EVOSCIENTIST_LANGGRAPH_DEV_HOST to the subprocess - sdk.py: `langgraph_dev_url` tracks host as well as port; EvoScientist.py reuses it instead of an inline f-string - server.py: `--host` flag mirroring `--port`, plus a red PUBLIC BIND banner whenever the bind is not provably loopback - webui.py: forwards both hosts; the front-end is widened via HOSTNAME because @evoscientist/webui ships no --host flag — its bin launcher does `HOSTNAME: process.env.HOSTNAME || "127.0.0.1"`. The warning is gated on the backend host only, so the shipped front-end default doesn't print a banner on every launch Verified end to end against a live server: requesting 0.0.0.0 yields a socket listening on 0.0.0.0 with the health probe correctly resolved to 127.0.0.1, while the default still binds 127.0.0.1 only. Note: webui_host defaulting to 0.0.0.0 is a behavior change — upgrading users will find the front-end reachable from the LAN. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> * feat: default both bind hosts to 0.0.0.0, add --host and wizard host rendering (closes #400) Completes the remaining items from #400. - `langgraph_dev_host` now defaults to 0.0.0.0, matching `webui_host`. Remote WebUI use needs both anyway (the UI reaches the backend from the browser, not server-side), so a loopback backend default just meant every remote user hit a silently failing UI. `_DEFAULT_HOST` and sdk's `DEFAULT_LANGGRAPH_DEV_HOST` follow, so there is one story about where these servers listen. SECURITY: this exposes an unauthenticated API whose agent can run shell commands. The red PUBLIC BIND banner consequently fires on every launch while exposed — kept deliberately, since the exposure is real and the escape hatch (`--host 127.0.0.1` / `config set langgraph_dev_host`) is only discoverable if we say so. READMEs now lead with the warning and document the SSH-tunnel alternative. - `EvoSci --host <ip>` on the WebUI launch path, driving both servers. In WebUI mode they are two halves of one surface; moving only one leaves the UI loading but unable to reach the agent. Blank values are dropped rather than written as an empty override that would beat the config file. - Onboarding wizard no longer prints hard-coded `http://127.0.0.1:{port}` / `http://localhost:{port}` (steps.py:160, :223) — both render the configured bind through `_base_url` / `_format_hostport`, so a pinned interface is reported honestly and a wildcard still shows loopback. Verified against a live server: with no host argument at all, resolution through EvoScientistConfig yields a socket listening on 0.0.0.0, a client URL of http://127.0.0.1, and the warning gate returning True. Still open and tracked separately: the front-end takes its backend URL from browser input: `@evoscientist/webui` reads only HOSTNAME, PORT and EVOSCIENTIST_LANGGRAPH_DEV_PORT, so advertising a backend URL needs a change in that repo. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> * ci: bump setup-uv v6 -> v9.0.0 to drop the deprecated node20 runtime GitHub now warns that setup-uv@v6 targets Node.js 20 and is being forced onto Node.js 24. v7.0.0 is the release that made that switch, so anything >= v7 clears the warning; v9.0.0 is current. Pinned to the full tag deliberately: setup-uv stopped publishing major and minor tags in v8.0.0 as supply-chain hardening, so `@v9` and `@v8` return 404 and would fail the job outright. Releases are immutable from v8 on, so the full tag is as tamper-proof as a SHA. Comment left in lint.yml because "simplifying" this back to `@v9` is an easy and CI-breaking mistake. actions/checkout@v5 is already node24 and needs no change. Note: v9.0.0 flips the `prune-cache` default to false (upstream did this to ease load on PyPI infrastructure). None of these workflows set it, so they follow the new default and Actions cache usage may grow. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> * fix(cli): correct --host help text and warn on public bind in non-WebUI modes The --host help claimed "WebUI mode only", which is wrong in a way that matters for security. `--host` writes `langgraph_dev_host` unconditionally, and `_ensure_async_subagent_server` auto-starts that backend for tui / cli / serve as well — the langgraph dev server is shared across UI modes. So the flag narrows or widens the agent API in every mode, and only `webui_host` is actually WebUI-specific. Reported against cli/commands.py. The documentation error hid a real gap: the PUBLIC BIND banner lived only in deploy/server.py and deploy/webui.py, so a plain `EvoSci` session bound 0.0.0.0 with no runtime signal whatsoever — and `--help` is opt-in, so fixing the text alone would not surface it. Added the same banner to the shared CLI path, gated on `is_async_subagents_available()`: ensure_langgraph_dev fails soft (async degrades to in-process delegation), and warning about a bind that never happened would be worse than staying quiet. READMEs (EN + zh-CN) get the same correction — the warning block sat inside the Desktop WebUI section and read as WebUI-scoped. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> * fix(deploy): strip the config-derived bind host, not just the CLI one `deploy()` only stripped the `--host` branch. When the flag was omitted, `getattr(config, "langgraph_dev_host", ...)` flowed unstripped into `_is_port_occupied`, `is_langgraph_dev_running`, `start_langgraph_dev` and the banner. `run_webui` already strips unconditionally; this aligns the two. Reachable because `deploy()` reads through `getattr` and is routinely handed duck-typed config objects (tests, embedders) that never run `EvoScientistConfig.__post_init__`, which is what normally normalizes these fields. Worst case was not just a bad bind: `_is_loopback_host(" 127.0.0.1 ")` is False, so a padded loopback value would print a false PUBLIC BIND warning while binding a string socket.bind() rejects outright — a security banner saying the opposite of the truth. Three regression tests added, each verified to fail against the old code. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> * style: apply ruff format to the bind-host changes The Lint workflow runs both `ruff check` and `ruff format --check`; I had only been running the former locally, so five files landed unformatted and failed CI. Whitespace and line-wrapping only — no semantic change. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> * fix(security): keep the langgraph dev backend on loopback by default The backend is an unauthenticated API whose agent can run shell commands, and it is auto-started in every UI mode (tui/cli/webui/serve/deploy) — so a 0.0.0.0 default put it on the network for users who never asked. Restore 127.0.0.1 as the default and make 0.0.0.0 an explicit opt-in. webui_host keeps its 0.0.0.0 default: the front-end serves the app shell only and holds no credentials. run_webui already prints a remote-backend hint when the front-end is exposed and the backend is not. Help text and both READMEs are reframed around widening rather than narrowing; the escape-hatch tests are inverted to assert the public-bind opt-in survives into argv. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> --------- Co-authored-by: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
Xiaohui Yan
@@ -46,6 +46,13 @@ def deploy(
|
||||
"--port",
|
||||
help="Port for langgraph dev (default: config.langgraph_dev_port = 6174)",
|
||||
),
|
||||
host: str | None = typer.Option(
|
||||
None,
|
||||
"--host",
|
||||
help="Interface to bind (default: config.langgraph_dev_host = "
|
||||
"127.0.0.1, i.e. this machine only — pass 0.0.0.0 to reach it from "
|
||||
"other machines, but note the server has no auth)",
|
||||
),
|
||||
tunnel: bool = typer.Option(
|
||||
False,
|
||||
"--tunnel",
|
||||
@@ -66,8 +73,11 @@ def deploy(
|
||||
"""
|
||||
from ..config import apply_config_to_env, get_effective_config
|
||||
from ..langgraph_dev.manager import (
|
||||
_DEFAULT_HOST,
|
||||
_DEFAULT_PORT,
|
||||
RUNTIME,
|
||||
_base_url,
|
||||
_is_loopback_host,
|
||||
_is_port_occupied,
|
||||
is_langgraph_dev_running,
|
||||
read_tunnel_url,
|
||||
@@ -114,12 +124,27 @@ def deploy(
|
||||
)
|
||||
raise typer.Exit(1)
|
||||
|
||||
# Same explicit-None resolution for the bind interface. Both branches strip
|
||||
# (matching run_webui): whitespace reaching socket.bind() surfaces as an
|
||||
# opaque gaierror, and an all-whitespace value collapses to the default
|
||||
# rather than erroring. The config branch needs it too even though
|
||||
# ``EvoScientistConfig.__post_init__`` normalizes these fields — this
|
||||
# function reads via ``getattr`` and is routinely handed duck-typed config
|
||||
# objects, which never run that normalization.
|
||||
effective_host = (
|
||||
str(
|
||||
getattr(config, "langgraph_dev_host", _DEFAULT_HOST) or _DEFAULT_HOST
|
||||
).strip()
|
||||
if host is None
|
||||
else host.strip()
|
||||
) or _DEFAULT_HOST
|
||||
|
||||
# 4. Pre-flight port check — refuse to start if a non-EvoSci process is
|
||||
# holding the port. If an existing EvoSci langgraph dev is already up,
|
||||
# also refuse (deploy is the "primary server" — running multiple on the
|
||||
# same port is a configuration error).
|
||||
if _is_port_occupied(effective_port):
|
||||
if is_langgraph_dev_running(port=effective_port):
|
||||
if _is_port_occupied(effective_port, effective_host):
|
||||
if is_langgraph_dev_running(port=effective_port, host=effective_host):
|
||||
console.print(
|
||||
f"[red]Port {effective_port} is already serving a langgraph dev "
|
||||
f"instance.[/red]"
|
||||
@@ -144,6 +169,7 @@ def deploy(
|
||||
Panel(
|
||||
Text.from_markup(
|
||||
f"[bold]Workspace:[/bold] {_shorten(ws)}\n"
|
||||
f"[bold]Host:[/bold] {effective_host}\n"
|
||||
f"[bold]Port:[/bold] {effective_port}\n"
|
||||
f"[bold]Auth:[/bold] {_auth_label}"
|
||||
),
|
||||
@@ -162,6 +188,13 @@ def deploy(
|
||||
f"[bold red]{DANGEROUS_BANNER_MESSAGE}[/bold red]"
|
||||
)
|
||||
|
||||
if not _is_loopback_host(effective_host):
|
||||
console.print(
|
||||
"[bold white on red] ⚠ PUBLIC BIND [/bold white on red] "
|
||||
f"[bold red]Listening on {effective_host} — no auth, and the agent "
|
||||
f"can run shell. Trusted networks only.[/bold red]"
|
||||
)
|
||||
|
||||
if tunnel:
|
||||
console.print(
|
||||
"[bold white on red] ⚠ PUBLIC TUNNEL [/bold white on red] "
|
||||
@@ -197,6 +230,7 @@ def deploy(
|
||||
proc = start_langgraph_dev(
|
||||
workspace_dir=Path(ws),
|
||||
port=effective_port,
|
||||
host=effective_host,
|
||||
file_persistence=file_persistence,
|
||||
jobs_per_worker=jobs_per_worker,
|
||||
deploy_mode=True,
|
||||
@@ -236,7 +270,7 @@ def deploy(
|
||||
Panel(
|
||||
Text.from_markup(
|
||||
f"[bold]Endpoint:[/bold] "
|
||||
f"http://localhost:{effective_port}\n"
|
||||
f"{_base_url(effective_port, effective_host)}\n"
|
||||
f"{public_line}"
|
||||
f"[bold]Assistant ID:[/bold] EvoScientist\n"
|
||||
f"[bold]Connect via:[/bold] any LangChain SDK / "
|
||||
|
||||
@@ -42,6 +42,7 @@ from ..stream.console import console
|
||||
# Front-end npm package + spec. ``@latest`` → always the newest published UI.
|
||||
_WEBUI_PACKAGE = "@evoscientist/webui@latest"
|
||||
_DEFAULT_WEBUI_PORT = 4716
|
||||
_DEFAULT_WEBUI_HOST = "0.0.0.0"
|
||||
|
||||
|
||||
def run_webui(config: Any, workspace_dir: str | None = None) -> None:
|
||||
@@ -58,8 +59,12 @@ def run_webui(config: Any, workspace_dir: str | None = None) -> None:
|
||||
"""
|
||||
from ..config import apply_config_to_env
|
||||
from ..langgraph_dev.manager import (
|
||||
_DEFAULT_HOST,
|
||||
_DEFAULT_PORT,
|
||||
RUNTIME,
|
||||
_base_url,
|
||||
_format_hostport,
|
||||
_is_loopback_host,
|
||||
_is_port_occupied,
|
||||
_read_workspace_sidecar,
|
||||
is_langgraph_dev_running,
|
||||
@@ -84,6 +89,15 @@ def run_webui(config: Any, workspace_dir: str | None = None) -> None:
|
||||
# webui_port = the local Next.js server the browser actually opens.
|
||||
backend_port = int(getattr(config, "langgraph_dev_port", _DEFAULT_PORT))
|
||||
webui_port = int(getattr(config, "webui_port", _DEFAULT_WEBUI_PORT))
|
||||
# ...and their bind interfaces. The defaults deliberately differ: the
|
||||
# front-end is exposed (it serves the app shell and holds no credentials),
|
||||
# the backend is not (unauthenticated API, agent can run shell).
|
||||
backend_host = (
|
||||
str(getattr(config, "langgraph_dev_host", _DEFAULT_HOST) or _DEFAULT_HOST)
|
||||
).strip() or _DEFAULT_HOST
|
||||
webui_host = (
|
||||
str(getattr(config, "webui_host", _DEFAULT_WEBUI_HOST) or _DEFAULT_WEBUI_HOST)
|
||||
).strip() or _DEFAULT_WEBUI_HOST
|
||||
for label, p in (("langgraph dev", backend_port), ("WebUI", webui_port)):
|
||||
if not (1 <= p <= 65535):
|
||||
console.print(
|
||||
@@ -128,8 +142,8 @@ def run_webui(config: Any, workspace_dir: str | None = None) -> None:
|
||||
# else start a fresh deploy-mode one (full MCP + async). Refuse a foreign
|
||||
# occupant — that's a configuration error, not something to silently share.
|
||||
started_proc = None
|
||||
if _is_port_occupied(backend_port):
|
||||
if is_langgraph_dev_running(port=backend_port):
|
||||
if _is_port_occupied(backend_port, backend_host):
|
||||
if is_langgraph_dev_running(port=backend_port, host=backend_host):
|
||||
# Reuse an existing EvoSci server only when it serves THIS workspace
|
||||
# — mirror the sidecar guard in ensure_langgraph_dev so WebUI started
|
||||
# from workspace B never silently binds to a server pinned to
|
||||
@@ -174,6 +188,7 @@ def run_webui(config: Any, workspace_dir: str | None = None) -> None:
|
||||
started_proc = start_langgraph_dev(
|
||||
workspace_dir=Path(ws),
|
||||
port=backend_port,
|
||||
host=backend_host,
|
||||
file_persistence=file_persistence,
|
||||
jobs_per_worker=jobs_per_worker,
|
||||
deploy_mode=True,
|
||||
@@ -184,7 +199,7 @@ def run_webui(config: Any, workspace_dir: str | None = None) -> None:
|
||||
raise typer.Exit(1) from exc
|
||||
console.print("[green]✓[/green] langgraph dev ready")
|
||||
|
||||
if _is_port_occupied(webui_port):
|
||||
if _is_port_occupied(webui_port, webui_host):
|
||||
console.print(
|
||||
f"[yellow]⚠ Port {webui_port} is already in use; the WebUI server "
|
||||
f"may fail to start. Change it with "
|
||||
@@ -197,20 +212,41 @@ def run_webui(config: Any, workspace_dir: str | None = None) -> None:
|
||||
# inherited so it all shows in THIS terminal. EVOSCIENTIST_LANGGRAPH_DEV_PORT
|
||||
# lets the UI's config prefill point at our backend automatically. Secrets
|
||||
# are scrubbed — the browser UI never needs LLM provider API keys.
|
||||
#
|
||||
# HOSTNAME is the front-end's bind knob: the package ships no --host flag,
|
||||
# and its bin launcher passes `HOSTNAME: process.env.HOSTNAME || "127.0.0.1"`
|
||||
# through to the Next standalone server. Setting it here is therefore the
|
||||
# only supported way to widen the front-end's interface.
|
||||
webui_env = _scrubbed_env(
|
||||
{
|
||||
"EVOSCIENTIST_LANGGRAPH_DEV_PORT": str(backend_port),
|
||||
"PORT": str(webui_port),
|
||||
"HOSTNAME": webui_host,
|
||||
}
|
||||
)
|
||||
# The UI connects to the backend from the BROWSER, not server-side, so a
|
||||
# remote visitor needs a backend address that resolves on *their* machine.
|
||||
# Spell that out when the front-end is exposed but the backend isn't —
|
||||
# otherwise the page loads and every request silently fails.
|
||||
remote_backend_hint = ""
|
||||
if not _is_loopback_host(webui_host) and _is_loopback_host(backend_host):
|
||||
remote_backend_hint = (
|
||||
f"\n[yellow]Note:[/yellow] the UI connects to the backend from the "
|
||||
f"browser. Remote visitors cannot reach a loopback backend — run "
|
||||
f"[bold]EvoSci config set langgraph_dev_host 0.0.0.0[/bold] and "
|
||||
f"point the UI at [bold]http://<this-machine-ip>:{backend_port}"
|
||||
f"[/bold].\n"
|
||||
)
|
||||
console.print(
|
||||
Panel(
|
||||
Text.from_markup(
|
||||
f"[bold]Backend:[/bold] http://localhost:{backend_port} "
|
||||
f"[bold]Backend:[/bold] {_base_url(backend_port, backend_host)} "
|
||||
f"[dim](langgraph dev — Assistant: EvoScientist)[/dim]\n"
|
||||
f"[bold]WebUI:[/bold] http://localhost:{webui_port} "
|
||||
f"[bold]WebUI:[/bold] "
|
||||
f"http://{_format_hostport(webui_host, webui_port)} "
|
||||
f"[dim](opens in your browser)[/dim]\n"
|
||||
f"[bold]Logs:[/bold] {_shorten(str(RUNTIME.log_file))}\n\n"
|
||||
f"[bold]Logs:[/bold] {_shorten(str(RUNTIME.log_file))}\n"
|
||||
f"{remote_backend_hint}\n"
|
||||
f"[dim]Fetching {_WEBUI_PACKAGE} via npx (first run may take a "
|
||||
f"moment)… Press Ctrl+C to stop.[/dim]"
|
||||
),
|
||||
@@ -218,6 +254,12 @@ def run_webui(config: Any, workspace_dir: str | None = None) -> None:
|
||||
border_style="green",
|
||||
)
|
||||
)
|
||||
if not _is_loopback_host(backend_host):
|
||||
console.print(
|
||||
"[bold white on red] ⚠ PUBLIC BIND [/bold white on red] "
|
||||
f"[bold red]Backend listening on {backend_host} — no auth, and the "
|
||||
f"agent can run shell. Trusted networks only.[/bold red]"
|
||||
)
|
||||
|
||||
popen_kwargs: dict[str, Any] = {"env": webui_env}
|
||||
if os.name == "posix":
|
||||
|
||||
Reference in New Issue
Block a user