CloudStudio 部署 DeepSeek-R1 大模型及远程访问配置指南

在云端免费算力资源日益丰富的背景下，利用 CloudStudio 部署大型语言模型（LLM）已成为开发者快速验证 AI 应用的高效途径。本文详细介绍如何在 CloudStudio 环境中部署 DeepSeek-R1 模型，并通过 SSH 隧道实现本地客户端的安全远程访问。

一、CloudStudio 环境配置

1. 开启终端与密钥生成

ssh-keygen -t rsa -b 2048 -f ~/.ssh/id_rsa

执行过程中按提示直接回车即可使用默认路径和空密码。此步骤将生成私钥 id_rsa 和公钥 id_rsa.pub。

2. 建立 SSH 隧道

为了从公网访问 CloudStudio 内部运行的服务（如模型推理接口），需要使用 localhost.run 提供的反向代理功能。执行以下命令建立隧道映射：

ssh -i ~/.ssh/id_rsa -R 80:localhost:6399 localhost.run

命令解析：

-i: 指定使用的私钥文件。
-R 80:localhost:6399: 将远程服务器的 80 端口映射到本地容器的 6399 端口。
localhost.run: 提供公网域名的代理服务。

执行成功后，终端会返回一个公网访问地址（例如 https://xxxxx.ngrok.io）。将该地址输入浏览器，若能看到模型交互界面，则表明外部访问已打通。

二、本地客户端部署 (OpenWebUI)

为了获得更友好的交互体验，建议在本地机器上部署 OpenWebUI 作为前端管理工具。该工具支持 Docker 一键启动，并具备知识库构建能力。

1. 安装 Docker 容器

确保本地已安装 Docker 环境，运行以下命令拉取并启动 OpenWebUI：

docker run -d \
  -e HF_ENDPOINT=https://hf-mirror.com \
  -p 3000:8080 \
  --add-host=host.docker.internal:host-gateway \
  -v open-webui:/app/backend/data \
  --name open-webui \
  --restart always \
  ghcr.io/open-webui/open-webui:main

参数说明：

-e HF_ENDPOINT: 设置 HuggingFace 镜像源，加速模型权重下载。
-p 3000:8080: 将容器 8080 端口映射到本地 3000 端口。
--add-host: 配置 Docker 内部网络解析，便于容器访问宿主机。
-v: 挂载数据卷，持久化用户数据和模型缓存。
--restart always: 确保容器异常退出后自动重启。

2. 注册与初始化

启动完成后，在浏览器访问 http://localhost:3000。首次访问会提示创建管理员账号，请按指引完成注册。

三、连接远程模型服务

本地客户端搭建完毕后，需将其指向 CloudStudio 中部署的 DeepSeek-R1 模型地址。

登录 OpenWebUI 管理后台。
点击右上角头像，选择 设置 (Settings) -> 管理员设置 (Admin Settings)。
找到 外部连接 (External Connections) 选项。
将 Ollama 地址修改为第一步中生成的 CloudStudio 公网地址（例如 https://xxxxx.ngrok.io）。
点击保存，系统会自动检测连接状态。

四、总结与扩展

通过上述步骤，我们实现了在免费云平台上部署大模型，并利用本地轻量级 UI 进行高效交互。这种架构的优势在于：

算力隔离：模型运行在云端，不占用本地硬件资源。
数据安全：敏感数据可保留在本地知识库中，仅传输必要的交互内容。
灵活扩展：支持接入多种后端模型，方便进行 A/B 测试。

对于需要频繁查阅资料或处理私有数据的场景，建议充分利用 OpenWebUI 的知识库功能，上传 PDF 或 TXT 文档，实现基于 RAG（检索增强生成）的智能问答。这不仅能提升回答的准确性，还能有效防止模型幻觉问题。

注意：SSH 隧道服务通常有连接时长限制，生产环境建议使用固定 IP 或更稳定的内网穿透方案。