Realm 转发（含 Rust Web 面板）：一键安装、规则启停、定时备份、FTP/SFTP 备份

功能定位：Realm 可视化 / 交互式管理脚本，支持 TCP + UDP 转发规则的安装、管理、备份与恢复，并可选安装 Rust 编写的 Web 面板。

目录

功能概览

脚本提供：

  • Realm 一键安装 / 卸载 / 更新
  • TCP + UDP 转发规则：添加 / 删除 / 修改 / 启停
  • IPv4 / IPv6 监听与转发支持
  • 规则冲突检测：
    • 配置内端口冲突检测
    • 系统端口占用检测（ss/netstat）
  • 规则导入 / 导出
  • 定时自动备份（cron）
  • FTP / SFTP 远程自动备份
  • 可选：Rust Web 面板（浏览器可视化管理规则）

适用场景：

  • VPS 端口转发
  • 游戏加速 / UDP 转发
  • IPv6 中转
  • 一键备份与快速恢复

环境要求

  • 必须使用 root 运行
  • Linux（Debian/Ubuntu/CentOS/Alpine 等）
  • 依赖（脚本会尽量自动安装/提示）：
    • curl、tar、systemctl
    • 端口检测：优先 ss，否则 netstat
    • cron：cron/crond/crontab（用于定时备份）
  • Web 面板额外依赖（脚本会自动处理）：
    • Rust/cargo（通过 rustup 安装）
    • build-essential/pkg-config/libssl-dev 或 Development Tools/openssl-devel

一键安装

1️⃣ 一键运行（推荐）

bash <(curl -fsSL https://raw.githubusercontent.com/hiapb/hia-realm/main/install.sh)

⚠️ 必须使用 root 用户运行
如你是普通用户，请先：sudo -i

脚本主菜单说明

启动后会看到类似菜单（内容可能随版本调整）：

===== Realm TCP+UDP 转发脚本 =====
状态：运行中 | 版本：x.x.x
----------------------------------
1.  安装 Realm
2.  卸载 Realm
3.  重启 Realm
--------------------
4.  添加转发规则
5.  删除单条规则
6.  删除全部规则
7.  查看当前规则
8.  修改某条规则
9.  启动/暂停某条规则
--------------------
10. 查看日志
11. 查看配置
12. 一键导出所有规则
13. 一键导入所有规则
14. 添加/删除定时备份任务
15. 自动备份到FTP/SFTP
16. Realm 面板管理
0.  退出

Realm 安装 / 卸载 / 重启

安装 Realm（第一次必须）

菜单：1. 安装 Realm

脚本会：

  • 自动识别 CPU 架构（x86_64 / arm / arm64）
  • 自动识别 libc（glibc / musl）
  • 自动下载 GitHub 最新版本 Realm
  • 自动创建并启动 systemd 服务（realm.service）

卸载 Realm

菜单：2. 卸载 Realm

会执行：

  • 停止 Realm 服务
  • 删除二进制文件
  • 删除 systemd 服务
  • 删除配置文件
  • 同时会卸载（如已安装）面板相关组件

重启 Realm

菜单：3. 重启 Realm

规则管理

添加规则

菜单：4. 添加转发规则

按提示完成以下步骤：

1) 选择监听协议

  • 1. IPv4（默认）
  • 2. IPv6

2) 输入规则名称（支持中文）

  • 长度 1-50，支持：中文 / 字母 / 数字 / _ / -
  • 示例：游戏UDP加速

3) 输入监听端口

脚本会自动检测：是否与现有规则冲突、是否被系统占用。

4) 输入远程目标（目标地址:端口）

  • IPv4 / 域名：1.2.3.4:443 或 example.com:443
  • IPv6：[2001:db8::1]:443

5) 自动生效：添加完成后脚本会自动重启 Realm。

查看规则

菜单：7. 查看当前规则

示例：1. [启用] [游戏UDP] 0.0.0.0:10000 -> 1.2.3.4:10000 (tcp+udp)

启动/暂停规则

菜单：9. 启动/暂停某条规则

自动将该 [[endpoints]] 段落整体 注释 / 取消注释。

规则导出 / 导入

📤 导出路径：/etc/realm/realm-rules.backup.toml
📥 导入模式：支持覆盖导入（清空原规则）或追加导入（保留原规则）。

定时自动备份（cron）

菜单：14. 添加/删除定时备份任务

  • cron 文件：/etc/cron.d/realm-rules-export
  • 导出脚本：/usr/local/bin/realm-export-rules.sh
  • 备份文件：/etc/realm/realm-rules.YYYY-MM-DD_HHMMSS.toml

Web 面板（Rust）

脚本菜单：16. Realm 面板管理

面板默认信息：

  • 默认端口：4794
  • 默认用户名：admin
  • 默认密码：123456

PC登录

PC登录

PC主页

PC主页

移动端

移动端1 移动端2

常用路径

项目 路径
Realm 配置/etc/realm/config.toml
Realm 二进制/usr/local/bin/realm
规则备份/etc/realm/realm-rules*.toml
面板数据文件/etc/realm/panel_data.json

常见问题

Q1：修改规则后需要重启吗？
不需要。脚本和面板操作都会自动重启 Realm 使之生效。

Q2：支持 UDP 吗？
支持。脚本默认规则类型为：type = "tcp+udp"。

免责声明与使用须知（必读）

1) 禁止商用：本项目仅供学习交流，禁止商业用途。
2) 转载标注来源：必须保留原作者信息。
3) 合法合规：禁止用于违法用途，后果由使用者自行承担。