Skip to main content

Docker Compose 部署

本指南介绍如何使用 Docker Compose 一键部署完整的 Hagicode 系统。这是推荐的部署方式，适合大多数用户，特别是开发、测试和生产环境。

使用配置生成器

推荐使用我们的 交互式 Docker Compose 配置生成器！

通过简单的表单填写，即可快速生成符合您需求的 docker-compose.yml 配置文件。生成器支持：

  • 自定义端口、容器名称等基础配置
  • 选择内置数据库或外部数据库
  • 自动配置 Windows/Linux 平台差异
  • 智能处理文件权限问题

🚀 立即使用生成器 →

推荐方式

Docker Compose 部署是首选的安装方式，具有以下优势：

  • 环境隔离，避免依赖冲突
  • 一键启动所有服务（PostgreSQL + Hagicode）
  • 易于管理和维护
  • 适合快速体验和测试

前置要求​

在开始之前，请确保您的系统已安装 Docker 和 Docker Compose。

安装 Docker​

下载并安装 Docker Desktop for Windows

安装完成后，确保 Docker Desktop 正在运行。

验证安装​

安装完成后，运行以下命令验证 Docker 和 Docker Compose 是否正确安装：

docker --version
docker compose version

快速开始​

1. 生成 Docker Compose 配置文件​

使用配置生成器

推荐使用我们的 交互式 Docker Compose 配置生成器 来生成您的配置文件。

生成器支持：

  • 多种 API 提供商选择（智谱 AI、Anthropic 官方、自定义 API）
  • 自动配置 API URL 和 Token
  • 自定义端口、容器名称等基础配置
  • 选择内置数据库或外部数据库
  • 自动配置 Windows/Linux 平台差异
  • 智能处理文件权限问题

🚀 立即使用生成器 →

  1. 打开 Docker Compose 配置生成器
  2. 根据您的需求填写配置：
    • 选择 API 提供商（智谱 AI、Anthropic 官方或自定义）
    • 配置端口、数据库、工作目录等选项
  3. 点击生成按钮，获取 docker-compose.yml 配置
  4. 将生成的配置保存为 docker-compose.yml 文件
  5. 如果需要，创建 .env 文件配置敏感信息
获取 API Token

您需要配置 Claude API Token 才能使用 Hagicode：

智谱 AI（推荐）：获取 API Token →

  • 国内访问稳定，响应更快
  • 性价比高，适合日常使用

Anthropic 官方：获取 API Token →

  • 直接使用 Anthropic 的服务

2. 启动服务​

在 docker-compose.yml 所在目录执行以下命令：

docker compose up -d

此命令将：

  • 下载并启动 PostgreSQL 容器
  • 下载并启动 Hagicode 应用容器
  • 创建并配置网络
  • 初始化数据库连接

3. 验证服务状态​

检查容器是否正在运行：

docker compose ps

您应该看到两个容器都处于 "running" 状态。

查看服务日志：

# 查看所有服务日志
docker compose logs

# 查看 Hagicode 服务日志
docker compose logs hagicode

# 实时跟踪日志
docker compose logs -f hagicode

配置说明​

如需修改配置（如更改端口、切换 API 提供商等），您可以：

  1. 重新使用 Docker Compose 配置生成器 生成新配置
  2. 手动编辑 docker-compose.yml 和 .env 文件
  3. 重启服务使配置生效：
docker compose restart

访问应用​

Web 界面​

服务启动成功后，通过浏览器访问：

http://localhost:45000

数据库连接​

如果您需要直接连接到 PostgreSQL 数据库，可以通过 docker exec 命令进入容器：

# 进入 PostgreSQL 容器并连接到数据库
docker exec -it hagicode-postgres psql -U postgres -d hagicode

容器内连接信息：

  • 主机: localhost 或 127.0.0.1（容器内）
  • 端口: 5432（PostgreSQL 默认端口）
  • 用户名: postgres
  • 密码: postgres
  • 数据库: hagicode
tip

PostgreSQL 未暴露到主机端口，这样更安全且避免端口冲突。如需从主机访问数据库，请使用 docker exec 命令。

后续步骤​

现在您已经成功部署了 Hagicode，请继续创建第一个项目以开始使用。

如果您更喜欢使用软件包方式部署，请参阅软件包部署指南。