文档中心

一键部署

使用以下命令快速安装 ITML：

注意：仅支持 Debian/Ubuntu 系列系统

curl -fsSL http://scm.closefrp.com/itml/onekeyinstall.sh | bash

安装方法

方法一：从源码安装

# 克隆项目
git clone https://github.com/zqamemz/Immortal-TUI-MEFrp-Launcher.git /opt/itml
cd /opt/itml

# 安装依赖
pip install textual requests pyyaml

# 安装 ITML
pip install -e .

方法二：使用 pip 安装（发布后）

pip install itml

快速开始

运行程序

# 直接启动
itml

# 或者使用 Python 模块
python -m itml

首次使用

  1. 启动程序后，使用已有账号密码或访问 Token 登录
  2. 登录后进入主菜单，可通过 设置 配置 frpc 路径
  3. 在 隧道列表 中查看已有隧道，或 新建隧道
  4. 进入隧道详情可 安装 Systemd 服务 实现进程守护

Systemd 服务管理

ITML 支持将隧道注册为 systemd 服务，实现进程守护和开机自启。

前提条件

操作说明

在程序 隧道详情 页面中，通过按钮可以：

操作 说明
安装服务 写入隧道配置并创建 systemd unit 文件
启动 systemctl start itml-tunnel-{id}
停止 systemctl stop itml-tunnel-{id}
重启 systemctl restart itml-tunnel-{id}
卸载服务 停止并删除 systemd unit 文件

手动管理命令

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

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

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

配置说明

配置文件位于 ~/.config/itml/config.json：

{
  "token": "your_api_token",
  "username": "your_username",
  "frpc_path": "/usr/local/bin/frpc",
  "last_node_id": 1
}

退出模式

快捷键 行为
Ctrl+Q 弹出退出确认菜单
保持隧道退出 所有隧道继续运行，仅关闭 UI
关闭隧道退出 停止所有 systemd 隧道服务后退出

系统要求