Skip to content

设置、配置与更新 ​

语言与外观 ​

打开 Settings / 设置 → Appearance / 外观,选择中文或 English、深浅主题和新会话默认字号。语言只翻译应用界面,不翻译服务器输出、文件正文或用户名称。

当前本地会话字号可以在其属性中修改。新会话默认值与已有会话设置需要区分。

环境变量与本地代理 ​

设置中的“环境与网络”定义全局默认值,新建会话中的“环境与代理”可覆盖单个本地会话。环境变量每行一个 KEY=value,值无需额外引号。

text
HTTP_PROXY=http://127.0.0.1:10808
NO_PROXY=localhost,127.0.0.1
MY_SETTING=value=with=equals

支持 http://、https://、socks5:// 和 socks5h:// 代理地址。代理设置会生成 HTTP_PROXY、HTTPS_PROXY 和 ALL_PROXY。优先级从低到高为:系统环境 → 全局代理 → 全局环境变量 → 单会话代理 → 单会话环境变量。

这些设置影响下次启动的本地 Shell 及其子进程,不修改 Windows 系统代理,也不为 SSH 连接提供代理或跳板机功能。具体程序是否使用代理环境变量取决于该程序。

配置保存在哪里 ​

产品 / 文件保存内容
%LOCALAPPDATA%\BranchTerm\config.json本地项目、会话、语言和工作空间
%LOCALAPPDATA%\eShell\config.jsoneShell 工作空间、语言和本地会话
config.ssh.json(eShell 目录内)SSH 配置、分组、最近记录和标签描述
config.ssh-trust.json(eShell 目录内)服务器主机信任记录
Windows 凭据管理器用户选择保存且成功使用的 SSH 密码

ESHELL_CONFIG 与 BRANCHTERM_CONFIG 可分别指定配置文件路径,用于隔离工作空间。请在启动应用前设置。有效配置保存时会保留相应备份,损坏配置不会被自动无提示覆盖。

密码绑定当前 Windows 用户、配置路径和保存配置 ID,不在 JSON 或 Excel 备份中。换机器、改变配置路径或复制保存配置后,需要重新保存密码。私钥 passphrase 始终不保存。

更新应用 ​

  1. 正常退出要更新的应用。
  2. 备份对应配置目录和旧程序目录。
  3. 用新包替换整个运行目录,保留随包的两个运行库和 notices。
  4. 从原固定路径启动,核对菜单、配置和连接情况。

Windows 会阻止覆盖正在运行的 exe。只更新源码或重新构建另一个目录,不会更新你已安装的程序。重启会恢复会话描述,不恢复旧进程、连接或命令输入。

需要清单时使用 Excel 导出,需要完整工作空间备份时保留配置目录。

Windows 桌面终端 · 图文使用手册