Nanbeige 4.1-3B快速部署：GitHub Actions自动构建+阿里云OSS静态托管
Nanbeige 4.1-3B快速部署：GitHub Actions自动构建+阿里云OSS静态托管
1. 项目概述
Nanbeige 4.1-3B是一款融合了复古像素游戏风格与AI对话功能的创新项目。这个独特的聊天终端将传统的大模型对话体验转变为一场视觉化的冒险旅程。
核心特点：
- 采用JRPG风格的像素美术设计
- 完整保留Nanbeige 4.1-3B模型的对话能力
- 支持流式响应和思考过程可视化
- 专为Web部署优化的轻量级前端
2. 环境准备
2.1 基础要求
在开始部署前，请确保您已准备好以下资源：
- GitHub账号：用于代码托管和Actions自动化
- 阿里云OSS存储桶：用于静态网站托管
- Python 3.8+环境：本地开发测试使用
- Docker环境（可选）：用于本地容器化测试
2.2 项目克隆
git clone https://github.com/[your-repo]/nanbeige-rpg-chat.git cd nanbeige-rpg-chat3. 本地运行测试
3.1 安装依赖
pip install -r requirements.txt3.2 启动本地服务
streamlit run app.py启动后，您将在终端看到类似输出：
You can now view your Streamlit app in your browser. Local URL: http://localhost:8501 Network URL: http://192.168.x.x:85014. 自动化部署配置
4.1 GitHub Actions设置
在项目根目录创建.github/workflows/deploy.yml文件：
name: Deploy to AliOSS on: push: branches: [ main ] jobs: deploy: runs-on: ubuntu-latest steps: - uses: actions/checkout@v3 - name: Set up Python uses: actions/setup-python@v4 with: python-version: '3.10' - name: Install dependencies run: | python -m pip install --upgrade pip pip install -r requirements.txt - name: Build static files run: | mkdir -p ./build streamlit run app.py --server.headless true --server.port 8501 & sleep 10 wget -r -np -nH --cut-dirs=1 -P ./build http://localhost:8501/ - name: Deploy to AliOSS uses: manyuanrong/setup-ossutil@v1.1 with: endpoint: oss-cn-beijing.aliyuncs.com access-key-id: ${{ secrets.OSS_ACCESS_KEY_ID }} access-key-secret: ${{ secrets.OSS_ACCESS_KEY_SECRET }} command: cp -r ./build oss://your-bucket-name/ --recursive --force4.2 阿里云OSS配置
- 登录阿里云OSS控制台
- 创建存储桶并开启静态网站托管功能
- 设置默认首页为
index.html - 在GitHub仓库设置中添加以下Secrets：
OSS_ACCESS_KEY_IDOSS_ACCESS_KEY_SECRET
5. 部署流程详解
5.1 构建过程解析
GitHub Actions将执行以下关键步骤：
- 设置Python环境
- 安装项目依赖
- 以无头模式启动Streamlit服务
- 使用wget抓取静态页面
- 通过ossutil工具上传到阿里云OSS
5.2 自定义域名配置（可选）
如果您需要使用自定义域名：
- 在阿里云OSS中绑定域名
- 配置CDN加速
- 设置HTTPS证书
- 修改CNAME记录指向OSS域名
6. 常见问题解决
6.1 静态资源加载失败
症状：页面显示但样式丢失
解决方案：
- 检查OSS存储桶的公共读权限
- 确保wget命令正确抓取了所有资源文件
- 验证文件路径是否一致
6.2 部署后功能异常
症状：对话功能不可用
解决方案：
- 确认后端API服务正常运行
- 检查跨域设置是否正确
- 验证模型加载是否成功
7. 总结
通过本文介绍的GitHub Actions+阿里云OSS方案，您可以实现Nanbeige 4.1-3B像素风格聊天终端的自动化部署。这种部署方式具有以下优势：
- 完全自动化：代码推送后自动构建部署
- 成本低廉：利用OSS静态托管节省服务器费用
- 高可用性：阿里云全球基础设施保障访问稳定
- 易于维护：版本控制与部署流程一体化
建议定期检查GitHub Actions的运行日志，并根据实际需求调整部署策略。对于高流量场景，可以考虑结合CDN进一步提升性能。
获取更多AI镜像
想探索更多AI镜像和应用场景？访问 CSDN星图镜像广场，提供丰富的预置镜像，覆盖大模型推理、图像生成、视频生成、模型微调等多个领域，支持一键部署。