---
title: "Discovery and page verification"
description: "How LocalStack discovers local HTML services and why some ports do not appear in the list."
---

> Documentation Index
> Fetch the complete documentation index at: https://localstack.pwp.sh/llms.txt
> Use this file to discover all available pages before exploring further.

# Discovery and page verification

LocalStack 关心的是可在浏览器中打开的开发页面。服务通过自动发现或主动注册进入验证流程，最终都由同一个 Coordinator 判断。

## 自动发现

1. 枚举当前用户启动的 TCP 监听进程。
2. 在 loopback 地址上检查候选 HTTP 服务。
3. 独立确认页面返回可浏览的 HTML，并验证进程身份与端口归属。
4. 将有效服务合并到注册表，持续检查健康状态。

普通本地 HTTP 开发服务器只要能返回 HTML，就可以被发现，不限定于特定前端框架。

## 主动注册

[Vite 插件与 SDK](/docs/vite)、[CLI and MCP](/docs/cli) 可以提交 PID、端口、名称和项目路径。注册请求不能跳过页面和进程验证。

SDK 和插件使用有期限的租约维护注册状态。插件自动发送 heartbeat，并在 Coordinator 重启后重新注册；开发服务器关闭时会尝试注销。

## 为什么站点没有出现？

依次检查：

- **页面是否能打开？** 在浏览器中直接访问本地 HTTP URL，确认服务已经启动完成。
- **返回的是 HTML 吗？** 只有 JSON 的 API、数据库、消息队列和普通 TCP 端口不在默认列表中。
- **是不是当前用户的进程？** 其他用户运行的服务不在发现范围。
- **地址是否是本机 loopback？** LAN 地址或远程站点不在发现范围。注册接口接受 `http://localhost`、`http://127.0.0.1` 与 `http://[::1]`；不支持 HTTPS 注册。
- **Coordinator 是否在线？** 启动 LocalStack 应用；如果安装了 CLI，运行 `localstack status` 查看状态。

服务启动后可以在面板按 `⌘ R` 刷新。Vite 项目需要自定义名称或非根路径时，可以使用 [插件配置](/docs/vite)。

Source: https://localstack.pwp.sh/docs/en/discovery