使用指南

01 / 新建站点

准备一个包含 index.html 的文件夹。如果是 React、Vue 等项目，请先完成构建，再选择生成的 dist 等产物目录。

02 / 基础配置：名称、目录与端口

03 / 局域网访问

想在手机上查看页面，或让同事预览作品？在站点配置里开启「局域网访问」，保存并启动后，使用卡片提供的局域网地址。

1. 让电脑和访问设备连接到同一局域网。
2. 开启该站点的「局域网访问」，确保站点处于运行状态。
3. 点击局域网地址，使用另一台设备扫码，或复制链接在其浏览器中打开。

上方 IP 仅为示例，请以应用显示的实际局域网地址为准。

04 / 自定义域名

在站点基础信息的「自定义域名」中填写主机名，例如 myapp.ls。推荐使用 .ls 后缀，不要填写协议、端口或路径。每个站点保存一个域名。

域名映射请求管理员授权

保存、删除或导入配置时，如果域名发生变化，macOS 会请求管理员授权，以便修改 hosts。LocalServe 对 hosts的操作不影响其它域名访问。

域名映射在哪生效？

hosts 映射仅作用于运行 LocalServe 的这台 Mac，其它设备无法访问自定义域名，请使用局域网 IP 地址访问，且仍需带上站点的端口。

备份与还原

在「设置 → 域名与 hosts」中，可以查看托管域名数量。「立即备份」保存当前完整 hosts；「还原到备份」在确认后恢复最近一次备份，操作前请确认备份后的其他 hosts 修改是否需要保留。

05 / 代理转发与路径重写

在站点编辑页的「代理规则」中，将某个路径前缀转发到另一个服务。前端通过同一站点地址请求接口，再由代理转发到目标后端，可以规避浏览器的跨域限制，方便前后端联调；目标后端需要单独运行。

以 /api 转发为例

请求   /api/users
  ↓    去掉 /api 前缀
目标   http://127.0.0.1:3000/users

关闭路径重写时，目标收到的是 /api/users。前缀与目标都填写完整的规则，保存后才会生效。

06 / 高级选项

• SPA history fallback

  没有匹配文件的请求回退到 index.html。使用前端 history 路由时，开启此项可避免刷新子页面出现 404。

• 附加 CORS 响应头

  为静态资源附加跨域响应头，默认关闭。同一站点中的接口请求优先使用代理规则。

• 应用启动时自动运行

  下次打开 LocalServe 时自动启动这个站点。这与应用自身的「开机自启动」是两个独立选项。

07 / 启停、访问与日志

启动、停止与重启

使用站点卡片右侧按钮启停服务。卡片显示「已停止」「启动中」「运行中」或「异常」；异常时会显示具体原因。更多菜单提供重启、编辑、导出配置、在 Finder 中显示目录和删除站点等操作。

访问站点与查看日志

站点运行后，点击地址可查看二维码、复制链接或在浏览器打开。按住 Command（或 Ctrl）点击地址，可直接用浏览器打开。

在站点更多菜单中打开「详情与日志」，查看端口、域名、代理数量和访问链接。日志支持按全部、访问、代理、错误筛选，也可搜索、清空和导出。清空只会清除应用记录的日志。

08 / 导入与导出站点配置

展开站点区域的更多操作，可导入配置或导出全部站点配置。单个站点的更多菜单可单独导出该站点。

配置保存的是站点设置，不包含网站文件。换一台电脑使用时，也需要拷贝网站目录，并确认配置中的目录路径、端口和代理目标在新电脑上可用。导入涉及域名变化时，仍可能请求 hosts 授权。

01 / 添加要分享的文件

点击「新增 → 新增文件」，或文件区域旁的新增按钮，选择要分享的文件。

02 / 局域网扫码下载

1. 选择文件卡片上的二维码入口，打开二维码弹窗
2. 同一局域网中的设备扫码或打开链接，即可下载文件。

http://本机IP:19800/文件名

03 / 文件失效与移除分享

原文件移动或删除后，卡片会显示「文件失效」，请直接删除，重新添加新的文件。如果未检测到局域网 IP，下载地址会不可用。

「移除分享」只会从分享列表移除文件，不会删除磁盘上的原文件。你也可以通过卡片操作在 Finder 中显示原文件。