远程开发与终端代理的最小操作边界

生命周期说明（2026-08-10）：本文由 2026 年的个人开发环境笔记整理而来，只保留不含主机、账号、密钥、令牌和真实代理地址的通用操作。工具界面与命令参数会变化，执行前请以所用工具的当前文档为准。

远程编辑先确认身份与边界

SSH 远程开发适合在本地编辑器中直接使用远端终端、文件系统和构建环境。连接前应确认主机地址、用户名、端口、目标仓库和密钥来源；不要把私钥、访问令牌或密码写进仓库、笔记或终端历史。

无论使用哪种客户端，先在受控环境中验证以下事项：

• 连接的主机是否是预期目标；
• 当前身份和工作目录是否正确；
• 远端修改是否会影响共享环境或生产资源；
• 密钥文件是否仅由必要账户读取。

临时终端代理

临时代理应只作用于当前终端会话。将下列占位值替换成当前代理监听地址和端口：

export http_proxy="http://<proxy-host>:<proxy-port>"
export https_proxy="http://<proxy-host>:<proxy-port>"
export HTTP_PROXY="$http_proxy"
export HTTPS_PROXY="$https_proxy"

完成网络操作后，清除环境变量，避免影响之后运行的构建、包管理器或其他项目：

unset http_proxy https_proxy HTTP_PROXY HTTPS_PROXY

代理地址本身可能暴露网络拓扑；即使它不含密码，也不应随意写入公开配置或日志。

Git 代理优先限定到仓库

只有确实需要代理访问远程仓库时，优先在当前仓库设置：

git config http.proxy "http://<proxy-host>:<proxy-port>"
git config https.proxy "http://<proxy-host>:<proxy-port>"

可以分别查看和取消配置：

git config --get http.proxy
git config --get https.proxy
git config --unset http.proxy
git config --unset https.proxy

--global 会影响当前用户下的全部仓库。使用前应确认影响范围，并在不再需要时移除；不要在公开仓库中提交包含凭据的代理 URL。

维护习惯

把连接信息、密钥位置和代理凭据交给受控的凭据管理方式，而不是散落在脚本中。出现拉取失败、证书错误或连接超时时，先检查当前终端环境变量与仓库级 Git 配置，再更改全局设置。这样更容易定位问题，也能减少一次临时配置影响其他项目的风险。