快速开始

本指南将帮助你快速部署和运行 rho-aias。

环境要求

项目	最低要求
操作系统	Linux Kernel 5.8+（推荐 6.1+）
Go	1.25+（仅源码编译需要）
Docker	20.10+
Docker Compose	v2.0+
硬件	支持 XDP 的网卡

内核版本检查

# 检查内核版本
uname -r

# 检查 XDP 支持
bpftool feature probe | grep xdp

---

安装步骤

方式一：使用预构建镜像（推荐）

1. 克隆项目

git clone https://cnb.cool/MakeCNBGreatAgain/rho-aias.git

2. 使用默认配置启动

注意⚠️：需要检查本机网卡的名称，并修改 config.yml 中的 ens33 为实际网卡名称。

docker compose up -d

3. 测试

root@debian:~# curl localhost
您的IP地址是: 127.0.0.1

root@debian:~# curl localhost/.svn
403 Forbidden

---

验证安装

1. 检查 XDP 程序

# 查看网卡是否加载 XDP
ip link show eth0 | grep xdp

# 输出示例：
# xdpgeneric/xdp1 id 123

2. 检查 API 服务

# 健康检查（未启用认证时）
curl http://localhost:8081/api/rules

# 查看数据源状态
curl http://localhost:8081/api/sources/status

3. 测试封禁功能

# 添加封禁规则
curl -X POST http://localhost:8081/api/manual/blacklist/rules \
  -H "Content-Type: application/json" \
  -d '{"value": "1.2.3.4"}'

# 查看规则
curl http://localhost:8081/api/rules

# 删除规则
curl -X DELETE http://localhost:8081/api/manual/blacklist/rules \
  -H "Content-Type: application/json" \
  -d '{"value": "1.2.3.4"}'

---

启用认证（生产环境必需）

1. 修改配置

auth:
  enabled: true
  jwt_secret: ""           # 从环境变量读取
  token_duration: 1440
  captcha_enabled: true

2. 设置环境变量

export JWT_SECRET="your-strong-secret-key-at-least-32-characters"

3. 重启服务

docker compose restart rho-aias

启用威胁情报

intel:
  enabled: true
  auto_refresh_on_start: true
  persistence_dir: ./data/intel
  sources:
    ipsum:
      enabled: true
      periodic: true
      schedule: "0 1 * * *"
      url: https://raw.githubusercontent.com/stamparm/ipsum/master/ipsum.txt
      format: ipsum

---

启用地域封禁

geo_blocking:
  enabled: true
  mode: whitelist          # 白名单模式
  allowed_countries:
    - CN                   # 仅允许中国
  allow_private_networks: true
  sources:
    maxmind:
      enabled: true
      periodic: true
      schedule: "0 3 * * *"
      url: https://github.com/P3TERX/GeoLite.mmdb/releases/download/2026.01.10/GeoLite2-Country.mmdb
      format: maxmind-db

---

启用 WAF 联动

需要配合 Caddy + Coraza WAF 使用：

waf:
  enabled: true
  waf_log_path: /caddy-logs/waf_audit.log
  rate_limit_log_path: /caddy-logs/rate_limit.log
  ban_duration: 3600       # 封禁 1 小时

Docker Compose 配置：

services:
  caddy:
    image: docker.cnb.cool/makecnbgreatagain/rho-aias/rho-aias-caddy:latest
    network_mode: host
    volumes:
      - ./caddy/Caddyfile:/etc/caddy/Caddyfile:ro
      - ./logs/caddy:/logs

  rho-aias:
    image: docker.cnb.cool/makecnbgreatagain/rho-aias/rho-aias:latest
    network_mode: host
    cap_add:
      - CAP_BPF
      - CAP_PERFMON
      - CAP_NET_ADMIN
      - CAP_NET_RAW
    volumes:
      - ./config.yml:/app/config/config.yml:ro
      - ./logs/caddy:/caddy-logs:ro  # 共享 WAF 日志

---

启用异常检测

anomaly_detection:
  enabled: true
  sample_rate: 1           # 100% 采样
  check_interval: 1        # 每秒检测
  block_duration: 60       # 封禁 60 秒
  ports:
    - 80
    - 443
  attacks:
    syn_flood:
      enabled: true
      ratio_threshold: 0.5
    udp_flood:
      enabled: true
      ratio_threshold: 0.8

---

常见问题

XDP 加载失败

Error: failed to attach XDP program: operation not permitted

解决方案：

• 确保使用 root 权限或添加必要的 capabilities
• 检查内核版本是否支持 XDP

网卡名称错误

Error: interface eth0 not found

解决方案：

# 查看可用网卡
ip link show

# 修改 config.yml 中的 interface_name

下一步

• 阅读 配置说明 了解完整的配置选项
• 阅读 API 参考 了解可用的 API 接口
• 阅读 认证授权 了解权限管理
• 阅读 WAF 集成 了解如何与 WAF 联动
• 阅读 异常检测 了解 DDoS 防护