Phantty V0.13 可被远程控制的终端

WispTerm V0.13 远程控制部署说明

在 V0.13 版本中，WispTerm 新增了远程控制能力。

也就是说，你可以先在本地 Windows 上启动 WispTerm，然后通过浏览器远程连接到这个终端界面。配置完成后，Phantty 会生成一个连接码。浏览器端登录后输入连接码，就可以加载本地终端，实现远程操作。

整个过程中，真正的终端仍然运行在本地电脑上，浏览器只是远程显示和输入入口。

部署方式选择

目前提供两种部署方式：

如果你的主要使用场景在国内，更推荐使用 PaaS 平台。以 sealos.run 为例，它可以直接提供域名、HTTPS 和容器运行环境，部署简单，国内连接速度也更快，延迟更低。

如果你的主要使用场景在海外，或者你本身就在使用 Cloudflare，可以选择 Cloudflare Workers。它不需要自己维护服务器，也方便绑定自己的域名，但国内访问时可能会受到网络环境影响。

推荐直接使用构建好的 Docker 镜像：

1	hoptoper/remote-phantty:latest

容器端口填写：8787

需要配置三个环境变量：

在 Linux 下，可以这样生成密码哈希：

1	echo -n "your_password" \| sha256sum

然后把输出结果整理成：

1	sha256:你的哈希值

生成 session secret：

1	openssl rand -hex 32

以 sealos.run 为例，部署流程如下：

如果使用 Cloudflare Workers，需要先准备 Node.js 环境。

# 安装依赖
npm install

# 安装 Wrangler
npm install -g wrangler

# 登录 Cloudflare
wrangler login

# 复制配置文件
cp wrangler.toml.example wrangler.toml

如果需要绑定自己的域名，可以修改 wrangler.toml：

1
2
3

[[routes]]
pattern = "remote.example.com"
custom_domain = true

然后配置三个 secret：

1
2
3

wrangler secret put ADMIN_USERNAME
wrangler secret put ADMIN_PASSWORD_HASH
wrangler secret put SESSION_SIGNING_SECRET

密码哈希同样使用：

1	echo -n "your_password" \| sha256sum

并填写为：sha256:你的哈希值

最后构建并部署：

1 2	npm run build wrangler deploy

部署完成后，Cloudflare 会返回访问地址。打开该地址即可进入 Remote Console 登录页面。

远程服务部署完成后，在 Windows 上启动 WispTerm。

使用 ctrl+, 进入配置页，填写：

1
2
3

remote-enabled = true
remote-server-url = https://你的远程服务器的域名
remote-device-name = MyPC1

连接成功后，WispTerm 会生成一个连接码。

⚠️ 为了安全，连接码复制之后会消失，每次启动都不一样。

然后在浏览器中打开 Remote Console，登录后输入连接码，即可加载本地终端。

到这里，WispTerm 的远程控制环境就已经配置完成。

你现在拥有的是一个浏览器可访问的远程终端入口。终端实际运行在本地 Windows 电脑上，远程浏览器只负责显示终端内容和发送输入。

后续使用时，只需要保持本地 WispTerm 正常运行，并确保它已经连接到 Remote Console 服务，就可以通过浏览器远程访问终端。

项目地址： https://github.com/xuzhougeng/wispterm