我是刚接触Linux的小白,想要使用cc-switch,去官网下载,但是没有找到匹配的版本,于是自己编译了一下,生成了一个安装包。

这个是安装包:

通过网盘分享的文件:CC Switch_3.11.1_arm64.deb
链接: https://pan.baidu.com/s/1i0TBt0jqPCD9XNqZO4i9iA?pwd=9per 提取码: 9per

环境要求:

同时满足以下两个条件,这软件才能在你的机器上跑起来。

1.操作系统必须是基于 Debian 的 Linux

比如 Ubuntu、Debian、Linux Mint、或者树莓派的 Raspberry Pi OS。

(如果对方用的是 CentOS 或者 Fedora,他们需要的是 .rpm 包,装不了你的 .deb)。

2.CPU 架构必须是 ARM64 (aarch64)

也就是说,对方必须也是在使用香橙派、树莓派 4/5(64位系统)、Jetson Nano 等 ARM 架构的开发板,或者是搭载了苹果 M 系列芯片并装了 Linux 虚拟机的电脑。

(如果对方用的是普通的 Intel 或 AMD 电脑装的 Ubuntu,强行安装会报架构不匹配的错误)。

安装指令:

# 安装软件包
sudo dpkg -i "CC Switch_3.11.1_arm64.deb"

# 自动补齐缺失的系统依赖
sudo apt-get install -f -y

如果你也想要自己尝试编译安装一下,可以参考以下内容:

🚀 香橙派 (ARM64) 源码编译安装 CC Switch 踩坑与全纪录

背景: 在香橙派 AI Pro(Ubuntu 22.04 aarch64)上尝试安装基于 Tauri 框架的桌面应用 CC Switch 时,发现官方并未提供 arm64/aarch64 架构的 .deb 安装包。强行安装 amd64 版本会报错架构不匹配。 为了解决这个问题,我决定直接拉取源码,在 ARM64 开发板上进行本地交叉编译。以下是完整、防坑的编译与安装指南。

🛠️ 第一步:安装系统底层依赖库

Tauri 框架需要依赖系统的 C/C++ 编译工具链以及 GTK 图形界面库。特别注意,最新版 Tauri 需要 4.1 版本的 WebKit。

打开终端,一次性执行以下命令补齐底层环境:

Bash

sudo apt update
sudo apt install -y build-essential curl wget file libssl-dev \
    libgtk-3-dev libayatana-appindicator3-dev librsvg2-dev \
    libwebkit2gtk-4.1-dev libjavascriptcoregtk-4.1-dev

🟢 第二步:安装前端环境 (Node.js) 并换源

CC Switch 的前端是由 Web 技术构建的,需要 Node.js 和包管理器 npm。 为了防止后续下载前端依赖卡死,强烈建议配置国内镜像源:

Bash

# 安装 Node.js 和 npm
sudo apt install -y nodejs npm

# 配置 npm 使用淘宝镜像源加速下载
npm config set registry https://registry.npmmirror.com

🦀 第三步:安装后端环境 (Rust) 并换源

Rust 是极其强悍的底层语言,但官方服务器在国内访问极慢。我们需要先挂载清华源,再运行安装脚本。

1. 使用清华源下载并安装 Rust:

Bash

export RUSTUP_DIST_SERVER=https://mirrors.tuna.tsinghua.edu.cn/rustup
export RUSTUP_UPDATE_ROOT=https://mirrors.tuna.tsinghua.edu.cn/rustup/rustup
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

(注:出现提示时直接输入 1 并回车,选择默认安装)

2. 让环境变量立即生效:

Bash

source "$HOME/.cargo/env"

3. 配置 Cargo 使用国内极速编译源 (rsproxy): 直接将以下整段代码复制到终端并回车,这能解决编译时拉取几百个依赖库超时的致命问题:

Bash

mkdir -p ~/.cargo
cat << 'EOF' > ~/.cargo/config.toml
[source.crates-io]
replace-with = 'rsproxy-sparse'

[source.rsproxy-sparse]
registry = "sparse+https://rsproxy.cn/index/"

[registries.rsproxy]
index = "https://rsproxy.cn/crates.io-index"

[net]
git-fetch-with-cli = true
EOF

📦 第四步:拉取源码与版本对齐 (关键防坑)

Bash

# 1. 克隆源码
git clone https://github.com/farion1231/cc-switch.git
cd cc-switch

# 2. 安装前端依赖
npm install

# 3. ⚠️ 关键防坑:对齐前后端版本
# 由于 npm 自动拉取了较新的前端包,如果直接编译会报 Tauri 版本不匹配错误。
# 需要让 Rust 后端也更新一下依赖版本:
cd src-tauri
cargo update
cd ..

🔨 第五步:开始终极编译

执行打包命令,此时 CPU 会满载运转,请耐心等待(香橙派 20T 大约需要 20 分钟左右):

Bash

npm run tauri build

(注:编译到最后,如果出现打包 .AppImage 报网络连接拒绝的红字 Error,无需理会,因为最核心的 .deb 包已经成功生成了!)

🎉 第六步:安装与运行

编译成功后,系统为你独家定制的 .deb 安装包会静静地躺在输出目录里。 我们使用最高效的 apt install ./ 方式进行安装(它能自动解决可能遗漏的依赖):

Bash

# 进入打包输出目录
cd src-tauri/target/release/bundle/deb/

# 一键安装本地 deb 包(注意文件名如果有空格需要加反斜杠或引号)
sudo apt install ./CC\ Switch_*_arm64.deb

避坑提示:不要在没有图形界面的 SSH 终端里直接输入 cc-switch 运行,会报 Failed to initialize GTK 的错误。请在外接显示器上,或者使用向日葵等远程桌面软件,在 Ubuntu 图形桌面内启动它!

Logo

有“AI”的1024 = 2048,欢迎大家加入2048 AI社区

更多推荐