从源码构建 Void 编辑器 Rust CLI环境搭建、Windows OpenSSL 依赖与隧道密钥交换原理【免费下载链接】void开源AI代码编辑器Cursor的替代方案。项目地址: https://gitcode.com/GitHub_Trending/void2/void本篇技术指南面向希望从源码自行构建 Void 编辑器命令行客户端CLI的开发者以仓库中的 cli/CONTRIBUTING.md 为核心脉络完整讲解子模块初始化、Rust 工具链配置、Windows 平台 OpenSSL/vcpkg 依赖安装并深入挖掘 CLI 内部隧道Tunnel转发为何依赖 OpenSSL 的密钥交换原理。读完本文你将能够独立完成 CLI 的编译与调试环境搭建并理解 Basis 隧道转发背后的加密选型逻辑。一、CLI 是什么仓库中的 Rust 命令行客户端Void 编辑器作为开源 AI 代码编辑器其命令行客户端是一套独立的 Rust 工程位于仓库的 cli/ 目录在 cli/CONTRIBUTING.md 中它被称为 launcher即当前仓库中的cli目录。从 cli/Cargo.toml 可以看到包名为code-cli默认二进制入口为codedefault-run codecli/src/lib.rs 为库入口采用edition 2021异步运行时基于tokiofeatures [full]隧道能力直接复用微软开源项目microsoft/dev-tunnelstunnels依赖default-features false, features [connections]对应实现集中在 cli/src/tunnels/ 的 24 个 Rust 文件中平台相关依赖按目标系统拆分Windows 使用winreg/winapimacOS 使用core-foundationLinux 使用zbus见 cli/Cargo.toml发布配置采用strip true、lto true、codegen-units 1追求更小的二进制体积与更优的运行性能cli/Cargo.toml。二、源码构建前的环境准备1. 克隆仓库并初始化子模块CLI 工程依赖多个子模块因此在克隆之后必须先执行子模块初始化。按照 cli/CONTRIBUTING.md 的步骤git clone 仓库地址 void cd void git submodule update --init --recursive--recursive会递归初始化嵌套子模块确保microsoft/dev-tunnels等外部依赖以 git 依赖形式出现在 cli/Cargo.toml 的[dependencies]中能够被完整拉取这是后续cargo build成功的前提。若跳过此步Cargo 在解析 git 依赖时可能因缺少对应提交例如tunnels依赖固定的rev 8cae9b2a24c65c6c1958f5a0e77d72b23b5c6c30而失败。2. 安装必需扩展文档要求安装两个 VS Code 扩展以提供 Rust 开发体验rust-analyzer提供 Rust 代码的补全、跳转、类型推断与错误提示CodeLLDB基于 LLDB 的调试器支持用于后续对 CLI 进程断点调试。两者均可通过 VS Code 的扩展市场直接搜索安装。3. 将工作区根目录指向 CLI 目录文档强调 Ensure your workspace is set to thelauncherfolder being the root即必须将 VS Code 工作区根目录设置为包含 Rust 工作区的那个文件夹当前仓库中即 cli/。这样做是为了让 rust-analyzer 与 CodeLLDB 能正确识别Cargo.toml所在的工程根避免把整个仓库当作一个工作区导致构建/调试目标错乱。三、Windows 平台构建vcpkg 与 OpenSSL 的安装1. 为什么 Windows 需要额外安装 OpenSSL在 Linux/macOS 上 OpenSSL 通常随系统存在而 Windows 默认并不附带。CLI 的隧道功能在做密钥交换时需要 OpenSSL 支持因此 Windows 上必须手动安装。文档给出了完整的四步流程按照微软 vcpkg 官方入门文档的步骤 1 和步骤 2完成 vcpkg 的克隆与引导生成vcpkg.exe将vcpkg目录添加到系统或用户 PATH环境变量重启终端使 PATH 生效后执行vcpkg install openssl:x64-windows-static-md其中x64-windows-static-md表示 64 位 Windows 平台、静态链接且使用动态 CRT/MD的 OpenSSL 构建配置与 CLI 的链接方式匹配完成后即可在cli目录下执行cargo build成功编译。2. 源码侧的证据keyring 与 OpenSSL 的耦合OpenSSL 并非孤立存在。查看 cli/Cargo.toml凭据存储库keyring的 Linux 特性即包含linux-secret-service-rt-tokio-crypto-openssl而tunnels的connections特性也涉及加密握手。也就是说OpenSSL 同时服务于隧道密钥交换与密钥环凭据加解密两条链路这也是文档强调OpenSSL is needed for the key exchange we do when forwarding Basis tunnels的原因。四、原理深挖为什么隧道转发离不开 OpenSSL1. Basis 隧道的密钥交换CLI 的端口转发/隧道能力围绕tunnels模块构建核心文件包括cli/src/tunnels/dev_tunnels.rs负责与隧道管理服务通信、创建/维护ActiveTunnel、生成转发端口的公开 URIcli/src/tunnels/port_forwarder.rsPortForwardingProcessor通过 mpsc 通道接收Forward/Unforward请求并逐个处理转发状态维护在一个HashSetu16中cli/src/tunnels/control_server.rs控制面服务端handle_forward/handle_unforward在此被触发见该文件约 L445-L449cli/src/tunnels/local_forwarding.rs本地转发器负责实际的端口流量转发与日志记录如forwarding {} port {} at {:?}。在这些组件构成的 Basis 隧道链路中客户端与隧道中继Relay之间需要执行密钥交换以建立加密信道。该密钥交换的数学基础依赖 OpenSSL 提供的密码学原语因此在 Windows 上缺了 OpenSSLcargo build便无法链接成功。2. ED25519 与 libsodium 的替代路径文档指出一旦所有涉及 Basis 的客户端都支持ED25519签名算法CLI 将可以完全摆脱 OpenSSL转而仅使用libsodium。但现实约束在于Chromium即编辑器前端的宿主运行时目前对 ED25519 相关能力没有积极的开发进展由于跨端客户端尚未统一支持 ED25519现阶段只能保留 OpenSSL 来完成与既有客户端的兼容密钥交换。从工程选型角度看这是一个典型的受制于生态兼容性的加密栈决策不是不想换更轻量的 libsodium 方案而是下游客户端的支持进度决定了上游不能先行切换。对希望裁剪依赖、缩减二进制体积的构建者来说这条说明也解释了为什么当前阶段不能简单移除 OpenSSL。五、调试 CLI使用预配置的 Debug 任务文档的 Debug 一节说明仓库已经预先配置好了 Debug 任务可以直接用来运行 launcherCLI。结合 CodeLLDB 扩展开发者可以在 VS Code 中打开以cli为根的工作区打开 Run and Debug 面板选择仓库预置的 Debug 任务启动后即可对 CLI 进程设置断点、观察变量、查看调用栈。预置任务的配置即来自前面安装的 CodeLLDB 扩展与 rust-analyzer 的配合无需手工编写 launch 配置即可进入断点调试。六、常见问题与构建自检清单结合 cli/CONTRIBUTING.md 的步骤与源码结构构建失败时可按以下顺序排查现象可能原因处置Cargo 解析 git 依赖失败子模块未初始化执行git submodule update --init --recursiveWindows 下链接 OpenSSL 符号失败未安装 vcpkg 与 OpenSSL按上文四步安装openssl:x64-windows-static-md并重启终端rust-analyzer 报工程错误工作区根目录不在cli将 VS Code 工作区根指向 cli/无法断点缺少 CodeLLDB安装 CodeLLDB 扩展后重试 Debug 任务代码风格不符仓库带有 cli/rustfmt.toml提交前运行cargo fmt以对齐仓库格式七、小结围绕 cli/CONTRIBUTING.md 这篇构建指南本文完整覆盖了克隆 子模块初始化 → 安装 rust-analyzer/CodeLLDB → 设置工作区根 → Windows 安装 vcpkg/OpenSSL → cargo build → 使用 Debug 任务调试的全流程并从源码层面解释了 OpenSSL 之于 Basis 隧道密钥交换的必要性以及未来切换到 ED25519 libsodium 的演进方向。无论你是想在 Windows 上从零编译 CLI还是想深入理解其隧道加密选型都可以以此为起点继续探索 cli/src/tunnels/ 中 24 个实现文件例如阅读 cli/src/tunnels/dev_tunnels.rs 了解隧道生命周期管理或阅读 cli/src/tunnels/port_forwarder.rs 了解端口转发请求的并发处理模型。【免费下载链接】void开源AI代码编辑器Cursor的替代方案。项目地址: https://gitcode.com/GitHub_Trending/void2/void创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 从源码构建 Void 编辑器 Rust CLI：环境搭建、Windows OpenSSL 依赖与隧道密钥交换原理
从源码构建 Void 编辑器 Rust CLI环境搭建、Windows OpenSSL 依赖与隧道密钥交换原理【免费下载链接】void开源AI代码编辑器Cursor的替代方案。项目地址: https://gitcode.com/GitHub_Trending/void2/void本篇技术指南面向希望从源码自行构建 Void 编辑器命令行客户端CLI的开发者以仓库中的 cli/CONTRIBUTING.md 为核心脉络完整讲解子模块初始化、Rust 工具链配置、Windows 平台 OpenSSL/vcpkg 依赖安装并深入挖掘 CLI 内部隧道Tunnel转发为何依赖 OpenSSL 的密钥交换原理。读完本文你将能够独立完成 CLI 的编译与调试环境搭建并理解 Basis 隧道转发背后的加密选型逻辑。一、CLI 是什么仓库中的 Rust 命令行客户端Void 编辑器作为开源 AI 代码编辑器其命令行客户端是一套独立的 Rust 工程位于仓库的 cli/ 目录在 cli/CONTRIBUTING.md 中它被称为 launcher即当前仓库中的cli目录。从 cli/Cargo.toml 可以看到包名为code-cli默认二进制入口为codedefault-run codecli/src/lib.rs 为库入口采用edition 2021异步运行时基于tokiofeatures [full]隧道能力直接复用微软开源项目microsoft/dev-tunnelstunnels依赖default-features false, features [connections]对应实现集中在 cli/src/tunnels/ 的 24 个 Rust 文件中平台相关依赖按目标系统拆分Windows 使用winreg/winapimacOS 使用core-foundationLinux 使用zbus见 cli/Cargo.toml发布配置采用strip true、lto true、codegen-units 1追求更小的二进制体积与更优的运行性能cli/Cargo.toml。二、源码构建前的环境准备1. 克隆仓库并初始化子模块CLI 工程依赖多个子模块因此在克隆之后必须先执行子模块初始化。按照 cli/CONTRIBUTING.md 的步骤git clone 仓库地址 void cd void git submodule update --init --recursive--recursive会递归初始化嵌套子模块确保microsoft/dev-tunnels等外部依赖以 git 依赖形式出现在 cli/Cargo.toml 的[dependencies]中能够被完整拉取这是后续cargo build成功的前提。若跳过此步Cargo 在解析 git 依赖时可能因缺少对应提交例如tunnels依赖固定的rev 8cae9b2a24c65c6c1958f5a0e77d72b23b5c6c30而失败。2. 安装必需扩展文档要求安装两个 VS Code 扩展以提供 Rust 开发体验rust-analyzer提供 Rust 代码的补全、跳转、类型推断与错误提示CodeLLDB基于 LLDB 的调试器支持用于后续对 CLI 进程断点调试。两者均可通过 VS Code 的扩展市场直接搜索安装。3. 将工作区根目录指向 CLI 目录文档强调 Ensure your workspace is set to thelauncherfolder being the root即必须将 VS Code 工作区根目录设置为包含 Rust 工作区的那个文件夹当前仓库中即 cli/。这样做是为了让 rust-analyzer 与 CodeLLDB 能正确识别Cargo.toml所在的工程根避免把整个仓库当作一个工作区导致构建/调试目标错乱。三、Windows 平台构建vcpkg 与 OpenSSL 的安装1. 为什么 Windows 需要额外安装 OpenSSL在 Linux/macOS 上 OpenSSL 通常随系统存在而 Windows 默认并不附带。CLI 的隧道功能在做密钥交换时需要 OpenSSL 支持因此 Windows 上必须手动安装。文档给出了完整的四步流程按照微软 vcpkg 官方入门文档的步骤 1 和步骤 2完成 vcpkg 的克隆与引导生成vcpkg.exe将vcpkg目录添加到系统或用户 PATH环境变量重启终端使 PATH 生效后执行vcpkg install openssl:x64-windows-static-md其中x64-windows-static-md表示 64 位 Windows 平台、静态链接且使用动态 CRT/MD的 OpenSSL 构建配置与 CLI 的链接方式匹配完成后即可在cli目录下执行cargo build成功编译。2. 源码侧的证据keyring 与 OpenSSL 的耦合OpenSSL 并非孤立存在。查看 cli/Cargo.toml凭据存储库keyring的 Linux 特性即包含linux-secret-service-rt-tokio-crypto-openssl而tunnels的connections特性也涉及加密握手。也就是说OpenSSL 同时服务于隧道密钥交换与密钥环凭据加解密两条链路这也是文档强调OpenSSL is needed for the key exchange we do when forwarding Basis tunnels的原因。四、原理深挖为什么隧道转发离不开 OpenSSL1. Basis 隧道的密钥交换CLI 的端口转发/隧道能力围绕tunnels模块构建核心文件包括cli/src/tunnels/dev_tunnels.rs负责与隧道管理服务通信、创建/维护ActiveTunnel、生成转发端口的公开 URIcli/src/tunnels/port_forwarder.rsPortForwardingProcessor通过 mpsc 通道接收Forward/Unforward请求并逐个处理转发状态维护在一个HashSetu16中cli/src/tunnels/control_server.rs控制面服务端handle_forward/handle_unforward在此被触发见该文件约 L445-L449cli/src/tunnels/local_forwarding.rs本地转发器负责实际的端口流量转发与日志记录如forwarding {} port {} at {:?}。在这些组件构成的 Basis 隧道链路中客户端与隧道中继Relay之间需要执行密钥交换以建立加密信道。该密钥交换的数学基础依赖 OpenSSL 提供的密码学原语因此在 Windows 上缺了 OpenSSLcargo build便无法链接成功。2. ED25519 与 libsodium 的替代路径文档指出一旦所有涉及 Basis 的客户端都支持ED25519签名算法CLI 将可以完全摆脱 OpenSSL转而仅使用libsodium。但现实约束在于Chromium即编辑器前端的宿主运行时目前对 ED25519 相关能力没有积极的开发进展由于跨端客户端尚未统一支持 ED25519现阶段只能保留 OpenSSL 来完成与既有客户端的兼容密钥交换。从工程选型角度看这是一个典型的受制于生态兼容性的加密栈决策不是不想换更轻量的 libsodium 方案而是下游客户端的支持进度决定了上游不能先行切换。对希望裁剪依赖、缩减二进制体积的构建者来说这条说明也解释了为什么当前阶段不能简单移除 OpenSSL。五、调试 CLI使用预配置的 Debug 任务文档的 Debug 一节说明仓库已经预先配置好了 Debug 任务可以直接用来运行 launcherCLI。结合 CodeLLDB 扩展开发者可以在 VS Code 中打开以cli为根的工作区打开 Run and Debug 面板选择仓库预置的 Debug 任务启动后即可对 CLI 进程设置断点、观察变量、查看调用栈。预置任务的配置即来自前面安装的 CodeLLDB 扩展与 rust-analyzer 的配合无需手工编写 launch 配置即可进入断点调试。六、常见问题与构建自检清单结合 cli/CONTRIBUTING.md 的步骤与源码结构构建失败时可按以下顺序排查现象可能原因处置Cargo 解析 git 依赖失败子模块未初始化执行git submodule update --init --recursiveWindows 下链接 OpenSSL 符号失败未安装 vcpkg 与 OpenSSL按上文四步安装openssl:x64-windows-static-md并重启终端rust-analyzer 报工程错误工作区根目录不在cli将 VS Code 工作区根指向 cli/无法断点缺少 CodeLLDB安装 CodeLLDB 扩展后重试 Debug 任务代码风格不符仓库带有 cli/rustfmt.toml提交前运行cargo fmt以对齐仓库格式七、小结围绕 cli/CONTRIBUTING.md 这篇构建指南本文完整覆盖了克隆 子模块初始化 → 安装 rust-analyzer/CodeLLDB → 设置工作区根 → Windows 安装 vcpkg/OpenSSL → cargo build → 使用 Debug 任务调试的全流程并从源码层面解释了 OpenSSL 之于 Basis 隧道密钥交换的必要性以及未来切换到 ED25519 libsodium 的演进方向。无论你是想在 Windows 上从零编译 CLI还是想深入理解其隧道加密选型都可以以此为起点继续探索 cli/src/tunnels/ 中 24 个实现文件例如阅读 cli/src/tunnels/dev_tunnels.rs 了解隧道生命周期管理或阅读 cli/src/tunnels/port_forwarder.rs 了解端口转发请求的并发处理模型。【免费下载链接】void开源AI代码编辑器Cursor的替代方案。项目地址: https://gitcode.com/GitHub_Trending/void2/void创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考