Skip to content

Never stop coding. Free MIT AI gateway: one endpoint, 375 providers (150+ free), 1,400+ models Kimi, Claude, GPT, Gemini, GLM, DeepSeek, MiniMax. Works with Claude Code, Codex, Cursor, OpenCode, Cline & Copilot. Quota-aware auto-fallback, RTK+Caveman compression saves 15-95% tokens, MCP/A2A, Desktop/PWA. Built by 900+ contributors

3.0 KB
Raw Blame
import test from "node:test";
import assert from "node:assert/strict";
import { resolveServerHost, resolveExposureWarning } from "../../bin/cli/utils/serverHost.mjs";

test("serve hostname: Linux honors OMNIROUTE_SERVER_HOST when HOSTNAME is set", () => {
  assert.equal(
    resolveServerHost(
      { OMNIROUTE_SERVER_HOST: "127.0.0.1", HOSTNAME: "fedora" },
      "linux",
      "localhost-live"
    ),
    "127.0.0.1"
  );
});

test("serve hostname: OMNIROUTE_SERVER_HOST overrides the Windows legacy HOSTNAME", () => {
  assert.equal(
    resolveServerHost(
      { OMNIROUTE_SERVER_HOST: "127.0.0.1", HOSTNAME: "192.168.1.50" },
      "win32",
      "windows-pc"
    ),
    "127.0.0.1"
  );
});

test("serve hostname: Linux ignores HOSTNAME when it differs from os.hostname() (#10492)", () => {
  // Fedora can export a short HOSTNAME while os.hostname() reports a different
  // canonical name. The standard shell variable must never become the bind host.
  assert.equal(resolveServerHost({ HOSTNAME: "fedora" }, "linux", "localhost-live"), "0.0.0.0");
});

test("serve hostname: macOS ignores HOSTNAME even when it matches os.hostname() (#6194)", () => {
  assert.equal(resolveServerHost({ HOSTNAME: "myhostname" }, "darwin", "myhostname"), "0.0.0.0");
});

test("serve hostname: falls back to 0.0.0.0 when no bind variable is set", () => {
  assert.equal(resolveServerHost({}, "linux", "myhostname"), "0.0.0.0");
});

test("serve hostname: falls back to 0.0.0.0 when bind variables are empty", () => {
  assert.equal(
    resolveServerHost({ OMNIROUTE_SERVER_HOST: "", HOSTNAME: "" }, "linux", "myhostname"),
    "0.0.0.0"
  );
});

test("serve hostname: Windows preserves an explicit legacy HOSTNAME", () => {
  assert.equal(
    resolveServerHost({ HOSTNAME: "192.168.1.50" }, "win32", "windows-pc"),
    "192.168.1.50"
  );
});

test("serve hostname: Windows ignores an auto-set HOSTNAME matching the machine", () => {
  assert.equal(resolveServerHost({ HOSTNAME: "windows-pc" }, "win32", "windows-pc"), "0.0.0.0");
});

test("exposure warning: fires when bound to all interfaces with no API-key requirement (GHSA-wmgv-ph3p-rv57)", () => {
  const warning = resolveExposureWarning({}, "0.0.0.0");
  assert.ok(warning, "a warning must be returned for the shipped default posture");
  assert.match(warning, /REQUIRE_API_KEY/);
  assert.match(warning, /OMNIROUTE_SERVER_HOST/);
});

test("exposure warning: silent when REQUIRE_API_KEY is enabled", () => {
  assert.equal(resolveExposureWarning({ REQUIRE_API_KEY: "true" }, "0.0.0.0"), null);
  assert.equal(resolveExposureWarning({ REQUIRE_API_KEY: "1" }, "0.0.0.0"), null);
});

test("exposure warning: silent on loopback binds", () => {
  assert.equal(resolveExposureWarning({}, "127.0.0.1"), null);
  assert.equal(resolveExposureWarning({}, "localhost"), null);
  assert.equal(resolveExposureWarning({}, "::1"), null);
});

test("exposure warning: fires for a LAN bind too (any non-loopback interface)", () => {
  assert.ok(resolveExposureWarning({}, "192.168.0.17"));
  assert.ok(resolveExposureWarning({}, "::"));
});