在 Ubuntu 20.04 上安装 CC-Switch (解决Ubuntu 20.04不支持Libwebkit2gtk-4.1-0)

在 Ubuntu 20.04 上安装 CC-Switch（Docker 完整指南）

1. 最终效果

在 Ubuntu 20.04 系统中，通过 Docker 运行 CC-Switch。最终效果如下：

2. 准备工作

2.1 安装 Docker

首先安装 Docker：

sudo apt-get update
sudo apt-get install -y docker.io
sudo systemctl start docker
sudo systemctl enable docker
sudo usermod -aG docker $USER

执行完成后，需要退出当前终端并重新登录，或者运行：

newgrp docker

newgrp docker 只对当前终端有效。

验证 Docker 权限：

docker ps

如果没有出现 permission denied，说明 Docker 权限配置成功。

---

3. 安装 CC-Switch

3.1 创建工作目录并下载安装包

mkdir -p ~/cc-switch-docker
cd ~/cc-switch-docker

下载最新版 .deb 安装包：

wget -O cc-switch.deb https://github.com/farion1231/cc-switch/releases/download/v3.16.1/CC-Switch-v3.16.1-Linux-x86_64.deb

---

3.2 解压 .deb 包

绕过安装失败问题，采用解压方式，将程序文件提取出来后放入 Docker 镜像中运行。

dpkg -x cc-switch.deb cc-switch-extract/

检查是否成功解压出可执行文件：

ls cc-switch-extract/usr/bin/

如果能够看到 cc-switch，说明解压成功。

---

3.3 配置 Docker 镜像加速

如果构建镜像时拉取 Ubuntu 镜像速度较慢，或者出现超时问题，可以配置 Docker 镜像加速。

sudo tee /etc/docker/daemon.json <<-'EOF'
{
  "registry-mirrors": [
  	"https://docker.mirrors.ustc.edu.cn",
    "https://docker.m.daocloud.io",
    "https://dockerproxy.com",
    "https://docker.nju.edu.cn"
  ]
}
EOF

重新加载 Docker 配置并重启服务：

sudo systemctl daemon-reload
sudo systemctl restart docker

验证配置是否生效：

docker info | grep -A 5 "Registry Mirrors"

---

3.4 创建 Dockerfile

在 ~/cc-switch-docker 目录下创建 Dockerfile，直接运行下面的命令：

cat > Dockerfile << 'EOF'
FROM ubuntu:22.04

ENV DEBIAN_FRONTEND=noninteractive

# 安装 CC-Switch 运行时依赖
# 关键依赖：libwebkit2gtk-4.1-0
RUN apt-get update && apt-get install -y \
    libwebkit2gtk-4.1-0 \
    libgtk-3-0 \
    libayatana-appindicator3-1 \
    libnotify4 \
    libnss3 \
    libxss1 \
    libxtst6 \
    xdg-utils \
    libatspi2.0-0 \
    libuuid1 \
    libsecret-1-0 \
    fonts-noto-cjk \
    locales \
    libfuse2 \
    ca-certificates \
    && rm -rf /var/lib/apt/lists/* \
    && locale-gen zh_CN.UTF-8

ENV LANG=zh_CN.UTF-8
ENV LC_ALL=zh_CN.UTF-8
ENV DEBIAN_FRONTEND=

# 复制解压后的 CC-Switch 文件到容器中
COPY cc-switch-extract/ /

# 添加执行权限
RUN chmod +x /usr/bin/cc-switch

# 启动 CC-Switch
CMD ["/usr/bin/cc-switch"]
EOF

---

3.5 构建 Docker 镜像

在 ~/cc-switch-docker 目录下执行：

docker build -t cc-switch .

构建完成后，可以通过以下命令查看镜像：

docker images

如果能看到名为 cc-switch 的镜像，说明构建成功。

---

4. 配置图形界面显示权限

由于 CC-Switch 是图形界面程序，而程序运行在 Docker 容器中，因此需要允许 Docker 容器访问宿主机的 X11 图形界面。

在运行 CC-Switch 之前，先执行：

xhost +local:docker

5. 创建启动脚本

为了方便启动 CC-Switch，可以创建一个启动脚本。

cat > ~/cc-switch.sh << 'EOF'
#!/bin/bash

xhost +local:docker > /dev/null 2>&1

docker run --rm \
  -e DISPLAY=$DISPLAY \
  -e XDG_RUNTIME_DIR=/tmp \
  -v /tmp/.X11-unix:/tmp/.X11-unix \
  -v $HOME/.claude:/root/.claude \
  cc-switch
EOF

添加执行权限：

chmod +x ~/cc-switch.sh

运行启动脚本：

~/cc-switch.sh

---

6. 添加命令别名

为了以后可以直接使用 cc-switch 命令启动程序，可以添加别名：

echo 'alias cc-switch="~/cc-switch.sh"' >> ~/.bashrc
source ~/.bashrc

之后只需要在终端输入：

cc-switch

即可启动 CC-Switch 图形界面。

---

7. 参考资源链接

• CC-Switch GitHub Releases
• https://blog.csdn.net/2302_80946742/article/details/161166298

---

转载自 CSDN-专业IT技术社区

原文链接：https://blog.csdn.net/qq_51411676/article/details/161680969