WezTerm 多路复用入门：一套域配置管住本地、SSH 与 WSL 终端会话

WezTerm 多路复用入门一套域配置管住本地、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 窗口后台那个 SSH 会话跟着没了目录和没跑完的命令全得重来。WezTerm 多路复用把会话从窗口里解耦出来交给一个后台的wezterm-mux-server管理重开窗口就能接回原来的标签页。配完 WezTerm 域配置能干什么关光所有窗口后重开 WezTerm之前的标签页和各自的工作目录原样接回一台远程机只做一次 SSH 认证之后每个新标签页都复用同一条连接本地不同项目各开一个域窗口互不干扰切走不丢状态网络抖动断开后重新 attach 到原会话而不是从头重跑WezTerm 域配置到底管什么可以把域Domain理解成一块长期占用的工作台面台面上的东西窗口、标签页、里面的进程归域所有你的 GUI 窗口只是往台面上贴的一层玻璃。玻璃碎了或拆掉关闭窗口台面上的东西还在。WezTerm 启动时默认创建一个Local 域窗口和标签直接由 GUI 进程管理此时还没有后台服务器。一旦你配置了Unix 域WezTerm 会在本地拉起wezterm-mux-server它监听一个 Unix 套接字GUI 以客户端身份 attach 上去——从这一刻起会话的生命周期跟着服务器走而不是跟着窗口走。SSH 域把同一套机制搬到远端WezTerm 通过 SSH 通道在远程主机上启动wezterm-mux-server再用类似 Unix 域的方式连回去。所以 SSH 域要求远端装有兼容版本的 WezTerm而 SSH 本身只是搬运通道。先把本地 Unix 域跑起来打开~/.wezterm.lua在末尾加上最短可用配置config.unix_domains { { name unix }, } -- 启动即连接想手动连接就去掉这行 config.default_gui_startup_args { connect, unix }验证新开 WezTerm 后建两个标签页关光所有窗口再执行ps aux | grep wezterm-mux-server进程还在此时运行wezterm connect unix两个标签页原样回来。先跑通这一步再调优。确认行为符合预期后再按需展开可选参数默认全部生效不用动config.unix_domains { { name unix, -- socket_path /run/user/1000/wezterm/sock, 默认路径即可无需指定 -- local_echo_threshold_ms 10, 本地预测回显Unix 域默认关闭 -- skip_permissions_check false, 多用户机器保持 false }, }WezTerm SSH 远程域两条最短路径路径 A手写ssh_domains。在~/.wezterm.lua里加config.ssh_domains { { name prod, remote_address 192.168.1.100, username devops, -- ssh_option { identityfile /path/to/id_ed25519 }, 可选 }, }然后连接$ wezterm connect prod注意远端必须先装好兼容版本的 WezTerm连不上多半是它没装。路径 B直接吃~/.ssh/config。自 20230408 版本起WezTerm 自动把 SSH 配置里的主机生成为带SSHMUX:前缀的域另有SSH:前缀表示裸 SSH 连接一行都不用配$ wezterm connect SSHMUX:staging管多台机器时优先用路径 BWezTerm 侧零维护。WezTerm WSL 集成怎么接仅 WSL 1WSL 2 的 AF_UNIX 不支持 Windows 侧直通官方方案目前只覆盖 WSL 1截至 2023 年官方文档行为。WSL 1 里可以这么配两端。Windows 端~/.wezterm.luaconfig.unix_domains { { name wsl, serve_command { wsl, wezterm-mux-server, --daemonize }, }, } config.default_gui_startup_args { connect, wsl }WSL 内的~/.wezterm.luaconfig.unix_domains { { name wsl, -- 套接字放到 Windows 文件系统上宿主端才能连进来 socket_path /mnt/c/Users/你的用户名/.local/share/wezterm/sock, skip_permissions_check true, -- NTFS 权限检查必然失败跳过 }, }速查表类别名称说明快捷键CtrlSpace默认打开命令面板可在其中选连接域等动作完整绑定用wezterm show-keys查看命令wezterm connect 域名新建窗口并连接指定域unix/prod/SSHMUX:host命令wezterm cli spawn --domain-name 域名在当前窗口的新标签页里连接指定域命令wezterm cli list列出当前域内的窗口与标签页命令wezterm cli list-clients列出 attach 到该域的客户端命令wezterm cli get-text直接取选区/全屏文本省得手复制配置项unix_domains定义本地 Unix 域socket_path、serve_command、skip_permissions_check配置项ssh_domains定义 SSH 域remote_address、username、ssh_option配置项default_gui_startup_args让 GUI 启动时自动执行connect 域名配置项local_echo_threshold_ms往返延迟超过阈值时启用本地预测回显连不上按这个顺序查两端版本是否兼容SSH 域要求远端装了 WezTerm。本地和远端各跑一次wezterm --version对比。后台服务器还活着吗ps aux | grep wezterm-mux-server没有进程说明还没拉起或已退出先手动wezterm connect触发一次。套接字文件在不在、属主对不对ls -la ${XDG_RUNTIME_DIR:-/run/user/$(id -u)}/wezterm/sock文件缺失或属主不是当前用户都会拒连。开日志重连看报错WEZTERM_LOG_LEVELdebug wezterm connect unix输出里最后一条错误基本就是结论。域的全部字段、TLS 域写法及更多示例见官方文档 docs/multiplexing.md。【免费下载链接】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），仅供参考