magentaaps/obvius-web

Obvius Web平台Docker镜像文档

镜像概述

Obvius Web平台Docker镜像是Obvius系列Web应用的容器化部署方案，旨在简化Web服务的搭建、配置与运维流程。通过Docker容器化技术，实现应用环境隔离、快速部署及跨环境一致性，降低传统部署中的环境依赖问题，适用于各类基于Obvius Web框架的应用场景。

核心功能与特性

• 容器化部署：基于Docker容器技术，封装完整运行环境，无需手动配置依赖组件
• 环境隔离：独立运行空间，避免与主机环境或其他应用冲突
• 快速启动：简化启动流程，通过一条命令即可完成服务部署
• 版本兼容：支持多版本Obvius Web平台，可通过标签指定具体版本
• 配置灵活：支持通过环境变量、配置文件挂载等方式自定义应用参数

使用场景

• 企业内部数据监控与管理系统部署
• 物联网（IoT）设备数据可视化平台搭建
• 实时数据采集与展示Web应用快速上线
• 开发/测试环境中Obvius应用的快速验证
• 中小型Web服务的轻量化部署与扩展

使用方法

基本部署（Docker Run）

通过docker run命令快速启动Obvius Web平台服务：

bash
docker run -d \
  --name obvius-web \
  -p 8080:80 \  # 端口映射（主机端口:容器端口）
  -v /path/to/local/config:/app/config \  # 挂载本地配置文件（可选）
  -e TZ=Asia/Shanghai \  # 设置时区（可选）
  -e LOG_LEVEL=info \  # 设置日志级别（可选，支持debug/info/warn/error）
  obvius/web-platform:latest

Docker Compose部署

创建docker-compose.yml文件，配置更复杂的部署环境（如与数据库联动）：

yaml
version: '3'
services:
  obvius-web:
    image: docker.xuanyuan.run/obvius/web-platform:latest
    container_name: obvius-web
    restart: always
    ports:
      - "8080:80"
    environment:
      - TZ=Asia/Shanghai
      - LOG_LEVEL=info
      - DB_HOST=mysql  # 数据库主机（需与数据库服务名一致）
      - DB_PORT=3306
      - DB_USER=obvius_user
      - DB_PASSWORD=obvius_pass
      - DB_NAME=obvius_db
    volumes:
      - ./config:/app/config  # 本地配置文件目录
      - ./data:/app/data      # 应用数据持久化目录
    depends_on:
      - mysql

  mysql:
    image: docker.xuanyuan.run/mysql:8.0
    container_name: obvius-mysql
    restart: always
    environment:
      - MYSQL_ROOT_PASSWORD=root_pass
      - MYSQL_DATABASE=obvius_db
      - MYSQL_USER=obvius_user
      - MYSQL_PASSWORD=obvius_pass
    volumes:
      - mysql-data:/var/lib/mysql

volumes:
  mysql-data:

启动服务：

bash
docker-compose up -d

环境变量配置

数据持久化

为避免容器重启导致数据丢失，建议挂载以下目录：

• 配置文件目录：/app/config（存放自定义配置文件）
• 应用数据目录：/app/data（存放应用运行时数据）
• 日志目录：/app/logs（存放服务日志，可选）

版本管理

通过镜像标签指定Obvius Web平台版本，格式为obvius/web-platform:<version>，例如：

• 最新稳定版：obvius/web-platform:latest
• 特定版本：obvius/web-platform:1.2.0

注意事项

1. 首次启动时，建议挂载配置文件目录，避免默认配置被覆盖
2. 如使用外部数据库，需确保数据库服务已提前启动并可访问
3. 生产环境部署时，建议通过docker-compose或容器编排工具（如Kubernetes）管理服务
4. 高并发场景下，可通过调整容器资源限制（--memory、--cpus）优化性能
5. 定期备份挂载的数据目录，防止数据丢失

常见问题

• 服务启动后无法访问：检查端口映射是否正确，容器日志是否有错误信息（docker logs obvius-web）
• 配置不生效：确认挂载的配置文件路径与容器内路径一致，配置文件格式是否正确
• 数据库连接失败：检查环境变量中数据库参数是否正确，数据库服务是否允许容器网络访问