Project Nest Docker镜像文档

概述

Project Nest 是一个专为项目管理和团队协作设计的轻量级Docker镜像，封装了完整的Project Nest应用服务。该镜像旨在提供简单易用的任务跟踪、团队协作和项目进度可视化解决方案，支持快速部署，无需复杂的环境配置，适用于各类规模的团队和项目管理场景。

核心功能与特性

• 任务管理：支持创建、分配、跟踪和完成任务，包含优先级、截止日期、标签和子任务管理
• 团队协作：提供团队成员管理、角色权限控制、评论互动和实时通知功能
• 项目可视化：通过看板、列表、日历和甘特图多视图展示项目进度，支持数据导出与报表生成
• API支持：内置RESTful API接口，支持与第三方工具集成（如Git、Slack、Jira等）
• 数据持久化：支持SQLite、MySQL和PostgreSQL多数据库类型，支持外部卷挂载确保数据安全
• 轻量级设计：基于Alpine Linux构建，镜像体积小（<200MB），资源占用低，启动速度快（<30秒）

使用场景与适用范围

• 小型团队协作：适用于5-20人规模的小型团队进行日常项目任务分配与进度跟踪
• 敏捷开发管理：支持Scrum、Kanban等敏捷开发方法论，可用于迭代计划、 sprint 跟踪和用户故事管理
• 个人项目管理：个人开发者用于管理多项目任务、目标追踪和时间规划
• 临时项目协作：快速部署用于短期项目的临时协作平台，项目结束后可一键移除容器，不残留系统依赖

使用方法与配置说明

快速启动

通过以下命令可快速启动Project Nest容器（默认使用SQLite数据库）：

bash
docker run -d -p 8080:8080 --name project-nest -v ./project-nest-data:/app/data projectnest:latest

参数说明：

• -d：后台运行容器
• -p 8080:8080：将容器8080端口映射到主机8080端口（默认应用端口）
• --name project-nest：指定容器名称为project-nest
• -v ./project-nest-data:/app/data：挂载主机当前目录下的project-nest-data文件夹到容器内/app/data目录，实现数据持久化

启动后，通过浏览器访问 http://localhost:8080 即可打开Project Nest应用，默认管理员账户：admin，密码：admin123。

环境变量配置

Project Nest支持通过环境变量自定义配置，常用环境变量说明如下：

外部数据库配置示例（MySQL）

bash
docker run -d -p 8080:8080 \
  -e DB_TYPE=mysql \
  -e DB_HOST=192.168.1.100 \
  -e DB_PORT=3306 \
  -e DB_USER=nestadmin \
  -e DB_PASSWORD=SecureDbPass123! \
  -e DB_NAME=project_nest_prod \
  -e ADMIN_PASSWORD=AdminPass2024! \
  --name project-nest \
  projectnest:latest

Docker Compose配置

推荐使用Docker Compose进行生产环境部署，以下是包含Project Nest和MySQL的完整配置示例：

yaml
version: '3.8'

services:
  project-nest:
    image: projectnest:latest
    container_name: project-nest
    ports:
      - "8080:8080"
    environment:
      - DB_TYPE=mysql
      - DB_HOST=mysql
      - DB_PORT=3306
      - DB_USER=nestuser
      - DB_PASSWORD=nestuserpass
      - DB_NAME=project_nest
      - ADMIN_USER=teamlead
      - ADMIN_PASSWORD=SecureAdmin2024!
      - LOG_LEVEL=info
    depends_on:
      - mysql
    restart: unless-stopped
    volumes:
      - ./attachments:/app/attachments  # 挂载附件存储目录

  mysql:
    image: mysql:8.0
    container_name: project-nest-mysql
    volumes:
      - mysql-data:/var/lib/mysql
    environment:
      - MYSQL_ROOT_PASSWORD=rootpass123
      - MYSQL_DATABASE=project_nest
      - MYSQL_USER=nestuser
      - MYSQL_PASSWORD=nestuserpass
    restart: unless-stopped
    ports:
      - "3306:3306"  # 可选：如需外部访问数据库

volumes:
  mysql-data:

保存为 docker-compose.yml 后，通过以下命令启动服务：

bash
docker-compose up -d

注意事项

• 安全配置：首次登录后请立即通过「设置 > 账户管理」修改默认管理员密码，生产环境建议启用两步验证
• 数据备份：定期备份挂载的数据卷目录（如./project-nest-data或./attachments），避免数据丢失
• 性能优化：对于10人以上团队或大量任务场景，建议使用MySQL/PostgreSQL数据库替代默认SQLite
• HTTPS配置：生产环境部署时，建议通过Nginx或Traefik等反向代理配置HTTPS，增强传输安全性
• 版本更新：升级镜像时，需先备份数据卷，再通过docker pull projectnest:latest拉取新版本并重启容器