标签 Headless Environment 下的文章

大家好!

我前几天在服务器上用 CC-Switch 时,GUI 版跑不起来(SSH 环境没图形),于是我做了一个 web/headless 版 cc-switch-web,把原版的供应
商 / MCP / 技能 / 提示词全搬到了浏览器里,让云端也能用。并且扩展了一些模板,添加了自动跳转备用服务商的功能。

效果(Web)

  • Skills 市场:浏览 / 一键安装

  • Prompt 编辑:提示词

- 页面展示:

  • 高级设置:目录重定向、导入导出、备份

为什么用 cc-switch-web?

  • 核心场景:服务器 / 云主机 + SSH,只需跑一个 Web Server,用浏览器管理。
  • 功能等价:供应商切换、MCP 统一管理、技能市场、提示词管理、导入导出 / 备份、双语。
  • 更安全:默认 Basic Auth 随机密码 + 同源;跨域需显式配置 CORS_ALLOW_ORIGINS。
  • 更云友好:可配 HOST/PORT,方便反代 / HTTPS;备用供应商自动切换,转发异常时兜底。
  • 更轻量:无 GUI 依赖,前后端分离,易脚本化、易自动化。

快速上手(Web)

pnpm install
pnpm build:web
cd src-tauri
cargo build --release --features web-server --bin cc-switch-server

启动(示例)

HOST=0.0.0.0 PORT=3000 ./target/release/cc-switch-server

  • 登录:admin / ~/.cc-switch/web_password(首次自动生成)。
  • CORS:默认同源;需要跨域时设置 CORS_ALLOW_ORIGINS(可选 CORS_ALLOW_CREDENTIALS=true)。
  • Web 模式无系统文件 / 目录选择器,路径需手动输入。

常用命令

  • 构建 Web 资源:pnpm build:web
  • 构建 / 运行 Web Server:cargo build --release --features web-server --bin cc-switch-server + HOST=… PORT=… ./target/
    release/cc-switch-server
  • API 测试:bash tests/run-all.sh(需运行中的 server)

维护说明
新版本刚上线,可能还有细节待打磨。欢迎提 issue:本周集中更新,之后每周定期维护,目标是把它打造成云开发也能放心用的可靠
工具。

项目信息

写在最后
核心业务逻辑基于 cc-switch,我做了 Web / 无头化和安全 / 云端增强。希望大家可以多多 star 、多提 issue,每个 issue、提交我都会看的 我们一起来完善这个工具吧。


📌 转载信息
原作者:
JINZHOU
转载时间:
2026/1/15 18:09:24