设置、配置与更新
语言与外观
打开 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.json | eShell 工作空间、语言和本地会话 |
config.ssh.json(eShell 目录内) | SSH 配置、分组、最近记录和标签描述 |
config.ssh-trust.json(eShell 目录内) | 服务器主机信任记录 |
| Windows 凭据管理器 | 用户选择保存且成功使用的 SSH 密码 |
ESHELL_CONFIG 与 BRANCHTERM_CONFIG 可分别指定配置文件路径,用于隔离工作空间。请在启动应用前设置。有效配置保存时会保留相应备份,损坏配置不会被自动无提示覆盖。
密码绑定当前 Windows 用户、配置路径和保存配置 ID,不在 JSON 或 Excel 备份中。换机器、改变配置路径或复制保存配置后,需要重新保存密码。私钥 passphrase 始终不保存。
更新应用
- 正常退出要更新的应用。
- 备份对应配置目录和旧程序目录。
- 用新包替换整个运行目录,保留随包的两个运行库和 notices。
- 从原固定路径启动,核对菜单、配置和连接情况。
Windows 会阻止覆盖正在运行的 exe。只更新源码或重新构建另一个目录,不会更新你已安装的程序。重启会恢复会话描述,不恢复旧进程、连接或命令输入。
需要清单时使用 Excel 导出,需要完整工作空间备份时保留配置目录。
