TruckedAway Admin Site Docker镜像文档

镜像概述

TruckedAway Admin Site Docker镜像是专为TruckedAway运输管理系统设计的管理后台部署镜像，封装了完整的前端界面和后端服务组件。该镜像旨在简化管理后台的部署流程，降低运维复杂度，帮助用户快速搭建功能完善的运输管理界面，适用于各类物流运输场景的管理需求。

核心功能与特性

• 运输任务管理：支持运输任务的创建、分配、跟踪、修改与完成状态更新，提供任务优先级设置和截止时间提醒
• 车辆监控：集成GPS数据展示模块，实时监控车辆位置、行驶速度、路线轨迹及历史行驶记录
• 用户权限配置：支持多角色管理（系统管理员、调度员、司机、财务等），可精细化配置菜单访问权限和操作权限
• 数据统计与报表：自动生成运输效率、车辆利用率、任务完成率、成本核算等关键指标报表，支持导出Excel格式
• 系统配置：提供工作流自定义、通知规则设置（邮件/短信）、数据备份策略配置等系统级参数管理功能

使用场景

• 物流公司内部部署：快速搭建运输管理后台，实现任务调度、车辆监控和团队协作
• 运输平台运维：运维团队通过Docker快速部署或更新管理界面，减少环境配置差异导致的部署问题
• 开发测试环境：开发人员可通过镜像快速复现生产环境管理界面，用于功能测试和问题排查
• 小型运输团队：无需复杂服务器配置，通过简单命令即可搭建专业的运输管理系统后台

使用方法

基本部署（docker run命令）

docker run -d -p 8080:80 --name truckedaway-admin \
  -e DB_HOST=mysql-host \
  -e DB_PORT=3306 \
  -e DB_USER=admin \
  -e DB_PASSWORD=your-db-password \
  -e ADMIN_USER=admin \
  -e ADMIN_PASSWORD=your-admin-password \
  truckedaway/admin-site:latest

说明：部署后通过 http://localhost:8080 访问管理界面

Docker Compose配置示例

version: '3'
services:
  admin-site:
    image: truckedaway/admin-site:latest
    container_name: truckedaway-admin
    ports:
      - "8080:80"
    environment:
      - DB_HOST=mysql
      - DB_PORT=3306
      - DB_USER=admin
      - DB_PASSWORD=db-secret-123
      - ADMIN_USER=admin
      - ADMIN_PASSWORD=admin-123
      - LOG_LEVEL=INFO
    depends_on:
      - mysql
    restart: unless-stopped

  mysql:
    image: mysql:8.0
    container_name: truckedaway-mysql
    environment:
      - MYSQL_ROOT_PASSWORD=root-secret-123
      - MYSQL_DATABASE=truckedaway_admin
      - MYSQL_USER=admin
      - MYSQL_PASSWORD=db-secret-123
    volumes:
      - mysql-data:/var/lib/mysql
    restart: unless-stopped

volumes:
  mysql-data:

环境变量配置说明

注意事项

1. 数据库依赖：首次启动需确保数据库服务已正常运行，镜像会自动执行数据库表结构初始化脚本
2. 持久化存储：生产环境建议挂载配置文件和日志目录，示例命令：-v ./config:/app/config -v ./logs:/app/logs
3. 初始密码：未指定ADMIN_PASSWORD时，初始密码会随机生成，可通过docker logs truckedaway-admin命令查看
4. 安全建议：生产环境中应配合Nginx反向代理配置SSL证书，避免明文传输敏感信息
5. 版本更新：更新镜像时建议先备份数据库，避免数据结构变更导致的数据丢失