关于 Clash Verge

开源、透明、社区驱动

项目介绍

Clash Verge 是一款基于 Clash 内核开发的跨平台图形化代理客户端，采用 Tauri 框架构建，拥有轻量级的体积和出色的性能表现。项目旨在为用户提供美观、易用、功能强大的网络代理体验。

项目采用 GPL-3.0 开源许可证，源代码完全公开透明。我们欢迎所有开发者参与贡献，无论是代码提交、Bug 反馈、文档完善还是翻译支持，都是对项目发展的宝贵贡献。

Clash Verge 支持 Windows、macOS 和 Linux 三大操作系统，同时兼容 Clash Premium 和 Clash Meta 双内核，满足不同用户的多样化需求。

贡献指南

如果您希望为 Clash Verge 项目做出贡献，可以通过以下方式参与：

1. 在 GitHub 上提交 Issue 报告 Bug 或提出功能建议，请尽量提供详细的复现步骤和环境信息。

2. Fork 项目仓库，提交 Pull Request 贡献代码。请遵循项目的代码规范和提交信息格式要求。

3. 帮助完善项目文档和翻译，让全球更多用户能够使用和理解 Clash Verge。

4. 在社区中帮助其他用户解答问题，分享您的使用经验和配置技巧。

社区渠道

💻

GitHub

源码仓库、Issue 反馈与 Pull Request

访问 GitHub
✉

Telegram

官方频道公告与群组即时交流

加入频道
💬

Discord

国际化社区讨论与技术交流

加入服务器
📖

GitHub Wiki

官方文档与知识库

查看文档
⚠ 官方渠道仅限以上平台（GitHub、Telegram、Discord），请勿相信任何第三方分发版本，谨防篡改植入。

高速节点购买

关于与社区常见问题

1. Clash Verge 项目是否完全免费？如何维持运营？

  1. Clash Verge 是完全免费且开源的软件，遵循 GPL-3.0 许可证，任何人都可以自由下载、使用和修改源代码。
  2. 项目的运营资金主要来自社区赞助和志愿者贡献，我们没有商业盈利模式，也不会在软件中植入广告或追踪代码。
  3. 赞助资金用于支付 GitHub 组织费用、文档托管服务器、域名续费以及偶尔的开发者激励等基础运营成本。
  4. 您可以通过爱发电（Afdian）或 Open Collective 平台进行定期或一次性赞助，所有赞助记录公开透明可查。
  5. 除了资金赞助，贡献代码、完善文档、帮助翻译、在社区中解答问题等都是对项目的重要支持方式。
  6. 我们承诺永远不会在软件中添加付费功能或限制免费版功能，所有用户都将获得完整的功能体验和平等的更新支持。

2. 如何验证下载的客户端是否为官方正版？

  1. 官方客户端仅通过 GitHub Releases 页面发布，这是唯一可信的官方下载渠道，其他任何来源的分发均非官方授权。
  2. 每个官方发布版本都附带 SHA256 校验码和 GPG 签名文件，下载后请核对文件哈希值确保完整性未被篡改。
  3. 官方 GPG 公钥指纹会在 GitHub 仓库的 README 和 Telegram 频道中公布，您可以导入公钥后验证 .asc 签名文件。
  4. 切勿从第三方下载站、网盘分享链接或不明来源获取安装包，这些文件可能已被植入恶意代码或后门程序。
  5. 安装后如怀疑客户端安全性，可使用 VirusTotal 等在线扫描工具对安装包进行多引擎检测，确认是否存在恶意特征。
  6. 本站（clashpd.com.cn）提供的下载链接指向官方 GitHub Releases 页面或经验证的 CDN 镜像，可放心使用。

3. 如何参与 Clash Verge 的代码贡献？

  1. 首先 Fork Clash Verge 的 GitHub 仓库到您自己的账号下，然后在本地克隆 Fork 后的仓库进行开发工作。
  2. 项目基于 Tauri 框架开发，前端使用 React/Vue，后端使用 Rust。确保本地安装了 Node.js 和 Rust 开发环境。
  3. 按照仓库 README 中的开发环境搭建指南安装依赖并运行项目，确保开发环境配置正确后再开始编写代码。
  4. 完成代码修改后，确保通过所有现有的测试用例，并为新功能或 Bug 修复编写相应的测试代码。
  5. 提交 Pull Request 时请遵循项目的提交规范（Conventional Commits），清晰描述修改内容和目的，关联相关 Issue。
  6. 提交后项目维护者会在合理时间内进行代码审查（Code Review），根据反馈进行修改调整后即可合并到主分支。

4. Telegram 群组和 Discord 服务器有什么区别？该加入哪个？

  1. Telegram 频道主要用于发布官方公告和版本更新通知，群组则是中文用户的主要交流阵地，适合国内用户日常使用。
  2. Discord 服务器面向国际化社区，设有多个频道分类（如中文区、英文区、开发讨论区），适合习惯使用 Discord 的用户。
  3. 两个平台的官方团队成员都会参与交流和答疑，问题响应速度相近，选择您更习惯使用的平台加入即可。
  4. Telegram 群组支持消息推送通知，适合希望第一时间获取官方公告的用户；Discord 的频道分类更细致，便于查找特定话题。
  5. 如果您同时使用两个平台，可以都加入以获得更全面的信息覆盖，但请注意不要在两个平台重复提问相同问题。
  6. 无论加入哪个平台，请遵守群规，保持友善交流氛围，不要发布广告、违规内容或未经证实的信息。

5. 发现 Bug 后应该如何正确提交 Issue？

  1. 在提交 Issue 前，先在 GitHub Issues 中搜索是否已有相同或类似的问题报告，避免重复提交浪费维护者的时间。
  2. 点击"New Issue"按钮，选择对应的 Issue 模板（Bug Report / Feature Request），按照模板要求填写完整信息。
  3. Bug 报告需包含：Clash Verge 版本号、操作系统及版本、详细的复现步骤、预期行为与实际行为的对比描述。
  4. 如果可能，请附上相关截图或日志文件（可在客户端 Logs 页面导出），这些信息对开发者定位问题至关重要。
  5. 请保持 Issue 描述的客观和礼貌，避免使用情绪化语言。开发者是志愿者，良好的沟通有助于问题更快得到解决。
  6. 提交后请关注 Issue 动态，及时回复维护者的追问或验证请求。问题解决后请关闭 Issue 并确认修复结果。

6. 如何成为 Clash Verge 的核心贡献者或维护者？

  1. 持续为项目贡献高质量的代码、文档或翻译，建立稳定的贡献记录。维护者会关注活跃且贡献质量高的社区成员。
  2. 积极参与 Issue 和 Pull Request 的审查工作，帮助其他贡献者改进代码，展现您对项目的理解和责任心。
  3. 在社区中积极帮助其他用户解答问题，分享有价值的教程和经验，建立良好的社区声誉和影响力。
  4. 当您的贡献达到一定规模和质量后，现有维护者会发起内部讨论，邀请符合条件的贡献者加入核心开发团队。
  5. 核心贡献者将获得仓库的直接推送权限、Issue 管理权限以及参与项目方向决策讨论的资格。
  6. 维护者身份需要长期稳定的投入和对项目的深度理解，这是一个自然晋升的过程，无需主动申请，用贡献说话。