# 一键配置 Rust 环境(给想体验 drission 的非 Rust 用户)
不熟悉 Rust?是 Python / TS 爬虫开发者,只想快速跑起来?用下面的**一键脚本**:
自动用**国内镜像([rsproxy.cn](https://rsproxy.cn))**装好 Rust + 配好 cargo 加速,**带进度、自动验证版本号**。
全程**装在用户目录、无需管理员权限**,也**不依赖 Homebrew 等包管理器**。
> 只想试跑、连 Rust 都不想装?直接用预编译二进制:[`../dist/mac`](../dist/mac) · [`../dist/win`](../dist/win)。
---
## macOS
1. 下载本目录的 **`install-mac.command`**。
2. **双击运行**(会自动打开「终端」)。
- 若提示“无法打开,因为来自身份不明的开发者”:**右键 → 打开 → 打开**;或终端执行
`xattr -d com.apple.quarantine install-mac.command` 后再双击。
- 若双击没反应(下载后丢了可执行权限):终端执行 `chmod +x install-mac.command` 再双击,
或直接 `bash install-mac.command`。
3. 首次可能弹出 **Apple 命令行工具**安装器(编译 Rust 必需),点「安装」等它装完,脚本会自动继续。
做的事:确保 Xcode 命令行工具 → rsproxy 装 rustup/Rust → 配 cargo 国内镜像 → 打印 `rustc` / `cargo` 版本号。
## Windows
1. 下载本目录的 **`install-windows.bat`** 和 **`install-windows.ps1`**(放同一个文件夹)。
2. **双击 `install-windows.bat`**。
- 若 SmartScreen 拦截:点“更多信息 → 仍要运行”。
3. 等待进度跑完,最后会打印 `rustc` / `cargo` 版本号。
安装的是 **`x86_64-pc-windows-gnu`** 工具链:**自带链接器、免装 Visual Studio**,纯 Rust 项目
(含 drission 默认 `cdp` 后端)开箱即编。**无需管理员权限**(不会弹 UAC)。
---
## 装完怎么用
**新开一个终端 / 命令行窗口**(让 PATH 生效),然后:
```bash
cargo new demo && cd demo
cargo add drission
cargo run
```
开发本仓库内置的 `drs` CLI / MCP 入口:
```bash
cargo install --path crates/drission-cli --bin drs
drs serve --backend cdp --headless
```
## 进阶 / 可选的 C 编译环境
以下功能依赖 C 工具链编译,**体验默认功能用不到**,需要时再装:
- **Windows**:`impersonate`(TLS/JA3 指纹,BoringSSL)等需 **Visual Studio Build Tools + nasm + cmake**;
或改用 MSVC 工具链 `rustup default stable-x86_64-pc-windows-msvc`。
- **macOS**:已随 Xcode 命令行工具具备 `clang`/`cmake` 可按需补(`xcode-select --install`)。
## 手动配置(脚本失败时的等价命令)
```bash
# 1) rustup 镜像
export RUSTUP_DIST_SERVER="https://rsproxy.cn"
export RUSTUP_UPDATE_ROOT="https://rsproxy.cn/rustup"
# 2) 安装(mac/linux)
# [source.crates-io]
# replace-with = "rsproxy-sparse"
# [source.rsproxy-sparse]
# registry = "sparse+https://rsproxy.cn/index/"
```