Raider

联盟仪表板。供联盟使用，用于生成跟踪代码和查看其余额。

Raider易于集成到现有系统中。您还可以使用模板和样式自定义仪表板的外观和感觉。它可以作为一个自助联盟系统使用，让您的联盟用户管理他们的账户，创建跟踪URL，查看他们的余额并请求提款。

在Rust版本：rustc 1.51.0-nightly (c8915eebe 2021-01-07)上测试

🇭🇺 在匈牙利布达佩斯制作。

谁在使用它？

Crisp

👋 您使用Raider并希望被列在那里？ 联系我。

功能

• 自助联盟仪表板
• 用户可以生成联盟跟踪代码
• 用户可以看到他们的联盟统计数据（例如，他们赚了多少钱）
• 用户可以请求提款（您将收到一封通知电子邮件）
• 您的后端将推荐客户付款报告给Raider

它是如何工作的？

Raider提供了一个自助联盟仪表板，用户可以在其中注册，登录并管理他们的账户（例如，创建跟踪代码，请求提款等）。您的后端可以将推荐客户付款报告给Raider，这样联盟就可以提取他们的佣金并在任何时候请求提款。

Raider提供两项服务

• 自助仪表板：供您的联盟用户使用
• 支付报告API：每次付款时由您的后端调用（即，将应计佣金金额记入联盟账户）

如何使用它？

安装

从发行版安装

安装 Raider 的最佳方式是从 Raider 发行版页面 拉取最新版本。

请确保选择正确的服务器架构（例如，Intel 32 位）。

👉 每个发行版二进制文件都附带一个 .asc 签名文件，可以使用 @valeriansaliou GPG 公钥进行验证：🔑valeriansaliou.gpg.pub.asc。

从软件包安装

Raider 为基于 Debian 的系统（Debian、Ubuntu 等）提供预构建的软件包。

重要提示：Raider 目前只为 Debian 12 提供针对 64 位的软件包（代号：bookworm）。您可能仍然可以在其他 Debian 版本以及 Ubuntu 上使用它们（尽管它们依赖于特定版本的 glibc，这可能在较旧或较新的系统上不可用）。

首先，添加 Raider APT 仓库（例如，对于 Debian bookworm）

echo "deb [signed-by=/usr/share/keyrings/valeriansaliou_raider.gpg] https://packagecloud.io/valeriansaliou/raider/debian/ bookworm main" > /etc/apt/sources.list.d/valeriansaliou_raider.list

curl -fsSL https://packagecloud.io/valeriansaliou/raider/gpgkey | gpg --dearmor -o /usr/share/keyrings/valeriansaliou_raider.gpg

apt-get update

然后，安装 Raider 软件包

apt-get install raider

然后，编辑预填充的 Raider 配置文件

nano /etc/raider.cfg

最后，重新启动 Raider

service raider restart

从 Cargo 安装

如果您更喜欢通过 Rust 的 Cargo 管理 raider，可以直接使用 cargo install 安装它

cargo install raider-server

请确保您的 $PATH 已正确配置，以便从中获取 Crates 二进制文件，然后使用 raider 命令运行 Raider。

从源代码安装

最后一个选项是从 Git 拉取源代码，并通过 cargo 编译 Raider。

cargo build --release

您可以在 ./target/release 目录中找到构建的二进制文件。

在编译 Raider 之前，请安装 libssl-dev（即 OpenSSL 头文件）和 libmysqlclient-dev（即 MySQL 客户端头文件）。SSL 依赖项对于电子邮件通知是必需的，而 MySQL 依赖项对于连接到您的数据库是必需的。

从 Docker Hub 安装

您可能会发现通过 Docker 运行 Raider 很方便。您可以在 Docker Hub 上找到预构建的 Raider 镜像，地址为 valeriansaliou/raider。

首先，拉取 valeriansaliou/raider 镜像

docker pull valeriansaliou/raider:v1.2.3

然后，创建配置文件并运行它（将 /path/to/your/raider/config.cfg 替换为您配置文件的路径）

docker run -p 8080:8080 -v /path/to/your/raider/config.cfg:/etc/raider.cfg valeriansaliou/raider:v1.2.3

在配置文件中，请确保

• server.inet 设置为 0.0.0.0:8080（这允许从容器外部访问 Raider）
• assets.path 设置为 ./res/assets/（这指的是容器内部路径，因为资产包含在那里）

Raider 可在 https://127.0.0.1:8080 上访问。

数据库

Raider 需要您的宿主机上运行 MySQL（遗憾的是，目前它不兼容 PostgreSQL 和其他数据库）。

应在您创建的 Raider 数据库中导入 Raider SQL 架构，您可以在 raider.sql 中找到。

配置

请使用示例 config.cfg 配置文件，并根据您的环境进行调整。

⚠️ 重要：请确保更改默认的 server.secret_key、server.track_token 和 server.management_token 配置值，使用您生成的密钥。另外，为 database.password_salt 生成一个任意长度的随机字符串。如果您不更改这些值中的任何一个，您的 Raider 实例将不安全。您可以通过运行 openssl rand -base64 32 来轻松创建这些令牌。

以下列出可用的配置选项及其允许的值

[server]

• log_level（类型：字符串，允许：debug、info、warn、error，默认：error）— 日志的详细程度，在生产环境中设置为 error
• inet（类型：字符串，允许：IPv4 / IPv6 + 端口，默认：[::1]:8080）— Raider 服务应监听的宿主机和 TCP 端口
• workers（类型：整数，允许：任何数字，默认：4）— Raider 服务运行的进程数
• track_token（类型：字符串，允许：秘密令牌，默认：无默认值）— Track API 的秘密令牌（即秘密密码）
• management_token（类型：字符串，允许：秘密令牌，默认：无默认值）— 管理API的秘密令牌（即秘密密码）
• secret_key（类型：字符串，允许：192位base64编码的秘密密钥，默认：无默认值）— 用于cookie加密的秘密密钥（有关详细信息，请参阅 Rocket 文档）

{
  "amount": 95.00,
  "currency": "EUR",
  "trace": "Plan: Unlimited; Customer: [email protected]; Website: crisp.chat"
}

{
  "email": "[email protected]",
  "full_name": "John Doe",
  "address": "1 Market Street, San Francisco, CA",
  "country": "US"
}