Fish Speech 1.5部署教程：从CSDN实例导出镜像到本地K8s集群迁移

Fish Speech 1.5部署教程：从CSDN实例导出镜像到本地K8s集群迁移

1. 项目概述与学习目标

Fish Speech 1.5是一个强大的文本转语音模型，能够生成自然流畅的多语言语音。本教程将手把手教你如何从CSDN实例导出Fish Speech 1.5镜像，并成功迁移到本地Kubernetes集群部署。

学完本教程，你将掌握：

• 从CSDN实例导出Docker镜像的完整流程
• 将镜像迁移到本地K8s集群的方法
• 在本地环境部署和运行Fish Speech 1.5
• 解决迁移过程中可能遇到的常见问题

前置要求：

• 基本的Linux命令行操作经验
• Docker和Kubernetes的基础知识
• 本地已安装Docker和kubectl工具

2. 环境准备与工具检查

在开始迁移之前，我们需要确保本地环境准备就绪。以下是需要检查的工具和组件：

2.1 必要工具清单

首先检查你的本地环境是否安装了以下工具：

# 检查Docker是否安装 docker --version # 检查kubectl是否安装 kubectl version --client # 检查tar工具（用于镜像打包） tar --version

如果缺少任何工具，请先安装它们。对于Ubuntu系统，可以使用以下命令安装：

# 安装Docker sudo apt update sudo apt install docker.io # 安装kubectl curl -LO "https://dl.k8s.io/release/$(curl -L -s https://dl.k8s.io/release/stable.txt)/bin/linux/amd64/kubectl" sudo install -o root -g root -m 0755 kubectl /usr/local/bin/kubectl

2.2 本地K8s集群准备

确保你的本地Kubernetes集群正常运行：

# 检查集群状态 kubectl cluster-info # 查看节点状态 kubectl get nodes # 检查存储类（用于持久化存储） kubectl get storageclass

3. 从CSDN实例导出镜像

现在我们来完成最关键的一步：从CSDN实例导出Fish Speech 1.5的Docker镜像。

3.1 连接到CSDN实例

首先通过SSH连接到你的CSDN GPU实例：

ssh root@your-csdn-instance-ip

3.2 查找并导出Docker镜像

在CSDN实例上执行以下命令来查找和导出镜像：

# 查找Fish Speech相关的镜像 docker images | grep fish-speech # 导出镜像到tar文件（假设镜像名为fish-speech-1.5） docker save fish-speech-1.5:latest > fish-speech-1.5.tar # 压缩镜像文件以减小传输大小 gzip fish-speech-1.5.tar

3.3 传输镜像到本地

将导出的镜像文件传输到你的本地机器：

# 从本地机器执行SCP命令 scp root@your-csdn-instance-ip:/path/to/fish-speech-1.5.tar.gz ./

文件大小提示：Fish Speech 1.5镜像大约5-7GB，传输可能需要一些时间，请确保网络连接稳定。

4. 本地K8s集群部署

现在我们已经将镜像传输到本地，接下来在K8s集群中部署Fish Speech 1.5。

4.1 加载镜像到本地Docker

首先将镜像加载到本地Docker环境中：

# 解压缩（如果之前压缩了） gunzip fish-speech-1.5.tar.gz # 加载镜像到Docker docker load < fish-speech-1.5.tar # 验证镜像加载成功 docker images | grep fish-speech

4.2 创建K8s部署配置文件

创建Fish Speech的Kubernetes部署文件fish-speech-deployment.yaml：

apiVersion: apps/v1 kind: Deployment metadata: name: fish-speech labels: app: fish-speech spec: replicas: 1 selector: matchLabels: app: fish-speech template: metadata: labels: app: fish-speech spec: containers: - name: fish-speech image: fish-speech-1.5:latest ports: - containerPort: 7860 resources: limits: nvidia.com/gpu: 1 memory: "8Gi" cpu: "4" requests: nvidia.com/gpu: 1 memory: "4Gi" cpu: "2" volumeMounts: - name:># pvc.yaml apiVersion: v1 kind: PersistentVolumeClaim metadata: name: fish-speech-pvc spec: accessModes: - ReadWriteOnce resources: requests: storage: 20Gi

应用PVC配置：

kubectl apply -f pvc.yaml

4.4 部署应用到K8s集群

现在部署Fish Speech应用到你的K8s集群：

