amd Radeon Cloud 用户使用指南 amd开发者中心免费显卡和免费算力 免费deepseek v4 flash Qwen3.6-35B-A3B
原文链接:https://github.com/AMD-DEV-CONTEST/Radeon-hackathon-2026-07/tree/main/Radeon-Cloud-User%20Guide#-expose-a-notebook-service-to-the-internet-tunnel
本文档完整讲解 Radeon Cloud 全流程:领取 AMD Radeon 云显卡、进入开发环境操作
⭐ 第0步 · 登录
打开 Radeon Cloud 官网,点击页面右上角登录,选择邮箱登录
官网地址:https://radeon-global.anruicloud.com/
⭐ 第1步 · 进入个人主页
登录完成后,点击右上角头像,在下拉菜单选择个人主页(Profile)
⭐ 第2步 · 创建自定义模板
在个人主页的「我的模板(My Templates)」板块,点击右上角添加模板(Add Template),在弹出表单中创建专属模板
① 填写模板名称
输入模板标题(必填项)
② 选择容器镜像
选择运行环境容器镜像(必填项)
若需要持久化保存文件,存储选项选择持久存储(PVC)——销毁实例后数据仍会保留
填写完成后点击底部「添加模板」完成创建
⭐ 第3步 · 启动模板实例
回到「我的模板」列表,找到刚创建的模板,点击对应行的启动(Launch)运行云实例
⭐ 第4步 · 两种方式进入开发环境(任选其一)
方式A · JupyterLab 网页终端
实例部署完成、弹窗显示「工作空间就绪(100%)」后,点击打开笔记本(Open Notebook)
浏览器会新开标签页打开 JupyterLab,这是实例默认访问入口,内置完整网页开发环境:
- 终端(Terminal):完整 Linux 终端,点击顶部「+」→ Terminal,或启动器里的终端图标,用于安装依赖、下载文件、启动服务
- 笔记本(.ipynb):代码+运行结果一体化交互式文档
- 文件管理器:左侧管理文件,点击上传图标可上传本地
.ipynb文件
方式B · SSH 远程连接
① 在个人主页上传 SSH 公钥
本地生成密钥对(已有密钥可跳过),Mac / Linux / Windows PowerShell 执行命令:
ssh-keygen-ted25519-C"你的邮箱@example.com"执行后默认生成两个文件:
私钥:~/.ssh/id_ed25519
公钥:~/.ssh/id_ed25519.pub
复制公钥全部内容(执行cat ~/.ssh/id_ed25519.pub获取),粘贴到个人主页「SSH公钥」输入框,点击保存密钥(Save Key)
⚠️ 仅粘贴.pub公钥文件内容,严禁上传私钥
② 创建模板时开启SSH访问
在第2步新建模板的表单底部,打开SSH访问(高级功能)开关,再点击添加模板;仅开启该选项的模板启动的实例支持SSH连接
③ 连接云实例
实例启动完成后,就绪弹窗、个人主页「运行中实例」板块会展示SSH连接信息:一键复制的连接命令、主机+端口、用户名
本地终端执行连接命令:
ssh<用户名>@<主机地址>-p<端口号>首次连接输入yes确认指纹即可
补充说明:部分镜像默认未预装SSH服务,若无法使用ssh,在网页终端手动安装启动:
sudoaptupdatesudoaptinstall-yopenssh-servermkdir-p/run/sshdwhichsshd /usr/sbin/sshd⭐ 使用兼容OpenAI格式的模型API
除网页笔记本外,Radeon Cloud 支持部署兼容OpenAI标准的HTTP模型接口,任意兼容OpenAI的工具(curl、openai SDK、Cherry Studio、LangChain等)均可调用,分为两种方案
方案1 · 免费公共模型API(共享资源,无需启动实例)
开箱即用共享接口,不消耗云算力额度,当前支持通义千问Qwen、DeepSeek大模型
打开密钥工厂页面并登录:https://developer.amd.com.cn/radeon/modelapis
在「公共免费模型API」区域选择模型(Qwen / DeepSeek),弹窗会展示接口基础地址、模型名称、你的API密钥、可直接运行的curl测试代码,复制API密钥备用
本地终端调用示例(将
<API_KEY>替换为你的密钥):
curlhttps://developer.amd.com.cn/radeon/api/v1/chat/completions\-H"Authorization: Bearer <API_KEY>"\-H"Content-Type: application/json"\-d'{"model":"Qwen3.6-35B-A3B","messages":[{"role":"user","content":"Hello"}]}'同一密钥可调用全部共享模型,仅需修改请求内model字段(如DeepSeek-V4-Flash)
方案2 · 专属私有模型API(自建实例,消耗算力额度)
在专属云实例部署模型,生成独立OpenAI兼容接口(消耗账户算力)
- 进入官网 https://radeon-global.anruicloud.com/ → 个人主页 → 添加模板
- 部署类型(Deploy Type)选择
vLLM Model API(平台仅支持vLLM部署),手动填写启动服务命令(Serve Command)
- 启动命令格式参考表单提示:
vllm serve <模型名称> --host 0.0.0.0 --port 8000 - 必须保留
--host 0.0.0.0 --port 8000,平台固定路由8000端口
- 点击添加模板,在「我的模板」启动实例;实例就绪后弹窗会展示专属接口地址(格式:
.../spaces/<实例ID>/8000/v1)、模型名、独立API密钥,调用方式和方案1完全一致,仅替换接口地址
⭐ 将笔记本内服务暴露至公网(隧道 rc-tunnel)
使用内置rc-tunnel工具,将笔记本内运行的HTTP/WebSocket服务生成可公网访问的独立地址
前置要求
- 仅支持本功能上线后新建的笔记本;旧笔记本需关闭重建才能使用
- 仅允许笔记本内监听
127.0.0.1的HTTP/WebSocket服务 - 本地端口范围:1024-65535,不可使用平台预留端口
- 公网域名由平台自动分配,格式:
rc-随机字符串.radeon.firstdg.ai - 单个云实例同一时间仅能暴露一个端口
- 公网地址全网可访问,业务需自行增加登录鉴权,禁止暴露无验证的后台管理页面
安装隧道工具
在笔记本终端执行安装脚本:
/var/run/secrets/frp-self-service/install工具会安装到$HOME/.local/bin/rc-tunnel并自动加入环境变量;当前终端可直接使用完整路径调用,新开终端可直接输入rc-tunnel。
非Bash终端需先执行环境变量配置:
exportPATH="$HOME/.local/bin:$PATH"若提示身份目录/FRP代理地址不存在,代表笔记本是旧实例,关闭重建实例后重试,禁止手动修改平台密钥
启动测试网页服务
创建测试文件夹并启动本地HTTP服务:
mkdir-p"$HOME/tunnel-demo"printf'%s\n''<!doctype html><title>RC Tunnel</title><h1>RC Tunnel 运行正常</h1>'>"$HOME/tunnel-demo/index.html"nohuppython3-mhttp.server8081--bind127.0.0.1--directory"$HOME/tunnel-demo">"$HOME/tunnel-demo/http.log"2>&1&# 本地测试服务是否正常运行curl--failhttp://127.0.0.1:8081/暴露端口到公网
执行命令自动分配域名,暴露本地8081端口:
"$HOME/.local/bin/rc-tunnel"expose--port8081执行成功会返回平台分配的公网地址,数秒内即可访问,示例地址:
https://rc-0123456789abcdef.radeon.firstdg.ai运维兼容场景可额外加--prefix指定域名前缀,普通用户无需配置
查看状态与故障排查
# 查看隧道运行状态"$HOME/.local/bin/rc-tunnel"status# 查看运行日志(读取最新100行)"$HOME/.local/bin/rc-tunnel"logs--lines100# 先确认本地服务是否正常curl--failhttp://127.0.0.1:8081/排查顺序:
- 本地curl访问失败:笔记本内服务未正常监听端口,与隧道工具无关
- status显示隧道未运行:查看日志定位报错
- 本地正常、公网无法访问:提供完整域名、笔记本创建时间、访问失败时间给运维,不要发送配置/密钥文件
关闭隧道
"$HOME/.local/bin/rc-tunnel"stop执行后公网地址立即失效,域名前缀会锁定24小时。隧道进程/实例关闭后,代理服务器会立刻断开连接;无心跳60秒的闲置隧道会被系统自动回收
功能限制
- 不支持TCP、UDP、SSH、数据库端口、自定义独立域名
- 禁止手动编辑
~/.local/state/rc-tunnel/frpc.toml配置文件 - 禁止将
~/.local/state/rc-tunnel文件夹复制到其他实例、分享给他人 - 笔记本重建后,需要重新执行安装、暴露端口操作
⭐ 使用完毕销毁实例
运行中的实例会持续消耗算力额度。使用完成后,前往个人主页「运行中实例」板块,点击红色销毁实例(Destroy Instance)释放资源https://p26-flow-imagex-sign.byteimg.com/isp-i18n-media/image/af891721804381752e927b7383141faf~tplv-be4g95zd3a-448x448.jpeg?lk3s=8e244e95&rcl=202607211715315BC2C63806E2B04501FB&rrcfp=2033b573&x-expires=1785230131&x-signature=7VatOzfJZ05xY970tcij6hqb1so%3D