# browser-workshop

**Repository Path**: hyjiacan/browser-workshop

## Basic Information

- **Project Name**: browser-workshop
- **Description**: 多版本浏览器管理工具，支持本地导入、远程下载、版本切换、隔离运行。
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: https://hyjiacan.github.io/browser-workshop/
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-07-20
- **Last Updated**: 2026-07-23

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Browser Workshop

<p align="center">
  <img src="https://gitee.com/hyjiacan/browser-workshop/raw/master/logo.png" alt="Browser Workshop logo" width="128" />
</p>

<p align="center">
  多版本浏览器管理工具，支持本地导入、远程下载、版本切换、隔离运行。
</p>

## 功能特性

- **多版本管理**：同时安装和管理多个浏览器版本，支持版本前缀快速筛选
- **本地导入**：从目录或压缩包自动识别并导入，支持 25+ 种格式
- **远程下载**：从官方源（Firefox FTP、Chromium GCS）下载指定版本
- **离线分发**：内置 `serve` 命令，支持自动同步，搭建局域网分发服务
- **隔离运行**：每个版本独立 Profile，支持命名 Profile
- **插件系统**：Lua 脚本插件，可在启动时自动修改参数、注入配置、执行自定义逻辑
- **代理支持**：全局代理配置，覆盖下载和浏览器启动
- **指纹隔离**：`--fingerprint` 预设（standard/random），降低浏览器指纹被追踪的风险
- **便携模式**：数据存储在 `bws-data/` 子目录，U 盘随身携带
- **浏览器短别名**：`gc` (chrome)、`ff` (firefox)、`cm` (chromium)
- **HTTPS 兼容**：默认跳过证书验证，适配内网/自签名证书环境

## 快速开始

```bash
# 查看已安装版本
bws ls
bws ls gc@79           # 使用短别名 + 版本前缀筛选

# 从本地目录批量导入
bws import /path/to/browsers

# 远程下载安装
bws install chrome@120

# Chrome 历史版本需手动下载后导入
# 下载地址: https://chromedownloads.net/
bws install --from-file chrome-120-win64.zip chrome@120

# 运行浏览器
bws run chrome@120
bws run gc@120 -i      # 隐身模式
```

## 文档

完整文档请访问：**[Browser Workshop 文档站](https://hyjiacan.github.io/browser-workshop)**

- [快速上手](https://hyjiacan.github.io/browser-workshop/guide/getting-started)
- [命令参考](https://hyjiacan.github.io/browser-workshop/guide/commands)
- [Serve 服务](https://hyjiacan.github.io/browser-workshop/guide/serve)
- [浏览器短别名](https://hyjiacan.github.io/browser-workshop/guide/short-aliases)

## 安装

```bash
go install github.com/hyjiacan/browser-workshop/cmd/bws@latest
```

或从 [Releases](https://github.com/hyjiacan/browser-workshop/releases) 下载预编译二进制。

国内用户也可以通过 Gitee 安装：

```bash
go install gitee.com/hyjiacan/browser-workshop/cmd/bws@latest
```

## 命令一览

| 命令 | 说明 |
|------|------|
| `bws ls` / `bws list` | 列出已安装的浏览器版本 |
| `bws ls -R` | 列出远程可用版本 |
| `bws run <browser@version>` | 运行指定版本 |
| `bws install <browser@version>` | 安装浏览器版本 |
| `bws import <dir>` | 从目录批量导入 |
| `bws serve` | 启动 HTTP 分发服务 |
| `bws config` | 管理配置 |
| `bws profile` | 管理 Profile |
| `bws plugin` | 管理插件（安装/卸载/搜索） |

完整命令说明请查看 [命令参考](https://hyjiacan.github.io/browser-workshop/guide/commands)。

## 浏览器短别名

| 短别名 | 完整名称 |
|--------|----------|
| `gc` | chrome / googlechrome |
| `ff` | firefox |
| `cm` | chromium |

所有命令都支持短别名。详见 [浏览器短别名](https://hyjiacan.github.io/browser-workshop/guide/short-aliases)。

## 代理与指纹隔离

```bash
# 设置全局代理（下载和浏览器启动均生效）
bws cfg set proxy socks5://127.0.0.1:1080

# 运行时使用指纹隔离
bws r chrome@120 --fingerprint random
bws r chrome@120 --fingerprint standard
```

## 插件系统

bws 支持 Lua 脚本插件，在浏览器启动时自动执行自定义逻辑。

```bash
# 安装插件
bws plugin install ./my-plugin.lua

# 使用插件运行浏览器
bws r chrome@120 --plugin my-plugin

# 同时激活多个插件
bws r chrome@120 --plugin plugin-a,plugin-b

# 搜索远程插件
bws plugin search fingerprint
```

编写插件非常简单，创建一个 `.lua` 文件即可：

```lua
-- ~/.bws/plugins/my-plugin.lua
function pre_run()
    if ctx.browser == "chrome" then
        ctx.add_arg("--disable-background-timer-throttling")
    end
end
```

更多示例见 [plugins/examples](plugins/examples/)。

## Serve 服务

```bash
# 首次运行（自动创建配置文件）
bws serve
# 编辑 bws-serve.ini 配置文件

# 启动服务
bws serve
```

详见 [Serve 服务文档](https://hyjiacan.github.io/browser-workshop/guide/serve)。

## 许可证

MIT