[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-81811":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":8,"htmlUrl":8,"language":9,"languages":8,"totalLinesOfCode":8,"stars":10,"forks":11,"watchers":12,"openIssues":13,"contributorsCount":13,"subscribersCount":13,"size":13,"stars1d":13,"stars7d":14,"stars30d":15,"stars90d":13,"forks30d":13,"starsTrendScore":13,"compositeScore":16,"rankGlobal":8,"rankLanguage":8,"license":17,"archived":18,"fork":18,"defaultBranch":19,"hasWiki":20,"hasPages":18,"topics":21,"createdAt":8,"pushedAt":8,"updatedAt":22,"readmeContent":23,"aiSummary":24,"trendingCount":13,"starSnapshotCount":13,"syncStatus":25,"lastSyncTime":26,"discoverSource":27},81811,"relay","0xUnixIO\u002Frelay","0xUnixIO",null,"Rust",38,9,35,0,1,3,40.8,"GNU Affero General Public License v3.0",false,"main",true,[],"2026-06-12 04:01:35","# relay\n\n[![Build](https:\u002F\u002Fgithub.com\u002F0xUnixIO\u002Frelay\u002Factions\u002Fworkflows\u002Frelease.yml\u002Fbadge.svg)](https:\u002F\u002Fgithub.com\u002F0xUnixIO\u002Frelay\u002Factions\u002Fworkflows\u002Frelease.yml)\n[![License: AGPL-3.0](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FLicense-AGPL--3.0-blue.svg)](.\u002FLICENSE)\n[![Release](https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fv\u002Frelease\u002F0xUnixIO\u002Frelay)](https:\u002F\u002Fgithub.com\u002F0xUnixIO\u002Frelay\u002Freleases)\n\n**relay** 是一个面向多服务器场景的端口转发管理平台，采用「主控 \u002F 节点」架构，支持多跳级联、用户套餐管理与 Web 控制台，适合个人搭建或商业化运营。\n\n```\n客户端  →  [入口节点]  →  [中转节点]  →  [出口节点]  →  目标服务\n```\n\n---\n\n## 特性\n\n- **高性能**：原生 Rust 二进制，直接运行在宿主机，无容器开销；Linux 零拷贝转发（`splice(2)`），tokio 异步 I\u002FO，低延迟、低内存占用\n- **无 Docker 依赖**：master \u002F node 均为静态编译的单一可执行文件，node 主机只需 systemd，Docker 仅用于 master 侧的 PostgreSQL \u002F Redis（可替换为自有数据库）\n- **多跳级联**：Layered DAG 拓扑，任意跳可配多台节点负载均衡，TCP + UDP 双协议\n- **mTLS 安全**：主控 ↔ 节点全链路双向 TLS，内置 CA，证书自动续期\n- **用户套餐**：多用户 + 角色，套餐批量绑定隧道，流量 \u002F 限速 \u002F 到期配额，超额自动暂停\n- **一键部署**：单条命令安装 master（内置 PostgreSQL + Redis，可选 Caddy HTTPS），Web UI 生成节点安装命令\n- **远程升级**：Admin 在 Web UI 发起节点升级，全程托管，失败自动回滚\n- **实时监控**：流量 sparkline、延迟探测、活跃连接数\n\n---\n\n## 架构\n\n```\n                        ┌──────────────────┐\n                        │   Web (React)    │\n                        └────────┬─────────┘\n                                 │ REST\n  ┌────────────┐        ┌────────▼─────────┐        ┌──────────────┐\n  │ PostgreSQL │◄──────►│  master (Rust)   │◄──────►│ Redis（可选）│\n  └────────────┘        └────────┬─────────┘        └──────────────┘\n                                 │ gRPC（mTLS 双向流）\n               ┌─────────────────┼─────────────────┐\n          ┌────▼────┐       ┌────▼────┐       ┌────▼────┐\n          │  node   │       │  node   │  ...  │  node   │\n          │ TCP\u002FUDP │       │ TCP\u002FUDP │       │ TCP\u002FUDP │\n          │  转发   │       │  转发   │       │  转发   │\n          └─────────┘       └─────────┘       └─────────┘\n```\n\n| 层     | 技术                                               |\n|--------|----------------------------------------------------|\n| 后端   | Rust（tokio · tonic · axum · sqlx + PostgreSQL）   |\n| 通信   | gRPC mTLS 双向流（master ↔ node）                  |\n| 前端   | Bun · React · TypeScript · shadcn\u002Fui · Tailwind v4 |\n| 存储   | PostgreSQL（主数据）· Redis（可选缓存）             |\n\n---\n\n## 快速开始\n\n### 1. 安装 master\n\n```bash\nbash \u003C(curl -fsSL https:\u002F\u002Fraw.githubusercontent.com\u002F0xUnixIO\u002Frelay\u002Fmain\u002Finstall.sh)\n```\n\n交互向导会引导完成：PostgreSQL → Redis（可选）→ 公网地址确认 → Web 域名 + HTTPS（可选）。全程约 2 分钟。\n\n> PostgreSQL \u002F Redis 支持三种方式：**Docker**（推荐，所有发行版）、**apt 原生安装**（仅 Debian\u002FUbuntu）、或填入已有实例的连接串。非 apt 发行版请提前自行安装数据库，或选择 Docker 方式。\n\n安装完成后：\n- Web 控制台：`http:\u002F\u002F\u003Cyour-ip>:7080`（或 HTTPS 域名）\n- 首次访问自动引导创建 admin 账户\n\n### 2. 添加节点\n\n在 Web 控制台 **Nodes → New Node**，填写节点 ID 后复制弹窗给出的一键安装命令，粘贴到目标主机执行即可。节点上线后在控制台可见，可立即用于隧道配置。\n\n### 3. 创建隧道与转发\n\n1. **Tunnels → New Tunnel**：选择入口\u002F中转\u002F出口节点，配置协议\n2. **用户管理**：为用户分配隧道（流量\u002F限速\u002F到期）\n3. 用户登录后在 **Forwards** 创建转发，指定目标地址和端口\n4. 复制入口地址给客户端使用\n\n---\n\n## 安装要求\n\n**master 主机**\n- Linux x86_64 或 aarch64\n- systemd\n- Docker + docker compose v2（推荐）或自有 PostgreSQL \u002F Redis 实例；原生 apt 安装仅支持 Debian\u002FUbuntu\n- 开放端口：`7080`（HTTP + 节点注册）、`7443`（gRPC）\n\n> relay master 本身是原生 Rust 二进制，以 systemd 服务运行在宿主机上，不跑在容器里。\n\n**node 主机**\n- Linux x86_64 或 aarch64\n- systemd（无需 Docker）\n- 能访问 master 的 `7080`（cold-start enrollment）和 `7443`（gRPC mTLS）端口\n\n---\n\n## 文档\n\n- [部署、升级、卸载](.\u002Fdocs\u002Fdeployment.md)\n- [本地开发](.\u002Fdocs\u002Fdevelopment.md)\n\n---\n\n## 贡献\n\n欢迎 Issue 和 PR。提交前请确保：\n\n```bash\ncargo fmt\ncargo clippy -- -D warnings\ncargo test\ncd web && bun run typecheck && bun run build\n```\n\n---\n\n## Star History\n\n\u003Ca href=\"https:\u002F\u002Fwww.star-history.com\u002F?repos=0xUnixIO%2Frelay&type=date&legend=top-left\">\n  \u003Cpicture>\n    \u003Csource media=\"(prefers-color-scheme: dark)\" srcset=\"https:\u002F\u002Fapi.star-history.com\u002Fchart?repos=0xUnixIO\u002Frelay&type=date&theme=dark&legend=top-left\" \u002F>\n    \u003Csource media=\"(prefers-color-scheme: light)\" srcset=\"https:\u002F\u002Fapi.star-history.com\u002Fchart?repos=0xUnixIO\u002Frelay&type=date&legend=top-left\" \u002F>\n    \u003Cimg alt=\"Star History Chart\" src=\"https:\u002F\u002Fapi.star-history.com\u002Fchart?repos=0xUnixIO\u002Frelay&type=date&legend=top-left\" \u002F>\n  \u003C\u002Fpicture>\n\u003C\u002Fa>\n\n---\n\n## License\n\n[AGPL-3.0](.\u002FLICENSE) © 2026 0xUnixIO\n","relay 是一个基于 Rust 的端口转发管理平台，适用于多服务器场景。它采用主控\u002F节点架构，支持多跳级联、用户套餐管理和 Web 控制台。核心功能包括高性能的零拷贝转发、无 Docker 依赖的静态编译二进制文件、mTLS 安全连接和一键部署。该平台适合需要灵活且安全地管理跨多个服务器的数据传输的个人或企业使用。通过 Web 界面可以轻松配置节点和隧道，并对流量进行实时监控和管理。",2,"2026-06-11 04:06:48","CREATED_QUERY"]