SSH Remote Development zh

SSH 与远程开发

English · 中文

发起 SSH profile 会话，解锁远程预览、下载、按工作目录上传以及端口转发。

发起 SSH 会话

打开会话启动器（Ctrl+Shift+T），从 WispTerm 内置的 SSH 启动器发起 SSH 会话。 这样发起会为会话附上 profile 元数据，正是它解锁了远程文件预览、远程下载、工作目录探测， 以及下文所述的自动端口转发。在本地 shell 里敲 ssh user@host 得不到这些功能 —— 见 文件浏览器与预览。

上报工作目录（OSC 7）

SSH profile 会话中的拖拽上传，会在 shell 用 OSC 7 上报时使用当前远程工作目录（与 Ghostty shell 集成相同的约定）。如果远程 shell 不发 OSC 7，WispTerm 会回退到用一个新的 ssh.exe 辅助进程运行 pwd，而它通常返回登录目录而非你 cd 进去的目录 —— 此时会显示 一个可点击的设置提示。

把下面其中一段加入远程 shell 的启动文件，然后开一个新的 WispTerm SSH 会话。

Bash（~/.bashrc）：

__wispterm_report_cwd() {
  printf '\033]7;file://%s%s\a' "${HOSTNAME:-localhost}" "$PWD"
}
PROMPT_COMMAND="__wispterm_report_cwd${PROMPT_COMMAND:+;$PROMPT_COMMAND}"

Zsh（~/.zshrc）：

__wispterm_report_cwd() {
  printf '\033]7;file://%s%s\a' "${HOST:-localhost}" "$PWD"
}
autoload -Uz add-zsh-hook
add-zsh-hook chpwd __wispterm_report_cwd
add-zsh-hook precmd __wispterm_report_cwd

Fish（~/.config/fish/config.fish）：

function __wispterm_report_cwd --on-variable PWD
    printf '\e]7;file://%s%s\a' (hostname) (string escape --style=url $PWD)
end
__wispterm_report_cwd

老旧 SSH 服务

对于仍需启用已弃用 OpenSSH 算法的老旧堡垒机或服务器，设置：

ssh-legacy-algorithms = true

这会为 WispTerm 的 SSH profile 启动以及辅助 ssh.exe / scp.exe 命令追加 ssh-rsa、 ssh-dss、较老的 Diffie-Hellman KEX 和 CBC 加密的兼容选项。

通过 SSH 访问 Web 应用（端口转发）

当远程 Web 应用打印 loopback 网址（如 http://127.0.0.1:4232 或 http://localhost:43455）时，WispTerm 会通过自动建立的本地 SSH 隧道打开它。Ctrl/Cmd 点击网址即可打开。这些隧道由内嵌浏览器面板和系统浏览器共享，因此设置 url-open-mode = system-browser 就能让远程应用在你常用的浏览器中打开。每个远程端口各自 保留一条转发；WispTerm 优先使用相同的本地端口，仅在该端口已被占用时才递增。非 loopback 网址（如 https://10.10.x.x 或公网站点）直接打开。面板本身见 浏览器与 Jupyter 面板。

---

另见：文件浏览器与预览 · 浏览器与 Jupyter 面板 · 配置