CloudStudio 部署 DeepSeek-R1 大模型及远程访问配置指南
在云端免费算力资源日益丰富的背景下，利用 CloudStudio 部署大型语言模型（LLM）已成为开发者快速验证 AI 应用的高效途径。本文详细介绍如何在 CloudStudio 环境中部署 DeepSeek-R1 模型，并通过 SSH 隧道实现本地客户端的安全远程访问。
一、CloudStudio 环境配置
1. 开启终端与密钥生成
登录 CloudStudio 主界面后，点击顶部导航栏的'终端'按钮进入命令行环境。为了确保 SSH 连接的安全性，首先生成 RSA 密钥对：
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) -> 。
