vitodeploy/vito

VitoDeploy

镜像概述

VitoDeploy 是一款专为 PHP 应用设计的自托管服务器管理工具，旨在帮助用户无需依赖第三方服务，即可自行部署、监控和管理服务器上的 PHP 应用程序。通过 Docker 容器化部署，简化了安装流程，同时确保环境一致性和可移植性。

核心功能与特性

• 自托管部署：支持在用户自有服务器上部署，完全掌控数据和服务器资源，无需依赖外部服务。
• PHP 应用管理：专为 PHP 应用优化，支持应用部署、版本控制、依赖管理等核心功能。
• 服务器监控：提供服务器资源（CPU、内存、磁盘）监控，实时查看应用运行状态和性能指标。
• 配置管理：集中管理服务器和应用配置，支持环境变量、配置文件的统一维护和更新。
• 容器化支持：基于 Docker 构建，支持与 Docker Compose 集成，简化多容器应用部署流程。

使用场景与适用范围

• PHP 开发者：需要自行管理服务器以部署个人项目或客户项目的开发者。
• 小型开发团队：缺乏专业运维人员，需要简单易用的工具管理团队的 PHP 应用服务器。
• 企业内部系统：对数据隐私和服务器控制权有较高要求，需在自有服务器部署 PHP 应用的企业。
• 测试与生产环境：支持从测试环境到生产环境的无缝迁移，确保环境一致性。

使用方法与配置说明

前提条件

• 已安装 Docker 和 Docker Compose（推荐 Docker 20.10+，Docker Compose 2.0+）。
• 服务器需开放必要端口（如 80、443 用于 Web 访问，具体端口可配置）。

Docker 快速启动

通过 docker run 命令快速启动 VitoDeploy 容器：

bash
docker run -d \
  --name vitodeploy \
  -p 80:80 \
  -p 443:443 \
  -v /path/to/vitodeploy/data:/app/data \
  -v /var/run/docker.sock:/var/run/docker.sock \
  --restart unless-stopped \
  docker.xuanyuan.run/vitodeploy/vitodeploy:latest

参数说明：

• -p 80:80：映射 HTTP 端口（可根据需求修改主机端口）。
• -p 443:443：映射 HTTPS 端口（如需启用 HTTPS）。
• -v /path/to/vitodeploy/data:/app/data：挂载数据目录，持久化存储配置和应用数据。
• -v /var/run/docker.sock:/var/run/docker.sock：挂载 Docker 守护进程套接字，用于管理服务器上的 Docker 容器。

Docker Compose 配置示例

创建 docker-compose.yml 文件，配置更复杂的部署环境：

yaml
version: '3.8'

services:
  vitodeploy:
    image: docker.xuanyuan.run/vitodeploy/vitodeploy:latest
    container_name: vitodeploy
    restart: unless-stopped
    ports:
      - "80:80"
      - "443:443"
    volumes:
      - ./vitodeploy-data:/app/data
      - /var/run/docker.sock:/var/run/docker.sock
    environment:
      - APP_ENV=production  # 环境变量：production 或 development
      - ADMIN_EMAIL=admin@example.com  # 管理员邮箱，用于初始登录
      - ADMIN_PASSWORD=securepassword  # 管理员初始密码（建议部署后修改）
      - DB_CONNECTION=sqlite  # 数据库连接方式，默认使用 SQLite
      # 如需使用 MySQL，可添加以下环境变量：
      # - DB_CONNECTION=mysql
      # - DB_HOST=mysql
      # - DB_PORT=3306
      # - DB_DATABASE=vitodeploy
      # - DB_USERNAME=root
      # - DB_PASSWORD=mysqlpassword

  # 如需使用 MySQL 数据库，可添加以下服务配置
  mysql:
    image: docker.xuanyuan.run/mysql:8.0
    container_name: vitodeploy-mysql
    restart: unless-stopped
    environment:
      - MYSQL_ROOT_PASSWORD=mysqlpassword
      - MYSQL_DATABASE=vitodeploy
    volumes:
      - ./mysql-data:/var/lib/mysql

启动服务：

bash
docker-compose up -d

环境变量配置

VitoDeploy 支持通过环境变量自定义配置，常用环境变量如下：

访问与初始化

服务启动后，通过服务器 IP 或域名访问 VitoDeploy 界面（默认端口 80），使用配置的管理员***和密码登录，完成初始设置（如服务器添加、应用部署等）。更多详细配置可参考官方文档：VitoDeploy Docker 安装指南。