@tedbrain/vlink 0.1.64 → 0.1.66

package/README.md

@@ -76,6 +76,20 @@ release 不存在或校验失败时，自动回退到 d01 下载服务器：
 回退: http://49.232.144.199/downloads/oss/vlink/<version>/vlink-<platform>
 ```
 
+下载器遵循标准代理环境变量，同时支持大写和小写形式：
+
+```bash
+HTTP_PROXY=http://proxy.example:8080
+HTTPS_PROXY=http://proxy.example:8080
+NO_PROXY=localhost,127.0.0.1,.internal.example
+```
+
+也支持 `http_proxy`、`https_proxy`、`no_proxy`、`ALL_PROXY`，以及 npm 注入的
+`npm_config_proxy`、`npm_config_https_proxy` 和 `npm_config_noproxy`。小写变量与
+大写变量同时存在时优先使用小写。HTTPS 请求通过代理的 CONNECT 隧道传输；每次
+重定向都会根据目标地址重新应用代理和 `NO_PROXY`。verbose 日志仅显示脱敏后的
+代理主机，不显示代理用户名、密码或下载 URL 查询参数。
+
 可用环境变量覆盖：
 
 ```bash

package/binaries.json

@@ -1,12 +1,12 @@
 {
-  "version": "0.1.64",
+  "version": "0.1.66",
   "binaries": {
-    "linux-x86_64": "cd46ed189a1cb56a4d2ff84af7cda6a4870ad202f6172500e02a29654cb82b54",
-    "linux-x86_64-glibc2.17": "d578c70bafe98de520b25e78ea10919a12cb14fff0524ab3339bb0d912a78961",
-    "linux-aarch64": "8acbcce5bd84e14652f778ab987abe2a9f461b3ba4bb0dbe4022f8900a42868e",
-    "macos-x86_64": "5e96d897d75dc02a0e8acca05bfb8a5910751d38b10de0eda9f1c0ae9ac6df13",
-    "macos-aarch64": "8481807cd40cac885908550959e259164eaf9d2a20f10e2972c57a5f3e125815",
-    "windows-x86_64.exe": "90a2a090f993bc6258ccddacf62aa05d99d96b411a39a041cf2e6f19c6f8fd69",
-    "windows-aarch64.exe": "e96d0dcbfde313747a62cb7b5f945cfdf444927f40e758f25ed06da6c0d517b6"
+    "linux-x86_64": "c2c49f8b91add274f11157ba7b3d1f9d1c6bad2773163e0c5519f5ffa2e264d8",
+    "linux-x86_64-glibc2.17": "5fcd9b7e0263d566c92799524a2ca4bccb181687c5ad11e5cd3ef6a625e5fc26",
+    "linux-aarch64": "ef1568f34062697a88c91837ead906178dd8a9a64bc63140765c57782db82ca9",
+    "macos-x86_64": "d33fb87786b1d61e386fd4b3452580cfea1faae6aa511e61027bfca7ca9e4e9d",
+    "macos-aarch64": "59e577015da3f14fb2cc1010bd1cf66a59d9510d068174fe3e86dd6cbccbb187",
+    "windows-x86_64.exe": "a5a9e65fc50e035e335530abd211e0341e9be539464e01f2fc95ce4dea502955",
+    "windows-aarch64.exe": "f0ecc9bd1211ebaf9be04ade0d8c9722c024c841483b1897af13d2d74f6e52cd"
   }
 }

package/install.js

@@ -8,6 +8,8 @@ const https = require('https');
 const os = require('os');
 const path = require('path');
 const { spawnSync } = require('child_process');
+const { HttpProxyAgent } = require('http-proxy-agent');
+const { HttpsProxyAgent } = require('https-proxy-agent');
 
 const PKG_ROOT = path.resolve(__dirname);
 const PKG = JSON.parse(fs.readFileSync(path.join(PKG_ROOT, 'package.json'), 'utf8'));
@@ -51,6 +53,107 @@ function displayUrl(value) {
   }
 }
 
