静态服务器

技能标识：static-server

Start a local HTTP server to preview static HTML pages. Use when testing static pages, previewing HTML files, or when browser tools cannot access file:// URLs. Provides localhost URL for browser testing.

作者：admin | 来源记录：ClawHub

静态服务器

启动一个Python HTTP服务器，用于在浏览器中预览静态HTML文件。

使用场景

- 测试静态HTML页面
部署前预览网页
浏览器工具阻止file://协议时
需要本地主机URL进行浏览器自动化操作

快速开始

使用内置脚本启动服务器：

bash
python scripts/serve.py <路径> [--port 端口]

参数说明：

- <路径>：文件路径（服务父目录）或目录路径
--port：可选端口号（默认：8000）

示例：

bash

服务特定HTML文件

python scripts/serve.py /path/to/index.html

服务目录

python scripts/serve.py /path/to/project

使用自定义端口

python scripts/serve.py /path/to/index.html --port 9000

输出信息

脚本会打印：

- 访问URL：http://localhost:端口/文件名.html
正在服务的目录
停止说明（Ctrl+C）

测试中的使用

当使用浏览器工具测试静态页面时：

1. 使用exec启动服务器（后台模式）
配合浏览器工具使用本地主机URL
完成测试
终止服务器进程

示例工作流程：

javascript
// 1. 在后台启动服务器
exec({
command: python scripts/serve.py /path/to/index.html --port 8888,
background: true
})

// 2. 在浏览器中打开
browser({
action: open,
targetUrl: http://localhost:8888/index.html
})

// 3. 测试并截图
browser({ action: screenshot, fullPage: true })

// 4. 清理
process({ action: kill, sessionId: ... })
browser({ action: close })

替代方案：单行命令

无需脚本的快速测试方式：

bash
python -m http.server 8000 --directory /path/to/dir

注意：此命令服务的是目录根路径，而非特定文件。

静态服务器