taigaio/taiga-back

taiga-back Docker镜像文档

镜像概述

taiga-back Docker镜像是Taiga开源项目管理工具的后端服务实现，作为Taiga系统的核心组件，负责提供RESTful API接口、业务逻辑处理、数据持久化及与前端服务（taiga-front）的交互，支撑项目管理、任务跟踪、用户协作等全流程功能。

核心功能与特性

• RESTful API支持：提供标准化API接口，覆盖项目创建、任务管理、用户协作等所有前端操作的后端支撑；
• 数据处理与存储：实现业务数据的接收、校验及处理，支持与PostgreSQL数据库交互完成数据持久化；
• 权限与认证管理：内置用户认证、角色权限控制逻辑，确保项目数据的访问安全性与操作合规性；
• 灵活配置能力：支持通过环境变量自定义数据库连接、服务端口、密钥等核心参数，适配不同部署场景需求。

使用场景

• 企业/团队搭建私有项目管理系统，实现任务跟踪、需求管理、敏捷开发流程落地；
• 开发/测试环境快速部署Taiga后端服务，配合前端组件验证功能完整性；
• 个人开发者构建轻量级项目管理工具，管理个人或小型团队的项目进度与资源分配。

使用方法与配置说明

前置依赖

• 需预先部署PostgreSQL数据库（推荐版本12+）；
• 建议配合taiga-front镜像部署，实现完整的Taiga系统功能。

快速启动（docker run）

bash
docker run -d \
  --name taiga-back \
  -p 8000:8000 \
  -e DATABASE_URL=postgres://user:password@postgres-host:5432/taiga \
  -e SECRET_KEY=your-secure-random-key \
  -e DEBUG=False \
  taigaio/taiga-back:latest

核心环境变量配置

Docker Compose完整部署示例

yaml
version: '3.8'

services:
  postgres:
    image: postgres:13-alpine
    environment:
      POSTGRES_USER: taiga
      POSTGRES_PASSWORD: taiga-passwd
      POSTGRES_DB: taiga
    volumes:
      - postgres_data:/var/lib/postgresql/data
    restart: unless-stopped

  taiga-back:
    image: taigaio/taiga-back:latest
    depends_on:
      - postgres
    environment:
      DATABASE_URL: postgres://taiga:taiga-passwd@postgres:5432/taiga
      SECRET_KEY: "your-32-char-random-secret-key-here"
      DEBUG: "False"
      ALLOWED_HOSTS: "taiga.example.com,192.168.1.100"
      PORT: "8000"
    ports:
      - "8000:8000"
    restart: unless-stopped

volumes:
  postgres_data:

部署后初始化

首次启动需执行数据库迁移以创建必要表结构：

bash
docker exec taiga-back python manage.py migrate

注意事项

• 生产环境中建议使用外部独立数据库，避免容器内数据丢失风险；
• SECRET_KEY需妥善保管，修改后可能导致现有加密数据不可用；
• 需配置taiga-front镜像的API_URL指向taiga-back服务地址（如http://taiga-back:8000/api）以确保前后端通信正常。