开发提效神器 DevSidecar 安装指南

蓝玄
29 阅读5分钟

🚀 开发提效神器 DevSidecar 安装指南，轻松解决各类开发访问问题

作为开发者，我们经常会遇到 GitHub 访问慢、文档加载超时、依赖包下载失败等问题，而 DevSidecar（开发者边车）正是为解决这些痛点而生的代理神器！它能自动识别开发场景的网络请求并进行智能代理，无需手动配置，开箱即用。本文将详细讲解 DevSidecar 的安装步骤，帮你快速上手这款工具。

📌 工具简介

DevSidecar 是一款专为开发者设计的本地代理工具，核心功能包括：

  • GitHub 加速：克隆、下载、访问速度大幅提升；
  • 开发者文档加速：MDN、React 官网、Vue 官网等一键提速；
  • 包管理加速：npm、yarn、pip 等依赖下载自动代理；
  • 无需手动配置规则，自动识别开发场景请求；
  • 跨平台支持：Windows、Mac、Linux 均兼容，同时支持 arm 架构（windows-arm64、linux-arm64、macos-arm64）。

工具仓库地址：github.com/docmirror/d…

🛠 安装步骤

第一步：下载安装包

  1. 打开 DevSidecar 的 Release 页面：github.com/docmirror/d…

  2. 根据自己的操作系统选择对应的安装包（优先选择最新稳定版 v2.0.0，避免 RC 测试版，该版本已修复 Mac 图标变大等常见问题）：

  • Windows：下载 .exe 格式安装包（如 DevSidecar-2.0.0-windows-x64.exe）；

  • Mac：区分架构，x64 芯片下载 DevSidecar-2.0.0-macos-x64.dmg，arm64 芯片下载 DevSidecar-2.0.0-macos-arm64.dmg；

  • Linux：根据架构选择，可下载 .AppImage、.deb 或 .tar.gz 格式包（如 DevSidecar-2.0.0-linux-x86_64.AppImage、DevSidecar-2.0.0-linux-arm64.deb）。

第二步：安装工具（分系统说明）

Windows 系统

  1. 双击下载好的 .exe 安装包，会弹出安装向导，点击「下一步」；

  2. 选择安装目录（建议默认路径，或自定义非中文路径，避免中文路径导致启动失败）；

  3. 勾选「创建桌面快捷方式」，点击「安装」；

  4. 等待安装完成后，点击「完成」启动 DevSidecar。

Mac 系统

  1. 双击下载的 .dmg 安装包，打开后将「DevSidecar」拖入「应用程序」文件夹；

  2. 打开「应用程序」，找到 DevSidecar，右键选择「打开」（首次打开会提示未知开发者，这是正常现象，该版本已修复 Mac dock 图标加载失败问题）；

  3. 在弹出的安全提示中，点击「打开」即可启动工具。

Linux 系统

  1. 下载 .AppImage 包后，赋予可执行权限：
chmod +x DevSidecar-2.0.0-linux-x86_64.AppImage

2. 直接运行文件启动工具：

./DevSidecar-2.0.0-linux-x86_64.AppImage

（若使用 .deb 包，执行 dpkg -i DevSidecar-2.0.0-linux-amd64.deb 即可完成安装；若使用 .tar.gz 包，解压后执行对应启动脚本）

第三步：基础配置与使用

  1. 启动 DevSidecar 后，工具会自动驻留在系统托盘（Windows 右下角、Mac 右上角，Linux 系统需先设置快捷键 Alt+S 才能呼出，支持隐藏窗口）；

  2. 首次启动会提示「安装证书」，必须安装证书才能实现 HTTPS 代理，点击「安装证书」并按照提示完成授权：

  • Windows：证书会自动安装到「受信任的根证书颁发机构」，无需手动操作；
  • Mac：需要手动打开「钥匙串访问」，找到对应证书，将其设置为「始终信任」；
  • Linux：按照提示完成证书安装，确保代理功能正常生效。

  1. 证书安装完成后，工具默认自动开启代理，无需额外配置，此时访问 GitHub、MDN 等网站即可感受到速度提升；

  2. 如需自定义规则（如添加专属域名、调整代理模式、配置 DNS、设置日志保存路径等），可右键托盘图标，选择「设置」进入配置页面；新增的内容搜索功能（快捷键 Ctrl+F）可快速查找配置项。

⚠️ 常见问题解决

  1. 启动后无响应/加速无效：
  • 检查是否安装证书，未安装则重新安装；
  • 关闭系统自带的代理工具（如梯子、其他代理软件），避免冲突；
  • 重启 DevSidecar 并确保工具在系统托盘正常运行；
  • 若为 v2.0.0 版本，检查是否下载的是稳定版，避免 RC 测试版的兼容性问题；若启动失败，可查看日志（日志路径可在设置中配置）排查问题。
  1. Mac 系统提示“无法验证开发者” ：
  • 打开「系统设置」→「隐私与安全性」→ 找到「安全性」板块，点击「仍要打开」即可；
  • 若仍无法打开，可在终端执行 xattr -d com.apple.quarantine /Applications/DevSidecar.app 解除限制。
  1. GitHub ****克隆 仍慢：
  • 右键托盘图标，选择「工具」→「GitHub 加速」，切换加速节点；
  • 检查网络环境，部分网络需要手动切换代理模式（HTTP/HTTPS）；
  • 可在设置中配置 DNS（支持 UDP、TCP、TLS 类型），优化网络连接。
  1. Linux 系统无法呼出窗口：

  • 先设置快捷键（默认 Alt+S），设置完成后即可通过快捷键呼出工具窗口；

  • 若使用 .AppImage 包无法启动，可检查是否赋予了可执行权限，或更换 .deb 包安装。

🎯 总结

DevSidecar 是一款真正“开箱即用”的开发者代理神器，v2.0.0 版本完成了框架升级（NodeJS 升级至 22.x）、提升了各 OS 兼容性，新增了内容搜索、自定义日志配置等实用功能，无需复杂的配置，就能解决日常开发中绝大多数的网络访问问题。按照本文的步骤完成安装和配置后，你会发现 GitHub 克隆、文档查阅、依赖下载的效率大幅提升！

如果使用过程中遇到问题，可前往项目仓库提 Issue，也欢迎在评论区交流你的使用体验～

项目仓库：github.com/docmirror/d…

温馨提示：本文仅用于技术交流，使用工具时请遵守当地网络法规和相关规定。

avatar
文章
阅读
粉丝