快速开始

本文将帮助你快速部署并运行米卡AIGC云转码系统。

环境要求

硬件要求

项目	最低配置	推荐配置
CPU	2 核	4 核+
内存	4 GB	8 GB+
磁盘	50 GB	100 GB+ SSD
带宽	5 Mbps	10 Mbps+

提示

视频转码是 CPU 密集型任务，建议使用高性能 CPU。磁盘空间取决于视频存储量。

软件要求

软件	版本要求	说明
宝塔面板	7.9+	服务器管理面板
Nginx	1.20+	Web 服务器
MySQL	8.0+	数据库
Redis	7.0+	缓存（可选但推荐）
FFmpeg	5.0+	视频转码引擎

说明

系统提供已编译的可执行文件，无需安装 Go 或 Node.js 环境。

部署方式

推荐使用宝塔面板部署，简单快捷：

方式	难度	适用场景
宝塔面板部署	⭐⭐ 简单	推荐，适合所有用户
手动部署	⭐⭐⭐⭐ 复杂	适合高级用户

快速部署（宝塔面板）

1. 准备项目文件

1. 从发布页下载最新版本的压缩包
2. 在宝塔面板 文件 管理中上传到 /www/wwwroot/mika 目录
3. 解压文件

2. 安装必要软件

在宝塔软件商店中安装：

• Nginx 1.20+
• MySQL 8.0+
• Redis 7.0+（可选）

3. 创建数据库

在宝塔面板 数据库 中创建新数据库：

• 数据库名：自定义
• 用户名：自定义
• 编码：utf8mb4

4. 添加 GO 项目

1. 打开宝塔面板 → 网站 → GO项目
2. 点击 添加GO项目
3. 填写配置：
   • 项目名称：server
   • 项目路径：/www/wwwroot/mika/server
   • 执行文件：server
   • 端口：7501
   • 域名：你的域名或 IP
4. 点击 启动 按钮

5. 访问系统

在浏览器中访问你的域名或 IP，系统会自动进入安装引导页面。

安装引导

首次访问系统时，会自动进入安装引导页面，按照提示完成配置即可。

配置数据库

在安装引导页面填写数据库连接信息：

配置项	说明
数据库主机	127.0.0.1
数据库端口	3306
数据库名称	步骤3创建的数据库名
数据库用户	步骤3创建的用户名
数据库密码	步骤3创建的密码

完成安装

点击"完成安装"按钮，系统将自动：

1. 验证数据库连接
2. 创建数据库表
3. 初始化系统配置
4. 跳转到登录页面

安全提醒

安装完成后，请立即登录系统并修改管理员密码！

安装配置文件

安装完成后，系统会在 server/configs/ 目录下创建 install.json 配置文件。

{
  "installed": true,
  "installed_at": "2024-01-01T00:00:00Z",
  "version": "2.0.0"
}

重新安装

如需重新进入安装引导页，只需删除 server/configs/install.json 文件，然后重启服务即可。

服务管理

通过宝塔面板管理

在 网站 → GO项目 中，可以方便地管理服务：

• 启动 - 启动服务
• 停止 - 停止服务
• 重启 - 重启服务
• 日志 - 查看运行日志

数据备份

备份数据库：

• 在宝塔面板 数据库 中，点击数据库后的 备份 按钮

备份文件：

• 在宝塔面板 文件 中，压缩 /www/wwwroot/mika 目录

常见问题

Q: GO 项目启动失败？

1. 检查执行文件权限：chmod +x /www/wwwroot/mika/server/server
2. 在宝塔 GO项目 中查看日志，找出具体错误
3. 检查端口 7501 是否被占用

Q: 无法访问系统？

1. 检查 GO 项目是否正常运行
2. 检查防火墙是否开放 80/443 端口
3. 检查域名是否正确解析

Q: 数据库连接失败？

1. 检查数据库服务是否运行
2. 检查数据库名、用户名、密码是否正确
3. 在宝塔 数据库 中查看 MySQL 状态

Q: 视频转码失败？

1. 检查 FFmpeg 是否安装：ffmpeg -version
2. 检查磁盘空间是否充足
3. 在 GO 项目日志中查看详细错误信息

下一步

• 宝塔面板部署 - 使用宝塔面板快速部署
• 系统配置 - 配置系统各项参数
• 视频转码 - 开始使用视频转码功能