dsh-agent-proxy
Manifest validOne switch that routes the git, npm and pip commands DSH runs through a local HTTP proxy, restoring every previous setting when turned off.
dsh-agent-proxy
给 DSH 的设置页加一个「代理」开关:打开后,DSH 替你运行的 git clone、npm install、pip install 等命令走本机代理,不再因为连不上 GitHub / npm 而超时。
它做什么
打开开关时,插件从两个层面让命令走代理:
1. 工具配置文件(对已经在运行的 shell 也生效)
| 工具 | 写入 |
|---|---|
| git | ~/.gitconfig 的 [http] proxy、[https] proxy |
| npm | ~/.npmrc 的 proxy、https-proxy |
| pip | pip.ini / pip.conf 的 [global] proxy |
打开前会记录每一项的原值;关闭时逐项还原(原本没有的键会被删掉,空下来的段/文件也会清理)。你原有的 [user]、registry=、timeout= 等其他配置不受影响。
2. 子进程环境变量(对之后新起的命令生效)
DSH 每次派生命令都会重建子进程环境,并重新套用它启动时解析出的代理策略,所以 http_proxy / https_proxy / all_proxy 这几个名字会在运行时被清掉。插件改用各工具自己的环境通道:
GIT_CONFIG_PARAMETERS http.proxy / https.proxy(等于 git -c,不写文件)
npm_config_proxy npm_config_https_proxy
PIP_PROXY PIP_HTTPS_PROXY
http_proxy https_proxy all_proxy(及大写形式)、NODE_USE_ENV_PROXY=1
代理地址从哪来
按优先级:
- 设置页「代理地址」里填写的地址(留空表示自动);
- 插件配置里的
proxyUrl; - Windows 系统代理(HKCU Internet Settings,即 Clash / V2Ray 打开的「系统代理」);
- DSH 启动时已导出的
HTTPS_PROXY/HTTP_PROXY。
设置页开关下方有一个「代理地址」输入框:填了就用它(仅支持 http:// / https://),留空自动使用系统代理。地址在失焦或回车时保存,开关开着会立即用新地址重连;开关下方会显示当前生效的地址与来源。
安装
从 npm 安装(发布后):
dsh plugin --profile desktop add dsh-agent-proxy
也可以直接从本目录安装(本地开发):
dsh plugin --profile desktop add <本包目录>
安装后完全退出并重开 DSH,打开 设置 → 代理。
配置
开关状态保存在 $DSH_HOME/agent-proxy.json,重启后保留。需要固定地址时:
- insert:
- id: agent-proxy
name: 'dsh-agent-proxy'
config:
enabled: true
proxyUrl: 'http://127.0.0.1:7890'
proxyUrl 留空即自动检测系统代理;enabled 只是状态文件尚不存在时的初始默认值。
验证
开启后让 DSH 执行:
git config --global --get http.proxy # 应输出代理地址
git ls-remote https://github.com/FNOSP/fnos-dsh HEAD
git 的详细输出里出现 Trying 127.0.0.1:789x 与 CONNECT tunnel established 即表示走了代理。
已知边界
- 只影响 DSH 派生的命令与 git/npm/pip 的全局代理配置;关闭后原值还原。
- 代理地址只支持 HTTP(S) 代理(
http://host:port),不支持 SOCKS5 / PAC。 - 只认
http_proxy且不读任何配置文件的命令(如某些curl调用)不一定被覆盖。
Comments
Loading…
Similar plugins
by Acr1mony
DSH plugin: switch the local HTTP proxy port at runtime with /proxy <port>; routes the agent's in-process fetches and child processes
★ 0
MIT
JavaScript
Oct 24, 2026
dsh plugin --profile web add dsh-proxy-portby citydirector
Reach the DSH Web GUI from your phone or another computer: a secret-path reverse proxy with an optional password and client allow list that bridges DSH's per-start launch token, configured from its own page in the Plugins panel.
★ 0
MIT
JavaScript
Nov 1, 2026
dsh plugin --profile web add dsh-remote-access-proxyRestore Host-persisted settings in dsh web behind a reverse proxy: marks the page's connection as host-owning so the settings/model pages work on non-loopback hostnames. · 反代部署下恢复 dsh 设置页的 host 持久化。
★ 0
MIT
JavaScript
dsh plugin --profile web add dsh-plugin-loopback-trustby 314857493
Opt-in HTTP proxy service for DSH plugins, with native address and port settings. Exposes scopedHttpProxy for explicit callers, applies address changes to subsequent requests, and leaves system proxie
★ 0
MIT
JavaScript
Oct 29, 2026
dsh plugin --profile web add dsh-scoped-http-proxyby Yangi-252410
该仓库暂未提供项目说明。
★ 0
JavaScript
Oct 5, 2026
dsh plugin --profile web add dsh-git-toolsby wjt0321
On-demand GitHub proxy for the Web UI: one-click git/SSH proxy toggle with connectivity tests.
★ 0
MIT
TypeScript
Aug 16, 2026
dsh plugin --profile web add dsh-git-proxy