Immortal-TUI-MEFrp-Launcher

Immortal-TUI-MEFrp-Launcher

在 SSH 和真实命令行环境下使用的 ME Frp 图形化终端管理程序

PythonTextualTUI

项目介绍

Immortal-TUI-MEFrp-Launcher(简称 ITML)是由 zqamemz 开发的 ME Frp 图形化终端管理程序, 基于 Textual 框架构建,无需 WebUI 即可在终端中完成从登录到守护的一站式隧道管理。

主要特性

  • 密码 / Token 登录,自动完成人机验证
  • 隧道管理:列表、创建、启用/禁用、删除,创建时实时展示节点负载与带宽
  • Systemd 守护:隧道一键安装为系统服务,开机自启、进程守护
  • 内置 mefrpc:首次启动自动安装,无需单独下载 frpc
  • 每日签到与权益抽取,均支持人机验证

系统要求

  • Python 3.8 或更高版本
  • Textual ≥ 1.0.0、Requests ≥ 2.25.0、PyYAML ≥ 5.1
  • Linux:Debian、Ubuntu 等主流发行版(SSH 环境亦可)
  • Systemd 守护功能需 root / sudo 权限

预览图

主界面 - Immortal-TUI-MEFrp-Launcher 界面截图

主界面

下载安装

系统要求

需要 Python 3.8 或更高版本,建议在 Linux 系统(Debian / Ubuntu 等)下使用。可以在终端输入 python3 --version 检查。

安装步骤

  1. 1

    一键部署(仅支持 Debian / Ubuntu 系列系统):

    curl -fsSL https://itml.shiftcore.top/onekeyinstall.sh | bash
  2. 2

    从源码安装

    git clone https://github.com/zqamemz/Immortal-TUI-MEFrp-Launcher.git /opt/itml
    cd /opt/itml
    pip install textual requests pyyaml
    pip install -e .
  3. 3

    pip 安装(发布后可用):

    pip install itml

使用指南

启动程序

sml

# 或使用 Python 模块方式启动
python -m sml

首次使用流程

登录(账号密码或访问 Token)→ 在主菜单「设置」中配置 frpc 路径 → 进入「隧道列表」查看已有隧道或「新建隧道」→ 在隧道详情中安装 Systemd 服务实现进程守护与开机自启。

提示:配置保存在 ~/.config/itml/config.json,包含 token、username、frpc_path 等字段。

Systemd 守护管理

隧道安装为系统服务后,可通过 systemd 手动管理:

# 查看所有 ITML 隧道服务
systemctl list-units --type=service | grep itml-tunnel

# 查看单个隧道状态
systemctl status itml-tunnel-10086

# 查看隧道日志
journalctl -u itml-tunnel-10086 -f

退出方式

Ctrl+Q 弹出退出确认菜单,可选择「保持隧道退出」(隧道继续运行,仅关闭 UI)或「关闭隧道退出」(停止所有 systemd 隧道服务后退出)。