+function firstEnvironmentValue(env, names) {
+  for (const name of names) {
+    if (Object.prototype.hasOwnProperty.call(env, name) && env[name]) {
+      return String(env[name]).trim();
+    }
+  }
+  return '';
+}
+
+function normalizeProxyUrl(value) {
+  if (!value) return '';
+  const candidate = /^[a-z][a-z0-9+.-]*:\/\//i.test(value)
+    ? value
+    : `http://${value}`;
+  try {
+    return new URL(candidate).toString();
+  } catch (error) {
+    throw new VlinkInstallError(`invalid proxy URL: ${error.message}`);
+  }
+}
+
+function noProxyMatches(target, value) {
+  if (!value) return false;
+  const url = new URL(target);
+  const hostname = url.hostname.toLowerCase().replace(/^\[|\]$/g, '');
+  const port = url.port || (url.protocol === 'https:' ? '443' : '80');
+
+  return String(value).split(/[\s,]+/).filter(Boolean).some((entry) => {
+    if (entry === '*') return true;
+    let rule = entry.toLowerCase();
+    let rulePort = '';
+    if (rule.startsWith('[')) {
+      const end = rule.indexOf(']');
+      if (end !== -1 && rule[end + 1] === ':') {
+        rulePort = rule.slice(end + 2);
+        rule = rule.slice(1, end);
+      } else if (end !== -1) {
+        rule = rule.slice(1, end);
+      }
+    } else {
+      const colon = rule.lastIndexOf(':');
+      if (colon > -1 && rule.indexOf(':') === colon && /^\d+$/.test(rule.slice(colon + 1))) {
+        rulePort = rule.slice(colon + 1);
+        rule = rule.slice(0, colon);
+      }
+    }
+    if (rulePort && rulePort !== port) return false;
+    if (rule.startsWith('*')) rule = rule.slice(1);
+    if (rule.startsWith('.')) {
+      return hostname.endsWith(rule) || hostname === rule.slice(1);
+    }
+    return hostname === rule || hostname.endsWith(`.${rule}`);
+  });
+}
+
+function proxyForUrl(target, env = process.env) {
+  const noProxy = firstEnvironmentValue(env, [
+    'no_proxy',
+    'NO_PROXY',
+    'npm_config_noproxy',
+    'npm_config_no_proxy'
+  ]);
+  if (noProxyMatches(target, noProxy)) return '';
+
+  const protocol = new URL(target).protocol;
+  const names = protocol === 'https:'
+    ? [
+        'https_proxy',
+        'HTTPS_PROXY',
+        'npm_config_https_proxy',
+        'npm_config_proxy',
+        'http_proxy',
+        'HTTP_PROXY',
+        'all_proxy',
+        'ALL_PROXY'
+      ]
+    : [
+        'http_proxy',
+        'HTTP_PROXY',
+        'npm_config_proxy',
+        'all_proxy',
+        'ALL_PROXY'
+      ];
+  return normalizeProxyUrl(firstEnvironmentValue(env, names));
+}
+
+function requestAgent(target, options = {}) {
+  const proxy = proxyForUrl(target, options.env || process.env);
+  if (!proxy) {
+    verboseLog(`network stage: direct ${displayUrl(target)}`, options);
+    return undefined;
+  }
+  verboseLog(
+    `network stage: ${displayUrl(target)} via proxy ${displayUrl(proxy)}`,
+    options
+  );
+  return target.startsWith('https:')
+    ? new HttpsProxyAgent(proxy)
+    : new HttpProxyAgent(proxy);
+}
+
 function parseGlibcVersion(text) {
   for (const line of String(text || '').split(/\r?\n/)) {
     const glibcMatch = line.match(/\bglibc\s+([0-9]+(?:\.[0-9]+)+)/);
@@ -141,13 +244,16 @@ function fallbackDownloadUrl(spec, suffix = spec.suffix) {
   return `${DOWNLOAD_BASE}/${CHANNEL}/vlink/${VERSION}/vlink-${suffix}`;
 }
 
-function httpGetText(url) {
+function httpGetText(url, options = {}) {
   return new Promise((resolve, reject) => {
     const request = (target, redirects) => {
       const transport = target.startsWith('https:') ? https : http;
       const req = transport.get(
         target,
-        { headers: { 'user-agent': `${PKG.name}/${PKG.version}` } },
+        {
+          agent: requestAgent(target, options),
+          headers: { 'user-agent': `${PKG.name}/${PKG.version}` }
+        },
         (res) => {
           if (
             res.statusCode >= 300 &&
@@ -188,19 +294,22 @@ function parseJson(text, url) {
   }
 }
 
-async function giteeReleaseId(version) {
+async function giteeReleaseId(version, options = {}) {
   const url = `${GITEE_API_BASE}/releases/tags/${version}`;
-  const release = parseJson(await httpGetText(url), url);
+  const release = parseJson(await httpGetText(url, options), url);
   if (!release || typeof release !== 'object' || !Number.isInteger(release.id)) {
     throw new VlinkInstallError(`gitee release is missing an id: ${url}`);
   }
   return release.id;
 }
 
-async function giteeAttachmentDownloadUrl(spec, suffix = spec.suffix) {
-  const releaseId = await giteeReleaseId(VERSION);
+async function giteeAttachmentDownloadUrl(spec, suffix = spec.suffix, options = {}) {
+  const releaseId = await giteeReleaseId(VERSION, options);
   const attachmentsUrl = `${GITEE_API_BASE}/releases/${releaseId}/attach_files?per_page=100`;
-  const attachments = parseJson(await httpGetText(attachmentsUrl), attachmentsUrl);
+  const attachments = parseJson(
+    await httpGetText(attachmentsUrl, options),
+    attachmentsUrl
+  );
   if (!Array.isArray(attachments)) {
     throw new VlinkInstallError(`gitee attachments response is not an array: ${attachmentsUrl}`);
   }
@@ -223,12 +332,12 @@ async function giteeAttachmentDownloadUrl(spec, suffix = spec.suffix) {
   throw new VlinkInstallError(`gitee attachment has no usable download URL: ${remoteName}`);
 }
 
-function buildDownloadSources(spec, suffix = spec.suffix) {
+function buildDownloadSources(spec, suffix = spec.suffix, options = {}) {
   const sources = [];
   if (process.env.VLINK_SKIP_GITEE !== '1') {
     sources.push({
       name: 'gitee',
-      resolve: () => giteeAttachmentDownloadUrl(spec, suffix)
+      resolve: () => giteeAttachmentDownloadUrl(spec, suffix, options)
     });
   }
   sources.push({
@@ -303,7 +412,7 @@ function sha256File(filePath) {
   });
 }
 
-function downloadFile(url, destPath) {
+function downloadFile(url, destPath, options = {}) {
   return new Promise((resolve, reject) => {
     const fileStream = fs.createWriteStream(destPath, { mode: 0o755 });
 
@@ -318,7 +427,10 @@ function downloadFile(url, destPath) {
       const transport = target.startsWith('https:') ? https : http;
       const req = transport.get(
         target,
-        { headers: { 'user-agent': `${PKG.name}/${PKG.version}` } },
+        {
+          agent: requestAgent(target, options),
+          headers: { 'user-agent': `${PKG.name}/${PKG.version}` }
+        },
         (res) => {
           if (
             res.statusCode >= 300 &&
@@ -389,7 +501,7 @@ async function ensureBinary(options = {}) {
 
   for (const suffix of spec.suffixes) {
     const tempPath = path.join(dir, `.${spec.binaryName}.download-${process.pid}`);
-    const sources = buildDownloadSources(spec, suffix);
+    const sources = buildDownloadSources(spec, suffix, options);
     verboseLog(
       `download stage: suffix=${suffix} sources=${sources.map((source) => source.name).join(',')}`,
       options
@@ -400,7 +512,7 @@ async function ensureBinary(options = {}) {
         const url = await source.resolve();
         console.error(`[vlink] downloading ${displayUrl(url)} [${source.name}]`);
         fs.rmSync(tempPath, { force: true });
-        await downloadFile(url, tempPath);
+        await downloadFile(url, tempPath, options);
         verboseLog(`download stage: received ${source.name} payload`, options);
 
         const checksum = expectedChecksum(spec, suffix);
@@ -440,6 +552,10 @@ module.exports = {
   GLIBC217_SUFFIX,
   verboseEnabled,
   displayUrl,
+  noProxyMatches,
+  proxyForUrl,
+  requestAgent,
+  httpGetText,
   parseGlibcVersion,
   glibcVersion,
   versionAtLeast,
@@ -447,6 +563,7 @@ module.exports = {
   fallbackDownloadUrl,
   giteeAttachmentDownloadUrl,
   buildDownloadSources,
+  downloadFile,
   resolveBinaryPath,
   ensureBinary,
   verifyBinary

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tedbrain/vlink",
-  "version": "0.1.64",
+  "version": "0.1.66",
   "description": "vlink Virtuoso bridge CLI installer. Installs the matching platform binary at npm install time, like Claude Code / Codex.",
   "license": "UNLICENSED",
   "bin": {
@@ -17,6 +17,10 @@
     "postinstall": "node install.js",
     "test": "node --test test/*.test.js"
   },
+  "dependencies": {
+    "http-proxy-agent": "^7.0.2",
+    "https-proxy-agent": "^7.0.6"
+  },
   "engines": {
     "node": ">=16"
   },