香橙派如何安装cc-switch
也就是说,对方必须也是在使用香橙派、树莓派 4/5(64位系统)、Jetson Nano 等 ARM 架构的开发板,或者是搭载了苹果 M 系列芯片并装了 Linux 虚拟机的电脑。链接: https://pan.baidu.com/s/1i0TBt0jqPCD9XNqZO4i9iA?(如果对方用的是 CentOS 或者 Fedora,他们需要的是 .rpm 包,装不了你的 .deb)。(如果对方用
我是刚接触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 图形桌面内启动它!
更多推荐



所有评论(0)