ARTICLE DETAIL

建站实战干货

来自一线的建站与推广经验沉淀,每一条都经过真实交付验证。

WezTerm多路复用3分钟上手:本地、SSH、WSL三个场景照着做

2026/8/24 22:02:12 拓冰建站 浏览量
WezTerm多路复用3分钟上手:本地、SSH、WSL三个场景照着做 WezTerm多路复用3分钟上手本地、SSH、WSL三个场景照着做【免费下载链接】weztermA GPU-accelerated cross-platform terminal emulator and multiplexer written by wez and implemented in Rust项目地址: https://gitcode.com/GitHub_Trending/we/wezterm你刚把跑了半小时的任务挂在服务器上手一抖关了终端会话跟着没了。WezTerm 多路复用干的就是这件事把窗口和标签页挂在一个后台进程上断线重连、关掉 GUI会话都还在换台电脑也能接回来。先说清能干什么能把本机所有标签页挂到后台进程上关掉窗口会话不丢能通过 SSH 把远程机器上的标签页拉回本机窗口里能让 Windows 端的 WezTerm 直接打开 WSL 里的 Linux 标签页支撑这三点的是域domain每个域就是一组窗口加标签页的容器本地一个、每台远程机一个、WSL 再开一个。域名是你自己起的后面所有命令都用它寻址。下面按场景走每段结束都告诉你下一步敲什么。跟着三个场景做3行Lua连本地域Unix域编辑~/.wezterm.lua加两行配置config.unix_domains { { name unix }, } config.default_gui_startup_args { connect, unix }保存重启 WezTerm。第一行声明一个名叫 unix 的域第二行让 GUI 一启动就连上它。默认套接字路径在~/.local/share/wezterm/sock不用改。为什么加第二行它等价于每次启动都替你敲了wezterm connect unix挂接状态不用手动进。想手动连随时敲wezterm connect unix也行。连上之后新建的标签页都挂在这个域上关窗不关会话。复用SSH配置自动生成SSH域前提远程机器上装好 WezTerm而且版本和本机别差太远。在~/.wezterm.lua里写config.ssh_domains { { name prod, remote_address 192.168.1.100, username devops, }, }wezterm connect prod # 或在已有GUI里开新标签页 wezterm cli spawn --domain-name prod连上后远端会自动拉起wezterm-mux-server你看到的窗口挂的就是远端那组会话。不想逐台写配置WezTerm 会读~/.ssh/config给每个 Host 自动生成SSHMUX:前缀的域wezterm connect SSHMUX:staging为什么要用这个SSH 密钥、跳板机全走你现成的 ssh 配置WezTerm 只负责把远端会话拉进本机窗口不用重复维护一份连接信息。Windows里直接开LinuxWSL先说限制这条路只支持 WSL 1WSL 2 的 socket 互操作没打通。先在 WSL 内的~/.wezterm.lua里写config.unix_domains { { name wsl, socket_path /mnt/c/Users/USERNAME/.local/share/wezterm/sock, skip_permissions_check true, -- NTFS上没有属主检查 }, }把 USERNAME 换成你的 Windows 用户名。再把 Windows 端的~/.wezterm.lua改成config.unix_domains { { name wsl, serve_command { wsl, wezterm-mux-server, --daemonize }, }, } config.default_gui_startup_args { connect, wsl }改完配置不用重启 WSL关掉 WezTerm 再开就行。为什么 Windows 端要写serve_command它告诉 WezTerm 用wsl命令去 Linux 里拉服务器而不是在本机文件系统上找套接字。配好后从开始菜单直接启动 WezTerm 就会落进 WSL新建标签页同样在 Linux 里生成。调优三件事1. 打字回显跟不上手现象远程会话下敲键字符慢半拍出现。根因是客户端和服务器之间的往返延迟。一行解config.unix_domains { { name unix, local_echo_threshold_ms 10 }, }往返延迟超过 10ms 时客户端会先在本地预测回显不再干等服务器。SSH 域、TLS 域上同名参数也能设。2. 后台服务器不走了现象所有窗口都关了wezterm-mux-server还挂在后台。这是设计使然——会话要活服务器就得在。确认要清场时先找到进程ps aux | grep wezterm-mux-serverkill对应 PID该域所有会话随之结束。还留着会话的阶段就别动它。3. 换台电脑接回同一会话现象公司机器连过这个域回家换台机器想接着用。解法就是把config.default_gui_startup_args { connect, unix }写进配置任何一台装了 WezTerm 的机器启动 GUI 就自动挂接不用记命令。报错速查按出现频率排的序前两条最常见。报错信息原因修复connection refused找不到 socket服务器没起来wezterm connect 域名会自动拉起别手删 sock 文件socket 属主/权限检查失败socket 落在 NTFS 等无属主语义的文件系统该域加skip_permissions_check trueSSH 域连不上、握手失败远端没装 WezTerm 或版本差太多远端跑wezterm --version和本机对齐unknown domain 类提示域名字母大小写或拼写不对域名以.wezterm.lua里的定义为准别猜WSL 2 下 socket 连不上WSL2 不支持 AF_UNIX 互操作换 WSL 1或改走 SSH 域键入卡顿、输出一顿一顿往返延迟高设local_echo_threshold_ms 10收尾三个场景跑通后WezTerm 多路复用就是三件事本地域保会话SSH 域接远端WSL 跨系统。继续深入全部配置项与 TLS 域docs/multiplexing.mdSSH 域参数参考config/lua/SshDomain.md服务端实现源码wezterm-mux-server-impl/src/【免费下载链接】weztermA GPU-accelerated cross-platform terminal emulator and multiplexer written by wez and implemented in Rust项目地址: https://gitcode.com/GitHub_Trending/we/wezterm创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考