终端代理怎么配：v2rayN 配合 Git、npm 与 Docker

浏览器能用，终端还要检查什么

终端工具要使用 v2rayN，需要把代理请求交给它的本地监听入口。浏览器已经能访问网络，不能作为终端配置成功的依据。

v2rayN Wiki 将系统代理的作用范围描述为浏览器等部分软件。Git、npm、curl 是否读取 Windows 系统代理，官方没有说明。排查时应查看工具自身的代理项。

截至 2026-11-08，v2rayN 7.25.6 的默认混合端口是 10808，HTTP 与 SOCKS5 共用这个入口。若你改过监听端口，下面的地址也要随之调整：

http://127.0.0.1:10808

以下示例把两边文档的信息组合使用：配置键和协议前缀依据工具文档，主机地址与端口依据 v2rayN。官方没有说明这一组合的完整操作流程，填写后需要自行测试。

端口、协议等概念可查代理相关术语解释。

设环境变量：先看工具支持哪些名称

截至 2026-11-08，curl 手册列出的代理环境变量包括：

使用支持 export 的终端时，可填写：

~~~sh

export http_proxy=http://127.0.0.1:10808

export HTTPS_PROXY=http://127.0.0.1:10808

~~~

NO_PROXY 接受逗号分隔的名称；值仅为 * 时，会匹配全部主机。若请求没有经过代理，应检查这里是否排除了目标。

环境变量没有跨工具统一的处理标准。变量大小写、地址前缀如何识别，要分别看工具文档，不能由 curl 的行为推断其他程序。

相关说明见 curl 手册。

Git：给 HTTP 请求指定入口

截至 2026-11-08，git-config 文档提供 http.proxy，它可覆盖环境变量里的 HTTP 代理设置。使用 HTTPS 仓库地址时，可按下面的组合测试：

~~~sh

git config --global http.proxy http://127.0.0.1:10808

~~~

--global 写入用户配置；不指定作用范围时，默认写入当前仓库的本地配置；--system 则写入系统配置。只想影响当前仓库时，应按这个范围选择命令。

Git 还支持 http.<url>.*，可把相应设置限定到匹配的 URL。需要按地址使用代理时，可以查阅这一配置方式。

git:// 使用的 core.gitProxy 是另一项配置，不能与 http.proxy 混为一谈。更改 HTTP 代理后，也不要把其他协议的连接结果当作验证依据。

出处：Git 配置文档。

npm：分别设置 HTTP 与 HTTPS

截至 2026-11-08，npm v10 文档分别提供 proxy 和 https-proxy，两项默认值均为 null。下面沿用前述 HTTP 入口组合：

~~~sh

npm config set proxy=http://127.0.0.1:10808

npm config set https-proxy=http://127.0.0.1:10808

~~~

npm 文档也列出了可读取的代理环境变量。noproxy 用于指定绕过代理的域名范围，并接受逗号分隔的字符串。

核对配置时可运行：

~~~sh

npm config get proxy

npm config get https-proxy

npm config list

~~~

这些结果用于确认配置值，不能单凭它们认定请求已经成功经过代理。

不再需要这两项设置时，可删除：

~~~sh

npm config delete proxy

npm config delete https-proxy

~~~

如果仍设有代理环境变量，还要一起检查。删除 npm 配置项，不代表环境变量也已取消。

出处：npm 配置说明、npm config 命令。

Docker：拉取镜像要配置守护进程

截至 2026-11-08，Docker 文档把代理分成两层：

因此，排查 docker pull 时，应查看守护进程代理。只修改客户端配置，不能据此判断镜像拉取已使用代理。

当守护进程与 v2rayN 位于同一主机时，可测试以下 daemon.json 字段组合：

~~~json

{

"proxies": {

"http-proxy": "http://127.0.0.1:10808",

"https-proxy": "http://127.0.0.1:10808"

}

}

~~~

修改后需重启守护进程。Docker 文档还列出环境变量方式，但直接配置守护进程的优先级更高。

Docker Desktop 会忽略 daemon.json 中的代理配置，应使用 Docker Desktop 的设置。

客户端文件使用的是 httpProxy、httpsProxy、noProxy 等键名，且只影响新的容器与构建，已有容器不会随之改变。代理环境变量会以明文存入容器配置，不要把含密码的代理地址提交到仓库。

出处：Docker 守护进程代理、Docker 客户端代理。

验证与按需使用：按配置层逐项核对

设置后，先核对地址和实际监听端口，再执行需要联网的操作。失败时按配置层检查：

• 工具是否另有显式代理设置，覆盖了环境变量。
• 绕过代理的列表是否包含目标。
• Git 当前使用的地址协议是否对应所改配置。
• Docker 修改的是守护进程还是客户端配置。

按需代理可以利用 Git 的仓库范围、URL 匹配范围，以及各工具的绕过列表控制。不要把一项设置的生效范围扩大理解为整个终端。

遇到连接问题，可继续看代理连接异常排查和使用中的常见疑问。

以上端口依据截至 2026-11-08 的 v2rayN 7.25.6 源码；工具配置依据截至 2026-11-08 的 Git、npm v10、Docker 与 curl 文档。升级工具或调整监听配置后，应重新核对。

第三方整理，与项目方无关。