diff --git a/docs/assets/faq/macos/mac_ignore_password.png b/docs/assets/faq/macos/mac_ignore_password.png new file mode 100644 index 0000000..6963b49 Binary files /dev/null and b/docs/assets/faq/macos/mac_ignore_password.png differ diff --git a/docs/assets/icons/app_store.svg b/docs/assets/icons/app_store.svg new file mode 100644 index 0000000..2cf27a1 --- /dev/null +++ b/docs/assets/icons/app_store.svg @@ -0,0 +1,42 @@ + + + + + + + + + + + + + + + + \ No newline at end of file diff --git a/docs/faq/macos.md b/docs/faq/macos.md index 2301724..2654c1f 100644 --- a/docs/faq/macos.md +++ b/docs/faq/macos.md @@ -17,6 +17,15 @@ sudo xattr -d com.apple.quarantine /Applications/Clash\ Verge.app - 解决方案: 详见[macOS 使用手册](https://support.apple.com/zh-cn/guide/mac-help/mchleab3a043/mac),并选择对应 mac 版本的文档。 +## macOS 系统代理设置修改失败/开关无效 + +> 点击系统代理开关启用/禁用系统代理,系统代理设置中实际上未能被修改。 + +- 问题原因: 更改锁定的系统偏好设置需要管理员密码,当前可能处于普通权限。 +- 解决方案: `系统偏好设置` -> `安全性与隐私` -> `高级`,关闭 `访问系统范围偏好设置需要输入管理员密码` (不同系统版本的名称略有差异),点击 `完成` 。 + +![访问系统范围偏好设置需要输入管理员密码](../assets/faq/macos/mac_ignore_password.png) + ## macOS 菜单栏左上角图标重叠 ![菜单栏左上角图标重叠](../assets/faq/macos/mac_icon_duplicated.png) diff --git a/docs/faq/other.md b/docs/faq/other.md index 9078a08..d95e34d 100644 --- a/docs/faq/other.md +++ b/docs/faq/other.md @@ -90,7 +90,7 @@ dns: !!! info - 如果你的内核版本至少为`v1.18.2`,可以将系统变量 `DISABLE_SYSTEM_HOSTS` 设置为 `1` 。 - - 如果你的内核版本至少为`v1.18.5`(或最新 `alpha` 版本),可以使用下列方案。 + - 如果你的内核版本至少为`v1.18.5`(或最新 `alpha` 版本),可以使用下列方案。 - 如果你了解配置文件、`Merge`/`Srcipt`工作原理,只需按照你能够接受的方式,自行将** DNS 配置**中的[use-system-hosts](https://wiki.metacubex.one/config/dns/#use-system-hosts)修改为`false`即可。**下列方案均基于此原理**。 - 如果你的 Clash Verge Rev 版本为 `v1.6.2`及以上。在订阅页面新建一个 Merge 配置,文件使用以下内容保存并右键`启用`。 diff --git a/docs/faq/windows.md b/docs/faq/windows.md index 839257c..e040a84 100644 --- a/docs/faq/windows.md +++ b/docs/faq/windows.md @@ -1,3 +1,26 @@ +## 找不到 VCRUNTIMEXXX.dll,无法继续执行代码 + +- 问题原因:操作系统缺少 VC 运行环境所需的库。 +- 解决方案:下载并安装 VC 运行库。 + +=== "x64" + + | 运行库 | 下载地址 | + | -------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | + | `vc_redist.x64.exe` | [vc_redist.x64.exe](https://aka.ms/vs/17/release/vc_redist.x64.exe) | + +=== "x86" + + | 运行库 | 下载地址 | + | -------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | + | `vc_redist.x86.exe` | [vc_redist.x86.exe](https://aka.ms/vs/17/release/vc_redist.x86.exe) | + +=== "arm64" + + | 运行库 | 下载地址 | + | -------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | + | `vc_redist.arm64.exe` | [vc_redist.arm64.exe](https://aka.ms/vs/17/release/vc_redist.arm64.exe) | + ## 此应用无法在你的电脑上运行 ![can_not_run](../assets/faq/windows/can_not_run.png) @@ -32,16 +55,20 @@ ## Windows 7 无法使用 -问题原因 +解决方案 -- Verge 内置的 mihomo 内核使用 go1.21 编译,不支持 Windows 7。 +借助 [vxiiduu/VxKex](https://github.com/vxiiduu/VxKex) 项目运行,步骤: -解决方案 +- 下载 [Releases](https://github.com/vxiiduu/VxKex/releases) 中的 `KexSetup_Release_x_x_x_xxxx.exe` 并安装。 + +- 进入 Clash Verge 主程序目录,右键打开下面文件的属性,找到 `VxKex` 选项卡,勾选 `Enable VxKex for this program` 及 `Disable VxKex for child processes` 选项,即可正常运行。 -- 到 mihomo [Release](https://github.com/MetaCubeX/mihomo/releases/latest) 下载 go1.20 编译的内核(带有 `windows` 和 `go120` 字样) -- 右键 Verge 托盘图标,打开目录-内核目录,删除其中的`clash-meta.exe`和`clash-meta-alpha.exe` -- 将下载的内核解压到内核目录,重命名为`clash-meta.exe`和`clash-meta-alpha.exe` -- 重启 Verge + | 文件清单 | + | --------------------------------- | + | Clash Verge.exe | + | resources\clash-verge-service.exe | + | resources\install-service.exe | + | resources\uninstall-service.exe | ## 升级,卸载、重装、开启的时候“服务模式”相关报错 diff --git a/docs/friendship.md b/docs/friendship.md index ab506b9..8bf4103 100644 --- a/docs/friendship.md +++ b/docs/friendship.md @@ -1,8 +1,9 @@ ## Clash 内核客户端 -| 客户端 | 内核 | 平台 | 正式版 | 测试版 | +| 客户端 | 内核 | 平台 | 正式版下载地址 | 测试版下载地址 | | ----------------------------------------------------------------------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | [clash-verge-rev](https://github.com/clash-verge-rev/clash-verge-rev) | Meta | | | | +| [clash-nyanpasu](https://github.com/LibNyanpasu/clash-nyanpasu) | Meta | | | | | [clash-verge](https://github.com/zzzgydi/clash-verge/tree/main) | Meta | | | | | [Clash for Windows](https://github.com/Fndroid/clash_for_windows_pkg) | Premium | | | | | [v2rayN](https://github.com/2dust/v2rayN) | Meta | | | | @@ -10,7 +11,21 @@ | [ClashX Pro](https://github.com/yichengchen/clashX) | Premium | | | | | [ClashX.Meta](https://github.com/MetaCubeX/ClashX.Meta) | Meta | | | | | [ClashMetaForAndroid](https://github.com/MetaCubeX/ClashMetaForAndroid) | Meta | | | | -| [ClashForAndroid](https://github.com/Kr328/ClashForAndroid) | Premium | | | | +| [ClashForAndroid](https://github.com/Kr328/ClashForAndroid) | Premium | | | | + +## 其他内核客户端 + +| 客户端 | 内核 | 平台 | 正式版下载地址 | 测试版下载地址 | +| -------------------------------------------------------------------------- | ----------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| [Hiddify](https://github.com/hiddify/hiddify-next) | sing-box | | | | +| [NekoBoxForAndroid](https://github.com/MatsuriDayo/NekoBoxForAndroid) | sing-box | | | | +| [v2rayNG](https://github.com/2dust/v2rayNG) | Xray、v2fly | | | | +| [surfboard](https://github.com/getsurfboard/surfboard) | | | | | +| [Shadowrocket](https://apps.apple.com/us/app/shadowrocket/id932747118) | | | 付费下载,买断制
需要非国区 Apple ID | | +| [Surge 5](https://apps.apple.com/us/app/surge-5/id1442620678) | | | 应用内购,订阅制
需要非国区 Apple ID | | +| [Loon](https://apps.apple.com/us/app/loon/id1373567447) | | | 付费下载,买断制
需要非国区 Apple ID | | +| [Quantumult X](https://apps.apple.com/us/app/quantumult-x/id1443988620) | | | 付费下载,买断制
需要非国区 Apple ID | | +| [Stash](https://apps.apple.com/us/app/stash-rule-based-proxy/id1596063349) | | | 付费下载,买断制
需要非国区 Apple ID | | ## 参考文档 diff --git a/docs/guide/term.md b/docs/guide/term.md index 4337431..d12ec0c 100644 --- a/docs/guide/term.md +++ b/docs/guide/term.md @@ -1,3 +1,29 @@ +## 系统代理 / Tun 模式 + +> 代理模式决定本机网络请求程序发出的流量如何抵达监听在本地的代理程序,即入站。 + +| 代理模式 | 说明 | 特点 | +| -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------- | +| 系统代理 | 1. 代理程序会在系统**“约定”**的特定位置(如注册表、系统变量等)设置好代理程序监听请求的端口信息,进行网络请求的应用会**自发性**地尝试读取这部分信息,并将请求发送至代理程序。不同操作系统的**“约定”**方式各异。
2. 系统代理更像是一种行业内的**“约定”**,并非所有程序都遵守这种非强制性的**“约定”**,最终采取哪种方式发生请求往往取决于开发人员的意愿。 | 1. 具有自发性,网络请求程序尝试使用”约定“配置或使用网络请求程序里额外指定的配置。
2. 不能代理`UDP`流量(如游戏数据包)。 | +| Tun 模式 | 代理程序会创建一张虚拟网卡,通过配置操作系统的路由将网络请求**重定向**到这张虚拟网卡,代理程序从虚拟网卡中读取并处理这些网络请求。
与系统代理不同的是,该步骤发生在网络请求程序发出请求之后,因此这种方法不依赖开发人员的意愿。 | 1. 拦截和处理所有流量(`TCP`/`UDP`)重定向到本地的代理程序。
2.网络请求程序无需额外配置。 | + +## 规则/ 全局 / 直连模式 + +> 路由模式决定监听在本地的代理程序的流量如何出去,即出站。 + +| 路由模式 | 说明 | +| -------- | --------------------------------------------------------------------------------- | +| 规则模式 | 根据配置文件中的规则(集)进行**条件匹配**,决定流量是从哪个代理节点/本地网络出去。 | +| 全局模式 | 所有流量均从**手工选定**的代理节点/本地网络出去。 | +| 直连模式 | 所有流量均从**本地网络**出去。 | + +## 服务模式 + +- 在操作系统中,子进程通常继承其父进程的权限级别,管理员身份启动的服务所“拉起”的子进程也会具有管理员权限。 +- 以管理员身份安装并启动服务模式后,由服务进程“拉起”代理内核程序。代理内核程序便成为服务进程的子进程,运行在管理员权限下。 +- 因此,服务模式的用途是能够以非管理员身份启动 TUN 模式。**如果当前用户已经是管理员或处于管理员分组下,可以不安装服务模式直接启动 TUN 模式**。 +- TUN 模式的默认堆栈是 `Gvisor`,如果需要切换到 `System` 或 `Mixed` 堆栈则需要安装服务模式。不同堆栈的区别详见[TUN Stack](https://wiki.metacubex.one/config/inbound/tun/#stack)。 + ## Meta 内核 - 一般指[Clash Meta](https://github.com/MetaCubeX/mihomo/releases/latest),也称 `Meta`、 `Mihomo` 内核。区别于 `Clash Premium` 为闭源内核,`Clash Meta` 为开源内核。 diff --git a/docs/install.md b/docs/install.md index 0f4140d..1838c82 100644 --- a/docs/install.md +++ b/docs/install.md @@ -1,13 +1,4 @@ -## 下载地址 - -> Clash Verge Rev 目前仅通过 GitHub Release 发布,请注意辨别。 - -| 发行版本 | 下载次数 | 下载地址 | 备注 | -| ------------------------- | ----------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------ | -| Github Release **正式版** | | | | -| Github Release **测试版** | | | 无法通过应用内更新,升级到最新测试版 | - -## 版本选择 +## 操作系统 === ":material-microsoft-windows: Windows" @@ -16,18 +7,19 @@ - **Windows 7** 用户请先查看相关[FAQ](./faq/windows.md#windows-7)。 - 带有 `fix_webview2` 字样的安装包为内置 `Webview2` 环境版本(该文件体积比普通安装包大,仅用于当系统缺少且[无法安装WebView2](./faq/windows.md#webview2)环境时使用)。 - ### 安装版 + #### 安装版 + !!! tip 如果你不清楚你的电脑系统架构,请下载 `x64` 架构文件(目前多数 Windows 电脑使用该架构)。 - | 系统架构 | 文件名称 | - | -------- | ---------------------------------------- | - | x86 | Clash.Verge`_版本号_`**x86-setup.exe** | - | x64 | Clash.Verge`_版本号_`**x64-setup.exe** | - | arm64 | Clash.Verge`_版本号_`**arm64-setup.exe** | + | 系统架构 | 下载地址 | + | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | + | x64 | 加载中... | + | x86 | 加载中... | + | arm64 | 加载中... | - ### 便携版 + #### 便携版 !!! warning - 带有 `portable` 字样的 zip 压缩包是便携版,下载后解压即可使用。 @@ -36,26 +28,61 @@ - 便携版通过检测目录下的 `.config/PORTABLE` 文件来判断是否为便携版。 - 如果你想要和安装版使用相同的配置文件路径,删除 `.config/PORTABLE` 文件即可。 + | 系统架构 | 下载地址 | + | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | + | x64 | 加载中... | + | x86 | 加载中... | + | arm64 | 加载中... | + === ":material-linux: Linux" - #### 安装方式 - - !!! warning - 仅提供 `deb` 和 `AppImage` 两种安装包。 + === ":material-debian: Debian/Ubuntu/Deepin" + + + !!! warning + Ubuntu `24.04` 需要安装额外依赖,详见[常见问题](./faq/linux.md)。 + + | 系统架构 | 下载地址 | + | -------- | ----------------------------------------------------------------------------------------------------------------------------------------- | + | x64 | 加载中... | + | x86 | 加载中... | + | arm64 | 加载中... | + | armv7 | 加载中... | + + === ":material-redhat: CentOS/Fedora/SUSE" - | Linux 发行版本 | 安装方式 | - | ----------------------- | ------------------------------------------------------------------------------ | - | `Ubuntu` / `Debian` | 下载 `deb` 安装包 | - | `ArchLinux` / `Manjaro` | 通过 `AUR` 安装 | - | 其他发行版 | 方式 1: 解压 `deb` 包得到可执行文件,重新打包
方式 2: 直接使用 `AppImage` | + | 系统架构 | 下载地址 | + | -------- | ------------------------------------------------------------------------------------------------------------------------------------------- | + | x64 | 加载中... | + | x86 | 加载中... | + | arm64 | 加载中... | + | armv7 | 加载中... | - #### 文件选择 + === ":material-arch: ArchLinux/Manjaro" - | 系统架构 | 文件名称 | - | -------- | ------------------------------------------------------------------------------- | - | x64 | clash-verge`_版本号_`**amd64.AppImage**
clash-verge`_版本号_`**amd64.deb** | - | arm64 | clash-verge`_版本号_`**arm64.deb** | - | armv7 | clash-verge`_版本号_`**armhf.deb** | + 1. 安装 AUR helper(如果未安装)。 + + ```bash + sudo pacman -S --needed git base-devel + git clone https://aur.archlinux.org/yay-git.git + cd yay-git + makepkg -si + ``` + 2. 安装 AUR 包。 + + ```bash + yay -S clash-verge-rev-bin + ``` + + === ":simple-linux: AppImage" + + + !!! warning + 因 `AppImage` 问题较多,不推荐使用 `AppImage` 安装。 + + | 系统架构 | 下载地址 | + | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | + | x64 | 加载中...加载中... | === ":material-apple: macOS" @@ -63,11 +90,57 @@ !!! warning 不支持 `macos` 10 操作系统,请升级 `macos` 到 11 或 更高版本。 - | 芯片类型 | 文件名称 | - | ------------ | ------------------------------------ | - | Intel 芯片 | Clash.Verge`_版本号_`**x64.dmg** | - | Apple M 芯片 | Clash.Verge`_版本号_`**aarch64.dmg** | + | 系统架构 | 下载地址 | + | ------------ | -------------------------------------------------------------------------------------------------------------------------------------------- | + | Intel 芯片 | 加载中... | + | Apple M 芯片 | 加载中... | ## 安装问题 如果安装/使用过程中遇到了问题,请参考文档中的[常见问题](./faq/windows.md)。 + +## 发布地址 + +> Clash Verge Rev 目前仅通过 GitHub Release 发布,请注意辨别。 + +| 发行版本 | 下载次数 | 下载地址 | 备注 | +| ------------------------- | ----------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------ | +| Github Release **正式版** | | | | +| Github Release **测试版** | | | 无法通过应用内更新,升级到最新测试版 | + + +