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)。

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