RustGPT完整部署教程：从源码到生产环境的简单步骤

【免费下载链接】rustgpt RustGPT is a ChatGPT UI built with Rust + HTMX: the power of Rust coupled with the simplicity of HTMX 💚 项目地址: https://gitcode.com/gh_mirrors/ru/rustgpt

RustGPT是一个使用Rust + HTMX构建的ChatGPT UI，将Rust的强大功能与HTMX的简洁性相结合。本教程将带你完成从源码克隆到生产环境部署的全过程，即使是新手也能轻松上手。

一、准备部署环境

在开始部署RustGPT之前，确保你的系统已安装以下工具：

• Git
• Docker和Docker Compose
• Rust开发环境（可选，如需本地开发）

二、获取项目源码

首先，克隆RustGPT项目仓库到本地：

git clone https://gitcode.com/gh_mirrors/ru/rustgpt
cd rustgpt

三、使用Docker快速部署（推荐）

3.1 构建Docker镜像

项目根目录下提供了Dockerfile文件，执行以下命令构建Docker镜像：

docker build -t bitswired/rustgpt .

3.2 配置环境变量

查看项目中的docker-compose.yml文件，其中定义了必要的环境变量：

• DATABASE_URL: 数据库连接URL
• MIGRATIONS_PATH: 数据库迁移文件路径
• TEMPLATES_PATH: 模板文件路径

如需修改配置，可以直接编辑docker-compose.yml文件。

3.3 启动服务

使用Docker Compose一键启动服务：

docker-compose up -d

服务启动后，访问 http://localhost:3000 即可使用RustGPT。

四、本地开发部署（适合开发者）

4.1 安装依赖

使用Cargo安装项目依赖：

cargo build

4.2 启动开发服务器

项目提供了justfile工具，可以使用以下命令启动开发模式：

just dev

此命令将同时运行tailwind和cargo run，并启用 watch 模式，方便开发时实时预览更改。

五、验证部署结果

部署完成后，可以通过以下方式验证：

1. 访问 http://localhost:3000，确认页面正常加载
2. 尝试进行简单的对话，检查AI响应功能是否正常
3. 查看数据库文件是否在指定路径生成（默认在db/db.db）

六、常见问题解决

6.1 端口冲突

如果3000端口已被占用，可以修改docker-compose.yml中的端口映射：

ports:
  - "8080:3000"  # 将8080替换为其他可用端口

6.2 数据库迁移失败

确保数据库目录有写入权限，或检查MIGRATIONS_PATH环境变量是否正确指向db/migrations/目录。

6.3 构建速度慢

使用Docker构建时，首次构建会下载依赖，可能需要较长时间，请耐心等待。后续构建会利用缓存，速度会显著提升。

通过以上步骤，你已经成功部署了RustGPT。无论是生产环境还是开发环境，都能快速搭建并开始使用这个强大的ChatGPT UI。如果在部署过程中遇到其他问题，可以查阅项目文档或提交issue寻求帮助。

【免费下载链接】rustgpt RustGPT is a ChatGPT UI built with Rust + HTMX: the power of Rust coupled with the simplicity of HTMX 💚 项目地址: https://gitcode.com/gh_mirrors/ru/rustgpt