简介 - Arc

如果你想最快理解 Arc、在本地跑起来并跳到对应文档，这一页就是最佳入口。

5 分钟快速上手

用最小配置安装并运行 arc-gateway。

理解架构设计

了解按核线程模型、请求流转路径和 crate 边界。

配置生产行为

配置监听器、路由、上游、插件和运行时参数。

安全运行 Arc

查看限流、防护、TLS 姿态和加固建议。

为什么选择 Arc

很多反向代理在高负载下依赖事件循环协调，会带来额外系统调用和跨线程开销。Arc 使用每个 CPU 核心一个 worker，并为其分配专属资源，因此在高并发下延迟更可预测。

快速开始

安装 Arc

curl -fsSL https://raw.githubusercontent.com/shuakami/Arc/master/install.sh | sh
arc-gateway --help

这个安装方式会把最新 GitHub Release 二进制安装到 /usr/local/bin/arc-gateway。

创建最小配置

node:
  workers: 0

listeners:
  - name: http
    kind: http
    bind: "0.0.0.0:8080"

upstreams:
  - name: app
    discovery:
      type: static
      endpoints:
        - address: "127.0.0.1:3000"

routes:
  - name: root
    match:
      path: "/{*rest}"
    action:
      upstream: app

运行 Arc

arc-gateway --config arc.yaml

验证运行结果

curl http://localhost:8080/
curl http://localhost:9090/healthz
curl http://localhost:9090/metrics

如果 Arc 运行正常，:8080 会把流量代理到你的上游服务，/healthz 返回 ok，/metrics 返回 Prometheus 文本指标。

核心能力

能力	你能获得什么
`io_uring` 数据平面	使用固定缓冲区和环形 I/O，构建低开销请求路径。
按核线程 worker	通过避免跨 worker 共享状态争用，获得更可预测的延迟。
HTTP/1.1 与 HTTP/2	覆盖常见南北向与内部服务流量协议。
TLS 与 ACME	Rustls 终止 TLS，并支持自动证书生命周期管理。
WASM 插件	不重编译核心代理逻辑，也能做请求过滤和扩展。
速率限制	提供路由级与全局级的突发流量与滥用防护。
可观测性	提供 Prometheus 指标、访问日志与追踪友好遥测。

文档导航

快速开始

快速完成 Arc 的安装、配置与运行。

部署

在 systemd、容器或 Kubernetes 中运行 Arc。

配置说明

全量配置字段与行为参考。

流量管理

路由、匹配、插件和流量镜像。

TLS 与证书

TLS 配置、证书自动化和轮换建议。

安全

安全加固、防护策略与风险控制。

可观测性

指标、日志与追踪集成方案。

控制面 API

通过 HTTP 接口管理运行时行为。

CLI

使用运维命令进行日志跟踪与查询。

基准测试

执行并解读性能基准测试结果。

内部 crate 布局

arc-gateway            主代理状态机与 worker 生命周期
arc-config             配置 schema、编译与热重载装配
arc-core               共享核心类型
arc-net                io_uring 封装、缓冲池与 socket 操作
arc-router             路由编译与匹配
arc-acme               ACME challenge 与证书生命周期
arc-global-rate-limit  基于 Redis 的集群级限流
arc-proto-http1        HTTP/1.x 解析与响应处理
arc-proto-h2           HTTP/2 帧、流与流控处理
arc-plugins            Wasmtime 集成与请求钩子 ABI
arc-observability      指标与管理端点
arc-logging            NDJSON 日志管线与轮转
arc-cli                运维 CLI 命令
arc-rate-limit         本地 GCRA 限流器
arc-common             共享错误与结果类型

下一步：阅读架构说明了解请求流转和依赖关系。

快速上手

运行与运维

参考资料

简介

5 分钟快速上手

理解架构设计

配置生产行为

安全运行 Arc

为什么选择 Arc

快速开始

核心能力

文档导航

快速开始

部署

配置说明

流量管理

TLS 与证书

安全

可观测性

控制面 API

CLI

基准测试

内部 crate 布局

5 分钟快速上手

理解架构设计

配置生产行为

安全运行 Arc

​为什么选择 Arc

​快速开始

​核心能力

​文档导航

快速开始

部署

配置说明

流量管理

TLS 与证书

安全

可观测性

控制面 API

CLI

基准测试

​内部 crate 布局

为什么选择 Arc

快速开始

核心能力

文档导航

内部 crate 布局