# 应用部署配置 kubectl apply -f fish-speech-deployment.yaml # 检查部署状态 kubectl get deployments # 查看Pod状态 kubectl get pods # 查看服务状态 kubectl get services

5. 验证部署与功能测试

部署完成后，我们需要验证Fish Speech是否正常运行。

5.1 检查服务状态

使用以下命令检查服务运行状态：

# 查看详细的Pod状态 kubectl describe pod <fish-speech-pod-name> # 查看日志确认服务正常启动 kubectl logs <fish-speech-pod-name> -f

5.2 访问Web界面

获取服务的访问地址：

# 获取外部IP或NodePort kubectl get service fish-speech-service # 如果是LoadBalancer类型，等待外部IP分配 # 如果是NodePort，通过节点IP:端口访问

打开浏览器访问Web界面，你应该能看到Fish Speech的操作界面。

5.3 功能测试

进行基本的语音合成测试：

1. 在输入文本框中输入测试文字："你好，这是Fish Speech语音合成测试"
2. 点击"开始合成"按钮
3. 等待处理完成
4. 播放生成的音频确认质量

6. 常见问题与解决方案

在迁移过程中可能会遇到一些问题，这里提供常见问题的解决方法。

6.1 镜像导入失败

问题：Docker镜像加载失败或显示无效的镜像格式

解决方案：

# 重新导出镜像时使用标准格式 docker save -o fish-speech-1.5.tar fish-speech-1.5:latest # 检查镜像完整性 tar -tf fish-speech-1.5.tar | head -10

6.2 GPU资源不足

问题：Pod启动失败，显示GPU资源不足

解决方案：

• 检查集群GPU节点：kubectl get nodes -o wide
• 修改部署文件减少GPU请求数量
• 或者添加更多GPU节点到集群

6.3 持久化存储问题

问题：PVC一直处于Pending状态

解决方案：

# 检查存储类 kubectl get storageclass # 修改PVC使用可用存储类 # 在pvc.yaml中添加storageClassName字段

6.4 服务无法访问

问题：服务部署成功但无法通过浏览器访问

解决方案：

# 检查服务类型和端口 kubectl describe service fish-speech-service # 检查网络策略 kubectl get networkpolicies # 临时端口转发进行测试 kubectl port-forward service/fish-speech-service 7860:7860

7. 优化与进阶配置

成功部署后，你可以进一步优化Fish Speech的性能和功能。

7.1 性能优化配置

调整部署资源配置以获得更好性能：

# 在deployment.yaml中调整资源限制 resources: limits: nvidia.com/gpu: 1 memory: "16Gi" cpu: "8" requests: nvidia.com/gpu: 1 memory: "8Gi" cpu: "4"

7.2 自动扩缩容配置

配置HPA（Horizontal Pod Autoscaler）实现自动扩缩容：

# 创建HPA kubectl autoscale deployment fish-speech --cpu-percent=50 --min=1 --max=3

7.3 监控与日志

设置监控和日志收集：

# 查看实时日志 kubectl logs -f deployment/fish-speech # 监控资源使用情况 kubectl top pods

8. 总结

通过本教程，你已经成功学会了如何从CSDN实例导出Fish Speech 1.5镜像并迁移到本地Kubernetes集群部署。整个过程包括环境准备、镜像导出、本地部署和功能验证四个主要步骤。

关键要点回顾：

1. 从CSDN实例导出镜像时使用docker save命令
2. 传输前压缩镜像文件以节省时间和带宽
3. 在本地使用docker load加载镜像
4. 通过K8s部署文件配置GPU资源和持久化存储
5. 部署后务必验证服务功能和访问性

下一步建议：

• 定期备份持久化数据中的重要文件
• 设置监控告警以便及时发现问题
• 考虑使用镜像仓库管理你的Docker镜像
• 探索Fish Speech的高级功能如声音克隆等

现在你已经在本地环境成功部署了Fish Speech 1.5，可以开始享受高质量的文本转语音服务了。如果在使用过程中遇到任何问题，可以参考第6节的常见问题解决方案，或者查阅Fish Speech的官方文档。

获取更多AI镜像

想探索更多AI镜像和应用场景？访问 CSDN星图镜像广场，提供丰富的预置镜像，覆盖大模型推理、图像生成、视频生成、模型微调等多个领域，支持一键部署。