easy-web

浏览器认证 CLI 工具 — 捕获登录 Cookie，在终端自动化执行需要认证的 API 调用

Go 1.22+ macOS · Linux · Windows MIT CGO_ENABLED=0

一键安装

Terminal 指南

手动安装

macOS 授权

macOS

Linux

Windows

curl -sSL https://smilemilks2021.github.io/easy-web/install.sh | sh

Terminal

$ curl -sSL https://smilemilks2021.github.io/easy-web/install.sh | sh

Detecting system: darwin/arm64

Downloading easy-web v0.2.0 for darwin/arm64...

██████████████████████████████ 100%

✓ Installed to /usr/local/bin/easy-web

✓ easy-web v0.2.0 ready

$ easy-web version

easy-web v0.2.0 darwin/arm64 (build: abc1234)

运行安装脚本

打开 Terminal，粘贴并执行以下命令：

Terminal — zsh

$ curl -sSL https://smilemilks2021.github.io/easy-web/install.sh | sh

Detecting system: darwin/arm64

Downloading easy-web v0.2.0...

✓ Installed to /usr/local/bin/easy-web

# 验证安装

$ easy-web version

easy-web v0.2.0 darwin/arm64

# 初始化配置（可选）

$ easy-web init

✓ Config written to ~/.easy-web.yaml

macOS 用户：首次运行授权

若提示"无法验证开发者"，请切换到 macOS 授权 标签页查看授权方法。

开始使用

easy-web -u https://your-site.com 即可登录并捕获 Cookie。

前往 GitHub Releases 下载

访问 github.com/smilemilks2021/easy-web/releases，下载对应平台的压缩包。

文件名对照

easy-web_darwin_arm64.tar.gz — macOS M 系列
easy-web_darwin_amd64.tar.gz — macOS Intel
easy-web_linux_amd64.tar.gz — Linux x86_64
easy-web_linux_arm64.tar.gz — Linux ARM64
easy-web_windows_amd64.zip — Windows 64-bit

解压并放入 PATH

macOS / Linux：解压后将 easy-web 移至 /usr/local/bin/
Windows：解压后将目录添加到系统 PATH，或直接在解压目录下运行。

Terminal — 手动安装示例

# macOS arm64 示例

$ tar -xzf easy-web_darwin_arm64.tar.gz

$ sudo mv easy-web /usr/local/bin/

$ chmod +x /usr/local/bin/easy-web

$ easy-web version

easy-web v0.2.0 darwin/arm64

🛡️

"easy-web" 无法打开，因为无法验证开发者。

macOS 无法验证此 App 是否包含恶意软件。

首次运行时 macOS 可能弹出此提示。选择"好"后，按以下步骤完成授权：

方法一：命令行解除隔离（推荐）

运行一次 xattr 命令，永久解除限制：

Terminal

$ xattr -d com.apple.quarantine /usr/local/bin/easy-web

$ easy-web version

easy-web v0.2.0 darwin/arm64

方法二：系统设置 → 隐私与安全

在弹窗点击"好"后，前往 系统设置 → 隐私与安全，找到"easy-web 被阻止"的提示，点击 "仍然允许"。

核心功能

专为需要登录认证的内部系统和 Web 控制台设计

🔐

5 种认证模式

auto、chromedp、browser、chrome、remote — 覆盖从全自动到手动登录的各类场景。

📡

API 录制

自动捕获页面发出的所有 API 请求，支持 URL 路径过滤，帮助发现未公开的内部接口。

⚡

带认证的 HTTP 请求

将缓存的 Cookie 注入 GET / POST / PUT / DELETE 请求，等同于自带完整认证的 curl。

🗝️

Token 提取

从请求头、localStorage 或 sessionStorage 中自动提取 Token 并缓存到本地。

🔗

多步骤 SSO 认证

通过 YAML 配置链式认证流程：浏览器登录 → Token 交换 → 最终鉴权，支持复杂企业 SSO。

🔄

自动更新

内置 easy-web selfupdate，通过 GitHub Releases 随时更新到最新版本。

认证模式对照

根据目标站点选择最合适的模式

模式	参数	说明
auto（默认）	`—`	缓存 → Chrome DB → 无头 Chromium（含 JWT 过期检测），推荐首选
chromedp	`-m chromedp`	启动无头 Chromium 自动化登录
browser	`-m browser`	打开可见浏览器，手动操作完成登录
chrome	`-m chrome`	读取本机 Chrome Cookie DB（kooky 跨平台解密，无需启动浏览器）
remote	`-m remote`	通过 CDP WebSocket 连接已运行的 Chrome

命令速查

常用命令一览

命令	功能
`easy-web -u <url>`	登录并捕获 Cookie（auto 模式）
`easy-web -m browser -u <url>`	可见浏览器，手动登录
`easy-web capture -u <url> -p /api/ --auto-save`	录制页面 API 请求
`easy-web request -u <url>`	GET 请求（自动注入 Cookie）
`easy-web request -u <url> -X POST -d '{}'`	POST 请求带 JSON Body
`easy-web cache list`	列出所有已缓存的域名
`easy-web cache clear -d <domain>`	清除指定域名的缓存
`easy-web auth --name <flow>`	执行命名的多步骤认证流
`easy-web chromium download`	下载内置 Chromium
`easy-web init`	生成 ~/.easy-web.yaml 默认配置
`easy-web selfupdate`	更新到最新版本
`easy-web version`	显示版本、平台、Git commit