社区镜像创作上传流程指引

1.云主机操作流程指引

1.1 官网地址：https://www.gongjiyun.com/

1.2 云主机产品操作流程

推荐您使用我们的云主机产品（预制镜像预配置主流深度学习框架或者社区镜像中的携带 ComfyUI-Manager 的 ComfyUI 基础镜像 进行二次开发）

点击按钮进入云主机控制台 https://console.suanli.cn/server/instances

设备选择根据您的需求来选择，地区都经过我们测试过，速率都很快

1.3 选择基础镜像或者 ComfyUI 基础镜像

选择完地区后可以选择我们的预制镜像（预配置主流深度学习框架）或者社区镜像中的携带 ComfyUI-Manager 的 ComfyUI 基础镜像进行二次开发

云主机发布成功后点击 更多操作 - 查看详情 进入镜像详情界面（我们的基础镜像中预配置了相关的 Jupyterlab 环境和 Vscode 环境）可以直接二次开发使用

2.发布为一个新的镜像

2.1 当您二次开发完之后通过设备管理中 部署服务 发布您的镜像便于社区其他用户使用

2.2 关机并保存镜像，输入镜像标签

2.3 选择最新版本

2.4 选择 GPU 配置（如 4090），节点默认选择 1 个

2.5 添加端口

建议：只暴露应用程序实际需要的服务端口

2.6 配置启动命令

启动命令与环境变量可根据个人需求配置，如果是从我们的基础镜像二次开发需要再次配置一下启动命令，可以参考我们的这个文档 https://www.gongjiyun.com/docs/server/jojuw4rfdiepfxkchonctw0jnxe/taaewpcy3ierj6km0okcmr40nuc/

2.7 确认部署

点击最下方“确认部署”即可，若无问题则会进入节点拉取界面，耐心等待即可

节点拉取成功后，点击链接即可快速访问服务 您可以测试下您的服务是否正常

2.8 镜像地址收集

镜像地址收集：通过弹性部署页面的设置中，您可以获取到您的镜像地址 复制出来提交表单和镜像相关的配置即可

2.9 社区镜像地址提交表单

社区镜像地址收集表单：您填写完成后可以在对应的创作者交流群内提醒我们，我们测试完成后会上线镜像并及时通知您

https://feishiai.feishu.cn/share/base/form/shrcnOiTGvHqBUuJjQBOIwji54c

当您二次开发还未完成时可以通过设备管理中 关机并保存镜像 ，方便下次接着上回的进度开发

镜像关机完成后下次可以通过云主机列表上的 开机 按钮再次启动

3.常见问题：

Q: 为什么 GitHub/Hugging Face 访问困难（速度慢、镜像站不清楚、TLS 无效）？

A: 由于 Github 和 Hugging Face 等网站的限制，访问有时不稳定，推荐您可以多刷新访问几次试试。 如果是需要下载 Hugging Face 上的模型的话可以通过添加环境变量访问国内镜像站 HF_ENDPOINT=https://hf-mirror.com 进行下载。

Q：为方便用户使用，是否不打算将热门模型作为公共库或提供公共的对象存储？

A：我们有这个规划，用户高频使用的模型会被收录到官方提供的对象存储仓库，供平台用户使用。

Q：几十上百 GB 的模型不可能打包进镜像，平台有公共模型库吗？

A:

1. 目前平台推荐把高频使用的模型上传到阿里云/腾讯云的对象存储（OSS/COS）。
2. 平台侧配置对象存储的只读挂载，任务启动时自动把所需模型缓存到集群本地盘。
3. 任务容器通过只读挂载路径（如 /models/public/）即可直接使用模型，无需重复下载。
4. 参考官方文档《对象存储挂载与模型缓存》

https://www.gongjiyun.com/docs/y/nnnkwiwlkid3m1ksgxdcrvsknrj/wqhqwbcf3i6byykijbvct9dkn0e/

文档中包含：

• 创建对象存储 Bucket 并上传模型
• 在平台「数据卷」里绑定对象存储路径
• 在任务 YAML 中添加 volumeMounts 示例

流程图示意：