Cherry Studio 本地 AI 模型远程访问配置指南
Cherry Studio 是一款支持连接 OpenAI、Gemini 等在线模型,也能对接本地 Ollama 部署大模型的客户端。它具备文档处理、智能体协作等实用功能,适合开发者调试代码或日常办公使用。其模块化设计允许自定义对话逻辑,新手与老手都能快速上手。
不过,本地模型服务默认仅支持局域网访问。若需在外网环境下调用本地部署的模型(如 DeepSeek-R1、千问 QWQ-32B),则需要通过内网穿透技术将本地端口映射至公网。
本地安装
在 Windows 系统下,可访问 Cherry Studio 的 GitHub 发布页下载客户端安装包:
https://github.com/CherryHQ/cherry-studio/releases
选择对应版本的安装程序,按照向导完成安装即可。
配置模型服务
启动客户端后,界面简洁直观。点击左下角设置图标进入配置页面。
在线模型服务
若未部署本地模型,可直接配置在线 API。以硅基流动为例,注册账号获取 API Key 后填入对应字段,开启开关即可使用。在管理面板中可添加具体模型(如 deepseek-r1-70b),随后在聊天界面顶部选择模型进行对话。
注意:在线模型通常按 Token 计费,大量使用前建议评估成本。
本地模型服务
若已部署 Ollama,可在设置中选择 Ollama 并开启开关。点击管理按钮,系统会自动扫描本地已下载的模型(如 qwq-32b)。添加后即可在聊天界面切换至本地模型,无需额外费用。
其他功能
除基础对话外,Cherry Studio 还支持创建智能体模版、调用 Flux.1 或 SD 模型进行文生图,以及使用 AI 翻译和多种小程序工具。
远程访问配置
要实现异地调用本地模型,需先开放 Ollama 的网络接口,再通过内网穿透工具生成公网地址。
1. 环境变量设置
打开终端(CMD 或 PowerShell),执行以下命令以允许外部访问:
setx OLLAMA_HOST "0.0.0.0"
setx OLLAMA_ORIGINS "*"
执行完成后重启 Ollama 服务使配置生效。
2. 配置内网穿透
使用内网穿透工具(如 cpolar)建立隧道。登录管理控制台后,创建新隧道:
- 隧道名称:ollama(自定义,避免重复)
- 协议:http
- 本地地址:11434(Ollama 默认端口)
- 域名类型:随机域名或二级子域名
- 地区:China Top
隧道创建成功后,复制生成的公网地址。将其粘贴至 Cherry Studio 的 Ollama 模型服务 API 地址栏中,保存即可。
此时,即使不在同一局域网内,也能通过该公网地址访问本地模型。
3. 固定公网地址(可选)
如需长期稳定访问,建议使用固定二级子域名。这通常需要升级至专业版套餐。
- 在控制台预留一个二级子域名(例如
csollama)。 - 编辑已创建的隧道,将域名类型改为'二级子域名',Sub Domain 填写预留的名称。
- 更新隧道配置,公网地址将变更为固定域名。
总结
通过 Cherry Studio 配合内网穿透工具,可以突破局域网限制,实现本地 AI 模型的远程调用。该方案无需购买云服务器,既保障了数据隐私,又降低了使用门槛。对于需要跨设备协作或个人远程办公的场景,这是一个高效且经济的解决方案。


