快速开始

RelayCore 是一个高性能 Rust 流量拦截引擎。按照以下步骤，你可以在几分钟内启动并运行。

安装

选择适合你的安装方式：

Cargo（推荐）

cargo install relay-core-cli

npm

npm install -g @relay-core/cli

预构建二进制

从 GitHub Releases 下载最新版本。

生成 CA 证书

要拦截 HTTPS 流量，需先生成 CA（默认写入 ~/.relay-core/）：

relay-core-cli ca generate

查看状态：

relay-core-cli ca status

安装到系统信任存储：

# macOS（推荐）
relay-core-cli ca install

# Linux（Debian/Ubuntu 示例）
sudo cp ~/.relay-core/ca_cert.pem /usr/local/share/ca-certificates/relay-core.crt
sudo update-ca-certificates

# Windows
# 通过 certmgr.msc 导入 ~/.relay-core/ca_cert.pem

启动代理

CA 文件必须已存在；否则 run 会提示先执行 ca generate。

# 基本用法
relay-core-cli run

# 带 TUI 界面
relay-core-cli run --ui

# 指定监听地址
relay-core-cli run --listen 127.0.0.1:9090

代理默认监听 127.0.0.1:8080。使用 --ui 启用 TUI 交互界面，使用 --api-port 8082 启用 REST API 和 SSE 事件流。

配置客户端

将你的 HTTP 客户端指向 RelayCore：

# curl
curl --proxy http://localhost:8080 https://example.com

# 环境变量
export HTTP_PROXY=http://localhost:8080
export HTTPS_PROXY=http://localhost:8080